@zag-js/utils 0.82.1 → 1.0.0

package/dist/index.d.mts

@@ -20,6 +20,7 @@ declare function next<T>(v: T[], idx: number, opts?: IndexOptions): T | undefine
 declare function prevIndex<T>(v: T[], idx: number, opts?: IndexOptions): number;
 declare function prev<T>(v: T[], index: number, opts?: IndexOptions): T | undefined;
 declare const chunk: <T>(v: T[], size: number) => T[][];
+declare function flatArray<T>(arr: T[]): T[];
 
 declare const isEqual: (a: any, b: any) => boolean;
 
@@ -27,11 +28,13 @@ type MaybeFunction<T> = T | (() => T);
 type Nullable<T> = T | null | undefined;
 declare const runIfFn: <T>(v: T | undefined, ...a: T extends (...a: any[]) => void ? Parameters<T> : never) => T extends (...a: any[]) => void ? NonNullable<ReturnType<T>> : NonNullable<T>;
 declare const cast: <T>(v: unknown) => T;
+declare const identity: (v: VoidFunction) => void;
 declare const noop: () => void;
 declare const callAll: <T extends (...a: any[]) => void>(...fns: (T | undefined)[]) => (...a: Parameters<T>) => void;
 declare const uuid: () => string;
 declare function match<V extends string | number = string, R = unknown>(key: V, record: Record<V, R | ((...args: any[]) => R)>, ...args: any[]): R;
 declare const tryCatch: <R>(fn: () => R, fallback: () => R) => R;
+declare function throttle<T extends (...args: any[]) => void>(fn: T, wait?: number): T;
 
 type AnyFunction = (...args: any[]) => any;
 declare const isDev: () => boolean;
@@ -93,9 +96,12 @@ declare function splitProps<T extends Dict>(props: T, keys: (keyof T)[]): Dict[]
 declare const createSplitProps: <T extends Dict>(keys: (keyof T)[]) => <Props extends T>(props: Props) => [T, Omit<Props, keyof T>];
 declare function omit<T extends Record<string, any>>(obj: T, keys: string[]): Omit<T, string | number>;
 
+declare function setRafInterval(callback: () => void, interval: number): () => void;
+declare function setRafTimeout(callback: () => void, delay: number): () => void;
+
 declare function warn(m: string): void;
 declare function warn(c: boolean, m: string): void;
 declare function invariant(m: string): void;
 declare function invariant(c: boolean, m: string): void;
 
-export { type IndexOptions, type MaybeFunction, type Nullable, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, decrementValue, first, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, 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, setValueAtIndex, snapValueToStep, splitProps, toArray, toFixedNumber, tryCatch, uniq, uuid, warn, wrap };
+export { type IndexOptions, type MaybeFunction, type Nullable, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, decrementValue, 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, tryCatch, uniq, uuid, warn, wrap };

package/dist/index.d.ts

@@ -20,6 +20,7 @@ declare function next<T>(v: T[], idx: number, opts?: IndexOptions): T | undefine
 declare function prevIndex<T>(v: T[], idx: number, opts?: IndexOptions): number;
 declare function prev<T>(v: T[], index: number, opts?: IndexOptions): T | undefined;
 declare const chunk: <T>(v: T[], size: number) => T[][];
+declare function flatArray<T>(arr: T[]): T[];
 
 declare const isEqual: (a: any, b: any) => boolean;
 
@@ -27,11 +28,13 @@ type MaybeFunction<T> = T | (() => T);
 type Nullable<T> = T | null | undefined;
 declare const runIfFn: <T>(v: T | undefined, ...a: T extends (...a: any[]) => void ? Parameters<T> : never) => T extends (...a: any[]) => void ? NonNullable<ReturnType<T>> : NonNullable<T>;
 declare const cast: <T>(v: unknown) => T;
+declare const identity: (v: VoidFunction) => void;
 declare const noop: () => void;
 declare const callAll: <T extends (...a: any[]) => void>(...fns: (T | undefined)[]) => (...a: Parameters<T>) => void;
 declare const uuid: () => string;
 declare function match<V extends string | number = string, R = unknown>(key: V, record: Record<V, R | ((...args: any[]) => R)>, ...args: any[]): R;
 declare const tryCatch: <R>(fn: () => R, fallback: () => R) => R;
