@motion-core/motion-gpu 0.5.0 → 0.7.0

package/dist/react/use-pointer.js

@@ -0,0 +1,285 @@
+import { createCurrentWritable } from "../core/current-value.js";
+import { createInitialPointerState, getPointerCoordinates, getPointerNowSeconds, normalizePointerKind, resolvePointerFrameRequestMode } from "../core/pointer.js";
+import { useMotionGPU } from "./motiongpu-context.js";
+import { useCallback, useEffect, useRef } from "react";
+//#region src/lib/react/use-pointer.ts
+/**
+* Resolves a valid click duration threshold in milliseconds.
+*/
+function resolveClickMaxDurationMs(value) {
+	if (typeof value !== "number" || Number.isNaN(value) || value <= 0) return 350;
+	return value;
+}
+/**
+* Resolves a valid click travel threshold in pixels.
+*/
+function resolveClickMaxMovePx(value) {
+	if (typeof value !== "number" || Number.isNaN(value) || value < 0) return 8;
+	return value;
+}
+/**
+* Normalizes click button configuration with a primary-button fallback.
+*/
+function normalizeClickButtons(buttons) {
+	const source = buttons && buttons.length > 0 ? buttons : [0];
+	return new Set(source);
+}
+/**
+* Tracks normalized pointer coordinates and click/tap snapshots for the active `FragCanvas`.
+*/
+function usePointer(options = {}) {
+	const motiongpu = useMotionGPU();
+	const stateRef = useRef(createCurrentWritable(createInitialPointerState()));
+	const clickRef = useRef(createCurrentWritable(null));
+	const optionsRef = useRef(options);
+	const activePointerIdRef = useRef(null);
+	const downSnapshotRef = useRef(null);
+	const clickCounterRef = useRef(0);
+	const previousPxRef = useRef(null);
+	const previousUvRef = useRef(null);
+	const previousTimeSecondsRef = useRef(0);
+	optionsRef.current = options;
+	const requestFrame = useCallback(() => {
+		const mode = resolvePointerFrameRequestMode(optionsRef.current.requestFrame ?? "auto", motiongpu.renderMode.current);
+		if (mode === "invalidate") {
+			motiongpu.invalidate();
+			return;
+		}
+		if (mode === "advance") motiongpu.advance();
+	}, [motiongpu]);
+	/**
+	* Commits a full pointer state snapshot with computed delta and velocity vectors.
+	*/
+	const updatePointerState = useCallback((input) => {
+		const nowSeconds = getPointerNowSeconds();
+		const previousTimeSeconds = previousTimeSecondsRef.current;
+		const dt = previousTimeSeconds > 0 ? Math.max(nowSeconds - previousTimeSeconds, 1e-6) : 0;
+		const previousPx = previousPxRef.current;
+		const previousUv = previousUvRef.current;
+		const deltaPx = input.resetDelta || !previousPx ? [0, 0] : [input.point.px[0] - previousPx[0], input.point.px[1] - previousPx[1]];
+		const deltaUv = input.resetDelta || !previousUv ? [0, 0] : [input.point.uv[0] - previousUv[0], input.point.uv[1] - previousUv[1]];
+		const velocityPx = dt > 0 ? [deltaPx[0] / dt, deltaPx[1] / dt] : [0, 0];
+		const velocityUv = dt > 0 ? [deltaUv[0] / dt, deltaUv[1] / dt] : [0, 0];
+		const nextState = {
+			px: input.point.px,
+			uv: input.point.uv,
+			ndc: input.point.ndc,
+			inside: input.inside,
+			pressed: input.pressed,
+			dragging: input.dragging,
+			pointerType: input.pointerType,
+			pointerId: input.pointerId,
+			button: input.button,
+			buttons: input.buttons,
+			time: nowSeconds,
+			downPx: input.downPx,
+			downUv: input.downUv,
+			deltaPx,
+			deltaUv,
+			velocityPx,
+			velocityUv
+		};
+		stateRef.current.set(nextState);
+		previousPxRef.current = input.point.px;
+		previousUvRef.current = input.point.uv;
+		previousTimeSecondsRef.current = nowSeconds;
+		requestFrame();
+		return nextState;
+	}, [requestFrame]);
+	useEffect(() => {
+		if (!(optionsRef.current.enabled ?? true)) return;
+		const canvas = motiongpu.canvas;
+		if (!canvas) return;
+		const isTrackedPointer = (event) => activePointerIdRef.current === null || event.pointerId === activePointerIdRef.current;
+		const handlePointerDown = (event) => {
+			const point = getPointerCoordinates(event.clientX, event.clientY, canvas.getBoundingClientRect());
+			const pointerType = normalizePointerKind(event.pointerType);
+			activePointerIdRef.current = event.pointerId;
+			downSnapshotRef.current = {
+				pointerId: event.pointerId,
+				pointerType,
+				button: event.button,
+				timeMs: getPointerNowSeconds() * 1e3,
+				px: point.px,
+				uv: point.uv,
+				inside: point.inside
+			};
+			if (optionsRef.current.capturePointer ?? true) try {
+				canvas.setPointerCapture(event.pointerId);
+			} catch {}
+			const nextState = updatePointerState({
+				point,
+				inside: point.inside,
+				pressed: true,
+				dragging: false,
+				pointerType,
+				pointerId: event.pointerId,
+				button: event.button,
+				buttons: event.buttons,
+				downPx: point.px,
+				downUv: point.uv,
+				resetDelta: true
+			});
+			optionsRef.current.onDown?.(nextState, event);
+		};
+		const handleMove = (event) => {
+			if (!isTrackedPointer(event)) return;
+			const point = getPointerCoordinates(event.clientX, event.clientY, canvas.getBoundingClientRect());
+			const pressed = activePointerIdRef.current !== null && event.pointerId === activePointerIdRef.current;
+			const downPx = pressed ? downSnapshotRef.current?.px ?? point.px : null;
+			const downUv = pressed ? downSnapshotRef.current?.uv ?? point.uv : null;
+			let dragging = false;
+			if (pressed && downPx) {
+				const dx = point.px[0] - downPx[0];
+				const dy = point.px[1] - downPx[1];
+				dragging = Math.hypot(dx, dy) > 0;
+			}
+			const nextState = updatePointerState({
+				point,
+				inside: point.inside,
+				pressed,
+				dragging,
+				pointerType: normalizePointerKind(event.pointerType),
+				pointerId: event.pointerId,
+				button: pressed ? downSnapshotRef.current?.button ?? event.button : null,
+				buttons: event.buttons,
+				downPx,
+				downUv
+			});
+			optionsRef.current.onMove?.(nextState, event);
+		};
+		const handleWindowMove = (event) => {
+			if (!(optionsRef.current.trackWhilePressedOutsideCanvas ?? true) || activePointerIdRef.current === null || event.pointerId !== activePointerIdRef.current) return;
+			const point = getPointerCoordinates(event.clientX, event.clientY, canvas.getBoundingClientRect());
+			if (point.inside) return;
+			const downPx = downSnapshotRef.current?.px ?? point.px;
+			const downUv = downSnapshotRef.current?.uv ?? point.uv;
+			const dx = point.px[0] - downPx[0];
+			const dy = point.px[1] - downPx[1];
+			const nextState = updatePointerState({
+				point,
+				inside: false,
+				pressed: true,
+				dragging: Math.hypot(dx, dy) > 0,
+				pointerType: downSnapshotRef.current?.pointerType ?? normalizePointerKind(event.pointerType),
+				pointerId: event.pointerId,
+				button: downSnapshotRef.current?.button ?? event.button,
+				buttons: event.buttons,
+				downPx,
+				downUv
+			});
+			optionsRef.current.onMove?.(nextState, event);
+		};
+		const releasePointer = (event, emitClick) => {
+			if (activePointerIdRef.current === null || event.pointerId !== activePointerIdRef.current) return;
+			const point = getPointerCoordinates(event.clientX, event.clientY, canvas.getBoundingClientRect());
+			const previous = downSnapshotRef.current;
+			const pointerType = previous?.pointerType ?? normalizePointerKind(event.pointerType);
+			const nextState = updatePointerState({
+				point,
+				inside: point.inside,
+				pressed: false,
+				dragging: false,
+				pointerType,
+				pointerId: null,
+				button: null,
+				buttons: event.buttons,
+				downPx: null,
+				downUv: null
+			});
+			optionsRef.current.onUp?.(nextState, event);
+			if ((optionsRef.current.capturePointer ?? true) && canvas.hasPointerCapture(event.pointerId)) try {
+				canvas.releasePointerCapture(event.pointerId);
+			} catch {}
+			if (emitClick && (optionsRef.current.clickEnabled ?? true) && previous) {
+				if (normalizeClickButtons(optionsRef.current.clickButtons).has(previous.button)) {
+					const clickMaxDurationMs = resolveClickMaxDurationMs(optionsRef.current.clickMaxDurationMs);
+					const clickMaxMovePx = resolveClickMaxMovePx(optionsRef.current.clickMaxMovePx);
+					const durationMs = getPointerNowSeconds() * 1e3 - previous.timeMs;
+					const dx = point.px[0] - previous.px[0];
+					const dy = point.px[1] - previous.px[1];
+					const moveDistance = Math.hypot(dx, dy);
+					if (previous.inside && point.inside && durationMs <= clickMaxDurationMs && moveDistance <= clickMaxMovePx) {
+						clickCounterRef.current += 1;
+						const click = {
+							id: clickCounterRef.current,
+							time: getPointerNowSeconds(),
+							pointerType,
+							pointerId: event.pointerId,
+							button: previous.button,
+							modifiers: {
+								alt: event.altKey,
+								ctrl: event.ctrlKey,
+								shift: event.shiftKey,
+								meta: event.metaKey
+							},
+							px: point.px,
+							uv: point.uv,
+							ndc: point.ndc
+						};
+						clickRef.current.set(click);
+						optionsRef.current.onClick?.(click, nextState, event);
+						requestFrame();
+					}
+				}
+			}
+			activePointerIdRef.current = null;
+			downSnapshotRef.current = null;
+		};
+		const handlePointerUp = (event) => {
+			releasePointer(event, true);
+		};
+		const handlePointerCancel = (event) => {
+			releasePointer(event, false);
+		};
+		const handlePointerLeave = () => {
+			if (activePointerIdRef.current !== null) return;
+			const current = stateRef.current.current;
+			stateRef.current.set({
+				...current,
+				inside: false,
+				time: getPointerNowSeconds(),
+				deltaPx: [0, 0],
+				deltaUv: [0, 0],
+				velocityPx: [0, 0],
+				velocityUv: [0, 0]
+			});
+			requestFrame();
+		};
+		canvas.addEventListener("pointerdown", handlePointerDown);
+		canvas.addEventListener("pointermove", handleMove);
+		canvas.addEventListener("pointerup", handlePointerUp);
+		canvas.addEventListener("pointercancel", handlePointerCancel);
+		canvas.addEventListener("pointerleave", handlePointerLeave);
+		if (optionsRef.current.trackWhilePressedOutsideCanvas ?? true) {
+			window.addEventListener("pointermove", handleWindowMove);
+			window.addEventListener("pointerup", handlePointerUp);
+			window.addEventListener("pointercancel", handlePointerCancel);
+		}
+		return () => {
+			canvas.removeEventListener("pointerdown", handlePointerDown);
+			canvas.removeEventListener("pointermove", handleMove);
+			canvas.removeEventListener("pointerup", handlePointerUp);
+			canvas.removeEventListener("pointercancel", handlePointerCancel);
+			canvas.removeEventListener("pointerleave", handlePointerLeave);
+			window.removeEventListener("pointermove", handleWindowMove);
+			window.removeEventListener("pointerup", handlePointerUp);
+			window.removeEventListener("pointercancel", handlePointerCancel);
+		};
+	}, [
+		motiongpu,
+		requestFrame,
+		updatePointerState
+	]);
+	return {
+		state: stateRef.current,
+		lastClick: clickRef.current,
+		resetClick: useCallback(() => {
+			clickRef.current.set(null);
+		}, [])
+	};
+}
+//#endregion
+export { usePointer };
+
+//# sourceMappingURL=use-pointer.js.map

