@zag-js/utils 2.0.0-next.0 → 2.0.0-next.2

package/dist/equal.js

@@ -23,36 +23,22 @@ __export(equal_exports, {
   isEqual: () => isEqual
 });
 module.exports = __toCommonJS(equal_exports);
-var isArrayLike = (value) => value?.constructor.name === "Array";
-var isArrayEqual = (a, b) => {
-  if (a.length !== b.length) return false;
-  for (let i = 0; i < a.length; i++) {
-    if (!isEqual(a[i], b[i])) return false;
-  }
-  return true;
-};
+var hasOwn = Object.prototype.hasOwnProperty;
 var isEqual = (a, b) => {
   if (Object.is(a, b)) return true;
-  if (a == null && b != null || a != null && b == null) return false;
-  if (typeof a?.isEqual === "function" && typeof b?.isEqual === "function") {
-    return a.isEqual(b);
-  }
-  if (typeof a === "function" && typeof b === "function") {
-    return a.toString() === b.toString();
-  }
-  if (isArrayLike(a) && isArrayLike(b)) {
-    return isArrayEqual(Array.from(a), Array.from(b));
-  }
-  if (!(typeof a === "object") || !(typeof b === "object")) return false;
-  const keys = Object.keys(b ?? /* @__PURE__ */ Object.create(null));
-  const length = keys.length;
-  for (let i = 0; i < length; i++) {
-    const hasKey = Reflect.has(a, keys[i]);
-    if (!hasKey) return false;
+  if (a == null || b == null) return false;
+  if (typeof a.isEqual === "function" && typeof b.isEqual === "function") return a.isEqual(b);
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) if (!isEqual(a[i], b[i])) return false;
+    return true;
   }
-  for (let i = 0; i < length; i++) {
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  const keys = Object.keys(b);
+  if (Object.keys(a).length !== keys.length) return false;
+  for (let i = 0; i < keys.length; i++) {
     const key = keys[i];
-    if (!isEqual(a[key], b[key])) return false;
+    if (!hasOwn.call(a, key) || !isEqual(a[key], b[key])) return false;
   }
   return true;
 };

package/dist/equal.mjs

@@ -1,36 +1,22 @@
 import "./chunk-MXGZDBDQ.mjs";
 
 // src/equal.ts
-var isArrayLike = (value) => value?.constructor.name === "Array";
-var isArrayEqual = (a, b) => {
-  if (a.length !== b.length) return false;
-  for (let i = 0; i < a.length; i++) {
-    if (!isEqual(a[i], b[i])) return false;
-  }
-  return true;
-};
+var hasOwn = Object.prototype.hasOwnProperty;
 var isEqual = (a, b) => {
   if (Object.is(a, b)) return true;
-  if (a == null && b != null || a != null && b == null) return false;
-  if (typeof a?.isEqual === "function" && typeof b?.isEqual === "function") {
-    return a.isEqual(b);
-  }
-  if (typeof a === "function" && typeof b === "function") {
-    return a.toString() === b.toString();
-  }
-  if (isArrayLike(a) && isArrayLike(b)) {
-    return isArrayEqual(Array.from(a), Array.from(b));
-  }
-  if (!(typeof a === "object") || !(typeof b === "object")) return false;
-  const keys = Object.keys(b ?? /* @__PURE__ */ Object.create(null));
-  const length = keys.length;
-  for (let i = 0; i < length; i++) {
-    const hasKey = Reflect.has(a, keys[i]);
-    if (!hasKey) return false;
+  if (a == null || b == null) return false;
+  if (typeof a.isEqual === "function" && typeof b.isEqual === "function") return a.isEqual(b);
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) if (!isEqual(a[i], b[i])) return false;
+    return true;
   }
-  for (let i = 0; i < length; i++) {
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  const keys = Object.keys(b);
+  if (Object.keys(a).length !== keys.length) return false;
+  for (let i = 0; i < keys.length; i++) {
     const key = keys[i];
-    if (!isEqual(a[key], b[key])) return false;
+    if (!hasOwn.call(a, key) || !isEqual(a[key], b[key])) return false;
   }
   return true;
 };

package/dist/index.d.mts

@@ -2,8 +2,9 @@ export { IndexOptions, add, addOrRemove, chunk, clear, diff, first, flatArray, f
 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 { Teardown, TeardownReason } from './lifecycle.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

@@ -2,8 +2,9 @@ export { IndexOptions, add, addOrRemove, chunk, clear, diff, first, flatArray, f
 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 { Teardown, TeardownReason } from './lifecycle.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/index.js

@@ -21,6 +21,7 @@ __reExport(index_exports, require("./array.js"), module.exports);
 __reExport(index_exports, require("./equal.js"), module.exports);
 __reExport(index_exports, require("./functions.js"), module.exports);
 __reExport(index_exports, require("./guard.js"), module.exports);
+__reExport(index_exports, require("./lifecycle.js"), module.exports);
 __reExport(index_exports, require("./number.js"), module.exports);
 __reExport(index_exports, require("./object.js"), module.exports);
 __reExport(index_exports, require("./store.js"), module.exports);
@@ -32,6 +33,7 @@ __reExport(index_exports, require("./warning.js"), module.exports);
   ...require("./equal.js"),
   ...require("./functions.js"),
   ...require("./guard.js"),
+  ...require("./lifecycle.js"),
   ...require("./number.js"),
   ...require("./object.js"),
   ...require("./store.js"),

package/dist/index.mjs

@@ -3,6 +3,7 @@ export * from "./array.mjs";
 export * from "./equal.mjs";
 export * from "./functions.mjs";
 export * from "./guard.mjs";
+export * from "./lifecycle.mjs";
 export * from "./number.mjs";
 export * from "./object.mjs";
 export * from "./store.mjs";

package/dist/lifecycle.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Why a cleanup is running: its inputs changed and it will be set up again, or it is being torn
+ * down for good. Lets a cleanup release resources gently on a restart, and fully on an exit.
+ */
+type TeardownReason = "restart" | "exit";
+/** A cleanup that may inspect why it was called. A plain `VoidFunction` is still valid. */
+type Teardown = (reason: TeardownReason) => void;
+
+export type { Teardown, TeardownReason };

package/dist/lifecycle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Why a cleanup is running: its inputs changed and it will be set up again, or it is being torn
+ * down for good. Lets a cleanup release resources gently on a restart, and fully on an exit.
+ */
+type TeardownReason = "restart" | "exit";
+/** A cleanup that may inspect why it was called. A plain `VoidFunction` is still valid. */
+type Teardown = (reason: TeardownReason) => void;
+
+export type { Teardown, TeardownReason };

package/dist/lifecycle.js

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lifecycle.ts
+var lifecycle_exports = {};
+module.exports = __toCommonJS(lifecycle_exports);

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": "2.0.0-next.0",
+  "version": "2.0.0-next.2",
   "description": "",
   "keywords": [
     "js",
@@ -10,7 +10,10 @@
   "author": "Segun Adebayo <sage@adebayosegun.com>",
   "homepage": "https://github.com/chakra-ui/zag#readme",
   "license": "MIT",
-  "repository": "https://github.com/chakra-ui/zag/tree/main/packages/utilities/core",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chakra-ui/zag/tree/main/packages/utilities/core"
+  },
   "sideEffects": false,
   "files": [
     "dist"
@@ -43,7 +46,7 @@
   },
   "scripts": {
     "build": "tsup",
-    "lint": "eslint src",
+    "lint": "oxlint src",
     "typecheck": "tsc --noEmit"
   }
 }