@sinclair/typebox 0.31.28 → 0.32.0-dev-2

package/esm/value/default/default.mjs

@@ -0,0 +1,171 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 { IsString, IsObject, IsArray, IsUndefined } from '../guard/index.mjs';
+import { TSchema as IsSchemaType } from '../../type/guard/type.mjs';
+import { Check } from '../check/index.mjs';
+import { Deref } from '../deref/index.mjs';
+import { Kind } from '../../type/symbols/index.mjs';
+// ------------------------------------------------------------------
+// ValueOrDefault
+// ------------------------------------------------------------------
+function ValueOrDefault(schema, value) {
+    return !(value === undefined) || !('default' in schema) ? value : schema.default;
+}
+// ------------------------------------------------------------------
+// IsCheckable
+// ------------------------------------------------------------------
+function IsCheckable(schema) {
+    return IsSchemaType(schema) && schema[Kind] !== 'Unsafe';
+}
+// ------------------------------------------------------------------
+// IsDefaultSchema
+// ------------------------------------------------------------------
+function IsDefaultSchema(value) {
+    return IsSchemaType(value) && 'default' in value;
+}
+// ------------------------------------------------------------------
+// Types
+// ------------------------------------------------------------------
+function TArray(schema, references, value) {
+    const defaulted = ValueOrDefault(schema, value);
+    if (!IsArray(defaulted))
+        return defaulted;
+    for (let i = 0; i < defaulted.length; i++) {
+        defaulted[i] = Visit(schema.items, references, defaulted[i]);
+    }
+    return defaulted;
+}
+function TIntersect(schema, references, value) {
+    const defaulted = ValueOrDefault(schema, value);
+    return schema.allOf.reduce((acc, schema) => {
+        const next = Visit(schema, references, defaulted);
+        return IsObject(next) ? { ...acc, ...next } : next;
+    }, {});
+}
+function TObject(schema, references, value) {
+    const defaulted = ValueOrDefault(schema, value);
+    if (!IsObject(defaulted))
+        return defaulted;
+    const additionalPropertiesSchema = schema.additionalProperties;
+    const knownPropertyKeys = Object.getOwnPropertyNames(schema.properties);
+    // properties
+    for (const key of knownPropertyKeys) {
+        if (!IsDefaultSchema(schema.properties[key]))
+            continue;
+        defaulted[key] = Visit(schema.properties[key], references, defaulted[key]);
+    }
+    // return if not additional properties
+    if (!IsDefaultSchema(additionalPropertiesSchema))
+        return defaulted;
+    // additional properties
+    for (const key of Object.getOwnPropertyNames(defaulted)) {
+        if (knownPropertyKeys.includes(key))
+            continue;
+        defaulted[key] = Visit(additionalPropertiesSchema, references, defaulted[key]);
+    }
+    return defaulted;
+}
+function TRecord(schema, references, value) {
+    const defaulted = ValueOrDefault(schema, value);
+    if (!IsObject(defaulted))
+        return defaulted;
+    const additionalPropertiesSchema = schema.additionalProperties;
+    const [propertyKeyPattern, propertySchema] = Object.entries(schema.patternProperties)[0];
+    const knownPropertyKey = new RegExp(propertyKeyPattern);
+    // properties
+    for (const key of Object.getOwnPropertyNames(defaulted)) {
+        if (!(knownPropertyKey.test(key) && IsDefaultSchema(propertySchema)))
+            continue;
+        defaulted[key] = Visit(propertySchema, references, defaulted[key]);
+    }
+    // return if not additional properties
+    if (!IsDefaultSchema(additionalPropertiesSchema))
+        return defaulted;
+    // additional properties
+    for (const key of Object.getOwnPropertyNames(defaulted)) {
+        if (knownPropertyKey.test(key))
+            continue;
+        defaulted[key] = Visit(additionalPropertiesSchema, references, defaulted[key]);
+    }
+    return defaulted;
+}
+function TRef(schema, references, value) {
+    return Visit(Deref(schema, references), references, ValueOrDefault(schema, value));
+}
+function TThis(schema, references, value) {
+    return Visit(Deref(schema, references), references, value);
+}
+function TTuple(schema, references, value) {
+    const defaulted = ValueOrDefault(schema, value);
+    if (!IsArray(defaulted) || IsUndefined(schema.items))
+        return defaulted;
+    const [items, max] = [schema.items, Math.max(schema.items.length, defaulted.length)];
+    for (let i = 0; i < max; i++) {
+        if (i < items.length)
+            defaulted[i] = Visit(items[i], references, defaulted[i]);
+    }
+    return defaulted;
+}
+function TUnion(schema, references, value) {
+    const defaulted = ValueOrDefault(schema, value);
+    for (const inner of schema.anyOf) {
+        const result = Visit(inner, references, defaulted);
+        if (IsCheckable(inner) && Check(inner, result)) {
+            return result;
+        }
+    }
+    return defaulted;
+}
+function Visit(schema, references, value) {
+    const references_ = IsString(schema.$id) ? [...references, schema] : references;
+    const schema_ = schema;
+    switch (schema_[Kind]) {
+        case 'Array':
+            return TArray(schema_, references_, value);
+        case 'Intersect':
+            return TIntersect(schema_, references_, value);
+        case 'Object':
+            return TObject(schema_, references_, value);
+        case 'Record':
+            return TRecord(schema_, references_, value);
+        case 'Ref':
+            return TRef(schema_, references_, value);
+        case 'This':
+            return TThis(schema_, references_, value);
+        case 'Tuple':
+            return TTuple(schema_, references_, value);
+        case 'Union':
+            return TUnion(schema_, references_, value);
+        default:
+            return ValueOrDefault(schema_, value);
+    }
+}
+/** `[Mutable]` Generates missing properties on a value using default schema annotations if available. This function does not check the value and returns an unknown type. You should Check the result before use. Default is a mutable operation. To avoid mutation, Clone the value first. */
+export function Default(...args) {
+    return args.length === 3 ? Visit(args[0], args[1], args[2]) : Visit(args[0], [], args[1]);
+}