package/dist/react/use-pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pointer.js","names":[],"sources":["../../src/lib/react/use-pointer.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport {\n\tcreateCurrentWritable as currentWritable,\n\ttype CurrentReadable\n} from '../core/current-value.js';\nimport {\n\tcreateInitialPointerState,\n\tgetPointerCoordinates,\n\tgetPointerNowSeconds,\n\tnormalizePointerKind,\n\tresolvePointerFrameRequestMode,\n\ttype PointerClick,\n\ttype PointerFrameRequestMode,\n\ttype PointerState,\n\ttype PointerVec2\n} from '../core/pointer.js';\nimport { useMotionGPU } from './motiongpu-context.js';\n\nexport type {\n\tPointerClick,\n\tPointerFrameRequestMode,\n\tPointerKind,\n\tPointerPoint,\n\tPointerState\n} from '../core/pointer.js';\n\n/**\n * Configuration for pointer input handling in `usePointer`.\n */\nexport interface UsePointerOptions {\n\t/**\n\t * Enables pointer listeners.\n\t *\n\t * @default true\n\t */\n\tenabled?: boolean;\n\t/**\n\t * Frame wake-up strategy for pointer-driven state changes.\n\t *\n\t * @default 'auto'\n\t */\n\trequestFrame?: PointerFrameRequestMode;\n\t/**\n\t * Requests pointer capture on pointer down.\n\t *\n\t * @default true\n\t */\n\tcapturePointer?: boolean;\n\t/**\n\t * Tracks pointer move/up outside canvas while pointer is pressed.\n\t *\n\t * @default true\n\t */\n\ttrackWhilePressedOutsideCanvas?: boolean;\n\t/**\n\t * Enables click/tap synthesis on pointer up.\n\t *\n\t * @default true\n\t */\n\tclickEnabled?: boolean;\n\t/**\n\t * Maximum press duration to consider pointer up a click (milliseconds).\n\t *\n\t * @default 350\n\t */\n\tclickMaxDurationMs?: number;\n\t/**\n\t * Maximum pointer travel from down to up to consider pointer up a click (pixels).\n\t *\n\t * @default 8\n\t */\n\tclickMaxMovePx?: number;\n\t/**\n\t * Allowed pointer buttons for click synthesis.\n\t *\n\t * @default [0]\n\t */\n\tclickButtons?: number[];\n\t/**\n\t * Called after pointer move state update.\n\t */\n\tonMove?: (state: PointerState, event: PointerEvent) => void;\n\t/**\n\t * Called after pointer down state update.\n\t */\n\tonDown?: (state: PointerState, event: PointerEvent) => void;\n\t/**\n\t * Called after pointer up/cancel state update.\n\t */\n\tonUp?: (state: PointerState, event: PointerEvent) => void;\n\t/**\n\t * Called when click/tap is synthesized.\n\t */\n\tonClick?: (click: PointerClick, state: PointerState, event: PointerEvent) => void;\n}\n\n/**\n * Reactive state returned by `usePointer`.\n */\nexport interface UsePointerResult {\n\t/**\n\t * Current pointer state.\n\t */\n\tstate: CurrentReadable<PointerState>;\n\t/**\n\t * Last synthesized click/tap event.\n\t */\n\tlastClick: CurrentReadable<PointerClick | null>;\n\t/**\n\t * Clears last click snapshot.\n\t */\n\tresetClick: () => void;\n}\n\ninterface PointerDownSnapshot {\n\tbutton: number;\n\tinside: boolean;\n\tpointerId: number;\n\tpointerType: 'mouse' | 'pen' | 'touch';\n\tpx: PointerVec2;\n\ttimeMs: number;\n\tuv: PointerVec2;\n}\n\n/**\n * Resolves a valid click duration threshold in milliseconds.\n */\nfunction resolveClickMaxDurationMs(value: number | undefined): number {\n\tif (typeof value !== 'number' || Number.isNaN(value) || value <= 0) {\n\t\treturn 350;\n\t}\n\n\treturn value;\n}\n\n/**\n * Resolves a valid click travel threshold in pixels.\n */\nfunction resolveClickMaxMovePx(value: number | undefined): number {\n\tif (typeof value !== 'number' || Number.isNaN(value) || value < 0) {\n\t\treturn 8;\n\t}\n\n\treturn value;\n}\n\n/**\n * Normalizes click button configuration with a primary-button fallback.\n */\nfunction normalizeClickButtons(buttons: number[] | undefined): Set<number> {\n\tconst source = buttons && buttons.length > 0 ? buttons : [0];\n\treturn new Set(source);\n}\n\n/**\n * Tracks normalized pointer coordinates and click/tap snapshots for the active `FragCanvas`.\n */\nexport function usePointer(options: UsePointerOptions = {}): UsePointerResult {\n\tconst motiongpu = useMotionGPU();\n\tconst stateRef = useRef(currentWritable<PointerState>(createInitialPointerState()));\n\tconst clickRef = useRef(currentWritable<PointerClick | null>(null));\n\tconst optionsRef = useRef(options);\n\tconst activePointerIdRef = useRef<number | null>(null);\n\tconst downSnapshotRef = useRef<PointerDownSnapshot | null>(null);\n\tconst clickCounterRef = useRef(0);\n\tconst previousPxRef = useRef<PointerVec2 | null>(null);\n\tconst previousUvRef = useRef<PointerVec2 | null>(null);\n\tconst previousTimeSecondsRef = useRef(0);\n\n\toptionsRef.current = options;\n\n\tconst requestFrame = useCallback((): void => {\n\t\tconst mode = resolvePointerFrameRequestMode(\n\t\t\toptionsRef.current.requestFrame ?? 'auto',\n\t\t\tmotiongpu.renderMode.current\n\t\t);\n\t\tif (mode === 'invalidate') {\n\t\t\tmotiongpu.invalidate();\n\t\t\treturn;\n\t\t}\n\t\tif (mode === 'advance') {\n\t\t\tmotiongpu.advance();\n\t\t}\n\t}, [motiongpu]);\n\n\t/**\n\t * Commits a full pointer state snapshot with computed delta and velocity vectors.\n\t */\n\tconst updatePointerState = useCallback(\n\t\t(input: {\n\t\t\tbutton: number | null;\n\t\t\tbuttons: number;\n\t\t\tdownPx: PointerVec2 | null;\n\t\t\tdownUv: PointerVec2 | null;\n\t\t\tdragging: boolean;\n\t\t\tinside: boolean;\n\t\t\tpointerId: number | null;\n\t\t\tpointerType: 'mouse' | 'pen' | 'touch' | null;\n\t\t\tpressed: boolean;\n\t\t\tpoint: {\n\t\t\t\tndc: PointerVec2;\n\t\t\t\tpx: PointerVec2;\n\t\t\t\tuv: PointerVec2;\n\t\t\t};\n\t\t\tresetDelta?: boolean;\n\t\t}): PointerState => {\n\t\t\tconst nowSeconds = getPointerNowSeconds();\n\t\t\tconst previousTimeSeconds = previousTimeSecondsRef.current;\n\t\t\tconst dt = previousTimeSeconds > 0 ? Math.max(nowSeconds - previousTimeSeconds, 1e-6) : 0;\n\t\t\tconst previousPx = previousPxRef.current;\n\t\t\tconst previousUv = previousUvRef.current;\n\t\t\tconst deltaPx: PointerVec2 =\n\t\t\t\tinput.resetDelta || !previousPx\n\t\t\t\t\t? [0, 0]\n\t\t\t\t\t: [input.point.px[0] - previousPx[0], input.point.px[1] - previousPx[1]];\n\t\t\tconst deltaUv: PointerVec2 =\n\t\t\t\tinput.resetDelta || !previousUv\n\t\t\t\t\t? [0, 0]\n\t\t\t\t\t: [input.point.uv[0] - previousUv[0], input.point.uv[1] - previousUv[1]];\n\t\t\tconst velocityPx: PointerVec2 = dt > 0 ? [deltaPx[0] / dt, deltaPx[1] / dt] : [0, 0];\n\t\t\tconst velocityUv: PointerVec2 = dt > 0 ? [deltaUv[0] / dt, deltaUv[1] / dt] : [0, 0];\n\t\t\tconst nextState: PointerState = {\n\t\t\t\tpx: input.point.px,\n\t\t\t\tuv: input.point.uv,\n\t\t\t\tndc: input.point.ndc,\n\t\t\t\tinside: input.inside,\n\t\t\t\tpressed: input.pressed,\n\t\t\t\tdragging: input.dragging,\n\t\t\t\tpointerType: input.pointerType,\n\t\t\t\tpointerId: input.pointerId,\n\t\t\t\tbutton: input.button,\n\t\t\t\tbuttons: input.buttons,\n\t\t\t\ttime: nowSeconds,\n\t\t\t\tdownPx: input.downPx,\n\t\t\t\tdownUv: input.downUv,\n\t\t\t\tdeltaPx,\n\t\t\t\tdeltaUv,\n\t\t\t\tvelocityPx,\n\t\t\t\tvelocityUv\n\t\t\t};\n\t\t\tstateRef.current.set(nextState);\n\t\t\tpreviousPxRef.current = input.point.px;\n\t\t\tpreviousUvRef.current = input.point.uv;\n\t\t\tpreviousTimeSecondsRef.current = nowSeconds;\n\t\t\trequestFrame();\n\t\t\treturn nextState;\n\t\t},\n\t\t[requestFrame]\n\t);\n\n\tuseEffect(() => {\n\t\tconst enabled = optionsRef.current.enabled ?? true;\n\t\tif (!enabled) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst canvas = motiongpu.canvas;\n\t\tif (!canvas) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst isTrackedPointer = (event: PointerEvent): boolean =>\n\t\t\tactivePointerIdRef.current === null || event.pointerId === activePointerIdRef.current;\n\n\t\tconst handlePointerDown = (event: PointerEvent): void => {\n\t\t\tconst point = getPointerCoordinates(\n\t\t\t\tevent.clientX,\n\t\t\t\tevent.clientY,\n\t\t\t\tcanvas.getBoundingClientRect()\n\t\t\t);\n\t\t\tconst pointerType = normalizePointerKind(event.pointerType);\n\t\t\tactivePointerIdRef.current = event.pointerId;\n\t\t\tdownSnapshotRef.current = {\n\t\t\t\tpointerId: event.pointerId,\n\t\t\t\tpointerType,\n\t\t\t\tbutton: event.button,\n\t\t\t\ttimeMs: getPointerNowSeconds() * 1000,\n\t\t\t\tpx: point.px,\n\t\t\t\tuv: point.uv,\n\t\t\t\tinside: point.inside\n\t\t\t};\n\t\t\tif (optionsRef.current.capturePointer ?? true) {\n\t\t\t\ttry {\n\t\t\t\t\tcanvas.setPointerCapture(event.pointerId);\n\t\t\t\t} catch {\n\t\t\t\t\t// Browser rejected capture (e.g. unsupported pointer state).\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst nextState = updatePointerState({\n\t\t\t\tpoint,\n\t\t\t\tinside: point.inside,\n\t\t\t\tpressed: true,\n\t\t\t\tdragging: false,\n\t\t\t\tpointerType,\n\t\t\t\tpointerId: event.pointerId,\n\t\t\t\tbutton: event.button,\n\t\t\t\tbuttons: event.buttons,\n\t\t\t\tdownPx: point.px,\n\t\t\t\tdownUv: point.uv,\n\t\t\t\tresetDelta: true\n\t\t\t});\n\t\t\toptionsRef.current.onDown?.(nextState, event);\n\t\t};\n\n\t\tconst handleMove = (event: PointerEvent): void => {\n\t\t\tif (!isTrackedPointer(event)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst point = getPointerCoordinates(\n\t\t\t\tevent.clientX,\n\t\t\t\tevent.clientY,\n\t\t\t\tcanvas.getBoundingClientRect()\n\t\t\t);\n\t\t\tconst pressed =\n\t\t\t\tactivePointerIdRef.current !== null && event.pointerId === activePointerIdRef.current;\n\t\t\tconst downPx = pressed ? (downSnapshotRef.current?.px ?? point.px) : null;\n\t\t\tconst downUv = pressed ? (downSnapshotRef.current?.uv ?? point.uv) : null;\n\t\t\tlet dragging = false;\n\t\t\tif (pressed && downPx) {\n\t\t\t\tconst dx = point.px[0] - downPx[0];\n\t\t\t\tconst dy = point.px[1] - downPx[1];\n\t\t\t\tdragging = Math.hypot(dx, dy) > 0;\n\t\t\t}\n\t\t\tconst nextState = updatePointerState({\n\t\t\t\tpoint,\n\t\t\t\tinside: point.inside,\n\t\t\t\tpressed,\n\t\t\t\tdragging,\n\t\t\t\tpointerType: normalizePointerKind(event.pointerType),\n\t\t\t\tpointerId: event.pointerId,\n\t\t\t\tbutton: pressed ? (downSnapshotRef.current?.button ?? event.button) : null,\n\t\t\t\tbuttons: event.buttons,\n\t\t\t\tdownPx,\n\t\t\t\tdownUv\n\t\t\t});\n\t\t\toptionsRef.current.onMove?.(nextState, event);\n\t\t};\n\n\t\tconst handleWindowMove = (event: PointerEvent): void => {\n\t\t\tif (\n\t\t\t\t!(optionsRef.current.trackWhilePressedOutsideCanvas ?? true) ||\n\t\t\t\tactivePointerIdRef.current === null ||\n\t\t\t\tevent.pointerId !== activePointerIdRef.current\n\t\t\t) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst point = getPointerCoordinates(\n\t\t\t\tevent.clientX,\n\t\t\t\tevent.clientY,\n\t\t\t\tcanvas.getBoundingClientRect()\n\t\t\t);\n\t\t\tif (point.inside) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst downPx = downSnapshotRef.current?.px ?? point.px;\n\t\t\tconst downUv = downSnapshotRef.current?.uv ?? point.uv;\n\t\t\tconst dx = point.px[0] - downPx[0];\n\t\t\tconst dy = point.px[1] - downPx[1];\n\t\t\tconst nextState = updatePointerState({\n\t\t\t\tpoint,\n\t\t\t\tinside: false,\n\t\t\t\tpressed: true,\n\t\t\t\tdragging: Math.hypot(dx, dy) > 0,\n\t\t\t\tpointerType:\n\t\t\t\t\tdownSnapshotRef.current?.pointerType ?? normalizePointerKind(event.pointerType),\n\t\t\t\tpointerId: event.pointerId,\n\t\t\t\tbutton: downSnapshotRef.current?.button ?? event.button,\n\t\t\t\tbuttons: event.buttons,\n\t\t\t\tdownPx,\n\t\t\t\tdownUv\n\t\t\t});\n\t\t\toptionsRef.current.onMove?.(nextState, event);\n\t\t};\n\n\t\tconst releasePointer = (event: PointerEvent, emitClick: boolean): void => {\n\t\t\tif (activePointerIdRef.current === null || event.pointerId !== activePointerIdRef.current) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst point = getPointerCoordinates(\n\t\t\t\tevent.clientX,\n\t\t\t\tevent.clientY,\n\t\t\t\tcanvas.getBoundingClientRect()\n\t\t\t);\n\t\t\tconst previous = downSnapshotRef.current;\n\t\t\tconst pointerType = previous?.pointerType ?? normalizePointerKind(event.pointerType);\n\t\t\tconst nextState = updatePointerState({\n\t\t\t\tpoint,\n\t\t\t\tinside: point.inside,\n\t\t\t\tpressed: false,\n\t\t\t\tdragging: false,\n\t\t\t\tpointerType,\n\t\t\t\tpointerId: null,\n\t\t\t\tbutton: null,\n\t\t\t\tbuttons: event.buttons,\n\t\t\t\tdownPx: null,\n\t\t\t\tdownUv: null\n\t\t\t});\n\t\t\toptionsRef.current.onUp?.(nextState, event);\n\n\t\t\tif (\n\t\t\t\t(optionsRef.current.capturePointer ?? true) &&\n\t\t\t\tcanvas.hasPointerCapture(event.pointerId)\n\t\t\t) {\n\t\t\t\ttry {\n\t\t\t\t\tcanvas.releasePointerCapture(event.pointerId);\n\t\t\t\t} catch {\n\t\t\t\t\t// Browser rejected release for this pointer id.\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (emitClick && (optionsRef.current.clickEnabled ?? true) && previous) {\n\t\t\t\tconst allowedButtons = normalizeClickButtons(optionsRef.current.clickButtons);\n\t\t\t\tif (allowedButtons.has(previous.button)) {\n\t\t\t\t\tconst clickMaxDurationMs = resolveClickMaxDurationMs(\n\t\t\t\t\t\toptionsRef.current.clickMaxDurationMs\n\t\t\t\t\t);\n\t\t\t\t\tconst clickMaxMovePx = resolveClickMaxMovePx(optionsRef.current.clickMaxMovePx);\n\t\t\t\t\tconst durationMs = getPointerNowSeconds() * 1000 - previous.timeMs;\n\t\t\t\t\tconst dx = point.px[0] - previous.px[0];\n\t\t\t\t\tconst dy = point.px[1] - previous.px[1];\n\t\t\t\t\tconst moveDistance = Math.hypot(dx, dy);\n\t\t\t\t\tif (\n\t\t\t\t\t\tprevious.inside &&\n\t\t\t\t\t\tpoint.inside &&\n\t\t\t\t\t\tdurationMs <= clickMaxDurationMs &&\n\t\t\t\t\t\tmoveDistance <= clickMaxMovePx\n\t\t\t\t\t) {\n\t\t\t\t\t\tclickCounterRef.current += 1;\n\t\t\t\t\t\tconst click: PointerClick = {\n\t\t\t\t\t\t\tid: clickCounterRef.current,\n\t\t\t\t\t\t\ttime: getPointerNowSeconds(),\n\t\t\t\t\t\t\tpointerType,\n\t\t\t\t\t\t\tpointerId: event.pointerId,\n\t\t\t\t\t\t\tbutton: previous.button,\n\t\t\t\t\t\t\tmodifiers: {\n\t\t\t\t\t\t\t\talt: event.altKey,\n\t\t\t\t\t\t\t\tctrl: event.ctrlKey,\n\t\t\t\t\t\t\t\tshift: event.shiftKey,\n\t\t\t\t\t\t\t\tmeta: event.metaKey\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tpx: point.px,\n\t\t\t\t\t\t\tuv: point.uv,\n\t\t\t\t\t\t\tndc: point.ndc\n\t\t\t\t\t\t};\n\t\t\t\t\t\tclickRef.current.set(click);\n\t\t\t\t\t\toptionsRef.current.onClick?.(click, nextState, event);\n\t\t\t\t\t\trequestFrame();\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tactivePointerIdRef.current = null;\n\t\t\tdownSnapshotRef.current = null;\n\t\t};\n\n\t\tconst handlePointerUp = (event: PointerEvent): void => {\n\t\t\treleasePointer(event, true);\n\t\t};\n\n\t\tconst handlePointerCancel = (event: PointerEvent): void => {\n\t\t\treleasePointer(event, false);\n\t\t};\n\n\t\tconst handlePointerLeave = (): void => {\n\t\t\tif (activePointerIdRef.current !== null) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst current = stateRef.current.current;\n\t\t\tstateRef.current.set({\n\t\t\t\t...current,\n\t\t\t\tinside: false,\n\t\t\t\ttime: getPointerNowSeconds(),\n\t\t\t\tdeltaPx: [0, 0],\n\t\t\t\tdeltaUv: [0, 0],\n\t\t\t\tvelocityPx: [0, 0],\n\t\t\t\tvelocityUv: [0, 0]\n\t\t\t});\n\t\t\trequestFrame();\n\t\t};\n\n\t\tcanvas.addEventListener('pointerdown', handlePointerDown);\n\t\tcanvas.addEventListener('pointermove', handleMove);\n\t\tcanvas.addEventListener('pointerup', handlePointerUp);\n\t\tcanvas.addEventListener('pointercancel', handlePointerCancel);\n\t\tcanvas.addEventListener('pointerleave', handlePointerLeave);\n\t\tif (optionsRef.current.trackWhilePressedOutsideCanvas ?? true) {\n\t\t\twindow.addEventListener('pointermove', handleWindowMove);\n\t\t\twindow.addEventListener('pointerup', handlePointerUp);\n\t\t\twindow.addEventListener('pointercancel', handlePointerCancel);\n\t\t}\n\n\t\treturn () => {\n\t\t\tcanvas.removeEventListener('pointerdown', handlePointerDown);\n\t\t\tcanvas.removeEventListener('pointermove', handleMove);\n\t\t\tcanvas.removeEventListener('pointerup', handlePointerUp);\n\t\t\tcanvas.removeEventListener('pointercancel', handlePointerCancel);\n\t\t\tcanvas.removeEventListener('pointerleave', handlePointerLeave);\n\t\t\twindow.removeEventListener('pointermove', handleWindowMove);\n\t\t\twindow.removeEventListener('pointerup', handlePointerUp);\n\t\t\twindow.removeEventListener('pointercancel', handlePointerCancel);\n\t\t};\n\t}, [motiongpu, requestFrame, updatePointerState]);\n\n\treturn {\n\t\tstate: stateRef.current,\n\t\tlastClick: clickRef.current,\n\t\tresetClick: useCallback(() => {\n\t\t\tclickRef.current.set(null);\n\t\t}, [])\n\t};\n}\n"],"mappings":"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"}

package/dist/svelte/advanced.js

@@ -7,7 +7,8 @@ import { PingPongComputePass } from "../passes/PingPongComputePass.js";
 import { applySchedulerPreset, captureSchedulerDebugSnapshot } from "../core/scheduler-helpers.js";
 import { useMotionGPU } from "./motiongpu-context.js";
 import { useFrame } from "./frame-context.js";
+import { usePointer } from "./use-pointer.js";
 import { useTexture } from "./use-texture.js";
 import { FragCanvas } from "./index.js";
 import { setMotionGPUUserContext, useMotionGPUUserContext } from "./use-motiongpu-user-context.js";
-export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, applySchedulerPreset, captureSchedulerDebugSnapshot, defineMaterial, setMotionGPUUserContext, useFrame, useMotionGPU, useMotionGPUUserContext, useTexture };
+export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, applySchedulerPreset, captureSchedulerDebugSnapshot, defineMaterial, setMotionGPUUserContext, useFrame, useMotionGPU, useMotionGPUUserContext, usePointer, useTexture };

package/dist/svelte/index.d.ts

@@ -6,12 +6,14 @@ export { defineMaterial } from '../core/material.js';
 export { BlitPass, CopyPass, ShaderPass, ComputePass, PingPongComputePass } from '../passes/index.js';
 export { useMotionGPU } from './motiongpu-context.js';
 export { useFrame } from './frame-context.js';
+export { usePointer } from './use-pointer.js';
 export { useTexture } from './use-texture.js';
 export type { FrameInvalidationToken, FrameState, OutputColorSpace, AnyPass, ComputePassLike, RenderPass, RenderPassContext, RenderPassFlags, RenderPassInputSlot, RenderPassOutputSlot, RenderMode, RenderTarget, RenderTargetDefinition, RenderTargetDefinitionMap, TextureData, TextureDefinition, TextureDefinitionMap, TextureUpdateMode, TextureMap, TextureSource, TextureValue, TypedUniform, UniformMat4Value, UniformMap, UniformType, UniformValue } from '../core/types.js';
 export type { LoadedTexture, TextureDecodeOptions, TextureLoadOptions } from '../core/texture-loader.js';
 export type { FragMaterial, FragMaterialInput, MaterialIncludes, MaterialDefineValue, MaterialDefines, TypedMaterialDefineValue } from '../core/material.js';
 export type { MotionGPUContext } from './motiongpu-context.js';
 export type { UseFrameOptions, UseFrameResult } from './frame-context.js';
+export type { PointerClick, PointerFrameRequestMode, PointerKind, PointerPoint, PointerState, UsePointerOptions, UsePointerResult } from './use-pointer.js';
 export type { TextureUrlInput, UseTextureResult } from './use-texture.js';
 export type { StorageBufferAccess, StorageBufferDefinition, StorageBufferDefinitionMap, StorageBufferType, ComputePassContext } from '../core/types.js';
 export type { ComputePassOptions, ComputeDispatchContext } from '../passes/ComputePass.js';

package/dist/svelte/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/svelte/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACX,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/svelte/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACX,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EACX,YAAY,EACZ,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/svelte/index.js

@@ -7,6 +7,7 @@ import { PingPongComputePass } from "../passes/PingPongComputePass.js";
 import "../passes/index.js";
 import { useMotionGPU } from "./motiongpu-context.js";
 import { useFrame } from "./frame-context.js";
+import { usePointer } from "./use-pointer.js";
 import { useTexture } from "./use-texture.js";
 import FragCanvas from "./FragCanvas.svelte";
-export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, defineMaterial, useFrame, useMotionGPU, useTexture };
+export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, defineMaterial, useFrame, useMotionGPU, usePointer, useTexture };

package/dist/svelte/use-pointer.d.ts

@@ -0,0 +1,94 @@
+import { type CurrentReadable } from '../core/current-value.js';
+import { type PointerClick, type PointerFrameRequestMode, type PointerState } from '../core/pointer.js';
+export type { PointerClick, PointerFrameRequestMode, PointerKind, PointerPoint, PointerState } from '../core/pointer.js';
+/**
+ * Configuration for pointer input handling in `usePointer`.
+ */
+export interface UsePointerOptions {
+    /**
+     * Enables pointer listeners.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Frame wake-up strategy for pointer-driven state changes.
+     *
+     * @default 'auto'
+     */
+    requestFrame?: PointerFrameRequestMode;
+    /**
+     * Requests pointer capture on pointer down.
+     *
+     * @default true
+     */
+    capturePointer?: boolean;
+    /**
+     * Tracks pointer move/up outside canvas while pointer is pressed.
+     *
+     * @default true
+     */
+    trackWhilePressedOutsideCanvas?: boolean;
+    /**
+     * Enables click/tap synthesis on pointer up.
+     *
+     * @default true
+     */
+    clickEnabled?: boolean;
+    /**
+     * Maximum press duration to consider pointer up a click (milliseconds).
+     *
+     * @default 350
+     */
+    clickMaxDurationMs?: number;
+    /**
+     * Maximum pointer travel from down to up to consider pointer up a click (pixels).
+     *
+     * @default 8
+     */
+    clickMaxMovePx?: number;
+    /**
+     * Allowed pointer buttons for click synthesis.
+     *
+     * @default [0]
+     */
+    clickButtons?: number[];
+    /**
+     * Called after pointer move state update.
+     */
+    onMove?: (state: PointerState, event: PointerEvent) => void;
+    /**
+     * Called after pointer down state update.
+     */
+    onDown?: (state: PointerState, event: PointerEvent) => void;
+    /**
+     * Called after pointer up/cancel state update.
+     */
+    onUp?: (state: PointerState, event: PointerEvent) => void;
+    /**
+     * Called when click/tap is synthesized.
+     */
+    onClick?: (click: PointerClick, state: PointerState, event: PointerEvent) => void;
+}
+/**
+ * Reactive state returned by `usePointer`.
+ */
+export interface UsePointerResult {
+    /**
+     * Current pointer state.
+     */
+    state: CurrentReadable<PointerState>;
+    /**
+     * Last synthesized click/tap event.
+     */
+    lastClick: CurrentReadable<PointerClick | null>;
+    /**
+     * Clears last click snapshot.
+     */
+    resetClick: () => void;
+}
+/**
+ * Tracks normalized pointer coordinates and click/tap snapshots for the active `FragCanvas`.
+ */
+export declare function usePointer(options?: UsePointerOptions): UsePointerResult;
+//# sourceMappingURL=use-pointer.d.ts.map

package/dist/svelte/use-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pointer.d.ts","sourceRoot":"","sources":["../../src/lib/svelte/use-pointer.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAMN,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAEjB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACX,YAAY,EACZ,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5D;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5D;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1D;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAClF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IACrC;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACvB;AA0CD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA6V5E"}