@adobe/data 0.2.2 → 0.2.4

package/dist/core/equals.test.js

@@ -0,0 +1,150 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { equals } from './equals.js';
+import { describe, expect, it } from 'vitest';
+describe('equals', () => {
+    describe('primitives and identical references', () => {
+        it('should return true for identical primitive values', () => {
+            expect(equals(42, 42)).toBe(true);
+            expect(equals('hello', 'hello')).toBe(true);
+            expect(equals(true, true)).toBe(true);
+            expect(equals(false, false)).toBe(true);
+        });
+        it('should return true for identical object references', () => {
+            const obj = { a: 1 };
+            expect(equals(obj, obj)).toBe(true);
+        });
+        it('should return false for different primitive values', () => {
+            expect(equals(42, 43)).toBe(false);
+            expect(equals('hello', 'world')).toBe(false);
+            expect(equals(true, false)).toBe(false);
+        });
+    });
+    describe('null and undefined handling', () => {
+        it('should return false when one value is null and other is not', () => {
+            expect(equals(null, 42)).toBe(false);
+            expect(equals(42, null)).toBe(false);
+            expect(equals(null, 'hello')).toBe(false);
+            expect(equals('hello', null)).toBe(false);
+        });
+        it('should return false when one value is undefined and other is not', () => {
+            expect(equals(undefined, 42)).toBe(false);
+            expect(equals(42, undefined)).toBe(false);
+            expect(equals(undefined, 'hello')).toBe(false);
+            expect(equals('hello', undefined)).toBe(false);
+        });
+        it('should return false when one is null and other is undefined', () => {
+            expect(equals(null, undefined)).toBe(false);
+            expect(equals(undefined, null)).toBe(false);
+        });
+    });
+    describe('type mismatch handling', () => {
+        it('should return false when one is primitive and other is object', () => {
+            expect(equals(42, {})).toBe(false);
+            expect(equals({}, 42)).toBe(false);
+            expect(equals('hello', [])).toBe(false);
+            expect(equals([], 'hello')).toBe(false);
+        });
+    });
+    describe('arrays', () => {
+        it('should return true for identical arrays', () => {
+            expect(equals([1, 2, 3], [1, 2, 3])).toBe(true);
+            expect(equals(['a', 'b'], ['a', 'b'])).toBe(true);
+            expect(equals([], [])).toBe(true);
+        });
+        it('should return false when one is array and other is object', () => {
+            expect(equals([1, 2, 3], { 0: 1, 1: 2, 2: 3 })).toBe(false);
+            expect(equals({ 0: 1, 1: 2, 2: 3 }, [1, 2, 3])).toBe(false);
+        });
+        it('should return false for arrays with different lengths', () => {
+            expect(equals([1, 2], [1, 2, 3])).toBe(false);
+            expect(equals([1, 2, 3], [1, 2])).toBe(false);
+        });
+        it('should return false for arrays with different values', () => {
+            expect(equals([1, 2, 3], [1, 2, 4])).toBe(false);
+            expect(equals([1, 2, 3], [1, 3, 2])).toBe(false);
+        });
+        it('should handle nested arrays', () => {
+            expect(equals([[1, 2], [3, 4]], [[1, 2], [3, 4]])).toBe(true);
+            expect(equals([[1, 2], [3, 4]], [[1, 2], [3, 5]])).toBe(false);
+        });
+        it('should handle arrays with mixed content', () => {
+            expect(equals([1, 'hello', { a: 1 }], [1, 'hello', { a: 1 }])).toBe(true);
+            expect(equals([1, 'hello', { a: 1 }], [1, 'hello', { a: 2 }])).toBe(false);
+        });
+    });
+    describe('objects', () => {
+        it('should return true for identical objects', () => {
+            expect(equals({ a: 1, b: 2 }, { a: 1, b: 2 })).toBe(true);
+            expect(equals({}, {})).toBe(true);
+        });
+        it('should return false for objects with different keys', () => {
+            expect(equals({ a: 1 }, { b: 1 })).toBe(false);
+            expect(equals({ a: 1, b: 2 }, { a: 1 })).toBe(false);
+            expect(equals({ a: 1 }, { a: 1, b: 2 })).toBe(false);
+        });
+        it('should return false for objects with same keys but different values', () => {
+            expect(equals({ a: 1, b: 2 }, { a: 1, b: 3 })).toBe(false);
+            expect(equals({ a: 1 }, { a: 2 })).toBe(false);
+        });
+        it('should handle nested objects', () => {
+            expect(equals({ a: { b: 1 } }, { a: { b: 1 } })).toBe(true);
+            expect(equals({ a: { b: 1 } }, { a: { b: 2 } })).toBe(false);
+        });
+        it('should handle objects with arrays', () => {
+            expect(equals({ a: [1, 2] }, { a: [1, 2] })).toBe(true);
+            expect(equals({ a: [1, 2] }, { a: [1, 3] })).toBe(false);
+        });
+        it('should handle complex nested structures', () => {
+            const obj1 = { a: [1, { b: 2, c: [3, 4] }], d: { e: 5 } };
+            const obj2 = { a: [1, { b: 2, c: [3, 4] }], d: { e: 5 } };
+            const obj3 = { a: [1, { b: 2, c: [3, 5] }], d: { e: 5 } };
+            expect(equals(obj1, obj2)).toBe(true);
+            expect(equals(obj1, obj3)).toBe(false);
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle objects with numeric keys', () => {
+            expect(equals({ '0': 1, '1': 2 }, { '0': 1, '1': 2 })).toBe(true);
+            expect(equals({ '0': 1, '1': 2 }, { '0': 1, '1': 3 })).toBe(false);
+        });
+        it('should handle empty arrays and objects', () => {
+            expect(equals([], [])).toBe(true);
+            expect(equals({}, {})).toBe(true);
+            expect(equals([], {})).toBe(false);
+        });
+        it('should handle objects with undefined values', () => {
+            expect(equals({ a: undefined }, { a: undefined })).toBe(true);
+            expect(equals({ a: undefined }, { a: null })).toBe(false);
+        });
+        it('should handle objects with null values', () => {
+            expect(equals({ a: null }, { a: null })).toBe(true);
+            expect(equals({ a: null }, { a: undefined })).toBe(false);
+        });
+        it('should handle NaN values', () => {
+            expect(equals(NaN, NaN)).toBe(true);
+            expect(equals(NaN, 42)).toBe(false);
+            expect(equals(42, NaN)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=equals.test.js.map

package/dist/core/equals.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equals.test.js","sourceRoot":"","sources":["../../src/core/equals.test.ts"],"names":[],"mappings":"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"}

package/dist/core/functions/array-equals-shallow.d.ts

@@ -0,0 +1 @@
+export declare function arrayEqualsShallow(a: unknown[], b: unknown[]): boolean;

package/dist/core/functions/{array-equals.js → array-equals-shallow.js}

@@ -19,7 +19,7 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
-export function arrayEquals(a, b) {
+export function arrayEqualsShallow(a, b) {
     const length = a.length;
     if (length !== b.length) {
         return false;
@@ -31,4 +31,4 @@ export function arrayEquals(a, b) {
     }
     return true;
 }
-//# sourceMappingURL=array-equals.js.map
+//# sourceMappingURL=array-equals-shallow.js.map

package/dist/core/functions/array-equals-shallow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-equals-shallow.js","sourceRoot":"","sources":["../../../src/core/functions/array-equals-shallow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,MAAM,UAAU,kBAAkB,CAAC,CAAY,EAAE,CAAY;IAC3D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,IAAI,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/functions/deep-assign.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Deeply assigns properties from source into target, throwing an error if attempting to overwrite any non-object value.
+ * Objects are merged recursively, but primitive values cannot be overwritten.
+ * Mutates the target object directly.
+ *
+ * @param target The target object to assign into
+ * @param source The source object to assign from
+ * @returns The modified target object
+ * @throws Error if attempting to overwrite a non-object value
+ */
+export declare function deepAssign<T, S>(target: T, source: S): T & S;

package/dist/core/functions/deep-assign.js

@@ -0,0 +1,61 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+/**
+ * Deeply assigns properties from source into target, throwing an error if attempting to overwrite any non-object value.
+ * Objects are merged recursively, but primitive values cannot be overwritten.
+ * Mutates the target object directly.
+ *
+ * @param target The target object to assign into
+ * @param source The source object to assign from
+ * @returns The modified target object
+ * @throws Error if attempting to overwrite a non-object value
+ */
+export function deepAssign(target, source) {
+    if (source !== undefined) {
+        for (const key in source) {
+            const targetValue = target[key];
+            const sourceValue = source[key];
+            const isTargetObject = targetValue && typeof targetValue === 'object';
+            const isSourceObject = sourceValue && typeof sourceValue === 'object' && !Array.isArray(sourceValue);
+            if (sourceValue !== undefined) {
+                if (key in target) {
+                    if (isTargetObject && isSourceObject) {
+                        deepAssign(targetValue, sourceValue);
+                    }
+                    else if (targetValue !== undefined) {
+                        throw new Error(`Cannot overwrite existing value at path "${key}". ` +
+                            `Existing value: ${JSON.stringify(targetValue)}, ` +
+                            `New value: ${JSON.stringify(sourceValue)}`);
+                    }
+                    else {
+                        target[key] = sourceValue;
+                    }
+                }
+                else {
+                    target[key] = sourceValue;
+                }
+            }
+        }
+    }
+    return target;
+}
+//# sourceMappingURL=deep-assign.js.map

package/dist/core/functions/deep-assign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-assign.js","sourceRoot":"","sources":["../../../src/core/functions/deep-assign.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAIX;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACtB,MAAS,EACT,MAAS;IAET,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,WAAW,GAAI,MAAc,CAAC,GAAU,CAAC,CAAC;YAChD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAEhC,MAAM,cAAc,GAAG,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,CAAC;YACtE,MAAM,cAAc,GAAG,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAErG,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,GAAG,IAAK,MAAc,EAAE,CAAC;oBACzB,IAAI,cAAc,IAAI,cAAc,EAAE,CAAC;wBACnC,UAAU,CACN,WAA6B,EAC7B,WAA6B,CAChC,CAAC;oBACN,CAAC;yBAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;wBACnC,MAAM,IAAI,KAAK,CACX,4CAA4C,GAAG,KAAK;4BACpD,mBAAmB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI;4BAClD,cAAc,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAC9C,CAAC;oBACN,CAAC;yBAAM,CAAC;wBACH,MAAc,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;oBACvC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACH,MAAc,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;gBACvC,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,MAAe,CAAC;AAC3B,CAAC"}

package/dist/core/functions/deep-assign.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/functions/deep-assign.test.js

@@ -0,0 +1,180 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { describe, it, expect } from 'vitest';
+import { deepAssign } from './deep-assign.js';
+describe('deepAssign', () => {
+    it('should merge flat objects by mutating target', () => {
+        const target = { a: 1 };
+        const source = { b: 2 };
+        const result = deepAssign(target, source);
+        expect(result).toEqual({ a: 1, b: 2 });
+        // Verify target was modified
+        expect(target).toEqual({ a: 1, b: 2 });
+        // Verify result is the same object as target
+        expect(result).toBe(target);
+        // Verify source wasn't modified
+        expect(source).toEqual({ b: 2 });
+    });
+    it('should deeply merge nested objects by mutating target', () => {
+        const target = {
+            a: { x: 1, y: 2 },
+            b: { z: 3 }
+        };
+        const source = {
+            a: { z: 3, w: 4 },
+            b: { q: 5 }
+        };
+        const result = deepAssign(target, source);
+        const expected = {
+            a: { x: 1, y: 2, z: 3, w: 4 },
+            b: { z: 3, q: 5 }
+        };
+        expect(result).toEqual(expected);
+        // Verify target was modified
+        expect(target).toEqual(expected);
+        // Verify nested objects are the same instances
+        expect(result.a).toBe(target.a);
+        expect(result.b).toBe(target.b);
+    });
+    it('should deeply merge nested objects by mutating target', () => {
+        const target = {
+            a: [1, 2, 3],
+            b: { z: 3 }
+        };
+        const source = {
+            a: { z: 3, w: 4 },
+            b: { q: 5 }
+        };
+        const result = deepAssign(target, source);
+        const expected = {
+            a: Object.assign([1, 2, 3], { z: 3, w: 4 }),
+            b: { z: 3, q: 5 }
+        };
+        expect(result).toEqual(expected);
+        // Verify target was modified
+        expect(target).toEqual(expected);
+        // Verify nested objects are the same instances
+        expect(result.a).toBe(target.a);
+        expect(result.b).toBe(target.b);
+    });
+    it('should throw when trying to overwrite primitive values', () => {
+        const target = {
+            a: 1,
+            b: { x: 1 }
+        };
+        const source = {
+            a: 2,
+            b: { x: 2 }
+        };
+        expect(() => deepAssign(target, source)).toThrow('Cannot overwrite existing value at path "a"');
+        // Verify target wasn't modified when error thrown
+        expect(target).toEqual({
+            a: 1,
+            b: { x: 1 }
+        });
+    });
+    it('should throw when trying to overwrite arrays', () => {
+        const target = {
+            a: [1, 2, 3],
+            b: { x: 1 }
+        };
+        const source = {
+            a: [4, 5, 6],
+            b: { x: 2 }
+        };
+        expect(() => deepAssign(target, source)).toThrow('Cannot overwrite existing value at path "a"');
+        // Verify target wasn't modified when error thrown
+        expect(target).toEqual({
+            a: [1, 2, 3],
+            b: { x: 1 }
+        });
+    });
+    it('should handle undefined values correctly', () => {
+        const target = {
+            a: undefined,
+            b: { x: undefined }
+        };
+        const source = {
+            a: 1,
+            b: { x: 2, y: 3 }
+        };
+        const result = deepAssign(target, source);
+        const expected = {
+            a: 1,
+            b: { x: 2, y: 3 }
+        };
+        expect(result).toEqual(expected);
+        // Verify target was modified
+        expect(target).toEqual(expected);
+        // Verify result is the same object as target
+        expect(result).toBe(target);
+    });
+    it('should handle deeply nested merges by mutating target', () => {
+        const target = {
+            a: {
+                b: {
+                    c: {
+                        d: { x: 1 }
+                    }
+                }
+            }
+        };
+        const source = {
+            a: {
+                b: {
+                    c: {
+                        d: { y: 2 }
+                    }
+                }
+            }
+        };
+        const result = deepAssign(target, source);
+        const expected = {
+            a: {
+                b: {
+                    c: {
+                        d: { x: 1, y: 2 }
+                    }
+                }
+            }
+        };
+        expect(result).toEqual(expected);
+        // Verify target was modified
+        expect(target).toEqual(expected);
+        // Verify all nested objects are the same instances
+        expect(result.a).toBe(target.a);
+        expect(result.a.b).toBe(target.a.b);
+        expect(result.a.b.c).toBe(target.a.b.c);
+        expect(result.a.b.c.d).toBe(target.a.b.c.d);
+    });
+    it('should handle empty objects', () => {
+        const target = {};
+        const source = { a: 1 };
+        const result = deepAssign(target, source);
+        expect(result).toEqual({ a: 1 });
+        // Verify target was modified
+        expect(target).toEqual({ a: 1 });
+        // Verify result is the same object as target
+        expect(result).toBe(target);
+    });
+});
+//# sourceMappingURL=deep-assign.test.js.map

package/dist/core/functions/deep-assign.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-assign.test.js","sourceRoot":"","sources":["../../../src/core/functions/deep-assign.test.ts"],"names":[],"mappings":"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"}

package/dist/core/functions/index.d.ts

@@ -1,3 +1 @@
-export * from './array-equals.js';
-export * from './is-async-generator.js';
-export * from './deep-merge.js';
+export * from '../../internal/async-generator/is-async-generator.js';

package/dist/core/functions/index.js

@@ -19,7 +19,5 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
-export * from './array-equals.js';
-export * from './is-async-generator.js';
-export * from './deep-merge.js';
+export * from '../../internal/async-generator/is-async-generator.js';
 //# sourceMappingURL=index.js.map

package/dist/core/functions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,sDAAsD,CAAC"}

package/dist/core/functions/memoize-factory.d.ts

@@ -0,0 +1 @@
+export declare function memoizeFactory<K, V>(fn: (key: K) => V): (key: K) => V;

package/dist/core/functions/memoize-factory.js

@@ -0,0 +1,12 @@
+export function memoizeFactory(fn) {
+    const cache = new Map();
+    return (key) => {
+        if (cache.has(key)) {
+            return cache.get(key);
+        }
+        const value = fn(key);
+        cache.set(key, value);
+        return value;
+    };
+}
+//# sourceMappingURL=memoize-factory.js.map

package/dist/core/functions/memoize-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize-factory.js","sourceRoot":"","sources":["../../../src/core/functions/memoize-factory.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,cAAc,CAAM,EAAiB;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAQ,CAAC;IAC9B,OAAO,CAAC,GAAM,EAAK,EAAE;QACjB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAC3B,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACjB,CAAC,CAAA;AACL,CAAC"}

package/dist/core/index.d.ts

@@ -1,3 +1,4 @@
-export * from "./data.js";
-export * from "./schema/index.js";
-export * from "./functions/index.js";
+export { type Data } from "./data.js";
+export { type IsData } from "./is-data.js";
+export { equals } from "./equals.js";
+export { normalize } from "./normalize.js";

package/dist/core/index.js

@@ -19,7 +19,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
-export * from "./data.js";
-export * from "./schema/index.js";
-export * from "./functions/index.js";
+export { equals } from "./equals.js";
+export { normalize } from "./normalize.js";
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAIX,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/core/is-data.d.ts

@@ -0,0 +1,11 @@
+type Primitive = string | number | boolean | null;
+/** invariant type-equality check (handles `readonly` correctly) */
+type EqualReadonly<X, Y> = (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? (<T>() => T extends Y ? 1 : 2) extends (<T>() => T extends X ? 1 : 2) ? true : false : false;
+/** are *all* own props already `readonly`?  */
+type IsFullyReadonly<T> = EqualReadonly<T, Readonly<T>>;
+export type IsData<T> = [
+    T
+] extends [Primitive] ? true : T extends ReadonlyArray<infer U> ? EqualReadonly<T, ReadonlyArray<U>> extends true ? IsData<U> : false : T extends object ? IsFullyReadonly<T> extends true ? {
+    [K in keyof T]-?: IsData<T[K]>;
+}[keyof T] extends false ? false : true : false : false;
+export {};

package/dist/core/is-data.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=is-data.js.map

package/dist/core/is-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-data.js","sourceRoot":"","sources":["../../src/core/is-data.ts"],"names":[],"mappings":""}

package/dist/core/normalize.d.ts

@@ -0,0 +1 @@
+export declare function normalize<D>(d: D): D;

package/dist/core/normalize.js

@@ -0,0 +1,34 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+export function normalize(d) {
+    //  we could structured clone but let's explicitly shed any keys with undefined values.
+    return JSON.parse(JSON.stringify(d), (_key, value) => {
+        if (value && !Array.isArray(value) && typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).sort(([a], [b]) => 
+            //  not using String.localeCompare
+            //  we want this consistent no matter locale
+            a < b ? -1 : a > b ? 1 : 0));
+        }
+        return value;
+    });
+}
+//# sourceMappingURL=normalize.js.map

package/dist/core/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/core/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,MAAM,UAAU,SAAS,CAAI,CAAI;IAC/B,uFAAuF;IACvF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;QACpE,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChE,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACtC,kCAAkC;YAClC,4CAA4C;YAC5C,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3B,CACF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/normalize.test.d.ts

@@ -0,0 +1 @@
+export {};