package/esm/value/default/index.d.mts

@@ -0,0 +1 @@
+export * from './default.mjs';

package/esm/value/default/index.mjs

@@ -0,0 +1,28 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 * from './default.mjs';

package/esm/value/delta/delta.d.mts

@@ -0,0 +1,41 @@
+import type { Static } from '../../type/static/index.mjs';
+export type Insert = Static<typeof Insert>;
+export declare const Insert: import("../../type/object/object.mjs").TObject<{
+    type: import("../../type/literal/literal.mjs").TLiteral<"insert">;
+    path: import("../../type/string/string.mjs").TString;
+    value: import("../../type/unknown/unknown.mjs").TUnknown;
+}>;
+export type Update = Static<typeof Update>;
+export declare const Update: import("../../type/object/object.mjs").TObject<{
+    type: import("../../type/literal/literal.mjs").TLiteral<"update">;
+    path: import("../../type/string/string.mjs").TString;
+    value: import("../../type/unknown/unknown.mjs").TUnknown;
+}>;
+export type Delete = Static<typeof Delete>;
+export declare const Delete: import("../../type/object/object.mjs").TObject<{
+    type: import("../../type/literal/literal.mjs").TLiteral<"delete">;
+    path: import("../../type/string/string.mjs").TString;
+}>;
+export type Edit = Static<typeof Edit>;
+export declare const Edit: import("../../type/union/union.mjs").TUnion<[import("../../type/object/object.mjs").TObject<{
+    type: import("../../type/literal/literal.mjs").TLiteral<"insert">;
+    path: import("../../type/string/string.mjs").TString;
+    value: import("../../type/unknown/unknown.mjs").TUnknown;
+}>, import("../../type/object/object.mjs").TObject<{
+    type: import("../../type/literal/literal.mjs").TLiteral<"update">;
+    path: import("../../type/string/string.mjs").TString;
+    value: import("../../type/unknown/unknown.mjs").TUnknown;
+}>, import("../../type/object/object.mjs").TObject<{
+    type: import("../../type/literal/literal.mjs").TLiteral<"delete">;
+    path: import("../../type/string/string.mjs").TString;
+}>]>;
+export declare class ValueDeltaObjectWithSymbolKeyError extends Error {
+    readonly key: unknown;
+    constructor(key: unknown);
+}
+export declare class ValueDeltaUnableToDiffUnknownValue extends Error {
+    readonly value: unknown;
+    constructor(value: unknown);
+}
+export declare function Diff(current: unknown, next: unknown): Edit[];
+export declare function Patch<T = any>(current: unknown, edits: Edit[]): T;

package/esm/value/delta/delta.mjs

