@tremolo-ui/react 0.1.4 → 0.1.6

package/dist/index.js

@@ -1,10 +1,8 @@
 import clsx from "clsx";
 import React, { createContext, createRef, forwardRef, useCallback, useContext, useEffect, useImperativeHandle, useInsertionEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { clamp, isBlackKey, isWhiteKey, normalizeValue, noteKey, noteKeys, radian, rawValue, stepValue, styleHelper, toFixed, xor } from "@tremolo-ui/functions";
+import { clamp, decimalPart, isBlackKey, isWhiteKey, normalizeValue, noteKey, noteKeys, radian, rawValue, stepValue, styleHelper, toFixed, xor } from "@tremolo-ui/functions";
 import { createStore, useStore } from "zustand";
-import { parseValue } from "@tremolo-ui/functions/NumberInput";
-import { generateOptionsList } from "@tremolo-ui/functions/Slider";
 
 //#region src/components/AnimationCanvas/canvas.ts
 const drawingState = [
@@ -27,9 +25,6 @@ const drawingState = [
 	"direction",
 	"imageSmoothingEnabled"
 ];
-
-//#endregion
-//#region src/components/AnimationCanvas/index.tsx
 function setDprConfig(canvas, context, width, height, dpr) {
 	canvas.width = width * dpr;
 	canvas.height = height * dpr;
@@ -38,7 +33,10 @@ function setDprConfig(canvas, context, width, height, dpr) {
 	canvas.style.width = `${width}px`;
 	canvas.style.height = `${height}px`;
 }
-function AnimationCanvas({ options, init, draw, width = 100, height = 100, relativeSize, reduceFlickering = true, className, onContextMenu = (event) => event.preventDefault(),...props }) {
+
+//#endregion
+//#region src/components/AnimationCanvas/index.tsx
+function AnimationCanvas({ draw, init, animate = true, options, width: _width = 100, height: _height = 100, relativeSize, reduceFlickering = true, className, onContextMenu = (event) => event.preventDefault(),...props }) {
 	const canvasRef = useRef(null);
 	const memoCanvasRef = useRef(null);
 	const reqIdRef = useRef(-1);
@@ -46,27 +44,40 @@ function AnimationCanvas({ options, init, draw, width = 100, height = 100, relat
 	const heightRef = useRef(0);
 	const deltaMemoRef = useRef(-1);
 	const startTimeRef = useRef(-1);
-	const loop = useCallback((context, width$1, height$1, count) => {
+	const loop = useCallback((context, width, height, count) => {
 		const now = performance.now();
 		const deltaTime = now - deltaMemoRef.current;
 		const elapsedTime = now - startTimeRef.current;
 		deltaMemoRef.current = now;
-		reqIdRef.current = requestAnimationFrame(() => loop(context, width$1, height$1, count + 1));
+		if (animate) reqIdRef.current = requestAnimationFrame(() => loop(context, width, height, count + 1));
 		draw(context, {
-			width: width$1.current,
-			height: height$1.current,
+			width: width.current,
+			height: height.current,
 			count: count + 1,
 			deltaTime,
 			elapsedTime,
 			fps: 1e3 / deltaTime
 		});
-	}, [draw]);
+	}, [draw, animate]);
 	useEffect(() => {
 		if (!canvasRef.current) return;
 		const canvas = canvasRef.current;
 		const context = canvas.getContext("2d", options);
 		if (!context) throw new Error("Cannot get canvas context.");
 		const dpr = globalThis.devicePixelRatio;
+		const firstRendering = (width, height) => {
+			setDprConfig(canvas, context, width, height, dpr);
+			widthRef.current = width;
+			heightRef.current = height;
+			if (init) init(context, {
+				width,
+				height
+			});
+			const now = performance.now();
+			deltaMemoRef.current = now;
+			startTimeRef.current = now;
+			loop(context, widthRef, heightRef, -1);
+		};
 		if (relativeSize) {
 			const parent = canvas.parentElement;
 			if (!parent) throw new Error("Canvas doesn't have a parent element.");
@@ -74,52 +85,37 @@ function AnimationCanvas({ options, init, draw, width = 100, height = 100, relat
 			const memoContext = memoCanvas?.getContext("2d", options);
 			const ro = new ResizeObserver((entries) => {
 				for (const entry of entries) {
+					const w = entry.contentRect.width;
+					const h = entry.contentRect.height;
 					const contextMemo = {};
-					for (const prop of drawingState) contextMemo[prop] = context[prop];
-					const w$1 = entry.contentRect.width;
-					const h$1 = entry.contentRect.height;
 					if (reduceFlickering && memoCanvas && memoContext) {
-						memoCanvas.width = w$1 * dpr;
-						memoCanvas.height = h$1 * dpr;
+						for (const prop of drawingState) contextMemo[prop] = context[prop];
+						memoCanvas.width = w * dpr;
+						memoCanvas.height = h * dpr;
 						memoContext.scale(1 / dpr, 1 / dpr);
 						if (canvas.width > 0 && canvas.height > 0) memoContext.drawImage(canvas, 0, 0);
 					}
-					setDprConfig(canvas, context, w$1, h$1, dpr);
-					widthRef.current = w$1;
-					heightRef.current = h$1;
-					for (const prop of drawingState) context[prop] = contextMemo[prop];
-					if (reduceFlickering && memoContext && memoCanvas && memoCanvas.width > 0 && memoCanvas.height > 0) context.drawImage(memoContext.canvas, 0, 0);
+					setDprConfig(canvas, context, w, h, dpr);
+					widthRef.current = w;
+					heightRef.current = h;
+					if (reduceFlickering && memoContext && memoCanvas && memoCanvas.width > 0 && memoCanvas.height > 0) {
+						for (const prop of drawingState) context[prop] = contextMemo[prop];
+						context.drawImage(memoContext.canvas, 0, 0);
+					}
+					if (!animate) loop(context, widthRef, heightRef, -1);
 				}
 			});
 			ro.observe(parent);
-			const w = parent.clientWidth;
-			const h = parent.clientHeight;
-			setDprConfig(canvas, context, w, h, dpr);
-			if (init) init(context, {
-				width: widthRef.current,
-				height: heightRef.current
-			});
-			const now = performance.now();
-			deltaMemoRef.current = now;
-			startTimeRef.current = now;
-			loop(context, widthRef, heightRef, -1);
+			const width = parent.clientWidth;
+			const height = parent.clientHeight;
+			firstRendering(width, height);
 			return () => {
 				if (reqIdRef.current) cancelAnimationFrame(reqIdRef.current);
 				ro.disconnect();
 			};
 		} else {
-			const rect = canvas.getBoundingClientRect();
-			setDprConfig(canvas, context, rect.width, rect.height, dpr);
-			widthRef.current = rect.width;
-			heightRef.current = rect.height;
-			if (init) init(context, {
-				width: widthRef.current,
-				height: heightRef.current
-			});
-			const now = performance.now();
-			deltaMemoRef.current = now;
-			startTimeRef.current = now;
-			loop(context, widthRef, heightRef, -1);
+			const { width, height } = canvas.getBoundingClientRect();
+			firstRendering(width, height);
 			return () => {
 				if (reqIdRef.current) cancelAnimationFrame(reqIdRef.current);
 			};
@@ -129,12 +125,13 @@ function AnimationCanvas({ options, init, draw, width = 100, height = 100, relat
 		init,
 		options,
 		reduceFlickering,
-		relativeSize
+		relativeSize,
+		animate
 	]);
 	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("canvas", {
 		className: clsx("tremolo-animation-canvas", className),
-		width: relativeSize ? 0 : width,
-		height: relativeSize ? 0 : height,
+		width: relativeSize ? 0 : _width,
+		height: relativeSize ? 0 : _height,
 		ref: canvasRef,
 		onContextMenu,
 		...props
@@ -147,8 +144,8 @@ function AnimationCanvas({ options, init, draw, width = 100, height = 100, relat
 //#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 = useRef(() => {
@@ -179,8 +176,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);
 	};
 }
 
@@ -205,6 +201,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 }) {
@@ -271,9 +268,7 @@ const AnimationKnob = forwardRef(({ value, min, max, defaultValue = min, startVa
 	const isRelativeSize = typeof (size ?? width) == "string" || typeof height == "string";
 	const onDrag = useCallback((_x, y) => {
 		if (!onChange) return;
-		const v = rawValue(valueRef.current - y / 100, min, max, skew);
-		const v2 = clamp(stepValue(v, step), min, max);
-		onChange(v2);
+		onChange(clamp(stepValue(rawValue(valueRef.current - y / 100, min, max, skew), step), min, max));
 	}, [
 		max,
 		min,
@@ -293,10 +288,8 @@ const AnimationKnob = forwardRef(({ value, min, max, defaultValue = min, startVa
 			event.preventDefault();
 			const x = key == "ArrowRight" || key == "ArrowUp" ? keyboard[1] : -keyboard[1];
 			let v;
-			if (keyboard[0] == "normalized") {
-				const n = normalizeValue(value, min, max, skew);
-				v = rawValue(n + x, min, max, skew);
-			} else v = value + x;
+			if (keyboard[0] == "normalized") v = rawValue(normalizeValue(value, min, max, skew) + x, min, max, skew);
+			else v = value + x;
 			onChange(clamp(stepValue(v, step), min, max));
 		}
 	}, [
@@ -323,10 +316,8 @@ const AnimationKnob = forwardRef(({ value, min, max, defaultValue = min, startVa
 		event.preventDefault();
 		const x = event.deltaY > 0 ? -wheel[1] : wheel[1];
 		let v;
-		if (wheel[0] == "normalized") {
-			const n = normalizeValue(value, min, max, skew);
-			v = rawValue(n + x, min, max, skew);
-		} else v = value + x;
+		if (wheel[0] == "normalized") v = rawValue(normalizeValue(value, min, max, skew) + x, min, max, skew);
+		else v = value + x;
 		if (onChange) onChange(clamp(stepValue(v, step), min, max));
 	}, { passive: false }, [
 		wheel,
@@ -438,20 +429,12 @@ function DragObserver(props) {
 *
 * @category Knob
 */
-const Knob = 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 = 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 = useRef(0);
 	const elmRef = useRef(null);
-	const padding = 8;
-	const thumbLineWeight = 6;
-	const thumbLineLength = 35;
-	const lineWeight = size * .06;
-	const p = normalizeValue(value, min, max, skew);
-	const s = normalizeValue(startValue, min, max, skew);
 	const onDrag = useCallback((_x, y) => {
 		if (!onChange || readonly) return;
-		const v = rawValue(valueRef.current - y / 100, min, max, skew);
-		const v2 = clamp(stepValue(v, step), min, max);
-		onChange(v2);
+		onChange(clamp(stepValue(rawValue(valueRef.current - y / 100, min, max, skew), step), min, max));
 	}, [
 		max,
 		min,
@@ -462,10 +445,8 @@ const Knob = forwardRef(({ value, min, max, step = 1, skew = 1, defaultValue = m
 	]);
 	const updateValueByEvent = useCallback((eventType, x) => {
 		let newValue;
-		if (eventType == "normalized") {
-			const n = normalizeValue(value, min, max, skew);
-			newValue = rawValue(n + x, min, max, skew);
-		} else newValue = value + x;
+		if (eventType == "normalized") newValue = rawValue(normalizeValue(value, min, max, skew) + x, min, max, skew);
+		else newValue = value + x;
 		return clamp(stepValue(newValue, step), min, max);
 	}, [
 		max,
@@ -515,7 +496,7 @@ const Knob = forwardRef(({ value, min, max, step = 1, skew = 1, defaultValue = m
 		readonly,
 		updateValueByEvent
 	]);
-	useImperativeHandle(ref, () => {
+	useImperativeHandle(forwardedRef, () => {
 		return {
 			focus() {
 				elmRef.current?.focus();
@@ -525,11 +506,15 @@ const Knob = forwardRef(({ value, min, max, step = 1, skew = 1, defaultValue = m
 			}
 		};
 	}, []);
-	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 - clamp(thumbSize, 0, 100)) / 2;
+	const p = normalizeValue(value, min, max, skew);
+	const s = 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(radian(r1 - 90));
 	const y1 = center + center * Math.sin(radian(r1 - 90));
 	const x2 = center + center * Math.cos(radian(r2 - 90));
@@ -539,12 +524,13 @@ const Knob = forwardRef(({ value, min, max, step = 1, skew = 1, defaultValue = m
 	const x4 = center + center * Math.cos(radian(r4 - 90));
 	const y4 = center + center * Math.sin(radian(r4 - 90));
 	return /* @__PURE__ */ jsxs("svg", {
-		className: clsx("tremolo-knob", className),
 		ref: (div) => {
 			elmRef.current = div;
 			wheelRefCallback(div);
 			touchMoveRefCallback(div);
 		},
+		className: clsx("tremolo-knob", className),
+		viewBox: `0 0 ${viewBoxSize} ${viewBoxSize}`,
 		width: size,
 		height: size,
 		tabIndex: 0,
@@ -594,7 +580,7 @@ const Knob = forwardRef(({ value, min, max, step = 1, skew = 1, defaultValue = m
 				children: [/* @__PURE__ */ jsx("circle", {
 					cx: "50%",
 					cy: "50%",
-					r: `${50 - padding}%`,
+					r: `${thumbSize / 2}%`,
 					fill: thumb || "currentColor"
 				}), /* @__PURE__ */ jsx("line", {
 					className: clsx("tremolo-knob-thumb-line", classes?.thumbLine),
@@ -605,7 +591,7 @@ const Knob = forwardRef(({ value, min, max, step = 1, skew = 1, defaultValue = m
 					stroke: thumbLine || "currentColor",
 					strokeWidth: `${thumbLineWeight}%`,
 					style: {
-						transform: `rotate(${-135 + p * 270}deg)`,
+						transform: `rotate(${r1 + p * angleRange}deg)`,
 						transformOrigin: "50% 50%"
 					}
 				})]
@@ -614,6 +600,47 @@ const Knob = forwardRef(({ value, min, max, step = 1, skew = 1, defaultValue = m
 	});
 });
 
+//#endregion
+//#region src/components/NumberInput/type.ts
+function selectUnit(units, value) {
+	let i = 0;
+	for (; i < units.length; i++) if (Math.abs(units[i][1]) > Math.abs(value)) break;
+	return units[Math.max(0, i - 1)];
+}
+function parseValue(inputString, units, digit) {
+	const str = inputString.trim();
+	if (!units || typeof units == "string") {
+		const m$1 = str.match(/-?\d+(\.\d+)?/);
+		let v = Number(m$1?.[0] ?? "0");
+		v = isNaN(v) ? 0 : v;
+		return {
+			rawValue: v,
+			formatValue: (digit != void 0 ? v.toFixed(digit) : v) + (units ?? ""),
+			unit: units ?? ""
+		};
+	}
+	const unitList = units.map(([u, _s]) => u);
+	const scaleList = units.map(([_u, s]) => s);
+	let rawValue$1 = 0;
+	let unit = unitList[0];
+	let formatValue = (digit != void 0 ? rawValue$1.toFixed(digit) : rawValue$1) + unit;
+	const m = str.match(/^(-?\d+(\.\d+)?)\s*(\w*)$/);
+	if (m) {
+		rawValue$1 = Number(m[1]) || 0;
+		const uIndex = unitList.indexOf(m[3]);
+		rawValue$1 *= uIndex != -1 ? scaleList[uIndex] : 1;
+		const [u, scale] = selectUnit(units, rawValue$1);
+		const v = rawValue$1 / scale;
+		formatValue = (digit != void 0 ? v.toFixed(digit) : v) + u;
+		unit = u;
+	}
+	return {
+		rawValue: rawValue$1,
+		formatValue,
+		unit
+	};
+}
+
 //#endregion
 //#region src/components/NumberInput/context.tsx
 function safeClamp(value, min = Number.MIN_SAFE_INTEGER, max = Number.MAX_SAFE_INTEGER) {
@@ -637,8 +664,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);
@@ -649,8 +675,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);
@@ -722,8 +747,7 @@ const InternalInput = forwardRef(({ disabled, readonly, selectWithFocus, blurOnE
 		let newValue;
 		if (eventType == "normalized") {
 			if (!min || !max) throw new Error("required parameter: min, max");
-			const n = normalizeValue(valueAsNumber, min, max);
-			newValue = rawValue(n + x, min, max);
+			newValue = rawValue(normalizeValue(valueAsNumber, min, max) + x, min, max);
 			return clamp(stepValue(newValue, step), min, max);
 		} else {
 			newValue = valueAsNumber + x;
@@ -839,6 +863,9 @@ function Stepper({ dynamic = true, children, className,...props }) {
 
 //#endregion
 //#region src/hooks/useInterval.ts
+/**
+* @category hooks
+*/
 function useInterval(callback, delay) {
 	const savedCallback = useRef(callback);
 	useEffect(() => {
@@ -857,6 +884,9 @@ function useInterval(callback, delay) {
 
 //#endregion
 //#region src/hooks/useLongPress.ts
+/**
+* @category hooks
+*/
 function useLongPress(callback, initialDelay = 500, interval = 40) {
 	const [pressed, setPressed] = useState(false);
 	const [delay, setDelay] = useState(initialDelay);
@@ -882,8 +912,7 @@ function IncrementStepper({ size = 12, children, className,...props }) {
 	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);
+	const press = useLongPress(useNumberInputContext((s) => s.increment));
 	return /* @__PURE__ */ jsx("div", {
 		className: clsx("tremolo-number-input-increment-stepper", className),
 		role: "button",
@@ -914,8 +943,7 @@ function DecrementStepper({ size = 12, children, className,...props }) {
 	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);
+	const press = useLongPress(useNumberInputContext((s) => s.decrement));
 	return /* @__PURE__ */ jsx("div", {
 		className: clsx("tremolo-number-input-decrement-stepper", className),
 		role: "button",
@@ -944,7 +972,7 @@ function DecrementStepper({ size = 12, children, className,...props }) {
 * Input with some useful functions for entering numerical values.
 * @category NumberInput
 */
-const NumberInput = 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 NumberInput = 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__ */ jsx(NumberInputProvider, {
 		value: String(value),
@@ -963,7 +991,7 @@ const NumberInput = forwardRef(({ value, min, max, step = 1, units, readonly = f
 			"data-stepper": !!children,
 			"data-variant": variant,
 			children: [/* @__PURE__ */ jsx(InternalInput, {
-				ref,
+				ref: forwardedRef,
 				readonly,
 				disabled,
 				selectWithFocus,
@@ -984,6 +1012,7 @@ const NumberInput = forwardRef(({ value, min, max, step = 1, units, readonly = f
 //#endregion
 //#region src/hooks/useDragWithElement.ts
 /**
+* @category hooks
 * @returns [refCallback, pointerDownHandler]
 */
 function useDragWithElement({ baseElementRef, onDrag, onDragStart, onDragEnd }) {
@@ -1063,9 +1092,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__ */ jsx("div", {
 		className: clsx("tremolo-piano-key-label-wrapper", wrapperClassName),
@@ -1091,8 +1118,7 @@ const KeyImpl = forwardRef(({ keyType, noteNumber, width, height, bg, color, act
 	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,
@@ -1102,10 +1128,10 @@ const KeyImpl = forwardRef(({ keyType, noteNumber, width, height, bg, color, act
 	};
 	useImperativeHandle(ref, () => {
 		return {
-			play() {
+			play(velocity) {
 				if (disabled) return;
 				setPlayed(true);
-				if (onPlayNote) onPlayNote(noteNumber);
+				if (onPlayNote) onPlayNote(noteNumber, velocity);
 			},
 			stop() {
 				setPlayed(false);
@@ -1196,12 +1222,9 @@ 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);
 }
@@ -1210,7 +1233,7 @@ 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 Piano = 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] = useState(_whiteNoteWidth);
 	const keyRefs = useRef([]);
 	for (let i = 0; i < noteRange.last - noteRange.first + 1; i++) keyRefs.current[i] = createRef();
@@ -1281,9 +1304,7 @@ function Piano({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts,
 	]);
 	const onDrag = 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) {
@@ -1337,6 +1358,25 @@ function Piano({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts,
 		const index = keyboardShortcuts.keys.indexOf(e.key);
 		if (index != -1) keyRefs.current[index]?.current?.stop();
 	});
+	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__ */ jsx(PianoProvider, {
 		notePosition,
 		noteRange,
@@ -1373,7 +1413,7 @@ function Piano({ noteRange, glissando = true, midiMax = 127, keyboardShortcuts,
 			}, note))
 		})
 	});
-}
+});
 
 //#endregion
 //#region src/components/Slider/context.tsx
@@ -1461,6 +1501,22 @@ function ScaleOption({ value, type = "mark-number", label, thickness = 1, length
 	});
 }
 
+//#endregion
+//#region src/components/Slider/type.ts
+function generateOptionsList(options, min, max, step) {
+	const optionsList = [];
+	const per = options[0] == "step" ? step : options[0];
+	const count = Math.floor(max / per) - Math.ceil(min / per) + 1;
+	for (let i = 0; i < count; i++) {
+		const value = toFixed(per * (Math.ceil(min / per) + i), decimalPart(per)?.length);
+		optionsList.push({
+			value,
+			type: options[1]
+		});
+	}
+	return optionsList;
+}
+
 //#endregion
 //#region src/components/Slider/Scale.tsx
 /** @category Slider */
@@ -1551,7 +1607,7 @@ function SliderTrack({ length = defaultLength, thickness = defaultThickness, act
 		"data-vertical": vertical,
 		style: !defaultStyle ? style : {
 			...colors,
-			background: 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: xor(vertical, reverse) ? `linear-gradient(to ${direction}, var(--inactive) ${__percent}%, var(--active) ${__percent}%)` : `linear-gradient(to ${direction}, var(--active) ${__percent}%, var(--inactive) ${__percent}%)`,
 			borderRadius: styleHelper(thickness, "/", 2),
 			width: !vertical ? length : thickness,
 			height: vertical ? length : thickness,
@@ -1568,7 +1624,7 @@ function SliderTrack({ length = defaultLength, thickness = defaultThickness, act
 * Customizable slider
 * @category Slider
 */
-const Slider = 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 Slider = 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 = useRef(null);
 	const thumbRef = useRef(null);
 	const p = toFixed(normalizeValue(value, min, max, skew) * 100);
@@ -1588,9 +1644,7 @@ const Slider = forwardRef(({ value, min, max, step = 1, skew = 1, vertical = fal
 	const onDrag = useCallback((nx, ny) => {
 		if (!onChange || readonly) return;
 		const n = vertical ? ny : nx;
-		const v = rawValue(displayReversed ? 1 - n : n, min, max, skew);
-		const v2 = clamp(stepValue(v, step), min, max);
-		onChange(v2);
+		onChange(clamp(stepValue(rawValue(displayReversed ? 1 - n : n, min, max, skew), step), min, max));
 	}, [
 		displayReversed,
 		max,
@@ -1603,10 +1657,8 @@ const Slider = forwardRef(({ value, min, max, step = 1, skew = 1, vertical = fal
 	]);
 	const updateValueByEvent = useCallback((eventType, x) => {
 		let newValue;
-		if (eventType == "normalized") {
-			const n = normalizeValue(value, min, max, skew);
-			newValue = rawValue(n + x, min, max, skew);
-		} else newValue = value + x;
+		if (eventType == "normalized") newValue = rawValue(normalizeValue(value, min, max, skew) + x, min, max, skew);
+		else newValue = value + x;
 		return clamp(stepValue(newValue, step), min, max);
 	}, [
 		max,
@@ -1669,7 +1721,7 @@ const Slider = forwardRef(({ value, min, max, step = 1, skew = 1, vertical = fal
 		onChange,
 		updateValueByEvent
 	]);
-	useImperativeHandle(ref, () => {
+	useImperativeHandle(forwardedRef, () => {
 		return {
 			focus() {
 				thumbRef.current?.focus();
@@ -1753,11 +1805,10 @@ const Slider = forwardRef(({ value, min, max, step = 1, skew = 1, vertical = fal
 /** @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__ */ jsx(Component, {
-		ref: wheelRefCallback,
+		ref: useRefCallbackEvent("wheel", (event) => {
+			if (onWheel) onWheel(event);
+		}, { passive: false }, [onWheel]),
 		...attributes,
 		children
 	});
@@ -1830,7 +1881,7 @@ const defaultValueOptions = {
 * Simple XYPad
 * @category XYPad
 */
-const XYPad = forwardRef(({ x: _x, y: _y, className, style, bodyNoSelect = true, disabled = false, readonly = false, onChange, onDragStart, onDragEnd, onPointerDown, onKeyDown, onFocus, onBlur, children,...props }, ref) => {
+const XYPad = 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 = useMemo(() => {
 		return {
 			...defaultValueOptions,
@@ -1861,9 +1912,7 @@ const XYPad = forwardRef(({ x: _x, y: _y, className, style, bodyNoSelect = true,
 		if (!onChange || readonly) return;
 		const vx = rawValue(x.reverse ? 1 - nx$1 : nx$1, x.min, x.max, x.skew);
 		const vy = rawValue(y.reverse ? 1 - ny$1 : ny$1, y.min, y.max, y.skew);
-		const newX = clamp(stepValue(vx, x.step), x.min, x.max);
-		const newY = clamp(stepValue(vy, y.step), y.min, y.max);
-		onChange(newX, newY);
+		onChange(clamp(stepValue(vx, x.step), x.min, x.max), clamp(stepValue(vy, y.step), y.min, y.max));
 	}, [
 		onChange,
 		readonly,
@@ -1880,10 +1929,8 @@ const XYPad = forwardRef(({ x: _x, y: _y, className, style, bodyNoSelect = true,
 	]);
 	const updateValueByEvent = useCallback((eventType, target, x$1) => {
 		let v;
-		if (eventType == "normalized") {
-			const n = normalizeValue(target.value, target.min, target.max, target.skew);
-			v = rawValue(n + x$1, target.min, target.max, target.skew);
-		} else v = target.value + x$1;
+		if (eventType == "normalized") v = rawValue(normalizeValue(target.value, target.min, target.max, target.skew) + x$1, target.min, target.max, target.skew);
+		else v = target.value + x$1;
 		return clamp(stepValue(v, target.step), target.min, target.max);
 	}, []);
 	const handleKeyDown = useCallback((event) => {
@@ -1950,7 +1997,7 @@ const XYPad = forwardRef(({ x: _x, y: _y, className, style, bodyNoSelect = true,
 		readonly,
 		updateValueByEvent
 	]);
-	useImperativeHandle(ref, () => {
+	useImperativeHandle(forwardedRef, () => {
 		return {
 			focus() {
 				thumbRef.current?.focus();
@@ -2013,6 +2060,9 @@ const XYPad = forwardRef(({ x: _x, y: _y, className, style, bodyNoSelect = true,
 
 //#endregion
 //#region src/hooks/useAnimationFrame.ts
+/**
+* @category hooks
+*/
 function useAnimationFrame(callback = () => {}, deps = []) {
 	const reqIdRef = useRef(-1);
 	const loop = useCallback(() => {
@@ -2026,5 +2076,78 @@ function useAnimationFrame(callback = () => {}, deps = []) {
 }
 
 //#endregion
-export { AnimationCanvas, AnimationKnob, BlackKey, DecrementStepper, DragObserver, IncrementStepper, KeyLabel, Knob, NumberInput, Piano, SHORTCUTS, Scale, ScaleOption, Slider, SliderThumb, SliderTrack, Stepper, WheelObserver, WhiteKey, XYPad, XYPadArea, XYPadThumb, getNoteRangeArray, useAnimationFrame, useDrag, useDragWithElement, useEventListener, useInterval, useLongPress, useSliderContext };
+//#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] = useState(null);
+	const [error, setError] = useState(null);
+	const request = useCallback(() => {
+		if (navigator.requestMIDIAccess) navigator.requestMIDIAccess().then((access) => {
+			setMidiAccess(access);
+			setError(null);
+		}).catch(() => {
+			setError(PERMISSION_DENIED);
+		});
+		else setError(NOT_SUPPORTED);
+	}, []);
+	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) {
+	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, 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
+export { AnimationCanvas, AnimationKnob, BlackKey, DecrementStepper, DragObserver, IncrementStepper, KeyLabel, Knob, NOT_SUPPORTED, NumberInput, PERMISSION_DENIED, Piano, SHORTCUTS, Scale, ScaleOption, Slider, SliderThumb, SliderTrack, Stepper, WheelObserver, WhiteKey, XYPad, XYPadArea, XYPadThumb, getNoteRangeArray, useAnimationFrame, useDrag, useDragWithElement, useEventListener, useInterval, useLongPress, useMIDIAccess, useMIDIInput, useMIDIMessage, useSliderContext };
 //# sourceMappingURL=index.js.map