@tremolo-ui/react 0.1.5 → 0.2.0

package/dist/index.cjs

@@ -21,11 +21,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const clsx = __toESM(require("clsx"));
-const react = __toESM(require("react"));
-const react_jsx_runtime = __toESM(require("react/jsx-runtime"));
-const __tremolo_ui_functions = __toESM(require("@tremolo-ui/functions"));
-const zustand = __toESM(require("zustand"));
+let clsx = require("clsx");
+clsx = __toESM(clsx);
+let react = require("react");
+react = __toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+let __tremolo_ui_functions = require("@tremolo-ui/functions");
+let zustand = require("zustand");
 
 //#region src/components/AnimationCanvas/canvas.ts
 const drawingState = [
@@ -167,8 +169,8 @@ function AnimationCanvas({ draw, init, animate = true, options, width: _width =
 //#endregion
 //#region src/hooks/useCallbackRef.ts
 /**
-* This hook is user-land implementation of the experimental `useEffectEvent` hook.
-* React docs: https://react.dev/learn/separating-events-from-effects#declaring-an-effect-event
+* Internal
+* @private
 */
 function useCallbackRef(callback, deps = []) {
 	const callbackRef = (0, react.useRef)(() => {
@@ -199,8 +201,7 @@ function useEventListener(target, event, handler, options) {
 		handler
 	]);
 	return () => {
-		const node = typeof target === "function" ? target() : target ?? document;
-		node?.removeEventListener(event, listener, options);
+		(typeof target === "function" ? target() : target ?? document)?.removeEventListener(event, listener, options);
 	};
 }
 
@@ -225,6 +226,7 @@ function useRefCallbackEvent(event, handler, options, deps = []) {
 //#endregion
 //#region src/hooks/useDrag.ts
 /**
+* @category hooks
 * @returns [refCallback, pointerDownHandler]
 */
 function useDrag({ threshold = 1, onDrag, onDragStart, onDragEnd }) {
@@ -291,9 +293,7 @@ const AnimationKnob = (0, react.forwardRef)(({ value, min, max, defaultValue = m
 	const isRelativeSize = typeof (size ?? width) == "string" || typeof height == "string";
 	const onDrag = (0, react.useCallback)((_x, y) => {
 		if (!onChange) return;
-		const v = (0, __tremolo_ui_functions.rawValue)(valueRef.current - y / 100, min, max, skew);
-		const v2 = (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(v, step), min, max);
-		onChange(v2);
+		onChange((0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)((0, __tremolo_ui_functions.rawValue)(valueRef.current - y / 100, min, max, skew), step), min, max));
 	}, [
 		max,
 		min,
@@ -313,10 +313,8 @@ const AnimationKnob = (0, react.forwardRef)(({ value, min, max, defaultValue = m
 			event.preventDefault();
 			const x = key == "ArrowRight" || key == "ArrowUp" ? keyboard[1] : -keyboard[1];
 			let v;
-			if (keyboard[0] == "normalized") {
-				const n = (0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew);
-				v = (0, __tremolo_ui_functions.rawValue)(n + x, min, max, skew);
-			} else v = value + x;
+			if (keyboard[0] == "normalized") v = (0, __tremolo_ui_functions.rawValue)((0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew) + x, min, max, skew);
+			else v = value + x;
 			onChange((0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(v, step), min, max));
 		}
 	}, [
@@ -343,10 +341,8 @@ const AnimationKnob = (0, react.forwardRef)(({ value, min, max, defaultValue = m
 		event.preventDefault();
 		const x = event.deltaY > 0 ? -wheel[1] : wheel[1];
 		let v;
-		if (wheel[0] == "normalized") {
-			const n = (0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew);
-			v = (0, __tremolo_ui_functions.rawValue)(n + x, min, max, skew);
-		} else v = value + x;
+		if (wheel[0] == "normalized") v = (0, __tremolo_ui_functions.rawValue)((0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew) + x, min, max, skew);
+		else v = value + x;
 		if (onChange) onChange((0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(v, step), min, max));
 	}, { passive: false }, [
 		wheel,
@@ -458,20 +454,12 @@ function DragObserver(props) {
 *
 * @category Knob
 */
-const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defaultValue = min, startValue = min, size = 50, bodyNoSelect = true, wheel = ["raw", 1], keyboard = ["raw", 1], enableDoubleClickDefault = true, disabled = false, readonly = false, activeLine, inactiveLine, thumb, thumbLine, onChange, onKeyDown, onPointerDown, onDoubleClick, className, classes,...props }, ref) => {
+const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defaultValue = min, startValue = min, size = 50, bodyNoSelect = true, wheel = ["raw", 1], keyboard = ["raw", 1], enableDoubleClickDefault = true, disabled = false, readonly = false, activeLine, inactiveLine, thumb, thumbLine, thumbSize = 84, thumbLineWeight = 6, thumbLineLength = 35, lineWeight = 6, angleRange = 270, onChange, onKeyDown, onPointerDown, onDoubleClick, className, classes,...props }, forwardedRef) => {
 	const valueRef = (0, react.useRef)(0);
 	const elmRef = (0, react.useRef)(null);
-	const padding = 8;
-	const thumbLineWeight = 6;
-	const thumbLineLength = 35;
-	const lineWeight = size * .06;
-	const p = (0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew);
-	const s = (0, __tremolo_ui_functions.normalizeValue)(startValue, min, max, skew);
 	const onDrag = (0, react.useCallback)((_x, y) => {
 		if (!onChange || readonly) return;
-		const v = (0, __tremolo_ui_functions.rawValue)(valueRef.current - y / 100, min, max, skew);
-		const v2 = (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(v, step), min, max);
-		onChange(v2);
+		onChange((0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)((0, __tremolo_ui_functions.rawValue)(valueRef.current - y / 100, min, max, skew), step), min, max));
 	}, [
 		max,
 		min,
@@ -482,10 +470,8 @@ const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defau
 	]);
 	const updateValueByEvent = (0, react.useCallback)((eventType, x) => {
 		let newValue;
-		if (eventType == "normalized") {
-			const n = (0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew);
-			newValue = (0, __tremolo_ui_functions.rawValue)(n + x, min, max, skew);
-		} else newValue = value + x;
+		if (eventType == "normalized") newValue = (0, __tremolo_ui_functions.rawValue)((0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew) + x, min, max, skew);
+		else newValue = value + x;
 		return (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(newValue, step), min, max);
 	}, [
 		max,
@@ -535,7 +521,7 @@ const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defau
 		readonly,
 		updateValueByEvent
 	]);
-	(0, react.useImperativeHandle)(ref, () => {
+	(0, react.useImperativeHandle)(forwardedRef, () => {
 		return {
 			focus() {
 				elmRef.current?.focus();
@@ -545,11 +531,15 @@ const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defau
 			}
 		};
 	}, []);
-	const center = size / 2;
-	const r1 = -135;
-	const r2 = -135 + Math.min(p, s) * 270;
-	const r3 = -135 + Math.max(p, s) * 270;
-	const r4 = 135;
+	const viewBoxSize = 100;
+	const center = viewBoxSize / 2;
+	const padding = (viewBoxSize - (0, __tremolo_ui_functions.clamp)(thumbSize, 0, 100)) / 2;
+	const p = (0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew);
+	const s = (0, __tremolo_ui_functions.normalizeValue)(startValue, min, max, skew);
+	const r1 = -angleRange / 2;
+	const r2 = r1 + Math.min(p, s) * angleRange;
+	const r3 = r1 + Math.max(p, s) * angleRange;
+	const r4 = angleRange / 2;
 	const x1 = center + center * Math.cos((0, __tremolo_ui_functions.radian)(r1 - 90));
 	const y1 = center + center * Math.sin((0, __tremolo_ui_functions.radian)(r1 - 90));
 	const x2 = center + center * Math.cos((0, __tremolo_ui_functions.radian)(r2 - 90));
@@ -559,12 +549,13 @@ const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defau
 	const x4 = center + center * Math.cos((0, __tremolo_ui_functions.radian)(r4 - 90));
 	const y4 = center + center * Math.sin((0, __tremolo_ui_functions.radian)(r4 - 90));
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
-		className: (0, clsx.default)("tremolo-knob", className),
 		ref: (div) => {
 			elmRef.current = div;
 			wheelRefCallback(div);
 			touchMoveRefCallback(div);
 		},
+		className: (0, clsx.default)("tremolo-knob", className),
+		viewBox: `0 0 ${viewBoxSize} ${viewBoxSize}`,
 		width: size,
 		height: size,
 		tabIndex: 0,
@@ -595,13 +586,6 @@ const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defau
 				stroke: inactiveLine || "currentColor",
 				strokeWidth: lineWeight
 			}),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
-				className: (0, clsx.default)("tremolo-knob-active-line", classes?.activeLine),
-				d: `M ${x2} ${y2} A ${center} ${center} -135 ${r3 - r2 > 180 ? 1 : 0} 1 ${x3}, ${y3}`,
-				fill: "none",
-				stroke: activeLine || "currentColor",
-				strokeWidth: lineWeight
-			}),
 			startValue < max && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
 				className: (0, clsx.default)("tremolo-knob-inactive-line", classes?.inactiveLine),
 				d: `M ${x3} ${y3} A ${center} ${center} -135 ${r4 - r3 > 180 ? 1 : 0} 1 ${x4}, ${y4}`,
@@ -609,12 +593,19 @@ const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defau
 				stroke: inactiveLine || "currentColor",
 				strokeWidth: lineWeight
 			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+				className: (0, clsx.default)("tremolo-knob-active-line", classes?.activeLine),
+				d: `M ${x2} ${y2} A ${center} ${center} -135 ${r3 - r2 > 180 ? 1 : 0} 1 ${x3}, ${y3}`,
+				fill: "none",
+				stroke: activeLine || "currentColor",
+				strokeWidth: lineWeight
+			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
 				className: (0, clsx.default)("tremolo-knob-thumb", classes?.thumb),
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
 					cx: "50%",
 					cy: "50%",
-					r: `${50 - padding}%`,
+					r: `${thumbSize / 2}%`,
 					fill: thumb || "currentColor"
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("line", {
 					className: (0, clsx.default)("tremolo-knob-thumb-line", classes?.thumbLine),
@@ -625,7 +616,7 @@ const Knob = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, defau
 					stroke: thumbLine || "currentColor",
 					strokeWidth: `${thumbLineWeight}%`,
 					style: {
-						transform: `rotate(${-135 + p * 270}deg)`,
+						transform: `rotate(${r1 + p * angleRange}deg)`,
 						transformOrigin: "50% 50%"
 					}
 				})]
@@ -698,8 +689,7 @@ const createNumberInputStore = (initProps) => {
 		valueAsNumber: parseValue(String(initProps?.value || ""), initProps?.units, initProps?.digit).rawValue,
 		increment: () => set((state) => {
 			if (state.readonly) return {};
-			const current = parseValue(state.value, state.units, state.digit).rawValue;
-			let next = current + (state.step ?? 1);
+			let next = parseValue(state.value, state.units, state.digit).rawValue + (state.step ?? 1);
 			if (state.keepWithinRange) next = safeClamp(next, state.min, state.max);
 			const v = parseValue(String(next), state.units, state.digit).formatValue;
 			state?.onChange?.(next, v);
@@ -710,8 +700,7 @@ const createNumberInputStore = (initProps) => {
 		}),
 		decrement: () => set((state) => {
 			if (state.readonly) return {};
-			const current = parseValue(state.value, state.units, state.digit).rawValue;
-			let next = current - (state.step ?? 1);
+			let next = parseValue(state.value, state.units, state.digit).rawValue - (state.step ?? 1);
 			if (state.keepWithinRange) next = safeClamp(next, state.min, state.max);
 			const v = parseValue(String(next), state.units, state.digit).formatValue;
 			state?.onChange?.(next, v);
@@ -756,6 +745,111 @@ function useNumberInputContext(selector) {
 	return (0, zustand.useStore)(store, selector);
 }
 
+//#endregion
+//#region src/hooks/useInterval.ts
+/**
+* @category hooks
+*/
+function useInterval(callback, delay) {
+	const savedCallback = (0, react.useRef)(callback);
+	(0, react.useEffect)(() => {
+		savedCallback.current = callback;
+	}, [callback]);
+	(0, react.useEffect)(() => {
+		if (delay === null) return;
+		const id = setInterval(() => {
+			savedCallback.current();
+		}, delay);
+		return () => {
+			clearInterval(id);
+		};
+	}, [delay]);
+}
+
+//#endregion
+//#region src/hooks/useLongPress.ts
+/**
+* @category hooks
+*/
+function useLongPress(callback, initialDelay = 500, interval = 40) {
+	const [pressed, setPressed] = (0, react.useState)(false);
+	const [delay, setDelay] = (0, react.useState)(initialDelay);
+	useInterval(() => {
+		callback();
+		setDelay(interval);
+	}, pressed ? delay : null);
+	useEventListener(globalThis.window, "pointerup", () => {
+		setPressed(false);
+		setDelay(initialDelay);
+	});
+	return (0, react.useCallback)(() => {
+		callback();
+		setPressed(true);
+	}, [callback]);
+}
+
+//#endregion
+//#region src/components/NumberInput/DecrementStepper.tsx
+/** @category NumberInput */
+function DecrementStepper({ size = 12, children, className,...props }) {
+	const min = useNumberInputContext((s) => s.min);
+	const valueAsNumber = useNumberInputContext((s) => s.valueAsNumber);
+	const readonly = useNumberInputContext((s) => s.readonly);
+	const keepWithinRange = useNumberInputContext((s) => s.keepWithinRange);
+	const press = useLongPress(useNumberInputContext((s) => s.decrement));
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: (0, clsx.default)("tremolo-number-input-decrement-stepper", className),
+		role: "button",
+		tabIndex: -1,
+		"aria-disabled": keepWithinRange && valueAsNumber <= (min ?? Number.MIN_SAFE_INTEGER),
+		"aria-readonly": readonly,
+		onPointerDown: press,
+		...props,
+		children: children || /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+			width: size,
+			height: size,
+			viewBox: "0 0 24 24",
+			fill: "none",
+			stroke: "currentColor",
+			strokeWidth: "2",
+			strokeLinecap: "round",
+			strokeLinejoin: "round",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", { points: "6 9 12 15 18 9" })
+		})
+	});
+}
+
+//#endregion
+//#region src/components/NumberInput/IncrementStepper.tsx
+/** @category NumberInput */
+function IncrementStepper({ size = 12, children, className,...props }) {
+	const max = useNumberInputContext((s) => s.max);
+	const valueAsNumber = useNumberInputContext((s) => s.valueAsNumber);
+	const readonly = useNumberInputContext((s) => s.readonly);
+	const keepWithinRange = useNumberInputContext((s) => s.keepWithinRange);
+	const press = useLongPress(useNumberInputContext((s) => s.increment));
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: (0, clsx.default)("tremolo-number-input-increment-stepper", className),
+		role: "button",
+		tabIndex: -1,
+		"aria-disabled": keepWithinRange && valueAsNumber >= (max ?? Number.MAX_SAFE_INTEGER),
+		"aria-readonly": readonly,
+		onPointerDown: press,
+		...props,
+		children: children || /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+			width: size,
+			height: size,
+			viewBox: "0 0 24 24",
+			fill: "none",
+			stroke: "currentColor",
+			strokeWidth: "2",
+			strokeLinecap: "round",
+			strokeLinejoin: "round",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", { points: "18 15 12 9 6 15" })
+		})
+	});
+}
+
 //#endregion
 //#region src/components/NumberInput/InternalInput.tsx
 const InternalInput = (0, react.forwardRef)(({ disabled, readonly, selectWithFocus, blurOnEnter, clampValueOnBlur, wheel, keyboard, className, onChange, onFocus, onBlur, onKeyDown, children: _children,...props }, ref) => {
@@ -783,8 +877,7 @@ const InternalInput = (0, react.forwardRef)(({ disabled, readonly, selectWithFoc
 		let newValue;
 		if (eventType == "normalized") {
 			if (!min || !max) throw new Error("required parameter: min, max");
-			const n = (0, __tremolo_ui_functions.normalizeValue)(valueAsNumber, min, max);
-			newValue = (0, __tremolo_ui_functions.rawValue)(n + x, min, max);
+			newValue = (0, __tremolo_ui_functions.rawValue)((0, __tremolo_ui_functions.normalizeValue)(valueAsNumber, min, max) + x, min, max);
 			return (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(newValue, step), min, max);
 		} else {
 			newValue = valueAsNumber + x;
@@ -898,114 +991,9 @@ function Stepper({ dynamic = true, children, className,...props }) {
 	});
 }
 
-//#endregion
-//#region src/hooks/useInterval.ts
-function useInterval(callback, delay) {
-	const savedCallback = (0, react.useRef)(callback);
-	(0, react.useEffect)(() => {
-		savedCallback.current = callback;
-	}, [callback]);
-	(0, react.useEffect)(() => {
-		if (delay === null) return;
-		const id = setInterval(() => {
-			savedCallback.current();
-		}, delay);
-		return () => {
-			clearInterval(id);
-		};
-	}, [delay]);
-}
-
-//#endregion
-//#region src/hooks/useLongPress.ts
-function useLongPress(callback, initialDelay = 500, interval = 40) {
-	const [pressed, setPressed] = (0, react.useState)(false);
-	const [delay, setDelay] = (0, react.useState)(initialDelay);
-	useInterval(() => {
-		callback();
-		setDelay(interval);
-	}, pressed ? delay : null);
-	useEventListener(globalThis.window, "pointerup", () => {
-		setPressed(false);
-		setDelay(initialDelay);
-	});
-	return (0, react.useCallback)(() => {
-		callback();
-		setPressed(true);
-	}, [callback]);
-}
-
-//#endregion
-//#region src/components/NumberInput/IncrementStepper.tsx
-/** @category NumberInput */
-function IncrementStepper({ size = 12, children, className,...props }) {
-	const max = useNumberInputContext((s) => s.max);
-	const valueAsNumber = useNumberInputContext((s) => s.valueAsNumber);
-	const readonly = useNumberInputContext((s) => s.readonly);
-	const keepWithinRange = useNumberInputContext((s) => s.keepWithinRange);
-	const increment = useNumberInputContext((s) => s.increment);
-	const press = useLongPress(increment);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		className: (0, clsx.default)("tremolo-number-input-increment-stepper", className),
-		role: "button",
-		tabIndex: -1,
-		"aria-disabled": keepWithinRange && valueAsNumber >= (max ?? Number.MAX_SAFE_INTEGER),
-		"aria-readonly": readonly,
-		onPointerDown: press,
-		...props,
-		children: children || /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
-			width: size,
-			height: size,
-			viewBox: "0 0 24 24",
-			fill: "none",
-			stroke: "currentColor",
-			strokeWidth: "2",
-			strokeLinecap: "round",
-			strokeLinejoin: "round",
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", { points: "18 15 12 9 6 15" })
-		})
-	});
-}
-
-//#endregion
-//#region src/components/NumberInput/DecrementStepper.tsx
-/** @category NumberInput */
-function DecrementStepper({ size = 12, children, className,...props }) {
-	const min = useNumberInputContext((s) => s.min);
-	const valueAsNumber = useNumberInputContext((s) => s.valueAsNumber);
-	const readonly = useNumberInputContext((s) => s.readonly);
-	const keepWithinRange = useNumberInputContext((s) => s.keepWithinRange);
-	const decrement = useNumberInputContext((s) => s.decrement);
-	const press = useLongPress(decrement);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		className: (0, clsx.default)("tremolo-number-input-decrement-stepper", className),
-		role: "button",
-		tabIndex: -1,
-		"aria-disabled": keepWithinRange && valueAsNumber <= (min ?? Number.MIN_SAFE_INTEGER),
-		"aria-readonly": readonly,
-		onPointerDown: press,
-		...props,
-		children: children || /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
-			width: size,
-			height: size,
-			viewBox: "0 0 24 24",
-			fill: "none",
-			stroke: "currentColor",
-			strokeWidth: "2",
-			strokeLinecap: "round",
-			strokeLinejoin: "round",
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", { points: "6 9 12 15 18 9" })
-		})
-	});
-}
-
 //#endregion
 //#region src/components/NumberInput/index.tsx
-/**
-* Input with some useful functions for entering numerical values.
-* @category NumberInput
-*/
-const NumberInput = (0, react.forwardRef)(({ value, min, max, step = 1, units, readonly = false, disabled = false, digit, variant = "outline", selectWithFocus = "none", blurOnEnter = true, keepWithinRange = true, clampValueOnBlur = true, wheel = ["raw", 1], keyboard = ["raw", 1], activeColor, wrapperClassName, className, onChange, onFocus, onBlur, children,...props }, ref) => {
+const NumberInputImpl = (0, react.forwardRef)(({ value, min, max, step = 1, units, readonly = false, disabled = false, digit, variant = "outline", selectWithFocus = "none", blurOnEnter = true, keepWithinRange = true, clampValueOnBlur = true, wheel = ["raw", 1], keyboard = ["raw", 1], activeColor, wrapperClassName, className, onChange, onFocus, onBlur, children,...props }, forwardedRef) => {
 	const colors = { "--active-color": activeColor };
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NumberInputProvider, {
 		value: String(value),
@@ -1024,7 +1012,7 @@ const NumberInput = (0, react.forwardRef)(({ value, min, max, step = 1, units, r
 			"data-stepper": !!children,
 			"data-variant": variant,
 			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(InternalInput, {
-				ref,
+				ref: forwardedRef,
 				readonly,
 				disabled,
 				selectWithFocus,
@@ -1041,10 +1029,20 @@ const NumberInput = (0, react.forwardRef)(({ value, min, max, step = 1, units, r
 		})
 	});
 });
+/**
+* Input with some useful functions for entering numerical values.
+* @category NumberInput
+*/
+const NumberInput = Object.assign(NumberInputImpl, {
+	Stepper,
+	IncrementStepper,
+	DecrementStepper
+});
 
 //#endregion
 //#region src/hooks/useDragWithElement.ts
 /**
+* @category hooks
 * @returns [refCallback, pointerDownHandler]
 */
 function useDragWithElement({ baseElementRef, onDrag, onDragStart, onDragEnd }) {
@@ -1124,9 +1122,7 @@ function usePianoContext(selector) {
 //#region src/components/Piano/KeyLabel.tsx
 /** @category Piano */
 function KeyLabel({ label, className, wrapperClassName, wrapperStyle, __note, __label,...props }) {
-	const noteRange = usePianoContext((s) => s.noteRange);
-	const noteRangeArray = getNoteRangeArray(noteRange);
-	const index = noteRangeArray.indexOf(__note);
+	const index = getNoteRangeArray(usePianoContext((s) => s.noteRange)).indexOf(__note);
 	const content = label ? label(__note, index) : __label && __label(__note, index);
 	return (content != void 0 || content != null) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		className: (0, clsx.default)("tremolo-piano-key-label-wrapper", wrapperClassName),
@@ -1152,8 +1148,7 @@ const KeyImpl = (0, react.forwardRef)(({ keyType, noteNumber, width, height, bg,
 	const onPlayNote = usePianoContext((s) => s.onPlayNote);
 	const onStopNote = usePianoContext((s) => s.onStopNote);
 	const label = usePianoContext((s) => s.label);
-	const notePosition = usePianoContext((s) => s.notePosition);
-	const position = notePosition(noteNumber);
+	const position = usePianoContext((s) => s.notePosition)(noteNumber);
 	const disabled = noteNumber > midiMax;
 	const colors = {
 		"--bg": bg,
@@ -1163,10 +1158,10 @@ const KeyImpl = (0, react.forwardRef)(({ keyType, noteNumber, width, height, bg,
 	};
 	(0, react.useImperativeHandle)(ref, () => {
 		return {
-			play() {
+			play(velocity) {
 				if (disabled) return;
 				setPlayed(true);
-				if (onPlayNote) onPlayNote(noteNumber);
+				if (onPlayNote) onPlayNote(noteNumber, velocity);
 			},
 			stop() {
 				setPlayed(false);
@@ -1257,21 +1252,14 @@ const SHORTCUTS = { HOME_ROW: { keys: [
 //#endregion
 //#region src/components/Piano/index.tsx
 /**
-* Piano component
-*
-* TODO:
-* - add scale highlight
+* [noteRange.first, noteRange.first + 1 ..., noteRange.last]
+* @category Piano
 */
-/** @category Piano */
 function getNoteRangeArray(noteRange) {
 	return Array.from({ length: noteRange.last - noteRange.first + 1 }, (_, i) => i + noteRange.first);
 }
 const blackPerWhiteWidth = defaultBlackKeyWidth / defaultWhiteKeyWidth;
-/**
-* Customizable piano component.
-* @category Piano
-*/
-function Piano({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts, fill = false, height = fill ? "100%" : 160, whiteNoteWidth: _whiteNoteWidth = defaultWhiteKeyWidth, style, className, onPlayNote, onStopNote, label, children, onPointerDown,...props }) {
+const PianoImpl = (0, react.forwardRef)(({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts, fill = false, height = fill ? "100%" : 160, whiteNoteWidth: _whiteNoteWidth = defaultWhiteKeyWidth, style, className, onPlayNote, onStopNote, label, children, onPointerDown,...props }, forwardedRef) => {
 	const [whiteNoteWidth, setWhiteNoteWidth] = (0, react.useState)(_whiteNoteWidth);
 	const keyRefs = (0, react.useRef)([]);
 	for (let i = 0; i < noteRange.last - noteRange.first + 1; i++) keyRefs.current[i] = (0, react.createRef)();
@@ -1342,9 +1330,7 @@ function Piano({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts,
 	]);
 	const onDrag = (0, react.useCallback)((perX, perY) => {
 		if (!pianoRef.current) return;
-		const x = perX * staticWidth;
-		const y = perY * pianoRef.current.clientHeight;
-		const note = getHitKeyIndex(x, y);
+		const note = getHitKeyIndex(perX * staticWidth, perY * pianoRef.current.clientHeight);
 		const index = noteRangeArray.indexOf(note);
 		if (index == -1) return;
 		if (hitKeyIndex.current != index) {
@@ -1398,6 +1384,25 @@ function Piano({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts,
 		const index = keyboardShortcuts.keys.indexOf(e.key);
 		if (index != -1) keyRefs.current[index]?.current?.stop();
 	});
+	(0, react.useImperativeHandle)(forwardedRef, () => {
+		return {
+			playNote(note, velocity) {
+				const index = noteRangeArray.indexOf(note);
+				if (index != -1) {
+					if (!keyRefs.current[index]?.current?.played()) keyRefs.current[index]?.current?.play(velocity);
+				} else onPlayNote?.(note, velocity);
+			},
+			stopNote(note) {
+				const index = noteRangeArray.indexOf(note);
+				if (index != -1) keyRefs.current[index]?.current?.stop();
+				else onStopNote?.(note);
+			}
+		};
+	}, [
+		noteRangeArray,
+		onPlayNote,
+		onStopNote
+	]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PianoProvider, {
 		notePosition,
 		noteRange,
@@ -1434,7 +1439,16 @@ function Piano({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts,
 			}, note))
 		})
 	});
-}
+});
+/**
+* Customizable piano component.
+* @category Piano
+*/
+const Piano = Object.assign(PianoImpl, {
+	WhiteKey,
+	BlackKey,
+	KeyLabel
+});
 
 //#endregion
 //#region src/components/Slider/context.tsx
@@ -1571,7 +1585,7 @@ function Scale({ gap = 6, options, children, className, style,...props }) {
 /** @category Slider */
 const defaultThumbSize = 22;
 /** @category Slider */
-const SliderThumb = (0, react.forwardRef)(({ size, width = defaultThumbSize, height = defaultThumbSize, color, children, className, style, __percent }, ref) => {
+const Thumb$1 = (0, react.forwardRef)(({ size, width = defaultThumbSize, height = defaultThumbSize, color, children, className, style, __percent }, ref) => {
 	const wrapperRef = (0, react.useRef)(null);
 	const vertical = useSliderContext((s) => s.vertical);
 	const disabled = useSliderContext((s) => s.disabled);
@@ -1613,7 +1627,7 @@ const SliderThumb = (0, react.forwardRef)(({ size, width = defaultThumbSize, hei
 const defaultLength = 140;
 const defaultThickness = 10;
 /** @category Slider */
-function SliderTrack({ length = defaultLength, thickness = defaultThickness, active, inactive, children, className, style, defaultStyle = true, __thumb, __percent = 0,...props }) {
+function Track({ length = defaultLength, thickness = defaultThickness, active, inactive, children, className, style, defaultStyle = true, __thumb, __percent = 0,...props }) {
 	const vertical = useSliderContext((s) => s.vertical);
 	const reverse = useSliderContext((s) => s.reverse);
 	const disabled = useSliderContext((s) => s.disabled);
@@ -1628,7 +1642,7 @@ function SliderTrack({ length = defaultLength, thickness = defaultThickness, act
 		"data-vertical": vertical,
 		style: !defaultStyle ? style : {
 			...colors,
-			background: (0, __tremolo_ui_functions.xor)(vertical, reverse) ? `linear-gradient(to ${direction}, var(--inactive, #eee) ${__percent}%, var(--active, #7998ec) ${__percent}%)` : `linear-gradient(to ${direction}, var(--active, #7998ec) ${__percent}%, var(--inactive, #eee) ${__percent}%)`,
+			background: (0, __tremolo_ui_functions.xor)(vertical, reverse) ? `linear-gradient(to ${direction}, var(--inactive) ${__percent}%, var(--active) ${__percent}%)` : `linear-gradient(to ${direction}, var(--active) ${__percent}%, var(--inactive) ${__percent}%)`,
 			borderRadius: (0, __tremolo_ui_functions.styleHelper)(thickness, "/", 2),
 			width: !vertical ? length : thickness,
 			height: vertical ? length : thickness,
@@ -1641,11 +1655,7 @@ function SliderTrack({ length = defaultLength, thickness = defaultThickness, act
 
 //#endregion
 //#region src/components/Slider/index.tsx
-/**
-* Customizable slider
-* @category Slider
-*/
-const Slider = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, vertical = false, reverse = false, bodyNoSelect = true, wheel = ["raw", 1], keyboard = ["raw", 1], disabled = false, readonly = false, onChange, onDragStart, onDragEnd, className, style, children, onFocus, onBlur, onPointerDown, onKeyDown,...props }, ref) => {
+const SliderImpl = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, vertical = false, reverse = false, bodyNoSelect = true, wheel = ["raw", 1], keyboard = ["raw", 1], disabled = false, readonly = false, onChange, onDragStart, onDragEnd, className, style, children, onFocus, onBlur, onPointerDown, onKeyDown,...props }, forwardedRef) => {
 	const trackElementRef = (0, react.useRef)(null);
 	const thumbRef = (0, react.useRef)(null);
 	const p = (0, __tremolo_ui_functions.toFixed)((0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew) * 100);
@@ -1656,8 +1666,8 @@ const Slider = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, ver
 	let thumbProps = {};
 	let scaleComponent = void 0;
 	if (children != void 0) react.default.Children.forEach(children, (child) => {
-		if (react.default.isValidElement(child)) if (child.type == SliderThumb) thumbProps = child.props;
-		else if (child.type == SliderTrack) trackProps = child.props;
+		if (react.default.isValidElement(child)) if (child.type == Thumb$1) thumbProps = child.props;
+		else if (child.type == Track) trackProps = child.props;
 		else if (child.type == Scale) scaleComponent = child;
 		else throw new Error("only <SliderThumb> or <SliderTrack>");
 		else throw new Error("children is an invalid element.");
@@ -1665,9 +1675,7 @@ const Slider = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, ver
 	const onDrag = (0, react.useCallback)((nx, ny) => {
 		if (!onChange || readonly) return;
 		const n = vertical ? ny : nx;
-		const v = (0, __tremolo_ui_functions.rawValue)(displayReversed ? 1 - n : n, min, max, skew);
-		const v2 = (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(v, step), min, max);
-		onChange(v2);
+		onChange((0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)((0, __tremolo_ui_functions.rawValue)(displayReversed ? 1 - n : n, min, max, skew), step), min, max));
 	}, [
 		displayReversed,
 		max,
@@ -1680,10 +1688,8 @@ const Slider = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, ver
 	]);
 	const updateValueByEvent = (0, react.useCallback)((eventType, x) => {
 		let newValue;
-		if (eventType == "normalized") {
-			const n = (0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew);
-			newValue = (0, __tremolo_ui_functions.rawValue)(n + x, min, max, skew);
-		} else newValue = value + x;
+		if (eventType == "normalized") newValue = (0, __tremolo_ui_functions.rawValue)((0, __tremolo_ui_functions.normalizeValue)(value, min, max, skew) + x, min, max, skew);
+		else newValue = value + x;
 		return (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(newValue, step), min, max);
 	}, [
 		max,
@@ -1746,7 +1752,7 @@ const Slider = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, ver
 		onChange,
 		updateValueByEvent
 	]);
-	(0, react.useImperativeHandle)(ref, () => {
+	(0, react.useImperativeHandle)(forwardedRef, () => {
 		return {
 			focus() {
 				thumbRef.current?.focus();
@@ -1810,9 +1816,9 @@ const Slider = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, ver
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 					className: "tremolo-slider-track-wrapper",
 					ref: trackElementRef,
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SliderTrack, {
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Track, {
 						__percent: percent,
-						__thumb: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SliderThumb, {
+						__thumb: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Thumb$1, {
 							ref: thumbRef,
 							__percent: percent,
 							...thumbProps
@@ -1824,17 +1830,26 @@ const Slider = (0, react.forwardRef)(({ value, min, max, step = 1, skew = 1, ver
 		})
 	});
 });
+/**
+* Customizable slider
+* @category Slider
+*/
+const Slider = Object.assign(SliderImpl, {
+	Thumb: Thumb$1,
+	Track,
+	Scale,
+	ScaleOption
+});
 
 //#endregion
 //#region src/components/WheelObserver/index.tsx
 /** @category WheelObserver */
 function WheelObserver(props) {
 	const { children, onWheel, as: Component = "div",...attributes } = props;
-	const wheelRefCallback = useRefCallbackEvent("wheel", (event) => {
-		if (onWheel) onWheel(event);
-	}, { passive: false }, [onWheel]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Component, {
-		ref: wheelRefCallback,
+		ref: useRefCallbackEvent("wheel", (event) => {
+			if (onWheel) onWheel(event);
+		}, { passive: false }, [onWheel]),
 		...attributes,
 		children
 	});
@@ -1843,7 +1858,7 @@ function WheelObserver(props) {
 //#endregion
 //#region src/components/XYPad/Area.tsx
 /** @category XYPad */
-function XYPadArea({ width = 120, height = 120, color, children, className, style, __thumb,...props }) {
+function Area({ width = 120, height = 120, color, children, className, style, __thumb,...props }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: (0, clsx.default)("tremolo-xy-pad-area", className),
 		style: {
@@ -1860,7 +1875,7 @@ function XYPadArea({ width = 120, height = 120, color, children, className, styl
 //#endregion
 //#region src/components/XYPad/Thumb.tsx
 /** @category XYPad */
-const XYPadThumb = (0, react.forwardRef)(({ size, width = 22, height = 22, color, children, wrapperClassName, wrapperStyle, className, style, __disabled, __css,...props }, ref) => {
+const Thumb = (0, react.forwardRef)(({ size, width = 22, height = 22, color, children, wrapperClassName, wrapperStyle, className, style, __disabled, __readonly, __css,...props }, ref) => {
 	const wrapperRef = (0, react.useRef)(null);
 	(0, react.useImperativeHandle)(ref, () => {
 		return {
@@ -1884,6 +1899,7 @@ const XYPadThumb = (0, react.forwardRef)(({ size, width = 22, height = 22, color
 			className: (0, clsx.default)("tremolo-xy-pad-thumb", className),
 			tabIndex: 0,
 			"aria-disabled": __disabled,
+			"aria-readonly": __readonly,
 			style: {
 				"--color": color,
 				width: size ?? width,
@@ -1903,11 +1919,7 @@ const defaultValueOptions = {
 	wheel: ["raw", 1],
 	keyboard: ["raw", 1]
 };
-/**
-* Simple XYPad
-* @category XYPad
-*/
-const XYPad = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSelect = true, disabled = false, readonly = false, onChange, onDragStart, onDragEnd, onPointerDown, onKeyDown, onFocus, onBlur, children,...props }, ref) => {
+const XYPadImpl = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSelect = true, disabled = false, readonly = false, onChange, onDragStart, onDragEnd, onPointerDown, onKeyDown, onFocus, onBlur, children,...props }, forwardedRef) => {
 	const x = (0, react.useMemo)(() => {
 		return {
 			...defaultValueOptions,
@@ -1929,8 +1941,8 @@ const XYPad = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSel
 	let areaProps = {};
 	let thumbProps = {};
 	if (children != void 0) react.default.Children.forEach(children, (child) => {
-		if (react.default.isValidElement(child)) if (child.type == XYPadThumb) thumbProps = child.props;
-		else if (child.type == XYPadArea) areaProps = child.props;
+		if (react.default.isValidElement(child)) if (child.type == Thumb) thumbProps = child.props;
+		else if (child.type == Area) areaProps = child.props;
 		else throw new Error("only <XYPadThumb> or <XYPadArea>");
 		else throw new Error("children is an invalid element.");
 	});
@@ -1938,9 +1950,7 @@ const XYPad = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSel
 		if (!onChange || readonly) return;
 		const vx = (0, __tremolo_ui_functions.rawValue)(x.reverse ? 1 - nx$1 : nx$1, x.min, x.max, x.skew);
 		const vy = (0, __tremolo_ui_functions.rawValue)(y.reverse ? 1 - ny$1 : ny$1, y.min, y.max, y.skew);
-		const newX = (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(vx, x.step), x.min, x.max);
-		const newY = (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(vy, y.step), y.min, y.max);
-		onChange(newX, newY);
+		onChange((0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(vx, x.step), x.min, x.max), (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(vy, y.step), y.min, y.max));
 	}, [
 		onChange,
 		readonly,
@@ -1957,10 +1967,8 @@ const XYPad = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSel
 	]);
 	const updateValueByEvent = (0, react.useCallback)((eventType, target, x$1) => {
 		let v;
-		if (eventType == "normalized") {
-			const n = (0, __tremolo_ui_functions.normalizeValue)(target.value, target.min, target.max, target.skew);
-			v = (0, __tremolo_ui_functions.rawValue)(n + x$1, target.min, target.max, target.skew);
-		} else v = target.value + x$1;
+		if (eventType == "normalized") v = (0, __tremolo_ui_functions.rawValue)((0, __tremolo_ui_functions.normalizeValue)(target.value, target.min, target.max, target.skew) + x$1, target.min, target.max, target.skew);
+		else v = target.value + x$1;
 		return (0, __tremolo_ui_functions.clamp)((0, __tremolo_ui_functions.stepValue)(v, target.step), target.min, target.max);
 	}, []);
 	const handleKeyDown = (0, react.useCallback)((event) => {
@@ -2027,7 +2035,7 @@ const XYPad = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSel
 		readonly,
 		updateValueByEvent
 	]);
-	(0, react.useImperativeHandle)(ref, () => {
+	(0, react.useImperativeHandle)(forwardedRef, () => {
 		return {
 			focus() {
 				thumbRef.current?.focus();
@@ -2072,10 +2080,11 @@ const XYPad = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSel
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			className: "tremolo-xy-pad-area-wrapper",
 			ref: areaElementRef,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(XYPadArea, {
-				__thumb: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(XYPadThumb, {
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Area, {
+				__thumb: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Thumb, {
 					ref: thumbRef,
 					__disabled: disabled,
+					__readonly: readonly,
 					__css: {
 						top: `${percentY}%`,
 						left: `${percentX}%`
@@ -2087,9 +2096,20 @@ const XYPad = (0, react.forwardRef)(({ x: _x, y: _y, className, style, bodyNoSel
 		})
 	});
 });
+/**
+* Simple XYPad
+* @category XYPad
+*/
+const XYPad = Object.assign(XYPadImpl, {
+	Thumb,
+	Area
+});
 
 //#endregion
 //#region src/hooks/useAnimationFrame.ts
+/**
+* @category hooks
+*/
 function useAnimationFrame(callback = () => {}, deps = []) {
 	const reqIdRef = (0, react.useRef)(-1);
 	const loop = (0, react.useCallback)(() => {
@@ -2102,29 +2122,92 @@ function useAnimationFrame(callback = () => {}, deps = []) {
 	}, [loop]);
 }
 
+//#endregion
+//#region src/hooks/useMIDIAccess.ts
+/** @private */
+const PERMISSION_DENIED = "PERMISSION_DENIED";
+/** @private */
+const NOT_SUPPORTED = "NOT_SUPPORTED";
+/**
+* Hooks for requesting MIDI access in the browser. The first argument allows you to choose whether to request access on mount.
+* @category hooks
+*/
+function useMIDIAccess(requestOnMount = true) {
+	const [midiAccess, setMidiAccess] = (0, react.useState)(null);
+	const [error, setError] = (0, react.useState)(null);
+	const request = (0, react.useCallback)(() => {
+		if (navigator.requestMIDIAccess) navigator.requestMIDIAccess().then((access) => {
+			setMidiAccess(access);
+			setError(null);
+		}).catch(() => {
+			setError(PERMISSION_DENIED);
+		});
+		else setError(NOT_SUPPORTED);
+	}, []);
+	(0, react.useEffect)(() => {
+		if (requestOnMount) request();
+	}, [requestOnMount, request]);
+	return {
+		request,
+		midiAccess,
+		error
+	};
+}
+
+//#endregion
+//#region src/hooks/useMIDIMessage.ts
+/**
+* Hooks for when you want to process MIDI events in more detail than useMIDIInput.
+* @category hooks
+*/
+function useMIDIMessage(midiAccess, onMIDIMessage) {
+	(0, react.useEffect)(() => {
+		if (!midiAccess) return;
+		for (const input of midiAccess.inputs.values()) input.addEventListener("midimessage", onMIDIMessage);
+		return () => {
+			for (const input of midiAccess.inputs.values()) input.removeEventListener("midimessage", onMIDIMessage);
+		};
+	}, [midiAccess, onMIDIMessage]);
+}
+
+//#endregion
+//#region src/hooks/useMIDIInput.ts
+const MIDI_EVENT_TO_NUMBER = {
+	NOTE_ON: 144,
+	NOTE_OFF: 128,
+	PITCH_BEND: 224
+};
+/**
+* Hooks for handling note on/off events. To be used with useMIDIAccess. Internally uses useMIDIMessage.
+* @category hooks
+*/
+function useMIDIInput(midiAccess, onNoteOnEvent, onNoteOffEvent, onPitchBendEvent) {
+	useMIDIMessage(midiAccess, (0, react.useCallback)((event) => {
+		if (!event.data) return;
+		const kind = event.data[0] & 240;
+		if (kind == MIDI_EVENT_TO_NUMBER.NOTE_OFF || kind == MIDI_EVENT_TO_NUMBER.NOTE_ON && event.data[2] == 0) onNoteOffEvent?.(event.data[1]);
+		else if (kind == MIDI_EVENT_TO_NUMBER.NOTE_ON) onNoteOnEvent?.(event.data[1], event.data[2]);
+		else if (kind == MIDI_EVENT_TO_NUMBER.PITCH_BEND) onPitchBendEvent?.(event.data[1], event.data[2]);
+	}, [
+		onNoteOffEvent,
+		onNoteOnEvent,
+		onPitchBendEvent
+	]));
+}
+
 //#endregion
 exports.AnimationCanvas = AnimationCanvas;
 exports.AnimationKnob = AnimationKnob;
-exports.BlackKey = BlackKey;
-exports.DecrementStepper = DecrementStepper;
 exports.DragObserver = DragObserver;
-exports.IncrementStepper = IncrementStepper;
-exports.KeyLabel = KeyLabel;
 exports.Knob = Knob;
+exports.NOT_SUPPORTED = NOT_SUPPORTED;
 exports.NumberInput = NumberInput;
+exports.PERMISSION_DENIED = PERMISSION_DENIED;
 exports.Piano = Piano;
 exports.SHORTCUTS = SHORTCUTS;
-exports.Scale = Scale;
-exports.ScaleOption = ScaleOption;
 exports.Slider = Slider;
-exports.SliderThumb = SliderThumb;
-exports.SliderTrack = SliderTrack;
-exports.Stepper = Stepper;
 exports.WheelObserver = WheelObserver;
-exports.WhiteKey = WhiteKey;
 exports.XYPad = XYPad;
-exports.XYPadArea = XYPadArea;
-exports.XYPadThumb = XYPadThumb;
 exports.getNoteRangeArray = getNoteRangeArray;
 exports.useAnimationFrame = useAnimationFrame;
 exports.useDrag = useDrag;
@@ -2132,5 +2215,8 @@ exports.useDragWithElement = useDragWithElement;
 exports.useEventListener = useEventListener;
 exports.useInterval = useInterval;
 exports.useLongPress = useLongPress;
+exports.useMIDIAccess = useMIDIAccess;
+exports.useMIDIInput = useMIDIInput;
+exports.useMIDIMessage = useMIDIMessage;
 exports.useSliderContext = useSliderContext;
 //# sourceMappingURL=index.cjs.map