@@ -0,0 +1,194 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 { IsPlainObject, IsArray, IsTypedArray, IsValueType, IsSymbol, IsUndefined } from '../guard/index.mjs';
+import { ValuePointer } from '../pointer/index.mjs';
+import { Clone } from '../clone/index.mjs';
+import { Literal as CreateLiteral } from '../../type/literal/index.mjs';
+import { Object as CreateObject } from '../../type/object/index.mjs';
+import { String as CreateString } from '../../type/string/index.mjs';
+import { Unknown as CreateUnknown } from '../../type/unknown/index.mjs';
+import { Union as CreateUnion } from '../../type/union/index.mjs';
+export const Insert = CreateObject({
+    type: CreateLiteral('insert'),
+    path: CreateString(),
+    value: CreateUnknown(),
+});
+export const Update = CreateObject({
+    type: CreateLiteral('update'),
+    path: CreateString(),
+    value: CreateUnknown(),
+});
+export const Delete = CreateObject({
+    type: CreateLiteral('delete'),
+    path: CreateString(),
+});
+export const Edit = CreateUnion([Insert, Update, Delete]);
+// ------------------------------------------------------------------
+// Errors
+// ------------------------------------------------------------------
+export class ValueDeltaObjectWithSymbolKeyError extends Error {
+    key;
+    constructor(key) {
+        super('Cannot diff objects with symbol keys');
+        this.key = key;
+    }
+}
+export class ValueDeltaUnableToDiffUnknownValue extends Error {
+    value;
+    constructor(value) {
+        super('Unable to create diff edits for unknown value');
+        this.value = value;
+    }
+}
+// ------------------------------------------------------------------
+// Command Factory
+// ------------------------------------------------------------------
+function CreateUpdate(path, value) {
+    return { type: 'update', path, value };
+}
+function CreateInsert(path, value) {
+    return { type: 'insert', path, value };
+}
+function CreateDelete(path) {
+    return { type: 'delete', path };
+}
+// ------------------------------------------------------------------
+// Diffing Generators
+// ------------------------------------------------------------------
+function* ObjectType(path, current, next) {
+    if (!IsPlainObject(next))
+        return yield CreateUpdate(path, next);
+    const currentKeys = [...globalThis.Object.keys(current), ...globalThis.Object.getOwnPropertySymbols(current)];
+    const nextKeys = [...globalThis.Object.keys(next), ...globalThis.Object.getOwnPropertySymbols(next)];
+    for (const key of currentKeys) {
+        if (IsSymbol(key))
+            throw new ValueDeltaObjectWithSymbolKeyError(key);
+        if (IsUndefined(next[key]) && nextKeys.includes(key))
+            yield CreateUpdate(`${path}/${globalThis.String(key)}`, undefined);
+    }
+    for (const key of nextKeys) {
+        if (IsUndefined(current[key]) || IsUndefined(next[key]))
+            continue;
+        if (IsSymbol(key))
+            throw new ValueDeltaObjectWithSymbolKeyError(key);
+        yield* Visit(`${path}/${globalThis.String(key)}`, current[key], next[key]);
+    }
+    for (const key of nextKeys) {
+        if (IsSymbol(key))
+            throw new ValueDeltaObjectWithSymbolKeyError(key);
+        if (IsUndefined(current[key]))
+            yield CreateInsert(`${path}/${globalThis.String(key)}`, next[key]);
+    }
+    for (const key of currentKeys.reverse()) {
+        if (IsSymbol(key))
+            throw new ValueDeltaObjectWithSymbolKeyError(key);
+        if (IsUndefined(next[key]) && !nextKeys.includes(key))
+            yield CreateDelete(`${path}/${globalThis.String(key)}`);
+    }
+}
+function* ArrayType(path, current, next) {
+    if (!IsArray(next))
+        return yield CreateUpdate(path, next);
+    for (let i = 0; i < Math.min(current.length, next.length); i++) {
+        yield* Visit(`${path}/${i}`, current[i], next[i]);
+    }
+    for (let i = 0; i < next.length; i++) {
+        if (i < current.length)
+            continue;
+        yield CreateInsert(`${path}/${i}`, next[i]);
+    }
+    for (let i = current.length - 1; i >= 0; i--) {
+        if (i < next.length)
+            continue;
+        yield CreateDelete(`${path}/${i}`);
+    }
+}
+function* TypedArrayType(path, current, next) {
+    if (!IsTypedArray(next) || current.length !== next.length || globalThis.Object.getPrototypeOf(current).constructor.name !== globalThis.Object.getPrototypeOf(next).constructor.name)
+        return yield CreateUpdate(path, next);
+    for (let i = 0; i < Math.min(current.length, next.length); i++) {
+        yield* Visit(`${path}/${i}`, current[i], next[i]);
+    }
+}
+function* ValueType(path, current, next) {
+    if (current === next)
+        return;
+    yield CreateUpdate(path, next);
+}
+function* Visit(path, current, next) {
+    if (IsPlainObject(current))
+        return yield* ObjectType(path, current, next);
+    if (IsArray(current))
+        return yield* ArrayType(path, current, next);
+    if (IsTypedArray(current))
+        return yield* TypedArrayType(path, current, next);
+    if (IsValueType(current))
+        return yield* ValueType(path, current, next);
+    throw new ValueDeltaUnableToDiffUnknownValue(current);
+}
+// ------------------------------------------------------------------
+// Diff
+// ------------------------------------------------------------------
+export function Diff(current, next) {
+    return [...Visit('', current, next)];
+}
+// ------------------------------------------------------------------
+// Patch
+// ------------------------------------------------------------------
+function IsRootUpdate(edits) {
+    return edits.length > 0 && edits[0].path === '' && edits[0].type === 'update';
+}
+function IsIdentity(edits) {
+    return edits.length === 0;
+}
+export function Patch(current, edits) {
+    if (IsRootUpdate(edits)) {
+        return Clone(edits[0].value);
+    }
+    if (IsIdentity(edits)) {
+        return Clone(current);
+    }
+    const clone = Clone(current);
+    for (const edit of edits) {
+        switch (edit.type) {
+            case 'insert': {
+                ValuePointer.Set(clone, edit.path, edit.value);
+                break;
+            }
+            case 'update': {
+                ValuePointer.Set(clone, edit.path, edit.value);
+                break;
+            }
+            case 'delete': {
+                ValuePointer.Delete(clone, edit.path);
+                break;
+            }
+        }
+    }
+    return clone;
+}

