@breadstone/mosaik-elements-foundation 0.1.50 → 0.1.52

package/Utilities/SnapEngine.js

@@ -0,0 +1,121 @@
+// #region Imports
+import { CssLength } from '@breadstone/mosaik-themes';
+import { clamp } from '../Extensions/NumberExtensions';
+/**
+ * Resolves a CSS length against a viewport extent.
+ *
+ * @internal
+ * @param value - The CSS length to resolve.
+ * @param viewportSize - The relevant viewport extent in CSS pixels.
+ * @param measure - Optional resolver for CSS units that require DOM measurement.
+ * @returns The resolved extent in CSS pixels.
+ */
+export function resolveSnapLength(value, viewportSize, measure) {
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (CssLength.isPercentage(value)
+        || value.endsWith('vh')
+        || value.endsWith('svh')
+        || value.endsWith('lvh')
+        || value.endsWith('dvh')) {
+        return viewportSize * CssLength.extractValue(value) / 100;
+    }
+    if (value.endsWith('px')) {
+        return CssLength.extractValue(value);
+    }
+    return measure?.(value) ?? CssLength.extractValue(value);
+}
+/**
+ * Resolves, clamps, sorts and de-duplicates snap values.
+ *
+ * @internal
+ * @param snaps - The configured snap values.
+ * @param contentSnap - The value that represents the measured content extent.
+ * @param viewportSize - The relevant viewport extent in CSS pixels.
+ * @param contentSize - The measured content extent in CSS pixels.
+ * @param maxExtent - The maximum legal visible extent in CSS pixels.
+ * @param measure - Optional resolver for CSS units that require DOM measurement.
+ * @returns The resolved snaps sorted from the smallest to the largest extent.
+ */
+export function resolveSnaps(snaps, contentSnap, viewportSize, contentSize, maxExtent, measure) {
+    const source = snaps.length > 0 ? snaps : [maxExtent];
+    const resolved = source.map((snap, index) => ({
+        index,
+        snap,
+        value: clamp(snap === contentSnap
+            ? contentSize
+            : resolveSnapLength(snap, viewportSize, measure), 0, maxExtent)
+    }));
+    resolved.sort((first, second) => first.value - second.value);
+    return resolved.filter((entry, index) => index === 0 || Math.abs(entry.value - resolved[index - 1].value) > 0.5);
+}
+/**
+ * Applies logarithmic resistance outside a legal range.
+ *
+ * @internal
+ * @param value - The requested value.
+ * @param min - The minimum legal value.
+ * @param max - The maximum legal value.
+ * @param elastic - Whether resistance instead of hard clamping is enabled.
+ * @returns The resisted or clamped value.
+ */
+export function applyElasticity(value, min, max, elastic) {
+    if (value >= min && value <= max) {
+        return value;
+    }
+    if (!elastic) {
+        return clamp(value, min, max);
+    }
+    const boundary = value < min ? min : max;
+    const distance = Math.abs(value - boundary);
+    const direction = value < min ? -1 : 1;
+    return boundary + direction * Math.log1p(distance) * 5;
+}
+/**
+ * Selects the landing snap for a released gesture.
+ *
+ * @internal
+ * @param position - The visible extent when the pointer is released.
+ * @param velocity - The signed opening velocity in CSS pixels per millisecond.
+ * @param snaps - The available resolved snaps.
+ * @param maxExtent - The maximum legal visible extent.
+ * @param closeThreshold - The close threshold as a fraction of `maxExtent`.
+ * @param inertia - Whether velocity is projected into the landing decision.
+ * @returns The close decision and resolved landing snap index.
+ */
+export function selectSnap(position, velocity, snaps, maxExtent, closeThreshold, inertia) {
+    if (snaps.length === 0) {
+        return { close: position <= maxExtent * closeThreshold, snapIndex: 0 };
+    }
+    if (velocity < -1.5) {
+        return { close: true, snapIndex: -1 };
+    }
+    const projected = inertia ? position + velocity * 180 : position;
+    if (projected <= maxExtent * closeThreshold) {
+        return { close: true, snapIndex: -1 };
+    }
+    let nearest = 0;
+    let distance = Number.POSITIVE_INFINITY;
+    for (let index = 0; index < snaps.length; index++) {
+        const nextDistance = Math.abs(snaps[index].value - projected);
+        if (nextDistance < distance) {
+            nearest = index;
+            distance = nextDistance;
+        }
+    }
+    return { close: false, snapIndex: nearest };
+}
+/**
+ * Converts vertical pointer movement into signed visible-extent movement.
+ *
+ * @internal
+ * @param edge - The viewport edge from which the surface opens.
+ * @param startY - The initial pointer position.
+ * @param currentY - The current pointer position.
+ * @returns A positive opening delta or negative closing delta.
+ */
+export function verticalPointerDelta(edge, startY, currentY) {
+    return edge === 'bottom' ? startY - currentY : currentY - startY;
+}
+//# sourceMappingURL=SnapEngine.js.map

package/Utilities/SnapEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapEngine.js","sourceRoot":"","sources":["../../src/Utilities/SnapEngine.ts"],"names":[],"mappings":"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"}