typebox 1.0.5 → 1.0.6

package/build/guard/guard.d.mts

@@ -34,6 +34,8 @@ export declare function IsLessThan<Type extends number | bigint>(left: Type, rig
 export declare function IsLessEqualThan<Type extends number | bigint>(left: Type, right: Type): boolean;
 export declare function IsGreaterEqualThan<Type extends number | bigint>(left: Type, right: Type): boolean;
 export declare function IsMultipleOf(dividend: bigint | number, divisor: bigint | number): boolean;
+/** Returns true if the value appears to be an instance of a class. */
+export declare function IsClassInstance(value: unknown): boolean;
 export declare function IsValueLike(value: unknown): value is bigint | boolean | null | number | string | undefined;
 /** Returns the number of Unicode Grapheme Clusters */
 export declare function StringGraphemeCount(value: string): number;

package/build/guard/guard.mjs

@@ -102,6 +102,20 @@ export function IsMultipleOf(dividend, divisor) {
     return Math.min(Math.abs(mod), Math.abs(mod - divisor)) < tolerance;
 }
 // ------------------------------------------------------------------
+// IsClassInstance
+// ------------------------------------------------------------------
+/** Returns true if the value appears to be an instance of a class. */
+export function IsClassInstance(value) {
+    if (!IsObject(value))
+        return false;
+    const proto = globalThis.Object.getPrototypeOf(value);
+    if (IsNull(proto))
+        return false;
+    return IsEqual(typeof proto.constructor, 'function') &&
+        !(IsEqual(proto.constructor, globalThis.Object) ||
+            IsEqual(proto.constructor.name, 'Object'));
+}
+// ------------------------------------------------------------------
 // IsValueLike
 // ------------------------------------------------------------------
 export function IsValueLike(value) {

package/build/value/clone/clone.mjs

@@ -1,9 +1,22 @@
 // deno-fmt-ignore-file
 import { Guard, GlobalsGuard } from '../../guard/index.mjs';
 // ------------------------------------------------------------------
-// Object
+// ClassInstance
+//
+// TypeBox does not support cloning arbitrary class instances. It treats
+// class instances as atomic values, similar to number, boolean, and
+// string. In the future, an implementation could detect the presence of
+// a .clone() method, but no formal specification for this behavior
+// exists, so we don't.
+//
 // ------------------------------------------------------------------
-function FromObject(value) {
+function FromClassInstance(value) {
+    return value; // atomic
+}
+// ------------------------------------------------------------------
+// ObjectInstance
+// ------------------------------------------------------------------
+function FromObjectInstance(value) {
     const result = {};
     for (const key of Object.getOwnPropertyNames(value)) {
         result[key] = Clone(value[key]);
@@ -14,6 +27,14 @@ function FromObject(value) {
     return result;
 }
 // ------------------------------------------------------------------
+// Object
+// ------------------------------------------------------------------
+function FromObject(value) {
+    return (Guard.IsClassInstance(value)
+        ? FromClassInstance(value)
+        : FromObjectInstance(value));
+}
+// ------------------------------------------------------------------
 // Array
 // ------------------------------------------------------------------
 function FromArray(value) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "typebox",
   "description": "A Runtime Type System for JavaScript",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "keywords": [
     "typescript",
     "jsonschema"

package/readme.md

@@ -49,7 +49,7 @@ type T = Static<typeof T>                           // type T = {
 
 ## Overview
 
-[Documentation](https://sinclairzx81.github.io/typebox/)
+[Documentation](https://sinclairzx81.github.io/typebox/) | [1.0 Migration Guide](https://github.com/sinclairzx81/typebox/blob/main/changelog/1.0.0-migration.md)
 
 TypeBox is a runtime type system that creates in-memory Json Schema objects that infer as TypeScript types. The schematics produced by this library are designed to match the static type checking rules of the TypeScript compiler. TypeBox offers a unified type system that can be statically checked by TypeScript and validated at runtime using standard Json Schema.