@zag-js/utils 1.21.9 → 1.22.0

package/dist/index.d.mts

@@ -100,6 +100,17 @@ 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>;
 
+type StoreListener = VoidFunction;
+type StoreCompareFn<T> = (a: T, b: T) => boolean;
+declare function createStore<T extends Record<string, any>>(initialState: T, compare?: StoreCompareFn<T>): Store<T>;
+interface Store<T extends Record<string, any>> {
+    subscribe: (listener: StoreListener) => () => void;
+    get: <K extends keyof T>(key: K) => T[K];
+    set: <K extends keyof T>(key: K, value: T[K]) => void;
+    update: (updates: Partial<T>) => void;
+    snapshot: () => T;
+}
+
 interface RafIntervalOptions {
     startMs: number;
     deltaMs: number;
@@ -115,4 +126,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, 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, partition, 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, type Store, type StoreCompareFn, type StoreListener, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, createStore, 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, partition, 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

@@ -100,6 +100,17 @@ 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>;
 
+type StoreListener = VoidFunction;
+type StoreCompareFn<T> = (a: T, b: T) => boolean;
+declare function createStore<T extends Record<string, any>>(initialState: T, compare?: StoreCompareFn<T>): Store<T>;
+interface Store<T extends Record<string, any>> {
+    subscribe: (listener: StoreListener) => () => void;
+    get: <K extends keyof T>(key: K) => T[K];
+    set: <K extends keyof T>(key: K, value: T[K]) => void;
+    update: (updates: Partial<T>) => void;
+    snapshot: () => T;
+}
+
 interface RafIntervalOptions {
     startMs: number;
     deltaMs: number;
@@ -115,4 +126,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, 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, partition, 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, type Store, type StoreCompareFn, type StoreListener, add, addOrRemove, callAll, cast, chunk, clampPercent, clampValue, clear, compact, createSplitProps, createStore, 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, partition, 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

@@ -370,6 +370,49 @@ function omit(obj, keys) {
   return createSplitProps(keys)(obj)[1];
 }
 
+// src/store.ts
+function createStore(initialState, compare = Object.is) {
+  let state = { ...initialState };
+  const listeners = /* @__PURE__ */ new Set();
+  const subscribe = (listener) => {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  };
+  const publish = () => {
+    listeners.forEach((listener) => listener());
+  };
+  const get = (key) => {
+    return state[key];
+  };
+  const set = (key, value) => {
+    if (!compare(state[key], value)) {
+      state[key] = value;
+      publish();
+    }
+  };
+  const update = (updates) => {
+    let hasChanges = false;
+    for (const key in updates) {
+      const value = updates[key];
+      if (value !== void 0 && !compare(state[key], value)) {
+        state[key] = value;
+        hasChanges = true;
+      }
+    }
+    if (hasChanges) {
+      publish();
+    }
+  };
+  const snapshot = () => ({ ...state });
+  return {
+    subscribe,
+    get,
+    set,
+    update,
+    snapshot
+  };
+}
+
 // src/timers.ts
 function setRafInterval(callback, interval) {
   let start = performance.now();
@@ -437,6 +480,7 @@ exports.clampValue = clampValue;
 exports.clear = clear;
 exports.compact = compact;
 exports.createSplitProps = createSplitProps;
+exports.createStore = createStore;
 exports.debounce = debounce;
 exports.decrementValue = decrementValue;
 exports.diff = diff;

package/dist/index.mjs

@@ -368,6 +368,49 @@ function omit(obj, keys) {
   return createSplitProps(keys)(obj)[1];
 }
 
+// src/store.ts
+function createStore(initialState, compare = Object.is) {
+  let state = { ...initialState };
+  const listeners = /* @__PURE__ */ new Set();
+  const subscribe = (listener) => {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  };
+  const publish = () => {
+    listeners.forEach((listener) => listener());
+  };
+  const get = (key) => {
+    return state[key];
+  };
+  const set = (key, value) => {
+    if (!compare(state[key], value)) {
+      state[key] = value;
+      publish();
+    }
+  };
+  const update = (updates) => {
+    let hasChanges = false;
+    for (const key in updates) {
+      const value = updates[key];
+      if (value !== void 0 && !compare(state[key], value)) {
+        state[key] = value;
+        hasChanges = true;
+      }
+    }
+    if (hasChanges) {
+      publish();
+    }
+  };
+  const snapshot = () => ({ ...state });
+  return {
+    subscribe,
+    get,
+    set,
+    update,
+    snapshot
+  };
+}
+
 // src/timers.ts
 function setRafInterval(callback, interval) {
   let start = performance.now();
@@ -425,4 +468,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, 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, partition, 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, createStore, 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, partition, 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.21.9",
+  "version": "1.22.0",
   "description": "",
   "keywords": [
     "js",