+declare function throttle<T extends (...args: any[]) => void>(fn: T, wait?: number): T;
 
 type AnyFunction = (...args: any[]) => any;
 declare const isDev: () => boolean;
@@ -93,9 +96,12 @@ declare function splitProps<T extends Dict>(props: T, keys: (keyof T)[]): Dict[]
 declare const createSplitProps: <T extends Dict>(keys: (keyof T)[]) => <Props extends T>(props: Props) => [T, Omit<Props, keyof T>];
 declare function omit<T extends Record<string, any>>(obj: T, keys: string[]): Omit<T, string | number>;
 
+declare function setRafInterval(callback: () => void, interval: number): () => void;
+declare function setRafTimeout(callback: () => void, delay: number): () => void;
+
 declare function warn(m: string): void;
 declare function warn(c: boolean, m: string): void;
 declare function invariant(m: string): void;
 declare function invariant(c: boolean, m: string): void;
 
-export { type IndexOptions, type MaybeFunction, type Nullable, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, decrementValue, first, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, 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, setValueAtIndex, snapValueToStep, splitProps, toArray, toFixedNumber, tryCatch, uniq, uuid, warn, wrap };
+export { type IndexOptions, type MaybeFunction, type Nullable, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, decrementValue, 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, tryCatch, uniq, uuid, warn, wrap };

package/dist/index.js

@@ -51,6 +51,14 @@ var chunk = (v, size) => {
     return rows;
   }, res);
 };
+function flatArray(arr) {
+  return arr.reduce((flat, item) => {
+    if (Array.isArray(item)) {
+      return flat.concat(flatArray(item));
+    }
+    return flat.concat(item);
+  }, []);
+}
 
 // src/equal.ts
 var isArrayLike = (value) => value?.constructor.name === "Array";
@@ -93,6 +101,7 @@ var runIfFn = (v, ...a) => {
   return res ?? void 0;
 };
 var cast = (v) => v;
+var identity = (v) => v();
 var noop = () => {
 };
 var callAll = (...fns) => (...a) => {
@@ -126,6 +135,28 @@ var tryCatch = (fn, fallback) => {
     return fallback?.();
   }
 };
+function throttle(fn, wait = 0) {
+  let lastCall = 0;
+  let timeout = null;
+  return (...args) => {
+    const now = Date.now();
+    const timeSinceLastCall = now - lastCall;
+    if (timeSinceLastCall >= wait) {
+      if (timeout) {
+        clearTimeout(timeout);
+        timeout = null;
+      }
+      fn(...args);
+      lastCall = now;
+    } else if (!timeout) {
+      timeout = setTimeout(() => {
+        fn(...args);
+        lastCall = Date.now();
+        timeout = null;
+      }, wait - timeSinceLastCall);
+    }
+  };
+}
 
 // src/guard.ts
 var isDev = () => process.env.NODE_ENV !== "production";
@@ -315,6 +346,35 @@ function omit(obj, keys) {
   return createSplitProps(keys)(obj)[1];
 }
 
+// src/timers.ts
+function setRafInterval(callback, interval) {
+  let start = performance.now();
+  let handle;
+  function loop(now) {
+    handle = requestAnimationFrame(loop);
+    const delta = now - start;
+    if (delta >= interval) {
+      start = now - delta % interval;
+      callback();
+    }
+  }
+  handle = requestAnimationFrame(loop);
+  return () => cancelAnimationFrame(handle);
+}
+function setRafTimeout(callback, delay) {
+  const start = performance.now();
+  let handle;
+  function loop(now) {
+    handle = requestAnimationFrame(loop);
+    const delta = now - start;
+    if (delta >= delay) {
+      callback();
+    }
+  }
+  handle = requestAnimationFrame(loop);
+  return () => cancelAnimationFrame(handle);
+}
+
 // src/warning.ts
 function warn(...a) {
   const m = a.length === 1 ? a[0] : a[1];
@@ -343,6 +403,7 @@ exports.compact = compact;
 exports.createSplitProps = createSplitProps;
 exports.decrementValue = decrementValue;
 exports.first = first;
+exports.flatArray = flatArray;
 exports.fromLength = fromLength;
 exports.getClosestValue = getClosestValue;
 exports.getClosestValueIndex = getClosestValueIndex;
@@ -357,6 +418,7 @@ exports.getValueSetterAtIndex = getValueSetterAtIndex;
 exports.getValueTransformer = getValueTransformer;
 exports.has = has;
 exports.hasProp = hasProp;
+exports.identity = identity;
 exports.incrementValue = incrementValue;
 exports.insertAt = insertAt;
 exports.invariant = invariant;
@@ -394,9 +456,12 @@ exports.roundToDpr = roundToDpr;
 exports.roundToStepPrecision = roundToStepPrecision;
 exports.roundValue = roundValue;
 exports.runIfFn = runIfFn;
+exports.setRafInterval = setRafInterval;
+exports.setRafTimeout = setRafTimeout;
 exports.setValueAtIndex = setValueAtIndex;
 exports.snapValueToStep = snapValueToStep;
 exports.splitProps = splitProps;
+exports.throttle = throttle;
 exports.toArray = toArray;
 exports.toFixedNumber = toFixedNumber;
 exports.tryCatch = tryCatch;

package/dist/index.mjs

@@ -49,6 +49,14 @@ var chunk = (v, size) => {
     return rows;
   }, res);
 };
