@zag-js/utils 1.43.0 → 1.43.2

package/dist/index.d.mts

@@ -3,7 +3,7 @@ export { isEqual } from './equal.mjs';
 export { MaybeFunction, Nullable, callAll, cast, debounce, hash, identity, match, noop, runIfFn, throttle, tryCatch, uuid } from './functions.mjs';
 export { hasProp, isArray, isBoolean, isDev, isFunction, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString } from './guard.mjs';
 export { clampPercent, clampValue, decrementValue, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, incrementValue, isNaN, isValueAtMax, isValueAtMin, isValueWithinRange, mod, nan, roundToDpr, roundToStepPrecision, roundValue, setValueAtIndex, snapValueToStep, toFixedNumber, toPx, wrap } from './number.mjs';
-export { compact, createSplitProps, json, keys, omit, pick, splitProps } from './object.mjs';
+export { MergeWithDefault, compact, createSplitProps, json, keys, mergeWithDefault, omit, pick, splitProps } from './object.mjs';
 export { Store, StoreCompareFn, StoreListener, createStore } from './store.mjs';
 export { Timer, TimerBaseContext, TimerContextFn, setRafInterval, setRafTimeout } from './timers.mjs';
 export { ensure, ensureProps, invariant, warn } from './warning.mjs';

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { isEqual } from './equal.js';
 export { MaybeFunction, Nullable, callAll, cast, debounce, hash, identity, match, noop, runIfFn, throttle, tryCatch, uuid } from './functions.js';
 export { hasProp, isArray, isBoolean, isDev, isFunction, isNull, isNumber, isObject, isObjectLike, isPlainObject, isString } from './guard.js';
 export { clampPercent, clampValue, decrementValue, getClosestValue, getClosestValueIndex, getMaxValueAtIndex, getMinValueAtIndex, getNextStepValue, getPercentValue, getPreviousStepValue, getValuePercent, getValueRanges, getValueSetterAtIndex, getValueTransformer, incrementValue, isNaN, isValueAtMax, isValueAtMin, isValueWithinRange, mod, nan, roundToDpr, roundToStepPrecision, roundValue, setValueAtIndex, snapValueToStep, toFixedNumber, toPx, wrap } from './number.js';
-export { compact, createSplitProps, json, keys, omit, pick, splitProps } from './object.js';
+export { MergeWithDefault, compact, createSplitProps, json, keys, mergeWithDefault, omit, pick, splitProps } from './object.js';
 export { Store, StoreCompareFn, StoreListener, createStore } from './store.js';
 export { Timer, TimerBaseContext, TimerContextFn, setRafInterval, setRafTimeout } from './timers.js';
 export { ensure, ensureProps, invariant, warn } from './warning.js';

package/dist/object.d.mts

@@ -6,5 +6,12 @@ type Dict = Record<string | symbol, any>;
 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 Defined<T> = {
+    [K in keyof T]-?: Exclude<T[K], undefined>;
+};
+type MergeWithDefault<D, O = unknown> = Defined<D> & ([NonNullable<O>] extends [never] ? unknown : Omit<NonNullable<O>, keyof D>);
+declare function mergeWithDefault<D extends object, O extends {
+    [K in keyof D]?: D[K] | undefined;
+} | undefined>(defaults: D, overrides?: O): MergeWithDefault<D, O>;
 
-export { compact, createSplitProps, json, keys, omit, pick, splitProps };
+export { type MergeWithDefault, compact, createSplitProps, json, keys, mergeWithDefault, omit, pick, splitProps };

package/dist/object.d.ts

@@ -6,5 +6,12 @@ type Dict = Record<string | symbol, any>;
 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 Defined<T> = {
+    [K in keyof T]-?: Exclude<T[K], undefined>;
+};
+type MergeWithDefault<D, O = unknown> = Defined<D> & ([NonNullable<O>] extends [never] ? unknown : Omit<NonNullable<O>, keyof D>);
+declare function mergeWithDefault<D extends object, O extends {
+    [K in keyof D]?: D[K] | undefined;
+} | undefined>(defaults: D, overrides?: O): MergeWithDefault<D, O>;
 
-export { compact, createSplitProps, json, keys, omit, pick, splitProps };
+export { type MergeWithDefault, compact, createSplitProps, json, keys, mergeWithDefault, omit, pick, splitProps };

package/dist/object.js

@@ -24,6 +24,7 @@ __export(object_exports, {
   createSplitProps: () => createSplitProps,
   json: () => json,
   keys: () => keys,
+  mergeWithDefault: () => mergeWithDefault,
   omit: () => omit,
   pick: () => pick,
   splitProps: () => splitProps
@@ -76,12 +77,23 @@ var createSplitProps = (keys2) => {
 function omit(obj, keys2) {
   return createSplitProps(keys2)(obj)[1];
 }
+function mergeWithDefault(defaults, overrides) {
+  if (!overrides) return defaults;
+  const result = { ...defaults };
+  const source = overrides;
+  for (const key in source) {
+    const value = source[key];
+    if (value !== void 0) result[key] = value;
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   compact,
   createSplitProps,
   json,
   keys,
+  mergeWithDefault,
   omit,
   pick,
   splitProps

package/dist/object.mjs

@@ -48,11 +48,22 @@ var createSplitProps = (keys2) => {
 function omit(obj, keys2) {
   return createSplitProps(keys2)(obj)[1];
 }
+function mergeWithDefault(defaults, overrides) {
+  if (!overrides) return defaults;
+  const result = { ...defaults };
+  const source = overrides;
+  for (const key in source) {
+    const value = source[key];
+    if (value !== void 0) result[key] = value;
+  }
+  return result;
+}
 export {
   compact,
   createSplitProps,
   json,
   keys,
+  mergeWithDefault,
   omit,
   pick,
   splitProps

package/package.json

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