@art-suite/art-core-ts-compare 0.0.11 → 0.1.1

package/dist/index.cjs

@@ -1,140 +1,166 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _art_suite_art_core_ts_types = require("@art-suite/art-core-ts-types");
+//#region src/compare.ts
+const compareArrays = (a, b) => {
+	const minLength = Math.min(a.length, b.length);
+	for (let i = 0; i < minLength; i++) {
+		const result = compare(a[i], b[i]);
+		if (result !== 0) return result;
+	}
+	return a.length - b.length;
 };
-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;
+/**
+* Compares two plain objects. If the keys are different, the two key sets are sorted and compared as arrays of strings.
+* If the keys are the same, the values are compared recursively.
+* @param a - The first object to compare
+* @param b - The second object to compare
+* @returns A number indicating the comparison result
+*/
+const comparePlainObjects = (a, b) => {
+	let differentKeys = false;
+	let leastDifferentKey;
+	let leastDifferentKeyResult = 0;
+	for (const key in a) if (!(key in b)) differentKeys = true;
+	else {
+		const result = compare(a[key], b[key]);
+		if (result !== 0) {
+			if (!leastDifferentKey || leastDifferentKey > key) {
+				leastDifferentKey = key;
+				leastDifferentKeyResult = result;
+			}
+		}
+	}
+	if (!differentKeys) {
+		for (const key in b) if (!(key in a)) {
+			differentKeys = true;
+			break;
+		}
+	}
+	if (differentKeys) return compareArrays(Object.keys(a), Object.keys(b));
+	return leastDifferentKeyResult;
 };
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  compare: () => compare,
-  eq: () => eq,
-  gt: () => gt,
-  gte: () => gte,
-  lt: () => lt,
-  lte: () => lte,
-  neq: () => neq
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/compare.ts
-var import_art_core_ts_types = require("@art-suite/art-core-ts-types");
-var compareArrays = (a, b) => {
-  const minLength = Math.min(a.length, b.length);
-  for (let i = 0; i < minLength; i++) {
-    const result = compare(a[i], b[i]);
-    if (result !== 0) return result;
-  }
-  return a.length - b.length;
-};
-var comparePlainObjects = (a, b) => {
-  let differentKeys = false;
-  let leastDifferentKey;
-  let leastDifferentKeyResult = 0;
-  for (const key in a) {
-    if (!(key in b)) differentKeys = true;
-    else {
-      const result = compare(a[key], b[key]);
-      if (result !== 0) {
-        if (!leastDifferentKey || leastDifferentKey > key) {
-          leastDifferentKey = key;
-          leastDifferentKeyResult = result;
-        }
-      }
-    }
-  }
-  if (!differentKeys) {
-    for (const key in b) {
-      if (!(key in a)) {
-        differentKeys = true;
-        break;
-      }
-    }
-  }
-  if (differentKeys) {
-    return compareArrays(Object.keys(a), Object.keys(b));
-  }
-  return leastDifferentKeyResult;
-};
-var compareCustomComparableHelper = (a, b) => {
-  if (a !== null && a !== void 0 && typeof a === "object") {
-    if ((0, import_art_core_ts_types.isFunction)(a.compare)) return a.compare(b);
-    if ((0, import_art_core_ts_types.isFunction)(a.eq) && a?.eq(b)) return 0;
-    if ((0, import_art_core_ts_types.isFunction)(a.lt) && a?.lt(b)) return -1;
-    if ((0, import_art_core_ts_types.isFunction)(a.gt) && a?.gt(b)) return 1;
-    if ((0, import_art_core_ts_types.isFunction)(a.lte) && a?.lte(b)) return -1;
-    if ((0, import_art_core_ts_types.isFunction)(a.gte) && a?.gte(b)) return 1;
-  }
-  return NaN;
+const compareCustomComparableHelper = (a, b) => {
+	if (a !== null && a !== void 0 && typeof a === "object") {
+		if ((0, _art_suite_art_core_ts_types.isFunction)(a.compare)) return a.compare(b);
+		if ((0, _art_suite_art_core_ts_types.isFunction)(a.eq) && a?.eq(b)) return 0;
+		if ((0, _art_suite_art_core_ts_types.isFunction)(a.lt) && a?.lt(b)) return -1;
+		if ((0, _art_suite_art_core_ts_types.isFunction)(a.gt) && a?.gt(b)) return 1;
+		if ((0, _art_suite_art_core_ts_types.isFunction)(a.lte) && a?.lte(b)) return -1;
+		if ((0, _art_suite_art_core_ts_types.isFunction)(a.gte) && a?.gte(b)) return 1;
+	}
+	return NaN;
 };
-var compareCustomComparable = (a, b) => {
-  const customResult = compareCustomComparableHelper(a, b);
-  if (!Number.isNaN(customResult)) return customResult;
-  return -compareCustomComparableHelper(b, a);
+const compareCustomComparable = (a, b) => {
+	const customResult = compareCustomComparableHelper(a, b);
+	if (!Number.isNaN(customResult)) return customResult;
+	return -compareCustomComparableHelper(b, a);
 };
-var comparePrimitives = (a, b) => {
-  if (a === null && b === null) return 0;
-  if (a === null) return -1;
-  if (b === null) return 1;
-  if (a === void 0 && b === void 0) return 0;
-  if (a === void 0) return 1;
-  if (b === void 0) return -1;
-  if (Number.isNaN(a) && Number.isNaN(b)) return 0;
-  if (Number.isNaN(a)) return -1;
-  if (Number.isNaN(b)) return 1;
-  if (typeof a === "number" && typeof b === "number") {
-    return a - b;
-  }
-  if (typeof a === "string" && typeof b === "string") {
-    return a.localeCompare(b);
-  }
-  if (typeof a === "boolean" && typeof b === "boolean") {
-    return Number(a) - Number(b);
-  }
-  if (typeof a !== typeof b) return NaN;
-  return NaN;
+const comparePrimitives = (a, b) => {
+	if (a === null && b === null) return 0;
+	if (a === null) return -1;
+	if (b === null) return 1;
+	if (a === void 0 && b === void 0) return 0;
+	if (a === void 0) return 1;
+	if (b === void 0) return -1;
+	if (Number.isNaN(a) && Number.isNaN(b)) return 0;
+	if (Number.isNaN(a)) return -1;
+	if (Number.isNaN(b)) return 1;
+	if (typeof a === "number" && typeof b === "number") return a - b;
+	if (typeof a === "string" && typeof b === "string") return a.localeCompare(b);
+	if (typeof a === "boolean" && typeof b === "boolean") return Number(a) - Number(b);
+	if (typeof a !== typeof b) return NaN;
+	return NaN;
 };
-var compare = (a, b) => {
-  if (a === b) return 0;
-  const customResult = compareCustomComparable(a, b);
-  if (!Number.isNaN(customResult)) return customResult;
-  if ((0, import_art_core_ts_types.isArray)(a) && (0, import_art_core_ts_types.isArray)(b)) {
-    return compareArrays(a, b);
-  }
-  if ((0, import_art_core_ts_types.isPlainObject)(a) && (0, import_art_core_ts_types.isPlainObject)(b)) {
-    return comparePlainObjects(a, b);
-  }
-  return comparePrimitives(a, b);
+/**
+* deep structural comparison
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns A number indicating the comparison result:
+*   - **< 0**: `a` is less than `b`
+*   - **== 0**: `a` is equal to `b` (deep structural equality)
+*   - **> 0**: `a` is greater than `b`
+*   - **NaN**: Values cannot be compared (incompatible types or custom comparison failed)
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const compare = (a, b) => {
+	if (a === b) return 0;
+	const customResult = compareCustomComparable(a, b);
+	if (!Number.isNaN(customResult)) return customResult;
+	if ((0, _art_suite_art_core_ts_types.isArray)(a) && (0, _art_suite_art_core_ts_types.isArray)(b)) return compareArrays(a, b);
+	if ((0, _art_suite_art_core_ts_types.isPlainObject)(a) && (0, _art_suite_art_core_ts_types.isPlainObject)(b)) return comparePlainObjects(a, b);
+	return comparePrimitives(a, b);
 };
+//#endregion
+//#region src/equality.ts
+/**
+* deep structural == test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if the values are deeply equal (compare returns 0), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const eq = (a, b) => compare(a, b) === 0;
+/**
+* deep structural != test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if the values are not deeply equal (compare returns non-zero), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const neq = (a, b) => compare(a, b) !== 0;
+/**
+* deep structural < test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is less than `b` (compare returns negative), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const lt = (a, b) => compare(a, b) < 0;
+/**
+* deep structural > test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is greater than `b` (compare returns positive), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const gt = (a, b) => compare(a, b) > 0;
+/**
+* deep structural <= test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is less than or equal to `b` (compare returns negative or zero), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const lte = (a, b) => compare(a, b) <= 0;
+/**
+* deep structural >= test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is greater than or equal to `b` (compare returns positive or zero), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const gte = (a, b) => compare(a, b) >= 0;
+//#endregion
+exports.compare = compare;
+exports.eq = eq;
+exports.gt = gt;
+exports.gte = gte;
+exports.lt = lt;
+exports.lte = lte;
+exports.neq = neq;
 
-// src/equality.ts
-var eq = (a, b) => compare(a, b) === 0;
-var neq = (a, b) => compare(a, b) !== 0;
-var lt = (a, b) => compare(a, b) < 0;
-var gt = (a, b) => compare(a, b) > 0;
-var lte = (a, b) => compare(a, b) <= 0;
-var gte = (a, b) => compare(a, b) >= 0;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  compare,
-  eq,
-  gt,
-  gte,
-  lt,
-  lte,
-  neq
-});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/compare.ts","../src/equality.ts"],"sourcesContent":["export * from './compare'\nexport * from './equality'","import { isArray, isPlainObject, isFunction } from '@art-suite/art-core-ts-types'\nimport { objectKeyCount } from '@art-suite/art-core-ts-containers'\n\nexport interface CustomComparableInterface {\n\n  /**\n   * Compares `this` with `b`\n   * @param b - The value to compare `this` with\n   * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`\n   */\n  compare(b: any): number\n}\n\nexport interface CustomEqualityInterface {\n  /**\n   * Checks if `this` equals `b`\n   * @param b - The value to compare `this` with\n   * @returns true if equal, false otherwise\n   */\n  eq(b: any): boolean\n}\n\nexport interface CustomInequalityInterface extends CustomEqualityInterface {\n  /**\n   * Checks if `this` is not equal to `b`\n   * @param b - The value to compare `this` with\n   * @returns true if not equal, false otherwise\n   */\n  lt(b: any): boolean\n  gt(b: any): boolean\n  lte(b: any): boolean\n  gte(b: any): boolean\n}\n\nconst compareArrays = (a: any[], b: any[]): number => {\n  const minLength = Math.min(a.length, b.length)\n\n  for (let i = 0; i < minLength; i++) {\n    const result = compare(a[i], b[i])\n    if (result !== 0) return result\n  }\n\n  return a.length - b.length\n}\n\n/**\n * Compares two plain objects. If the keys are different, the two key sets are sorted and compared as arrays of strings.\n * If the keys are the same, the values are compared recursively.\n * @param a - The first object to compare\n * @param b - The second object to compare\n * @returns A number indicating the comparison result\n */\nconst comparePlainObjects = (a: Record<string, any>, b: Record<string, any>): number => {\n  // Create a merged list of all unique keys and sort it\n  // const allKeys = [...new Set([...Object.keys(a), ...Object.keys(b)])].sort()\n\n  // Compare values for keys in A that are also in B\n  let differentKeys = false\n  let leastDifferentKey: string | undefined\n  let leastDifferentKeyResult: number = 0\n  for (const key in a) {\n    if (!(key in b)) differentKeys = true;\n    else {\n      // Both have the key, compare their values\n      const result = compare(a[key], b[key])\n      if (result !== 0) {\n        if (!leastDifferentKey || leastDifferentKey > key) {\n          leastDifferentKey = key\n          leastDifferentKeyResult = result\n        }\n      }\n    }\n  }\n\n  // if B had all As keys, we need to check if B has any keys that A doesn't have\n  if (!differentKeys) {\n    for (const key in b) {\n      if (!(key in a)) { differentKeys = true; break }\n    }\n  }\n\n  // if the keys are different, compare the keys\n  if (differentKeys) {\n    return compareArrays(Object.keys(a), Object.keys(b))\n  }\n\n  return leastDifferentKeyResult // All keys and values are equal\n}\n\nconst compareCustomComparableHelper = (a: any, b: any): number => {\n  // Only check for custom methods if a is not null/undefined and is an object\n  if (a !== null && a !== undefined && typeof a === 'object') {\n    // Check if left operand supports any of the custom methods (highest priority)\n    if (isFunction(a.compare)) return a.compare(b);\n    if (isFunction(a.eq) && a?.eq(b)) return 0;\n    if (isFunction(a.lt) && a?.lt(b)) return -1;\n    if (isFunction(a.gt) && a?.gt(b)) return 1;\n    if (isFunction(a.lte) && a?.lte(b)) return -1;\n    if (isFunction(a.gte) && a?.gte(b)) return 1;\n  }\n  return NaN\n}\n\nconst compareCustomComparable = (a: any, b: any): number => {\n  const customResult = compareCustomComparableHelper(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n  return -compareCustomComparableHelper(b, a)\n}\n\nconst comparePrimitives = (a: any, b: any): number => {\n  // Handle null\n  if (a === null && b === null) return 0\n  if (a === null) return -1\n  if (b === null) return 1\n\n  // Handle undefined\n  if (a === undefined && b === undefined) return 0\n  if (a === undefined) return 1\n  if (b === undefined) return -1\n\n  // Handle NaN\n  if (Number.isNaN(a) && Number.isNaN(b)) return 0\n  if (Number.isNaN(a)) return -1\n  if (Number.isNaN(b)) return 1\n\n  // Handle numbers - use subtraction for efficiency\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a - b\n  }\n\n  // Handle strings - use localeCompare for proper string comparison\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b)\n  }\n\n  // Handle booleans - convert to numbers for comparison\n  if (typeof a === 'boolean' && typeof b === 'boolean') {\n    return Number(a) - Number(b)\n  }\n\n  // Return NaN for different types or incompatible comparisons\n  if (typeof a !== typeof b) return NaN\n\n  // For same types that aren't numbers, strings, or booleans, return NaN\n  return NaN\n}\n\n/**\n * deep structural comparison\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns A number indicating the comparison result:\n *   - **< 0**: `a` is less than `b`\n *   - **== 0**: `a` is equal to `b` (deep structural equality)\n *   - **> 0**: `a` is greater than `b`\n *   - **NaN**: Values cannot be compared (incompatible types or custom comparison failed)\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const compare = (a: any, b: any): number => {\n  if (a === b) return 0;\n  // Handle custom comparable first\n  const customResult = compareCustomComparable(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n\n  // Handle arrays\n  if (isArray(a) && isArray(b)) {\n    return compareArrays(a, b)\n  }\n\n  // Handle plain objects\n  if (isPlainObject(a) && isPlainObject(b)) {\n    return comparePlainObjects(a, b)\n  }\n\n  // Handle primitives\n  return comparePrimitives(a, b)\n}","import { compare } from './compare'\n\n/**\n * deep structural == test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are deeply equal (compare returns 0), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const eq = (a: any, b: any): boolean => compare(a, b) === 0;\n\n/**\n * deep structural != test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are not deeply equal (compare returns non-zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const neq = (a: any, b: any): boolean => compare(a, b) !== 0;\n\n/**\n * deep structural < test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than `b` (compare returns negative), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lt = (a: any, b: any): boolean => compare(a, b) < 0;\n\n/**\n * deep structural > test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than `b` (compare returns positive), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gt = (a: any, b: any): boolean => compare(a, b) > 0;\n\n/**\n * deep structural <= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than or equal to `b` (compare returns negative or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lte = (a: any, b: any): boolean => compare(a, b) <= 0;\n\n/**\n * deep structural >= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than or equal to `b` (compare returns positive or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gte = (a: any, b: any): boolean => compare(a, b) >= 0;\n"],"mappings":"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","names":[]}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/compare.ts","../src/equality.ts"],"sourcesContent":["import { isArray, isPlainObject, isFunction } from '@art-suite/art-core-ts-types'\nimport { objectKeyCount } from '@art-suite/art-core-ts-containers'\n\nexport interface CustomComparableInterface {\n\n  /**\n   * Compares `this` with `b`\n   * @param b - The value to compare `this` with\n   * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`\n   */\n  compare(b: any): number\n}\n\nexport interface CustomEqualityInterface {\n  /**\n   * Checks if `this` equals `b`\n   * @param b - The value to compare `this` with\n   * @returns true if equal, false otherwise\n   */\n  eq(b: any): boolean\n}\n\nexport interface CustomInequalityInterface extends CustomEqualityInterface {\n  /**\n   * Checks if `this` is not equal to `b`\n   * @param b - The value to compare `this` with\n   * @returns true if not equal, false otherwise\n   */\n  lt(b: any): boolean\n  gt(b: any): boolean\n  lte(b: any): boolean\n  gte(b: any): boolean\n}\n\nconst compareArrays = (a: any[], b: any[]): number => {\n  const minLength = Math.min(a.length, b.length)\n\n  for (let i = 0; i < minLength; i++) {\n    const result = compare(a[i], b[i])\n    if (result !== 0) return result\n  }\n\n  return a.length - b.length\n}\n\n/**\n * Compares two plain objects. If the keys are different, the two key sets are sorted and compared as arrays of strings.\n * If the keys are the same, the values are compared recursively.\n * @param a - The first object to compare\n * @param b - The second object to compare\n * @returns A number indicating the comparison result\n */\nconst comparePlainObjects = (a: Record<string, any>, b: Record<string, any>): number => {\n  // Create a merged list of all unique keys and sort it\n  // const allKeys = [...new Set([...Object.keys(a), ...Object.keys(b)])].sort()\n\n  // Compare values for keys in A that are also in B\n  let differentKeys = false\n  let leastDifferentKey: string | undefined\n  let leastDifferentKeyResult: number = 0\n  for (const key in a) {\n    if (!(key in b)) differentKeys = true;\n    else {\n      // Both have the key, compare their values\n      const result = compare(a[key], b[key])\n      if (result !== 0) {\n        if (!leastDifferentKey || leastDifferentKey > key) {\n          leastDifferentKey = key\n          leastDifferentKeyResult = result\n        }\n      }\n    }\n  }\n\n  // if B had all As keys, we need to check if B has any keys that A doesn't have\n  if (!differentKeys) {\n    for (const key in b) {\n      if (!(key in a)) { differentKeys = true; break }\n    }\n  }\n\n  // if the keys are different, compare the keys\n  if (differentKeys) {\n    return compareArrays(Object.keys(a), Object.keys(b))\n  }\n\n  return leastDifferentKeyResult // All keys and values are equal\n}\n\nconst compareCustomComparableHelper = (a: any, b: any): number => {\n  // Only check for custom methods if a is not null/undefined and is an object\n  if (a !== null && a !== undefined && typeof a === 'object') {\n    // Check if left operand supports any of the custom methods (highest priority)\n    if (isFunction(a.compare)) return a.compare(b);\n    if (isFunction(a.eq) && a?.eq(b)) return 0;\n    if (isFunction(a.lt) && a?.lt(b)) return -1;\n    if (isFunction(a.gt) && a?.gt(b)) return 1;\n    if (isFunction(a.lte) && a?.lte(b)) return -1;\n    if (isFunction(a.gte) && a?.gte(b)) return 1;\n  }\n  return NaN\n}\n\nconst compareCustomComparable = (a: any, b: any): number => {\n  const customResult = compareCustomComparableHelper(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n  return -compareCustomComparableHelper(b, a)\n}\n\nconst comparePrimitives = (a: any, b: any): number => {\n  // Handle null\n  if (a === null && b === null) return 0\n  if (a === null) return -1\n  if (b === null) return 1\n\n  // Handle undefined\n  if (a === undefined && b === undefined) return 0\n  if (a === undefined) return 1\n  if (b === undefined) return -1\n\n  // Handle NaN\n  if (Number.isNaN(a) && Number.isNaN(b)) return 0\n  if (Number.isNaN(a)) return -1\n  if (Number.isNaN(b)) return 1\n\n  // Handle numbers - use subtraction for efficiency\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a - b\n  }\n\n  // Handle strings - use localeCompare for proper string comparison\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b)\n  }\n\n  // Handle booleans - convert to numbers for comparison\n  if (typeof a === 'boolean' && typeof b === 'boolean') {\n    return Number(a) - Number(b)\n  }\n\n  // Return NaN for different types or incompatible comparisons\n  if (typeof a !== typeof b) return NaN\n\n  // For same types that aren't numbers, strings, or booleans, return NaN\n  return NaN\n}\n\n/**\n * deep structural comparison\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns A number indicating the comparison result:\n *   - **< 0**: `a` is less than `b`\n *   - **== 0**: `a` is equal to `b` (deep structural equality)\n *   - **> 0**: `a` is greater than `b`\n *   - **NaN**: Values cannot be compared (incompatible types or custom comparison failed)\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const compare = (a: any, b: any): number => {\n  if (a === b) return 0;\n  // Handle custom comparable first\n  const customResult = compareCustomComparable(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n\n  // Handle arrays\n  if (isArray(a) && isArray(b)) {\n    return compareArrays(a, b)\n  }\n\n  // Handle plain objects\n  if (isPlainObject(a) && isPlainObject(b)) {\n    return comparePlainObjects(a, b)\n  }\n\n  // Handle primitives\n  return comparePrimitives(a, b)\n}","import { compare } from './compare'\n\n/**\n * deep structural == test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are deeply equal (compare returns 0), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const eq = (a: any, b: any): boolean => compare(a, b) === 0;\n\n/**\n * deep structural != test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are not deeply equal (compare returns non-zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const neq = (a: any, b: any): boolean => compare(a, b) !== 0;\n\n/**\n * deep structural < test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than `b` (compare returns negative), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lt = (a: any, b: any): boolean => compare(a, b) < 0;\n\n/**\n * deep structural > test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than `b` (compare returns positive), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gt = (a: any, b: any): boolean => compare(a, b) > 0;\n\n/**\n * deep structural <= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than or equal to `b` (compare returns negative or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lte = (a: any, b: any): boolean => compare(a, b) <= 0;\n\n/**\n * deep structural >= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than or equal to `b` (compare returns positive or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gte = (a: any, b: any): boolean => compare(a, b) >= 0;\n"],"mappings":";;;AAkCA,MAAM,iBAAiB,GAAU,MAAqB;CACpD,MAAM,YAAY,KAAK,IAAI,EAAE,QAAQ,EAAE,OAAO;AAE9C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,KAAK;EAClC,MAAM,SAAS,QAAQ,EAAE,IAAI,EAAE,GAAG;AAClC,MAAI,WAAW,EAAG,QAAO;;AAG3B,QAAO,EAAE,SAAS,EAAE;;;;;;;;;AAUtB,MAAM,uBAAuB,GAAwB,MAAmC;CAKtF,IAAI,gBAAgB;CACpB,IAAI;CACJ,IAAI,0BAAkC;AACtC,MAAK,MAAM,OAAO,EAChB,KAAI,EAAE,OAAO,GAAI,iBAAgB;MAC5B;EAEH,MAAM,SAAS,QAAQ,EAAE,MAAM,EAAE,KAAK;AACtC,MAAI,WAAW;OACT,CAAC,qBAAqB,oBAAoB,KAAK;AACjD,wBAAoB;AACpB,8BAA0B;;;;AAOlC,KAAI,CAAC;OACE,MAAM,OAAO,EAChB,KAAI,EAAE,OAAO,IAAI;AAAE,mBAAgB;AAAM;;;AAK7C,KAAI,cACF,QAAO,cAAc,OAAO,KAAK,EAAE,EAAE,OAAO,KAAK,EAAE,CAAC;AAGtD,QAAO;;AAGT,MAAM,iCAAiC,GAAQ,MAAmB;AAEhE,KAAI,MAAM,QAAQ,MAAM,KAAA,KAAa,OAAO,MAAM,UAAU;AAE1D,OAAA,GAAA,6BAAA,YAAe,EAAE,QAAQ,CAAE,QAAO,EAAE,QAAQ,EAAE;AAC9C,OAAA,GAAA,6BAAA,YAAe,EAAE,GAAG,IAAI,GAAG,GAAG,EAAE,CAAE,QAAO;AACzC,OAAA,GAAA,6BAAA,YAAe,EAAE,GAAG,IAAI,GAAG,GAAG,EAAE,CAAE,QAAO;AACzC,OAAA,GAAA,6BAAA,YAAe,EAAE,GAAG,IAAI,GAAG,GAAG,EAAE,CAAE,QAAO;AACzC,OAAA,GAAA,6BAAA,YAAe,EAAE,IAAI,IAAI,GAAG,IAAI,EAAE,CAAE,QAAO;AAC3C,OAAA,GAAA,6BAAA,YAAe,EAAE,IAAI,IAAI,GAAG,IAAI,EAAE,CAAE,QAAO;;AAE7C,QAAO;;AAGT,MAAM,2BAA2B,GAAQ,MAAmB;CAC1D,MAAM,eAAe,8BAA8B,GAAG,EAAE;AACxD,KAAI,CAAC,OAAO,MAAM,aAAa,CAAE,QAAO;AACxC,QAAO,CAAC,8BAA8B,GAAG,EAAE;;AAG7C,MAAM,qBAAqB,GAAQ,MAAmB;AAEpD,KAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,KAAI,MAAM,KAAM,QAAO;AACvB,KAAI,MAAM,KAAM,QAAO;AAGvB,KAAI,MAAM,KAAA,KAAa,MAAM,KAAA,EAAW,QAAO;AAC/C,KAAI,MAAM,KAAA,EAAW,QAAO;AAC5B,KAAI,MAAM,KAAA,EAAW,QAAO;AAG5B,KAAI,OAAO,MAAM,EAAE,IAAI,OAAO,MAAM,EAAE,CAAE,QAAO;AAC/C,KAAI,OAAO,MAAM,EAAE,CAAE,QAAO;AAC5B,KAAI,OAAO,MAAM,EAAE,CAAE,QAAO;AAG5B,KAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SACxC,QAAO,IAAI;AAIb,KAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SACxC,QAAO,EAAE,cAAc,EAAE;AAI3B,KAAI,OAAO,MAAM,aAAa,OAAO,MAAM,UACzC,QAAO,OAAO,EAAE,GAAG,OAAO,EAAE;AAI9B,KAAI,OAAO,MAAM,OAAO,EAAG,QAAO;AAGlC,QAAO;;;;;;;;;;;;;;;AAgBT,MAAa,WAAW,GAAQ,MAAmB;AACjD,KAAI,MAAM,EAAG,QAAO;CAEpB,MAAM,eAAe,wBAAwB,GAAG,EAAE;AAClD,KAAI,CAAC,OAAO,MAAM,aAAa,CAAE,QAAO;AAGxC,MAAA,GAAA,6BAAA,SAAY,EAAE,KAAA,GAAA,6BAAA,SAAY,EAAE,CAC1B,QAAO,cAAc,GAAG,EAAE;AAI5B,MAAA,GAAA,6BAAA,eAAkB,EAAE,KAAA,GAAA,6BAAA,eAAkB,EAAE,CACtC,QAAO,oBAAoB,GAAG,EAAE;AAIlC,QAAO,kBAAkB,GAAG,EAAE;;;;;;;;;;;;;ACtKhC,MAAa,MAAM,GAAQ,MAAoB,QAAQ,GAAG,EAAE,KAAK;;;;;;;;;;AAWjE,MAAa,OAAO,GAAQ,MAAoB,QAAQ,GAAG,EAAE,KAAK;;;;;;;;;;AAWlE,MAAa,MAAM,GAAQ,MAAoB,QAAQ,GAAG,EAAE,GAAG;;;;;;;;;;AAW/D,MAAa,MAAM,GAAQ,MAAoB,QAAQ,GAAG,EAAE,GAAG;;;;;;;;;;AAW/D,MAAa,OAAO,GAAQ,MAAoB,QAAQ,GAAG,EAAE,IAAI;;;;;;;;;;AAWjE,MAAa,OAAO,GAAQ,MAAoB,QAAQ,GAAG,EAAE,IAAI"}

package/dist/index.d.cts

@@ -1,29 +1,30 @@
+//#region src/compare.d.ts
 interface CustomComparableInterface {
-    /**
-     * Compares `this` with `b`
-     * @param b - The value to compare `this` with
-     * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`
-     */
-    compare(b: any): number;
+  /**
+   * Compares `this` with `b`
+   * @param b - The value to compare `this` with
+   * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`
+   */
+  compare(b: any): number;
 }
 interface CustomEqualityInterface {
-    /**
-     * Checks if `this` equals `b`
-     * @param b - The value to compare `this` with
-     * @returns true if equal, false otherwise
-     */
-    eq(b: any): boolean;
+  /**
+   * Checks if `this` equals `b`
+   * @param b - The value to compare `this` with
+   * @returns true if equal, false otherwise
+   */
+  eq(b: any): boolean;
 }
 interface CustomInequalityInterface extends CustomEqualityInterface {
-    /**
-     * Checks if `this` is not equal to `b`
-     * @param b - The value to compare `this` with
-     * @returns true if not equal, false otherwise
-     */
-    lt(b: any): boolean;
-    gt(b: any): boolean;
-    lte(b: any): boolean;
-    gte(b: any): boolean;
+  /**
+   * Checks if `this` is not equal to `b`
+   * @param b - The value to compare `this` with
+   * @returns true if not equal, false otherwise
+   */
+  lt(b: any): boolean;
+  gt(b: any): boolean;
+  lte(b: any): boolean;
+  gte(b: any): boolean;
 }
 /**
  * deep structural comparison
@@ -39,7 +40,8 @@ interface CustomInequalityInterface extends CustomEqualityInterface {
  * For more details on comparison behavior, see the art-core-ts-compare README.
  */
 declare const compare: (a: any, b: any) => number;
-
+//#endregion
+//#region src/equality.d.ts
 /**
  * deep structural == test
  *
@@ -100,5 +102,6 @@ declare const lte: (a: any, b: any) => boolean;
  * For more details on comparison behavior, see the art-core-ts-compare README.
  */
 declare const gte: (a: any, b: any) => boolean;
-
-export { type CustomComparableInterface, type CustomEqualityInterface, type CustomInequalityInterface, compare, eq, gt, gte, lt, lte, neq };
+//#endregion
+export { CustomComparableInterface, CustomEqualityInterface, CustomInequalityInterface, compare, eq, gt, gte, lt, lte, neq };
+//# sourceMappingURL=index.d.cts.map

package/dist/{index.d.ts → index.d.mts}

@@ -1,29 +1,30 @@
+//#region src/compare.d.ts
 interface CustomComparableInterface {
-    /**
-     * Compares `this` with `b`
-     * @param b - The value to compare `this` with
-     * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`
-     */
-    compare(b: any): number;
+  /**
+   * Compares `this` with `b`
+   * @param b - The value to compare `this` with
+   * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`
+   */
+  compare(b: any): number;
 }
 interface CustomEqualityInterface {
-    /**
-     * Checks if `this` equals `b`
-     * @param b - The value to compare `this` with
-     * @returns true if equal, false otherwise
-     */
-    eq(b: any): boolean;
+  /**
+   * Checks if `this` equals `b`
+   * @param b - The value to compare `this` with
+   * @returns true if equal, false otherwise
+   */
+  eq(b: any): boolean;
 }
 interface CustomInequalityInterface extends CustomEqualityInterface {
-    /**
-     * Checks if `this` is not equal to `b`
-     * @param b - The value to compare `this` with
-     * @returns true if not equal, false otherwise
-     */
-    lt(b: any): boolean;
-    gt(b: any): boolean;
-    lte(b: any): boolean;
-    gte(b: any): boolean;
+  /**
+   * Checks if `this` is not equal to `b`
+   * @param b - The value to compare `this` with
+   * @returns true if not equal, false otherwise
+   */
+  lt(b: any): boolean;
+  gt(b: any): boolean;
+  lte(b: any): boolean;
+  gte(b: any): boolean;
 }
 /**
  * deep structural comparison
@@ -39,7 +40,8 @@ interface CustomInequalityInterface extends CustomEqualityInterface {
  * For more details on comparison behavior, see the art-core-ts-compare README.
  */
 declare const compare: (a: any, b: any) => number;
-
+//#endregion
+//#region src/equality.d.ts
 /**
  * deep structural == test
  *
@@ -100,5 +102,6 @@ declare const lte: (a: any, b: any) => boolean;
  * For more details on comparison behavior, see the art-core-ts-compare README.
  */
 declare const gte: (a: any, b: any) => boolean;
-
-export { type CustomComparableInterface, type CustomEqualityInterface, type CustomInequalityInterface, compare, eq, gt, gte, lt, lte, neq };
+//#endregion
+export { CustomComparableInterface, CustomEqualityInterface, CustomInequalityInterface, compare, eq, gt, gte, lt, lte, neq };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,159 @@
+import { isArray, isFunction, isPlainObject } from "@art-suite/art-core-ts-types";
+//#region src/compare.ts
+const compareArrays = (a, b) => {
+	const minLength = Math.min(a.length, b.length);
+	for (let i = 0; i < minLength; i++) {
+		const result = compare(a[i], b[i]);
+		if (result !== 0) return result;
+	}
+	return a.length - b.length;
+};
+/**
+* Compares two plain objects. If the keys are different, the two key sets are sorted and compared as arrays of strings.
+* If the keys are the same, the values are compared recursively.
+* @param a - The first object to compare
+* @param b - The second object to compare
+* @returns A number indicating the comparison result
+*/
+const comparePlainObjects = (a, b) => {
+	let differentKeys = false;
+	let leastDifferentKey;
+	let leastDifferentKeyResult = 0;
+	for (const key in a) if (!(key in b)) differentKeys = true;
+	else {
+		const result = compare(a[key], b[key]);
+		if (result !== 0) {
+			if (!leastDifferentKey || leastDifferentKey > key) {
+				leastDifferentKey = key;
+				leastDifferentKeyResult = result;
+			}
+		}
+	}
+	if (!differentKeys) {
+		for (const key in b) if (!(key in a)) {
+			differentKeys = true;
+			break;
+		}
+	}
+	if (differentKeys) return compareArrays(Object.keys(a), Object.keys(b));
+	return leastDifferentKeyResult;
+};
+const compareCustomComparableHelper = (a, b) => {
+	if (a !== null && a !== void 0 && typeof a === "object") {
+		if (isFunction(a.compare)) return a.compare(b);
+		if (isFunction(a.eq) && a?.eq(b)) return 0;
+		if (isFunction(a.lt) && a?.lt(b)) return -1;
+		if (isFunction(a.gt) && a?.gt(b)) return 1;
+		if (isFunction(a.lte) && a?.lte(b)) return -1;
+		if (isFunction(a.gte) && a?.gte(b)) return 1;
+	}
+	return NaN;
+};
+const compareCustomComparable = (a, b) => {
+	const customResult = compareCustomComparableHelper(a, b);
+	if (!Number.isNaN(customResult)) return customResult;
+	return -compareCustomComparableHelper(b, a);
+};
+const comparePrimitives = (a, b) => {
+	if (a === null && b === null) return 0;
+	if (a === null) return -1;
+	if (b === null) return 1;
+	if (a === void 0 && b === void 0) return 0;
+	if (a === void 0) return 1;
+	if (b === void 0) return -1;
+	if (Number.isNaN(a) && Number.isNaN(b)) return 0;
+	if (Number.isNaN(a)) return -1;
+	if (Number.isNaN(b)) return 1;
+	if (typeof a === "number" && typeof b === "number") return a - b;
+	if (typeof a === "string" && typeof b === "string") return a.localeCompare(b);
+	if (typeof a === "boolean" && typeof b === "boolean") return Number(a) - Number(b);
+	if (typeof a !== typeof b) return NaN;
+	return NaN;
+};
+/**
+* deep structural comparison
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns A number indicating the comparison result:
+*   - **< 0**: `a` is less than `b`
+*   - **== 0**: `a` is equal to `b` (deep structural equality)
+*   - **> 0**: `a` is greater than `b`
+*   - **NaN**: Values cannot be compared (incompatible types or custom comparison failed)
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const compare = (a, b) => {
+	if (a === b) return 0;
+	const customResult = compareCustomComparable(a, b);
+	if (!Number.isNaN(customResult)) return customResult;
+	if (isArray(a) && isArray(b)) return compareArrays(a, b);
+	if (isPlainObject(a) && isPlainObject(b)) return comparePlainObjects(a, b);
+	return comparePrimitives(a, b);
+};
+//#endregion
+//#region src/equality.ts
+/**
+* deep structural == test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if the values are deeply equal (compare returns 0), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const eq = (a, b) => compare(a, b) === 0;
+/**
+* deep structural != test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if the values are not deeply equal (compare returns non-zero), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const neq = (a, b) => compare(a, b) !== 0;
+/**
+* deep structural < test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is less than `b` (compare returns negative), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const lt = (a, b) => compare(a, b) < 0;
+/**
+* deep structural > test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is greater than `b` (compare returns positive), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const gt = (a, b) => compare(a, b) > 0;
+/**
+* deep structural <= test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is less than or equal to `b` (compare returns negative or zero), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const lte = (a, b) => compare(a, b) <= 0;
+/**
+* deep structural >= test
+*
+* @param a - The first value to compare
+* @param b - The second value to compare
+* @returns `true` if `a` is greater than or equal to `b` (compare returns positive or zero), `false` otherwise
+*
+* For more details on comparison behavior, see the art-core-ts-compare README.
+*/
+const gte = (a, b) => compare(a, b) >= 0;
+//#endregion
+export { compare, eq, gt, gte, lt, lte, neq };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/compare.ts","../src/equality.ts"],"sourcesContent":["import { isArray, isPlainObject, isFunction } from '@art-suite/art-core-ts-types'\nimport { objectKeyCount } from '@art-suite/art-core-ts-containers'\n\nexport interface CustomComparableInterface {\n\n  /**\n   * Compares `this` with `b`\n   * @param b - The value to compare `this` with\n   * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`\n   */\n  compare(b: any): number\n}\n\nexport interface CustomEqualityInterface {\n  /**\n   * Checks if `this` equals `b`\n   * @param b - The value to compare `this` with\n   * @returns true if equal, false otherwise\n   */\n  eq(b: any): boolean\n}\n\nexport interface CustomInequalityInterface extends CustomEqualityInterface {\n  /**\n   * Checks if `this` is not equal to `b`\n   * @param b - The value to compare `this` with\n   * @returns true if not equal, false otherwise\n   */\n  lt(b: any): boolean\n  gt(b: any): boolean\n  lte(b: any): boolean\n  gte(b: any): boolean\n}\n\nconst compareArrays = (a: any[], b: any[]): number => {\n  const minLength = Math.min(a.length, b.length)\n\n  for (let i = 0; i < minLength; i++) {\n    const result = compare(a[i], b[i])\n    if (result !== 0) return result\n  }\n\n  return a.length - b.length\n}\n\n/**\n * Compares two plain objects. If the keys are different, the two key sets are sorted and compared as arrays of strings.\n * If the keys are the same, the values are compared recursively.\n * @param a - The first object to compare\n * @param b - The second object to compare\n * @returns A number indicating the comparison result\n */\nconst comparePlainObjects = (a: Record<string, any>, b: Record<string, any>): number => {\n  // Create a merged list of all unique keys and sort it\n  // const allKeys = [...new Set([...Object.keys(a), ...Object.keys(b)])].sort()\n\n  // Compare values for keys in A that are also in B\n  let differentKeys = false\n  let leastDifferentKey: string | undefined\n  let leastDifferentKeyResult: number = 0\n  for (const key in a) {\n    if (!(key in b)) differentKeys = true;\n    else {\n      // Both have the key, compare their values\n      const result = compare(a[key], b[key])\n      if (result !== 0) {\n        if (!leastDifferentKey || leastDifferentKey > key) {\n          leastDifferentKey = key\n          leastDifferentKeyResult = result\n        }\n      }\n    }\n  }\n\n  // if B had all As keys, we need to check if B has any keys that A doesn't have\n  if (!differentKeys) {\n    for (const key in b) {\n      if (!(key in a)) { differentKeys = true; break }\n    }\n  }\n\n  // if the keys are different, compare the keys\n  if (differentKeys) {\n    return compareArrays(Object.keys(a), Object.keys(b))\n  }\n\n  return leastDifferentKeyResult // All keys and values are equal\n}\n\nconst compareCustomComparableHelper = (a: any, b: any): number => {\n  // Only check for custom methods if a is not null/undefined and is an object\n  if (a !== null && a !== undefined && typeof a === 'object') {\n    // Check if left operand supports any of the custom methods (highest priority)\n    if (isFunction(a.compare)) return a.compare(b);\n    if (isFunction(a.eq) && a?.eq(b)) return 0;\n    if (isFunction(a.lt) && a?.lt(b)) return -1;\n    if (isFunction(a.gt) && a?.gt(b)) return 1;\n    if (isFunction(a.lte) && a?.lte(b)) return -1;\n    if (isFunction(a.gte) && a?.gte(b)) return 1;\n  }\n  return NaN\n}\n\nconst compareCustomComparable = (a: any, b: any): number => {\n  const customResult = compareCustomComparableHelper(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n  return -compareCustomComparableHelper(b, a)\n}\n\nconst comparePrimitives = (a: any, b: any): number => {\n  // Handle null\n  if (a === null && b === null) return 0\n  if (a === null) return -1\n  if (b === null) return 1\n\n  // Handle undefined\n  if (a === undefined && b === undefined) return 0\n  if (a === undefined) return 1\n  if (b === undefined) return -1\n\n  // Handle NaN\n  if (Number.isNaN(a) && Number.isNaN(b)) return 0\n  if (Number.isNaN(a)) return -1\n  if (Number.isNaN(b)) return 1\n\n  // Handle numbers - use subtraction for efficiency\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a - b\n  }\n\n  // Handle strings - use localeCompare for proper string comparison\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b)\n  }\n\n  // Handle booleans - convert to numbers for comparison\n  if (typeof a === 'boolean' && typeof b === 'boolean') {\n    return Number(a) - Number(b)\n  }\n\n  // Return NaN for different types or incompatible comparisons\n  if (typeof a !== typeof b) return NaN\n\n  // For same types that aren't numbers, strings, or booleans, return NaN\n  return NaN\n}\n\n/**\n * deep structural comparison\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns A number indicating the comparison result:\n *   - **< 0**: `a` is less than `b`\n *   - **== 0**: `a` is equal to `b` (deep structural equality)\n *   - **> 0**: `a` is greater than `b`\n *   - **NaN**: Values cannot be compared (incompatible types or custom comparison failed)\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const compare = (a: any, b: any): number => {\n  if (a === b) return 0;\n  // Handle custom comparable first\n  const customResult = compareCustomComparable(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n\n  // Handle arrays\n  if (isArray(a) && isArray(b)) {\n    return compareArrays(a, b)\n  }\n\n  // Handle plain objects\n  if (isPlainObject(a) && isPlainObject(b)) {\n    return comparePlainObjects(a, b)\n  }\n\n  // Handle primitives\n  return comparePrimitives(a, b)\n}","import { compare } from './compare'\n\n/**\n * deep structural == test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are deeply equal (compare returns 0), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const eq = (a: any, b: any): boolean => compare(a, b) === 0;\n\n/**\n * deep structural != test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are not deeply equal (compare returns non-zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const neq = (a: any, b: any): boolean => compare(a, b) !== 0;\n\n/**\n * deep structural < test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than `b` (compare returns negative), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lt = (a: any, b: any): boolean => compare(a, b) < 0;\n\n/**\n * deep structural > test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than `b` (compare returns positive), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gt = (a: any, b: any): boolean => compare(a, b) > 0;\n\n/**\n * deep structural <= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than or equal to `b` (compare returns negative or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lte = (a: any, b: any): boolean => compare(a, b) <= 0;\n\n/**\n * deep structural >= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than or equal to `b` (compare returns positive or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gte = (a: any, b: any): boolean => compare(a, b) >= 0;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@art-suite/art-core-ts-compare",
-  "version": "0.0.11",
+  "version": "0.1.1",
   "description": "A TypeScript comparison utility library",
   "keywords": [],
   "repository": {
@@ -12,19 +12,19 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     }
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist"
   ],
   "scripts": {
     "prebuild": "npm run clean",
-    "build": "npx sort-package-json;tsup src/index.ts --format esm,cjs --dts --sourcemap",
+    "build": "npx sort-package-json;tsdown src/index.ts --format esm,cjs --dts --sourcemap",
     "build:clean": "npm run clean && npm run build",
     "check:types": "tsc --noEmit",
     "check:types:fast": "tsc --noEmit --incremental",
@@ -36,10 +36,10 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@art-suite/art-core-ts-containers": "^0.9.9",
-    "@art-suite/art-core-ts-types": "^0.3.11"
+    "@art-suite/art-core-ts-containers": "^1.0.0",
+    "@art-suite/art-core-ts-types": "^0.4.0"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^4.0.5"
+    "@vitest/coverage-v8": "^4.0.18"
   }
 }

package/dist/index.js

@@ -1,107 +0,0 @@
-// src/compare.ts
-import { isArray, isPlainObject, isFunction } from "@art-suite/art-core-ts-types";
-var compareArrays = (a, b) => {
-  const minLength = Math.min(a.length, b.length);
-  for (let i = 0; i < minLength; i++) {
-    const result = compare(a[i], b[i]);
-    if (result !== 0) return result;
-  }
-  return a.length - b.length;
-};
-var comparePlainObjects = (a, b) => {
-  let differentKeys = false;
-  let leastDifferentKey;
-  let leastDifferentKeyResult = 0;
-  for (const key in a) {
-    if (!(key in b)) differentKeys = true;
-    else {
-      const result = compare(a[key], b[key]);
-      if (result !== 0) {
-        if (!leastDifferentKey || leastDifferentKey > key) {
-          leastDifferentKey = key;
-          leastDifferentKeyResult = result;
-        }
-      }
-    }
-  }
-  if (!differentKeys) {
-    for (const key in b) {
-      if (!(key in a)) {
-        differentKeys = true;
-        break;
-      }
-    }
-  }
-  if (differentKeys) {
-    return compareArrays(Object.keys(a), Object.keys(b));
-  }
-  return leastDifferentKeyResult;
-};
-var compareCustomComparableHelper = (a, b) => {
-  if (a !== null && a !== void 0 && typeof a === "object") {
-    if (isFunction(a.compare)) return a.compare(b);
-    if (isFunction(a.eq) && a?.eq(b)) return 0;
-    if (isFunction(a.lt) && a?.lt(b)) return -1;
-    if (isFunction(a.gt) && a?.gt(b)) return 1;
-    if (isFunction(a.lte) && a?.lte(b)) return -1;
-    if (isFunction(a.gte) && a?.gte(b)) return 1;
-  }
-  return NaN;
-};
-var compareCustomComparable = (a, b) => {
-  const customResult = compareCustomComparableHelper(a, b);
-  if (!Number.isNaN(customResult)) return customResult;
-  return -compareCustomComparableHelper(b, a);
-};
-var comparePrimitives = (a, b) => {
-  if (a === null && b === null) return 0;
-  if (a === null) return -1;
-  if (b === null) return 1;
-  if (a === void 0 && b === void 0) return 0;
-  if (a === void 0) return 1;
-  if (b === void 0) return -1;
-  if (Number.isNaN(a) && Number.isNaN(b)) return 0;
-  if (Number.isNaN(a)) return -1;
-  if (Number.isNaN(b)) return 1;
-  if (typeof a === "number" && typeof b === "number") {
-    return a - b;
-  }
-  if (typeof a === "string" && typeof b === "string") {
-    return a.localeCompare(b);
-  }
-  if (typeof a === "boolean" && typeof b === "boolean") {
-    return Number(a) - Number(b);
-  }
-  if (typeof a !== typeof b) return NaN;
-  return NaN;
-};
-var compare = (a, b) => {
-  if (a === b) return 0;
-  const customResult = compareCustomComparable(a, b);
-  if (!Number.isNaN(customResult)) return customResult;
-  if (isArray(a) && isArray(b)) {
-    return compareArrays(a, b);
-  }
-  if (isPlainObject(a) && isPlainObject(b)) {
-    return comparePlainObjects(a, b);
-  }
-  return comparePrimitives(a, b);
-};
-
-// src/equality.ts
-var eq = (a, b) => compare(a, b) === 0;
-var neq = (a, b) => compare(a, b) !== 0;
-var lt = (a, b) => compare(a, b) < 0;
-var gt = (a, b) => compare(a, b) > 0;
-var lte = (a, b) => compare(a, b) <= 0;
-var gte = (a, b) => compare(a, b) >= 0;
-export {
-  compare,
-  eq,
-  gt,
-  gte,
-  lt,
-  lte,
-  neq
-};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/compare.ts","../src/equality.ts"],"sourcesContent":["import { isArray, isPlainObject, isFunction } from '@art-suite/art-core-ts-types'\nimport { objectKeyCount } from '@art-suite/art-core-ts-containers'\n\nexport interface CustomComparableInterface {\n\n  /**\n   * Compares `this` with `b`\n   * @param b - The value to compare `this` with\n   * @returns A number greater than zero if `this` is greater than `b`, less than zero if `this` is less than `b`, and zero if `this` is equal to `b`\n   */\n  compare(b: any): number\n}\n\nexport interface CustomEqualityInterface {\n  /**\n   * Checks if `this` equals `b`\n   * @param b - The value to compare `this` with\n   * @returns true if equal, false otherwise\n   */\n  eq(b: any): boolean\n}\n\nexport interface CustomInequalityInterface extends CustomEqualityInterface {\n  /**\n   * Checks if `this` is not equal to `b`\n   * @param b - The value to compare `this` with\n   * @returns true if not equal, false otherwise\n   */\n  lt(b: any): boolean\n  gt(b: any): boolean\n  lte(b: any): boolean\n  gte(b: any): boolean\n}\n\nconst compareArrays = (a: any[], b: any[]): number => {\n  const minLength = Math.min(a.length, b.length)\n\n  for (let i = 0; i < minLength; i++) {\n    const result = compare(a[i], b[i])\n    if (result !== 0) return result\n  }\n\n  return a.length - b.length\n}\n\n/**\n * Compares two plain objects. If the keys are different, the two key sets are sorted and compared as arrays of strings.\n * If the keys are the same, the values are compared recursively.\n * @param a - The first object to compare\n * @param b - The second object to compare\n * @returns A number indicating the comparison result\n */\nconst comparePlainObjects = (a: Record<string, any>, b: Record<string, any>): number => {\n  // Create a merged list of all unique keys and sort it\n  // const allKeys = [...new Set([...Object.keys(a), ...Object.keys(b)])].sort()\n\n  // Compare values for keys in A that are also in B\n  let differentKeys = false\n  let leastDifferentKey: string | undefined\n  let leastDifferentKeyResult: number = 0\n  for (const key in a) {\n    if (!(key in b)) differentKeys = true;\n    else {\n      // Both have the key, compare their values\n      const result = compare(a[key], b[key])\n      if (result !== 0) {\n        if (!leastDifferentKey || leastDifferentKey > key) {\n          leastDifferentKey = key\n          leastDifferentKeyResult = result\n        }\n      }\n    }\n  }\n\n  // if B had all As keys, we need to check if B has any keys that A doesn't have\n  if (!differentKeys) {\n    for (const key in b) {\n      if (!(key in a)) { differentKeys = true; break }\n    }\n  }\n\n  // if the keys are different, compare the keys\n  if (differentKeys) {\n    return compareArrays(Object.keys(a), Object.keys(b))\n  }\n\n  return leastDifferentKeyResult // All keys and values are equal\n}\n\nconst compareCustomComparableHelper = (a: any, b: any): number => {\n  // Only check for custom methods if a is not null/undefined and is an object\n  if (a !== null && a !== undefined && typeof a === 'object') {\n    // Check if left operand supports any of the custom methods (highest priority)\n    if (isFunction(a.compare)) return a.compare(b);\n    if (isFunction(a.eq) && a?.eq(b)) return 0;\n    if (isFunction(a.lt) && a?.lt(b)) return -1;\n    if (isFunction(a.gt) && a?.gt(b)) return 1;\n    if (isFunction(a.lte) && a?.lte(b)) return -1;\n    if (isFunction(a.gte) && a?.gte(b)) return 1;\n  }\n  return NaN\n}\n\nconst compareCustomComparable = (a: any, b: any): number => {\n  const customResult = compareCustomComparableHelper(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n  return -compareCustomComparableHelper(b, a)\n}\n\nconst comparePrimitives = (a: any, b: any): number => {\n  // Handle null\n  if (a === null && b === null) return 0\n  if (a === null) return -1\n  if (b === null) return 1\n\n  // Handle undefined\n  if (a === undefined && b === undefined) return 0\n  if (a === undefined) return 1\n  if (b === undefined) return -1\n\n  // Handle NaN\n  if (Number.isNaN(a) && Number.isNaN(b)) return 0\n  if (Number.isNaN(a)) return -1\n  if (Number.isNaN(b)) return 1\n\n  // Handle numbers - use subtraction for efficiency\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a - b\n  }\n\n  // Handle strings - use localeCompare for proper string comparison\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b)\n  }\n\n  // Handle booleans - convert to numbers for comparison\n  if (typeof a === 'boolean' && typeof b === 'boolean') {\n    return Number(a) - Number(b)\n  }\n\n  // Return NaN for different types or incompatible comparisons\n  if (typeof a !== typeof b) return NaN\n\n  // For same types that aren't numbers, strings, or booleans, return NaN\n  return NaN\n}\n\n/**\n * deep structural comparison\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns A number indicating the comparison result:\n *   - **< 0**: `a` is less than `b`\n *   - **== 0**: `a` is equal to `b` (deep structural equality)\n *   - **> 0**: `a` is greater than `b`\n *   - **NaN**: Values cannot be compared (incompatible types or custom comparison failed)\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const compare = (a: any, b: any): number => {\n  if (a === b) return 0;\n  // Handle custom comparable first\n  const customResult = compareCustomComparable(a, b)\n  if (!Number.isNaN(customResult)) return customResult\n\n  // Handle arrays\n  if (isArray(a) && isArray(b)) {\n    return compareArrays(a, b)\n  }\n\n  // Handle plain objects\n  if (isPlainObject(a) && isPlainObject(b)) {\n    return comparePlainObjects(a, b)\n  }\n\n  // Handle primitives\n  return comparePrimitives(a, b)\n}","import { compare } from './compare'\n\n/**\n * deep structural == test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are deeply equal (compare returns 0), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const eq = (a: any, b: any): boolean => compare(a, b) === 0;\n\n/**\n * deep structural != test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if the values are not deeply equal (compare returns non-zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const neq = (a: any, b: any): boolean => compare(a, b) !== 0;\n\n/**\n * deep structural < test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than `b` (compare returns negative), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lt = (a: any, b: any): boolean => compare(a, b) < 0;\n\n/**\n * deep structural > test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than `b` (compare returns positive), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gt = (a: any, b: any): boolean => compare(a, b) > 0;\n\n/**\n * deep structural <= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is less than or equal to `b` (compare returns negative or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const lte = (a: any, b: any): boolean => compare(a, b) <= 0;\n\n/**\n * deep structural >= test\n *\n * @param a - The first value to compare\n * @param b - The second value to compare\n * @returns `true` if `a` is greater than or equal to `b` (compare returns positive or zero), `false` otherwise\n *\n * For more details on comparison behavior, see the art-core-ts-compare README.\n */\nexport const gte = (a: any, b: any): boolean => compare(a, b) >= 0;\n"],"mappings":"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","names":[]}