+function flatArray(arr) {
+  return arr.reduce((flat, item) => {
+    if (Array.isArray(item)) {
+      return flat.concat(flatArray(item));
+    }
+    return flat.concat(item);
+  }, []);
+}
 
 // src/equal.ts
 var isArrayLike = (value) => value?.constructor.name === "Array";
@@ -91,6 +99,7 @@ var runIfFn = (v, ...a) => {
   return res ?? void 0;
 };
 var cast = (v) => v;
+var identity = (v) => v();
 var noop = () => {
 };
 var callAll = (...fns) => (...a) => {
@@ -124,6 +133,28 @@ var tryCatch = (fn, fallback) => {
     return fallback?.();
   }
 };
+function throttle(fn, wait = 0) {
+  let lastCall = 0;
+  let timeout = null;
+  return (...args) => {
+    const now = Date.now();
+    const timeSinceLastCall = now - lastCall;
+    if (timeSinceLastCall >= wait) {
+      if (timeout) {
+        clearTimeout(timeout);
+        timeout = null;
+      }
+      fn(...args);
+      lastCall = now;
+    } else if (!timeout) {
+      timeout = setTimeout(() => {
+        fn(...args);
+        lastCall = Date.now();
+        timeout = null;
+      }, wait - timeSinceLastCall);
+    }
+  };
+}
 
 // src/guard.ts
 var isDev = () => process.env.NODE_ENV !== "production";
@@ -313,6 +344,35 @@ function omit(obj, keys) {
   return createSplitProps(keys)(obj)[1];
 }
 
+// src/timers.ts
+function setRafInterval(callback, interval) {
+  let start = performance.now();
+  let handle;
+  function loop(now) {
+    handle = requestAnimationFrame(loop);
+    const delta = now - start;
+    if (delta >= interval) {
+      start = now - delta % interval;
+      callback();
+    }
+  }
+  handle = requestAnimationFrame(loop);
+  return () => cancelAnimationFrame(handle);
+}
+function setRafTimeout(callback, delay) {
+  const start = performance.now();
+  let handle;
+  function loop(now) {
+    handle = requestAnimationFrame(loop);
+    const delta = now - start;
+    if (delta >= delay) {
+      callback();
+    }
+  }
+  handle = requestAnimationFrame(loop);
+  return () => cancelAnimationFrame(handle);
+}
+
 // src/warning.ts
 function warn(...a) {
   const m = a.length === 1 ? a[0] : a[1];
@@ -329,4 +389,4 @@ function invariant(...a) {
   }
 }
 
-export { add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, decrementValue, first, fromLength, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, has, hasProp, 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, setValueAtIndex, snapValueToStep, splitProps, toArray, toFixedNumber, tryCatch, uniq, uuid, warn, wrap };
+export { add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, decrementValue, 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, tryCatch, uniq, uuid, warn, wrap };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/utils",
-  "version": "0.82.1",
+  "version": "1.0.0",
   "description": "",
   "keywords": [
     "js",
@@ -30,9 +30,14 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     },
     "./package.json": "./package.json"
   },