package/esm/value/delta/index.d.mts

@@ -0,0 +1 @@
+export * from './delta.mjs';

package/esm/value/delta/index.mjs

@@ -0,0 +1,28 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 * from './delta.mjs';

package/{value/deref.d.ts → esm/value/deref/deref.d.mts}

@@ -1,5 +1,7 @@
-import { TypeBoxError, TSchema, TRef, TThis } from '../typebox';
-export declare class TypeDereferenceError extends TypeBoxError {
+import type { TSchema } from '../../type/schema/index.mjs';
+import type { TRef } from '../../type/ref/index.mjs';
+import type { TThis } from '../../type/recursive/index.mjs';
+export declare class TypeDereferenceError extends Error {
     readonly schema: TRef | TThis;
     constructor(schema: TRef | TThis);
 }

package/esm/value/deref/deref.mjs

@@ -0,0 +1,41 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 class TypeDereferenceError extends Error {
+    schema;
+    constructor(schema) {
+        super(`Unable to dereference schema with $id '${schema.$id}'`);
+        this.schema = schema;
+    }
+}
+/** Dereferences a schema from the references array or throws if not found */
+export function Deref(schema, references) {
+    const index = references.findIndex((target) => target.$id === schema.$ref);
+    if (index === -1)
+        throw new TypeDereferenceError(schema);
+    return references[index];
+}

package/esm/value/deref/index.d.mts

@@ -0,0 +1 @@
+export * from './deref.mjs';

package/esm/value/deref/index.mjs

@@ -0,0 +1,28 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 * from './deref.mjs';

package/esm/value/equal/equal.mjs

@@ -0,0 +1,73 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 { IsPlainObject, IsDate, IsArray, IsTypedArray, IsValueType } from '../guard/index.mjs';
+// ------------------------------------------------------------------
+// Equality Checks
+// ------------------------------------------------------------------
+function ObjectType(left, right) {
+    if (!IsPlainObject(right))
+        return false;
+    const leftKeys = [...Object.keys(left), ...Object.getOwnPropertySymbols(left)];
+    const rightKeys = [...Object.keys(right), ...Object.getOwnPropertySymbols(right)];
+    if (leftKeys.length !== rightKeys.length)
+        return false;
+    return leftKeys.every((key) => Equal(left[key], right[key]));
+}
+function DateType(left, right) {
+    return IsDate(right) && left.getTime() === right.getTime();
+}
+function ArrayType(left, right) {
+    if (!IsArray(right) || left.length !== right.length)
+        return false;
+    return left.every((value, index) => Equal(value, right[index]));
+}
+function TypedArrayType(left, right) {
+    if (!IsTypedArray(right) || left.length !== right.length || Object.getPrototypeOf(left).constructor.name !== Object.getPrototypeOf(right).constructor.name)
+        return false;
+    return left.every((value, index) => Equal(value, right[index]));
+}
+function ValueType(left, right) {
+    return left === right;
+}
+// ------------------------------------------------------------------
+// Equal
+// ------------------------------------------------------------------
+/** Returns true if the left value deep-equals the right */
+export function Equal(left, right) {
+    if (IsPlainObject(left))
+        return ObjectType(left, right);
+    if (IsDate(left))
+        return DateType(left, right);
+    if (IsTypedArray(left))
+        return TypedArrayType(left, right);
+    if (IsArray(left))
+        return ArrayType(left, right);
+    if (IsValueType(left))
+        return ValueType(left, right);
+    throw new Error('ValueEquals: Unable to compare value');
+}

package/esm/value/equal/index.d.mts

@@ -0,0 +1 @@
+export * from './equal.mjs';

package/esm/value/equal/index.mjs

@@ -0,0 +1,28 @@
+/*--------------------------------------------------------------------------
+
+@sinclair/typebox/value
+
+The MIT License (MIT)
+
+Copyright (c) 2017-2023 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
+
+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 * from './equal.mjs';