@zag-js/utils 1.14.0 → 1.15.1

package/dist/index.d.mts

@@ -9,6 +9,7 @@ declare const remove: <T>(v: T[], ...items: T[]) => T[];
 declare const removeAt: <T>(v: T[], i: number) => T[];
 declare const insertAt: <T>(v: T[], i: number, ...items: T[]) => T[];
 declare const uniq: <T>(v: T[]) => T[];
+declare const diff: <T>(a: T[], b: T[]) => T[];
 declare const addOrRemove: <T>(v: T[], item: T) => T[];
 declare function clear<T>(v: T[]): T[];
 type IndexOptions = {
@@ -113,4 +114,4 @@ declare function ensure<T>(c: T | null | undefined, m: () => string): asserts c
 type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
 declare function ensureProps<T, K extends keyof T>(props: T, keys: K[], scope?: string): asserts props is T & RequiredBy<T, K>;
 
-export { type IndexOptions, type MaybeFunction, type Nullable, type RafIntervalOptions, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, debounce, decrementValue, ensure, ensureProps, first, flatArray, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, identity, incrementValue, insertAt, invariant, isArray, isBoolean, isDev, isEmpty, isEqual, isFunction, isNaN, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString, isValueAtMax, isValueAtMin, isValueWithinRange, json, last, match, mod, nan, next, nextIndex, noop, omit, pick, prev, prevIndex, remove, removeAt, roundToDpr, roundToStepPrecision, roundValue, runIfFn, setRafInterval, setRafTimeout, setValueAtIndex, snapValueToStep, splitProps, throttle, toArray, toFixedNumber, toPx, tryCatch, uniq, uuid, warn, wrap };
+export { type IndexOptions, type MaybeFunction, type Nullable, type RafIntervalOptions, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, debounce, decrementValue, diff, ensure, ensureProps, first, flatArray, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, identity, incrementValue, insertAt, invariant, isArray, isBoolean, isDev, isEmpty, isEqual, isFunction, isNaN, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString, isValueAtMax, isValueAtMin, isValueWithinRange, json, last, match, mod, nan, next, nextIndex, noop, omit, pick, prev, prevIndex, remove, removeAt, roundToDpr, roundToStepPrecision, roundValue, runIfFn, setRafInterval, setRafTimeout, setValueAtIndex, snapValueToStep, splitProps, throttle, toArray, toFixedNumber, toPx, tryCatch, uniq, uuid, warn, wrap };

package/dist/index.d.ts

@@ -9,6 +9,7 @@ declare const remove: <T>(v: T[], ...items: T[]) => T[];
 declare const removeAt: <T>(v: T[], i: number) => T[];
 declare const insertAt: <T>(v: T[], i: number, ...items: T[]) => T[];
 declare const uniq: <T>(v: T[]) => T[];
+declare const diff: <T>(a: T[], b: T[]) => T[];
 declare const addOrRemove: <T>(v: T[], item: T) => T[];
 declare function clear<T>(v: T[]): T[];
 type IndexOptions = {
@@ -113,4 +114,4 @@ declare function ensure<T>(c: T | null | undefined, m: () => string): asserts c
 type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
 declare function ensureProps<T, K extends keyof T>(props: T, keys: K[], scope?: string): asserts props is T & RequiredBy<T, K>;
 
-export { type IndexOptions, type MaybeFunction, type Nullable, type RafIntervalOptions, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, debounce, decrementValue, ensure, ensureProps, first, flatArray, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, identity, incrementValue, insertAt, invariant, isArray, isBoolean, isDev, isEmpty, isEqual, isFunction, isNaN, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString, isValueAtMax, isValueAtMin, isValueWithinRange, json, last, match, mod, nan, next, nextIndex, noop, omit, pick, prev, prevIndex, remove, removeAt, roundToDpr, roundToStepPrecision, roundValue, runIfFn, setRafInterval, setRafTimeout, setValueAtIndex, snapValueToStep, splitProps, throttle, toArray, toFixedNumber, toPx, tryCatch, uniq, uuid, warn, wrap };
+export { type IndexOptions, type MaybeFunction, type Nullable, type RafIntervalOptions, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, debounce, decrementValue, diff, ensure, ensureProps, first, flatArray, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, identity, incrementValue, insertAt, invariant, isArray, isBoolean, isDev, isEmpty, isEqual, isFunction, isNaN, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString, isValueAtMax, isValueAtMin, isValueWithinRange, json, last, match, mod, nan, next, nextIndex, noop, omit, pick, prev, prevIndex, remove, removeAt, roundToDpr, roundToStepPrecision, roundValue, runIfFn, setRafInterval, setRafTimeout, setValueAtIndex, snapValueToStep, splitProps, throttle, toArray, toFixedNumber, toPx, tryCatch, uniq, uuid, warn, wrap };

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/array.ts
 function toArray(v) {
-  if (!v) return [];
+  if (v == null) return [];
   return Array.isArray(v) ? v : [v];
 }
 var fromLength = (length) => Array.from(Array(length).keys());
@@ -15,6 +15,10 @@ var remove = (v, ...items) => v.filter((t) => !items.includes(t));
 var removeAt = (v, i) => v.filter((_, idx) => idx !== i);
 var insertAt = (v, i, ...items) => [...v.slice(0, i), ...items, ...v.slice(i)];
 var uniq = (v) => Array.from(new Set(v));
+var diff = (a, b) => {
+  const set = new Set(b);
+  return a.filter((t) => !set.has(t));
+};
 var addOrRemove = (v, item) => {
   if (has(v, item)) return remove(v, item);
   return add(v, item);
@@ -221,23 +225,19 @@ var roundToStepPrecision = (v, step) => {
 };
 var roundToDpr = (v, dpr) => typeof dpr === "number" ? floor(v * dpr + 0.5) / dpr : round(v);
 var snapValueToStep = (v, vmin, vmax, step) => {
-  vmin = Number(vmin);
-  vmax = Number(vmax);
-  let remainder = (v - (isNaN(vmin) ? 0 : vmin)) % step;
-  let sv = roundToStepPrecision(
-    abs(remainder) * 2 >= step ? v + sign(remainder) * (step - abs(remainder)) : v - remainder,
-    step
-  );
-  if (!isNaN(vmin)) {
-    if (sv < vmin) {
-      sv = vmin;
-    } else if (!isNaN(vmax) && sv > vmax) {
-      sv = vmin + floor(roundToStepPrecision((vmax - vmin) / step, step)) * step;
-    }
-  } else if (!isNaN(vmax) && sv > vmax) {
-    sv = vmin + floor(roundToStepPrecision((vmax - vmin) / step, step)) * step;
+  const min2 = vmin != null ? Number(vmin) : 0;
+  const max2 = Number(vmax);
+  const remainder = (v - min2) % step;
+  let snapped = abs(remainder) * 2 >= step ? v + sign(remainder) * (step - abs(remainder)) : v - remainder;
+  snapped = roundToStepPrecision(snapped, step);
+  if (!isNaN(min2) && snapped < min2) {
+    snapped = min2;
+  } else if (!isNaN(max2) && snapped > max2) {
+    const stepsInRange = floor((max2 - min2) / step);
+    const largestValidStep = min2 + stepsInRange * step;
+    snapped = stepsInRange <= 0 || largestValidStep < min2 ? max2 : largestValidStep;
   }
-  return roundToStepPrecision(sv, step);
+  return roundToStepPrecision(snapped, step);
 };
 var setValueAtIndex = (vs, i, v) => {
   if (vs[i] === v) return vs;
@@ -427,6 +427,7 @@ exports.compact = compact;
 exports.createSplitProps = createSplitProps;
 exports.debounce = debounce;
 exports.decrementValue = decrementValue;
+exports.diff = diff;
 exports.ensure = ensure;
 exports.ensureProps = ensureProps;
 exports.first = first;

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // src/array.ts
 function toArray(v) {
-  if (!v) return [];
+  if (v == null) return [];
   return Array.isArray(v) ? v : [v];
 }
 var fromLength = (length) => Array.from(Array(length).keys());
@@ -13,6 +13,10 @@ var remove = (v, ...items) => v.filter((t) => !items.includes(t));
 var removeAt = (v, i) => v.filter((_, idx) => idx !== i);
 var insertAt = (v, i, ...items) => [...v.slice(0, i), ...items, ...v.slice(i)];
 var uniq = (v) => Array.from(new Set(v));
+var diff = (a, b) => {
+  const set = new Set(b);
+  return a.filter((t) => !set.has(t));
+};
 var addOrRemove = (v, item) => {
   if (has(v, item)) return remove(v, item);
   return add(v, item);
@@ -219,23 +223,19 @@ var roundToStepPrecision = (v, step) => {
 };
 var roundToDpr = (v, dpr) => typeof dpr === "number" ? floor(v * dpr + 0.5) / dpr : round(v);
 var snapValueToStep = (v, vmin, vmax, step) => {
-  vmin = Number(vmin);
-  vmax = Number(vmax);
-  let remainder = (v - (isNaN(vmin) ? 0 : vmin)) % step;
-  let sv = roundToStepPrecision(
-    abs(remainder) * 2 >= step ? v + sign(remainder) * (step - abs(remainder)) : v - remainder,
-    step
-  );
-  if (!isNaN(vmin)) {
-    if (sv < vmin) {
-      sv = vmin;
-    } else if (!isNaN(vmax) && sv > vmax) {
-      sv = vmin + floor(roundToStepPrecision((vmax - vmin) / step, step)) * step;
-    }
-  } else if (!isNaN(vmax) && sv > vmax) {
-    sv = vmin + floor(roundToStepPrecision((vmax - vmin) / step, step)) * step;
+  const min2 = vmin != null ? Number(vmin) : 0;
+  const max2 = Number(vmax);
+  const remainder = (v - min2) % step;
+  let snapped = abs(remainder) * 2 >= step ? v + sign(remainder) * (step - abs(remainder)) : v - remainder;
+  snapped = roundToStepPrecision(snapped, step);
+  if (!isNaN(min2) && snapped < min2) {
+    snapped = min2;
+  } else if (!isNaN(max2) && snapped > max2) {
+    const stepsInRange = floor((max2 - min2) / step);
+    const largestValidStep = min2 + stepsInRange * step;
+    snapped = stepsInRange <= 0 || largestValidStep < min2 ? max2 : largestValidStep;
   }
-  return roundToStepPrecision(sv, step);
+  return roundToStepPrecision(snapped, step);
 };
 var setValueAtIndex = (vs, i, v) => {
   if (vs[i] === v) return vs;
@@ -413,4 +413,4 @@ function ensureProps(props, keys, scope) {
     throw new Error(`[zag-js${scope ? ` > ${scope}` : ""}] missing required props: ${missingKeys.join(", ")}`);
 }
 
-export { add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, debounce, decrementValue, ensure, ensureProps, first, flatArray, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, identity, incrementValue, insertAt, invariant, isArray, isBoolean, isDev, isEmpty, isEqual, isFunction, isNaN, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString, isValueAtMax, isValueAtMin, isValueWithinRange, json, last, match, mod, nan, next, nextIndex, noop, omit, pick, prev, prevIndex, remove, removeAt, roundToDpr, roundToStepPrecision, roundValue, runIfFn, setRafInterval, setRafTimeout, setValueAtIndex, snapValueToStep, splitProps, throttle, toArray, toFixedNumber, toPx, tryCatch, uniq, uuid, warn, wrap };
+export { add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, debounce, decrementValue, diff, ensure, ensureProps, first, flatArray, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, identity, incrementValue, insertAt, invariant, isArray, isBoolean, isDev, isEmpty, isEqual, isFunction, isNaN, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString, isValueAtMax, isValueAtMin, isValueWithinRange, json, last, match, mod, nan, next, nextIndex, noop, omit, pick, prev, prevIndex, remove, removeAt, roundToDpr, roundToStepPrecision, roundValue, runIfFn, setRafInterval, setRafTimeout, setValueAtIndex, snapValueToStep, splitProps, throttle, toArray, toFixedNumber, toPx, tryCatch, uniq, uuid, warn, wrap };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/utils",
-  "version": "1.14.0",
+  "version": "1.15.1",
   "description": "",
   "keywords": [
     "js",