@unrulysystems/native-motion-core 0.1.0-alpha.0

package/dist/gesture/directionLock.cjs

@@ -0,0 +1,25 @@
+"use strict";
+// REQ-GESTURE-025 — direction-lock pure math (R15 D4).
+// Pin: VisualElementDragControls.getCurrentDirection (lockThreshold = 10, y preferred).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIRECTION_LOCK_THRESHOLD_PX = void 0;
+exports.resolveDirectionLockAxis = resolveDirectionLockAxis;
+/** Pin lock threshold in px — never hand-tuned (REQ-GESTURE-025). */
+exports.DIRECTION_LOCK_THRESHOLD_PX = 10;
+/**
+ * Resolve the first drag axis once |offset| exceeds the pin threshold.
+ * Prefers `y` when both exceed (pin order). Returns null below threshold.
+ */
+function resolveDirectionLockAxis(offsetX, offsetY, threshold = exports.DIRECTION_LOCK_THRESHOLD_PX) {
+    if (!(threshold >= 0) || !Number.isFinite(threshold)) {
+        throw new Error(`direction-lock threshold must be a finite non-negative number, got ${String(threshold)} (REQ-GESTURE-025).`);
+    }
+    if (!Number.isFinite(offsetX) || !Number.isFinite(offsetY)) {
+        throw new Error(`direction-lock offsets must be finite numbers (REQ-GESTURE-025).`);
+    }
+    if (Math.abs(offsetY) > threshold)
+        return 'y';
+    if (Math.abs(offsetX) > threshold)
+        return 'x';
+    return null;
+}

package/dist/gesture/directionLock.d.cts

@@ -0,0 +1,8 @@
+import type { DragAxis } from "./dragConfig.cjs";
+/** Pin lock threshold in px — never hand-tuned (REQ-GESTURE-025). */
+export declare const DIRECTION_LOCK_THRESHOLD_PX = 10;
+/**
+ * Resolve the first drag axis once |offset| exceeds the pin threshold.
+ * Prefers `y` when both exceed (pin order). Returns null below threshold.
+ */
+export declare function resolveDirectionLockAxis(offsetX: number, offsetY: number, threshold?: number): DragAxis | null;

package/dist/gesture/directionLock.d.ts

@@ -0,0 +1,8 @@
+import type { DragAxis } from "./dragConfig.js";
+/** Pin lock threshold in px — never hand-tuned (REQ-GESTURE-025). */
+export declare const DIRECTION_LOCK_THRESHOLD_PX = 10;
+/**
+ * Resolve the first drag axis once |offset| exceeds the pin threshold.
+ * Prefers `y` when both exceed (pin order). Returns null below threshold.
+ */
+export declare function resolveDirectionLockAxis(offsetX: number, offsetY: number, threshold?: number): DragAxis | null;

package/dist/gesture/directionLock.js

@@ -0,0 +1,21 @@
+// REQ-GESTURE-025 — direction-lock pure math (R15 D4).
+// Pin: VisualElementDragControls.getCurrentDirection (lockThreshold = 10, y preferred).
+/** Pin lock threshold in px — never hand-tuned (REQ-GESTURE-025). */
+export const DIRECTION_LOCK_THRESHOLD_PX = 10;
+/**
+ * Resolve the first drag axis once |offset| exceeds the pin threshold.
+ * Prefers `y` when both exceed (pin order). Returns null below threshold.
+ */
+export function resolveDirectionLockAxis(offsetX, offsetY, threshold = DIRECTION_LOCK_THRESHOLD_PX) {
+    if (!(threshold >= 0) || !Number.isFinite(threshold)) {
+        throw new Error(`direction-lock threshold must be a finite non-negative number, got ${String(threshold)} (REQ-GESTURE-025).`);
+    }
+    if (!Number.isFinite(offsetX) || !Number.isFinite(offsetY)) {
+        throw new Error(`direction-lock offsets must be finite numbers (REQ-GESTURE-025).`);
+    }
+    if (Math.abs(offsetY) > threshold)
+        return 'y';
+    if (Math.abs(offsetX) > threshold)
+        return 'x';
+    return null;
+}