@oscarpalmer/atoms 0.19.0 → 0.21.0

package/dist/js/index.js

@@ -275,8 +275,17 @@ function getString(value) {
   const result = value?.toString?.() ?? value;
   return result?.toString?.() ?? String(result);
 }
-function isNullableOrWhitespace(value) {
-  return value == null || getString(value).trim().length === 0;
+
+// src/js/is.ts
+function isArrayOrPlainObject(value) {
+  return Array.isArray(value) || isPlainObject(value);
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
 }
 
 // src/js/value.ts
@@ -286,13 +295,13 @@ var _getDiffs = function(first, second, prefix) {
   let outer = 0;
   for (;outer < 2; outer += 1) {
     const value = outer === 0 ? first : second;
-    if (!isArrayOrObject(value)) {
+    if (!value) {
       continue;
     }
     const keys = Object.keys(value);
-    const size = keys.length;
+    const { length } = keys;
     let inner = 0;
-    for (;inner < size; inner += 1) {
+    for (;inner < length; inner += 1) {
       const key = keys[inner];
       if (checked.has(key)) {
         continue;
@@ -306,7 +315,9 @@ var _getDiffs = function(first, second, prefix) {
           to,
           key: prefixed
         });
-        changes.push(..._getDiffs(from, to, prefixed));
+        if (isArrayOrPlainObject(from) && isArrayOrPlainObject(to)) {
+          changes.push(..._getDiffs(from, to, prefixed));
+        }
       }
       checked.add(key);
     }
@@ -345,8 +356,8 @@ function diff(first, second) {
     values: {}
   };
   const same = Object.is(first, second);
-  const firstIsArrayOrObject = isArrayOrObject(first);
-  const secondIsArrayOrObject = isArrayOrObject(second);
+  const firstIsArrayOrObject = isArrayOrPlainObject(first);
+  const secondIsArrayOrObject = isArrayOrPlainObject(second);
   if (same || !firstIsArrayOrObject && !secondIsArrayOrObject) {
     result.type = same ? "none" : "full";
     return result;
@@ -379,20 +390,11 @@ function get(data, key) {
   }
   return value;
 }
-function isArrayOrObject(value) {
-  return /^(array|object)$/i.test(value?.constructor?.name);
-}
-function isNullable(value) {
-  return value == null;
-}
-function isObject(value) {
-  return /^object$/i.test(value?.constructor?.name);
-}
 function merge(...values) {
   if (values.length === 0) {
     return {};
   }
-  const actual = values.filter(isArrayOrObject);
+  const actual = values.filter((value) => isArrayOrPlainObject(value));
   const result = actual.every(Array.isArray) ? [] : {};
   const { length } = actual;
   let itemIndex = 0;
@@ -405,8 +407,8 @@ function merge(...values) {
       const key = keys[keyIndex];
       const next = item[key];
       const previous = result[key];
-      if (isArrayOrObject(next)) {
-        result[key] = isArrayOrObject(previous) ? merge(previous, next) : merge(next);
+      if (isArrayOrPlainObject(next)) {
+        result[key] = isArrayOrPlainObject(previous) ? merge(previous, next) : merge(next);
       } else {
         result[key] = next;
       }
@@ -417,11 +419,12 @@ function merge(...values) {
 function set(data, key, value) {
   const parts = getString(key).split(".");
   const { length } = parts;
+  const lastIndex = length - 1;
   let index = 0;
   let target = typeof data === "object" ? data ?? {} : {};
   for (;index < length; index += 1) {
     const part = parts[index];
-    if (parts.indexOf(part) === parts.length - 1) {
+    if (parts.indexOf(part) === lastIndex) {
       _setValue(target, part, value);
       break;
     }
@@ -436,36 +439,50 @@ function set(data, key, value) {
 }
 
 // src/js/proxy.ts
-var _createProxy = function(blob, value2) {
-  if (!isArrayOrObject(value2) || _isProxy(value2)) {
+var _createProxy = function(existing, value2) {
+  if (!isArrayOrPlainObject(value2) || _isProxy(value2) && value2.$ === existing) {
     return value2;
   }
   const isArray = Array.isArray(value2);
-  const proxyBlob = blob ?? new ProxyBlob;
-  const proxyValue = new Proxy(isArray ? [] : {}, {});
-  Object.defineProperty(proxyValue, "$", {
-    value: proxyBlob
+  const proxy = new Proxy(isArray ? [] : {}, {
+    get(target, property) {
+      return property === "$" ? manager : Reflect.get(target, property);
+    },
+    set(target, property, value3) {
+      return property === "$" || Reflect.set(target, property, _createProxy(manager, value3));
+    }
+  });
+  const manager = existing ?? new Manager(proxy);
+  Object.defineProperty(proxy, "$", {
+    value: manager
   });
   const keys = Object.keys(value2);
-  const size = keys.length ?? 0;
+  const { length } = keys;
   let index = 0;
-  for (;index < size; index += 1) {
+  for (;index < length; index += 1) {
     const key = keys[index];
-    proxyValue[key] = _createProxy(proxyBlob, value2[key]);
+    proxy[key] = value2[key];
   }
-  return proxyValue;
+  return proxy;
 };
 var _isProxy = function(value2) {
-  return value2?.$ instanceof ProxyBlob;
+  return value2?.$ instanceof Manager;
 };
 function proxy(value2) {
-  if (!isArrayOrObject(value2)) {
+  if (!isArrayOrPlainObject(value2)) {
     throw new Error("Proxy value must be an array or object");
   }
   return _createProxy(undefined, value2);
 }
 
-class ProxyBlob {
+class Manager {
+  owner;
+  constructor(owner) {
+    this.owner = owner;
+  }
+  clone() {
+    return clone(merge(this.owner));
+  }
 }
 // src/js/timer.ts
 function repeat(callback, options) {
@@ -559,10 +576,6 @@ export {
   push,
   proxy,
   merge,
-  isObject,
-  isNullableOrWhitespace,
-  isNullable,
-  isArrayOrObject,
   insert,
   indexOf,
   groupBy,

package/dist/js/is.js

@@ -0,0 +1,44 @@
+// src/js/string.ts
+function getString(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  const result = value?.toString?.() ?? value;
+  return result?.toString?.() ?? String(result);
+}
+
+// src/js/is.ts
+function isArrayOrPlainObject(value) {
+  return Array.isArray(value) || isPlainObject(value);
+}
+function isNullable(value) {
+  return value == null;
+}
+function isNullableOrWhitespace(value) {
+  return value == null || getString(value).trim().length === 0;
+}
+function isNumber(value) {
+  return typeof value === "number" && !Number.isNaN(value);
+}
+function isNumerical(value) {
+  return isNumber(value) || typeof value === "string" && value.trim().length > 0 && !Number.isNaN(+value);
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null || typeof value === "function";
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
+}
+export {
+  isPlainObject,
+  isObject,
+  isNumerical,
+  isNumber,
+  isNullableOrWhitespace,
+  isNullable,
+  isArrayOrPlainObject
+};

package/dist/js/is.mjs

@@ -0,0 +1,36 @@
+// src/js/is.ts
+import {getString} from "./string";
+function isArrayOrPlainObject(value) {
+  return Array.isArray(value) || isPlainObject(value);
+}
+function isNullable(value) {
+  return value == null;
+}
+function isNullableOrWhitespace(value) {
+  return value == null || getString(value).trim().length === 0;
+}
+function isNumber(value) {
+  return typeof value === "number" && !Number.isNaN(value);
+}
+function isNumerical(value) {
+  return isNumber(value) || typeof value === "string" && value.trim().length > 0 && !Number.isNaN(+value);
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null || typeof value === "function";
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
+}
+export {
+  isPlainObject,
+  isObject,
+  isNumerical,
+  isNumber,
+  isNullableOrWhitespace,
+  isNullable,
+  isArrayOrPlainObject
+};

package/dist/js/proxy.js

@@ -1,39 +1,91 @@
+// src/js/is.ts
+function isArrayOrPlainObject(value) {
+  return Array.isArray(value) || isPlainObject(value);
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
+}
+
 // src/js/value.ts
-function isArrayOrObject(value) {
-  return /^(array|object)$/i.test(value?.constructor?.name);
+function clone(value) {
+  return structuredClone(value);
+}
+function merge(...values) {
+  if (values.length === 0) {
+    return {};
+  }
+  const actual = values.filter((value) => isArrayOrPlainObject(value));
+  const result = actual.every(Array.isArray) ? [] : {};
+  const { length } = actual;
+  let itemIndex = 0;
+  for (;itemIndex < length; itemIndex += 1) {
+    const item = actual[itemIndex];
+    const keys = Object.keys(item);
+    const size = keys.length;
+    let keyIndex = 0;
+    for (;keyIndex < size; keyIndex += 1) {
+      const key = keys[keyIndex];
+      const next = item[key];
+      const previous = result[key];
+      if (isArrayOrPlainObject(next)) {
+        result[key] = isArrayOrPlainObject(previous) ? merge(previous, next) : merge(next);
+      } else {
+        result[key] = next;
+      }
+    }
+  }
+  return result;
 }
 
 // src/js/proxy.ts
-var _createProxy = function(blob, value2) {
-  if (!isArrayOrObject(value2) || _isProxy(value2)) {
+var _createProxy = function(existing, value2) {
+  if (!isArrayOrPlainObject(value2) || _isProxy(value2) && value2.$ === existing) {
     return value2;
   }
   const isArray = Array.isArray(value2);
-  const proxyBlob = blob ?? new ProxyBlob;
-  const proxyValue = new Proxy(isArray ? [] : {}, {});
-  Object.defineProperty(proxyValue, "$", {
-    value: proxyBlob
+  const proxy = new Proxy(isArray ? [] : {}, {
+    get(target, property) {
+      return property === "$" ? manager : Reflect.get(target, property);
+    },
+    set(target, property, value3) {
+      return property === "$" || Reflect.set(target, property, _createProxy(manager, value3));
+    }
+  });
+  const manager = existing ?? new Manager(proxy);
+  Object.defineProperty(proxy, "$", {
+    value: manager
   });
   const keys = Object.keys(value2);
-  const size = keys.length ?? 0;
+  const { length } = keys;
   let index = 0;
-  for (;index < size; index += 1) {
+  for (;index < length; index += 1) {
     const key = keys[index];
-    proxyValue[key] = _createProxy(proxyBlob, value2[key]);
+    proxy[key] = value2[key];
   }
-  return proxyValue;
+  return proxy;
 };
 var _isProxy = function(value2) {
-  return value2?.$ instanceof ProxyBlob;
+  return value2?.$ instanceof Manager;
 };
 function proxy(value2) {
-  if (!isArrayOrObject(value2)) {
+  if (!isArrayOrPlainObject(value2)) {
     throw new Error("Proxy value must be an array or object");
   }
   return _createProxy(undefined, value2);
 }
 
-class ProxyBlob {
+class Manager {
+  owner;
+  constructor(owner) {
+    this.owner = owner;
+  }
+  clone() {
+    return clone(merge(this.owner));
+  }
 }
 export {
   proxy

package/dist/js/proxy.mjs

@@ -1,35 +1,50 @@
 // src/js/proxy.ts
-import {isArrayOrObject} from "./value";
-var _createProxy = function(blob, value2) {
-  if (!isArrayOrObject(value2) || _isProxy(value2)) {
+import {isArrayOrPlainObject} from "./is";
+import {clone, merge} from "./value";
+var _createProxy = function(existing, value2) {
+  if (!isArrayOrPlainObject(value2) || _isProxy(value2) && value2.$ === existing) {
     return value2;
   }
   const isArray = Array.isArray(value2);
-  const proxyBlob = blob ?? new ProxyBlob;
-  const proxyValue = new Proxy(isArray ? [] : {}, {});
-  Object.defineProperty(proxyValue, "$", {
-    value: proxyBlob
+  const proxy = new Proxy(isArray ? [] : {}, {
+    get(target, property) {
+      return property === "$" ? manager : Reflect.get(target, property);
+    },
+    set(target, property, value3) {
+      return property === "$" || Reflect.set(target, property, _createProxy(manager, value3));
+    }
+  });
+  const manager = existing ?? new Manager(proxy);
+  Object.defineProperty(proxy, "$", {
+    value: manager
   });
   const keys = Object.keys(value2);
-  const size = keys.length ?? 0;
+  const { length } = keys;
   let index = 0;
-  for (;index < size; index += 1) {
+  for (;index < length; index += 1) {
     const key = keys[index];
-    proxyValue[key] = _createProxy(proxyBlob, value2[key]);
+    proxy[key] = value2[key];
   }
-  return proxyValue;
+  return proxy;
 };
 var _isProxy = function(value2) {
-  return value2?.$ instanceof ProxyBlob;
+  return value2?.$ instanceof Manager;
 };
 function proxy(value2) {
-  if (!isArrayOrObject(value2)) {
+  if (!isArrayOrPlainObject(value2)) {
     throw new Error("Proxy value must be an array or object");
   }
   return _createProxy(undefined, value2);
 }
 
-class ProxyBlob {
+class Manager {
+  owner;
+  constructor(owner) {
+    this.owner = owner;
+  }
+  clone() {
+    return clone(merge(this.owner));
+  }
 }
 export {
   proxy

package/dist/js/string.js

@@ -9,11 +9,7 @@ function getString(value) {
   const result = value?.toString?.() ?? value;
   return result?.toString?.() ?? String(result);
 }
-function isNullableOrWhitespace(value) {
-  return value == null || getString(value).trim().length === 0;
-}
 export {
-  isNullableOrWhitespace,
   getString,
   createUuid
 };

package/dist/js/string.mjs

@@ -9,11 +9,7 @@ function getString(value) {
   const result = value?.toString?.() ?? value;
   return result?.toString?.() ?? String(result);
 }
-function isNullableOrWhitespace(value) {
-  return value == null || getString(value).trim().length === 0;
-}
 export {
-  isNullableOrWhitespace,
   getString,
   createUuid
 };

package/dist/js/value.js

@@ -7,6 +7,18 @@ function getString(value) {
   return result?.toString?.() ?? String(result);
 }
 
+// src/js/is.ts
+function isArrayOrPlainObject(value) {
+  return Array.isArray(value) || isPlainObject(value);
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
+}
+
 // src/js/value.ts
 var _getDiffs = function(first, second, prefix) {
   const changes = [];
@@ -14,13 +26,13 @@ var _getDiffs = function(first, second, prefix) {
   let outer = 0;
   for (;outer < 2; outer += 1) {
     const value = outer === 0 ? first : second;
-    if (!isArrayOrObject(value)) {
+    if (!value) {
       continue;
     }
     const keys = Object.keys(value);
-    const size = keys.length;
+    const { length } = keys;
     let inner = 0;
-    for (;inner < size; inner += 1) {
+    for (;inner < length; inner += 1) {
       const key = keys[inner];
       if (checked.has(key)) {
         continue;
@@ -34,7 +46,9 @@ var _getDiffs = function(first, second, prefix) {
           to,
           key: prefixed
         });
-        changes.push(..._getDiffs(from, to, prefixed));
+        if (isArrayOrPlainObject(from) && isArrayOrPlainObject(to)) {
+          changes.push(..._getDiffs(from, to, prefixed));
+        }
       }
       checked.add(key);
     }
@@ -73,8 +87,8 @@ function diff(first, second) {
     values: {}
   };
   const same = Object.is(first, second);
-  const firstIsArrayOrObject = isArrayOrObject(first);
-  const secondIsArrayOrObject = isArrayOrObject(second);
+  const firstIsArrayOrObject = isArrayOrPlainObject(first);
+  const secondIsArrayOrObject = isArrayOrPlainObject(second);
   if (same || !firstIsArrayOrObject && !secondIsArrayOrObject) {
     result.type = same ? "none" : "full";
     return result;
@@ -107,20 +121,11 @@ function get(data, key) {
   }
   return value;
 }
-function isArrayOrObject(value) {
-  return /^(array|object)$/i.test(value?.constructor?.name);
-}
-function isNullable(value) {
-  return value == null;
-}
-function isObject(value) {
-  return /^object$/i.test(value?.constructor?.name);
-}
 function merge(...values) {
   if (values.length === 0) {
     return {};
   }
-  const actual = values.filter(isArrayOrObject);
+  const actual = values.filter((value) => isArrayOrPlainObject(value));
   const result = actual.every(Array.isArray) ? [] : {};
   const { length } = actual;
   let itemIndex = 0;
@@ -133,8 +138,8 @@ function merge(...values) {
       const key = keys[keyIndex];
       const next = item[key];
       const previous = result[key];
-      if (isArrayOrObject(next)) {
-        result[key] = isArrayOrObject(previous) ? merge(previous, next) : merge(next);
+      if (isArrayOrPlainObject(next)) {
+        result[key] = isArrayOrPlainObject(previous) ? merge(previous, next) : merge(next);
       } else {
         result[key] = next;
       }
@@ -145,11 +150,12 @@ function merge(...values) {
 function set(data, key, value) {
   const parts = getString(key).split(".");
   const { length } = parts;
+  const lastIndex = length - 1;
   let index = 0;
   let target = typeof data === "object" ? data ?? {} : {};
   for (;index < length; index += 1) {
     const part = parts[index];
-    if (parts.indexOf(part) === parts.length - 1) {
+    if (parts.indexOf(part) === lastIndex) {
       _setValue(target, part, value);
       break;
     }
@@ -165,9 +171,6 @@ function set(data, key, value) {
 export {
   set,
   merge,
-  isObject,
-  isNullable,
-  isArrayOrObject,
   get,
   diff,
   clone

package/dist/js/value.mjs

@@ -1,4 +1,5 @@
 // src/js/value.ts
+import {isArrayOrPlainObject} from "./is";
 import {getString} from "./string";
 var _getDiffs = function(first, second, prefix) {
   const changes = [];
@@ -6,13 +7,13 @@ var _getDiffs = function(first, second, prefix) {
   let outer = 0;
   for (;outer < 2; outer += 1) {
     const value = outer === 0 ? first : second;
-    if (!isArrayOrObject(value)) {
+    if (!value) {
       continue;
     }
     const keys = Object.keys(value);
-    const size = keys.length;
+    const { length } = keys;
     let inner = 0;
-    for (;inner < size; inner += 1) {
+    for (;inner < length; inner += 1) {
       const key = keys[inner];
       if (checked.has(key)) {
         continue;
@@ -26,7 +27,9 @@ var _getDiffs = function(first, second, prefix) {
           to,
           key: prefixed
         });
-        changes.push(..._getDiffs(from, to, prefixed));
+        if (isArrayOrPlainObject(from) && isArrayOrPlainObject(to)) {
+          changes.push(..._getDiffs(from, to, prefixed));
+        }
       }
       checked.add(key);
     }
@@ -65,8 +68,8 @@ function diff(first, second) {
     values: {}
   };
   const same = Object.is(first, second);
-  const firstIsArrayOrObject = isArrayOrObject(first);
-  const secondIsArrayOrObject = isArrayOrObject(second);
+  const firstIsArrayOrObject = isArrayOrPlainObject(first);
+  const secondIsArrayOrObject = isArrayOrPlainObject(second);
   if (same || !firstIsArrayOrObject && !secondIsArrayOrObject) {
     result.type = same ? "none" : "full";
     return result;
@@ -99,20 +102,11 @@ function get(data, key) {
   }
   return value;
 }
-function isArrayOrObject(value) {
-  return /^(array|object)$/i.test(value?.constructor?.name);
-}
-function isNullable(value) {
-  return value == null;
-}
-function isObject(value) {
-  return /^object$/i.test(value?.constructor?.name);
-}
 function merge(...values) {
   if (values.length === 0) {
     return {};
   }
-  const actual = values.filter(isArrayOrObject);
+  const actual = values.filter((value) => isArrayOrPlainObject(value));
   const result = actual.every(Array.isArray) ? [] : {};
   const { length } = actual;
   let itemIndex = 0;
@@ -125,8 +119,8 @@ function merge(...values) {
       const key = keys[keyIndex];
       const next = item[key];
       const previous = result[key];
-      if (isArrayOrObject(next)) {
-        result[key] = isArrayOrObject(previous) ? merge(previous, next) : merge(next);
+      if (isArrayOrPlainObject(next)) {
+        result[key] = isArrayOrPlainObject(previous) ? merge(previous, next) : merge(next);
       } else {
         result[key] = next;
       }
@@ -137,11 +131,12 @@ function merge(...values) {
 function set(data, key, value) {
   const parts = getString(key).split(".");
   const { length } = parts;
+  const lastIndex = length - 1;
   let index = 0;
   let target = typeof data === "object" ? data ?? {} : {};
   for (;index < length; index += 1) {
     const part = parts[index];
-    if (parts.indexOf(part) === parts.length - 1) {
+    if (parts.indexOf(part) === lastIndex) {
       _setValue(target, part, value);
       break;
     }
@@ -157,9 +152,6 @@ function set(data, key, value) {
 export {
   set,
   merge,
-  isObject,
-  isNullable,
-  isArrayOrObject,
   get,
   diff,
   clone

package/package.json

@@ -36,6 +36,12 @@
 			"require": "./dist/js/element/focusable.js",
 			"types": "./types/element/focusable.d.ts"
 		},
+		"./is": {
+			"bun": "./src/js/is.ts",
+			"import": "./dist/js/is.mjs",
+			"require": "./dist/js/is.js",
+			"types": "./types/is.d.ts"
+		},
 		"./number": {
 			"bun": "./src/js/number.ts",
 			"import": "./dist/js/number.mjs",
@@ -99,5 +105,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.19.0"
+	"version": "0.21.0"
 }

package/src/js/array.ts

@@ -1,4 +1,5 @@
-import {GenericObject, Key} from './value';
+import {PlainObject} from './is';
+import {Key} from './value';
 
 type BooleanCallback<T> = (item: T, index: number, array: T[]) => boolean;
 
@@ -35,7 +36,7 @@ function _getCallbacks<T>(
 	}
 
 	return {
-		key: (item: T) => (item as GenericObject)?.[key as string] as Key,
+		key: (item: T) => (item as PlainObject)?.[key as string] as Key,
 	};
 }
 

package/src/js/is.ts

@@ -0,0 +1,77 @@
+import {getString} from './string';
+
+export type ArrayOrPlainObject = unknown[] | PlainObject;
+
+export type PlainObject = Record<string, unknown>;
+
+/**
+ * Is the value an array or a plain object?
+ */
+export function isArrayOrPlainObject(
+	value: unknown,
+): value is ArrayOrPlainObject {
+	return Array.isArray(value) || isPlainObject(value);
+}
+
+/**
+ * Is the value undefined or null?
+ */
+export function isNullable(value: unknown): value is undefined | null {
+	return value == null;
+}
+
+/**
+ * Is the value undefined, null, or an empty string?
+ */
+export function isNullableOrWhitespace(
+	value: unknown,
+): value is undefined | null | '' {
+	return value == null || getString(value).trim().length === 0;
+}
+
+/**
+ * Is the value a number?
+ */
+export function isNumber(value: unknown): value is number {
+	return typeof value === 'number' && !Number.isNaN(value);
+}
+
+/**
+ * Is the value a number, or a number-like string?
+ */
+export function isNumerical(value: unknown): value is number | `${number}` {
+	return (
+		isNumber(value) ||
+		(typeof value === 'string' &&
+			value.trim().length > 0 &&
+			!Number.isNaN(+value))
+	);
+}
+
+/**
+ * Is the value an object?
+ */
+export function isObject(value: unknown): value is object {
+	return (
+		(typeof value === 'object' && value !== null) || typeof value === 'function'
+	);
+}
+
+/**
+ * Is the value a generic object?
+ */
+export function isPlainObject(value: unknown): value is PlainObject {
+	if (typeof value !== 'object' || value === null) {
+		return false;
+	}
+
+	const prototype = Object.getPrototypeOf(value);
+
+	return (
+		(prototype === null ||
+			prototype === Object.prototype ||
+			Object.getPrototypeOf(prototype) === null) &&
+		!(Symbol.toStringTag in value) &&
+		!(Symbol.iterator in value)
+	);
+}

package/src/js/proxy.ts

@@ -1,49 +1,71 @@
-import {ArrayOrObject, GenericObject, isArrayOrObject} from './value';
+import {ArrayOrPlainObject, PlainObject, isArrayOrPlainObject} from './is';
+import {clone, merge} from './value';
 
-class ProxyBlob {}
+class Manager<T extends ArrayOrPlainObject = PlainObject> {
+	constructor(readonly owner: Proxied<T>) {}
 
-type ProxyValue = {
-	$: ProxyBlob;
-};
+	clone(): Proxied<T> {
+		return clone(merge(this.owner)) as Proxied<T>;
+	}
+}
+
+export type Proxied<T extends ArrayOrPlainObject = PlainObject> = {
+	$: Manager<T>;
+} & T;
 
-function _createProxy<T extends ArrayOrObject>(
-	blob: ProxyBlob | undefined,
+function _createProxy<T extends ArrayOrPlainObject>(
+	existing: Manager | undefined,
 	value: T,
-): T {
-	if (!isArrayOrObject(value) || _isProxy(value)) {
+): unknown {
+	if (
+		!isArrayOrPlainObject(value) ||
+		(_isProxy(value) && value.$ === existing)
+	) {
 		return value;
 	}
 
 	const isArray = Array.isArray(value);
-	const proxyBlob = blob ?? new ProxyBlob();
-	const proxyValue = new Proxy(isArray ? [] : {}, {});
 
-	Object.defineProperty(proxyValue, '$', {
-		value: proxyBlob,
+	const proxy = new Proxy(isArray ? [] : {}, {
+		get(target, property) {
+			return property === '$' ? manager : Reflect.get(target, property);
+		},
+		set(target, property, value) {
+			return (
+				property === '$' ||
+				Reflect.set(target, property, _createProxy(manager, value))
+			);
+		},
+	}) as Proxied;
+
+	const manager = existing ?? new Manager(proxy);
+
+	Object.defineProperty(proxy, '$', {
+		value: manager,
 	});
 
-	const keys =  Object.keys(value);
-	const size = keys.length ?? 0;
+	const keys = Object.keys(value);
+	const {length} = keys;
 
 	let index = 0;
 
-	for (; index < size; index += 1) {
+	for (; index < length; index += 1) {
 		const key = keys[index];
 
-		proxyValue[key as never] = _createProxy(proxyBlob, value[key as never]);
+		proxy[key as never] = value[key as never];
 	}
 
-	return proxyValue as T;
+	return proxy;
 }
 
-function _isProxy(value: unknown): value is ProxyValue {
-	return (value as GenericObject)?.$ instanceof ProxyBlob;
+function _isProxy(value: unknown): value is Proxied {
+	return (value as Proxied)?.$ instanceof Manager;
 }
 
-export function proxy<T extends ArrayOrObject>(value: T): T {
-	if (!isArrayOrObject(value)) {
+export function proxy<T extends PlainObject>(value: T): Proxied<T> {
+	if (!isArrayOrPlainObject(value)) {
 		throw new Error('Proxy value must be an array or object');
 	}
 
-	return _createProxy(undefined, value);
+	return _createProxy(undefined, value) as Proxied<T>;
 }

package/src/js/string.ts

@@ -24,12 +24,3 @@ export function getString(value: unknown): string {
 
 	return result?.toString?.() ?? String(result);
 }
-
-/**
- * Is the value undefined, null, or an empty string?
- */
-export function isNullableOrWhitespace(
-	value: unknown,
-): value is undefined | null | '' {
-	return value == null || getString(value).trim().length === 0;
-}

package/src/js/value.ts

@@ -1,7 +1,7 @@
+import {chunk} from './array';
+import {ArrayOrPlainObject, PlainObject, isArrayOrPlainObject} from './is';
 import {getString} from './string';
 
-export type ArrayOrObject = unknown[] | GenericObject;
-
 export type DiffType = 'full' | 'none' | 'partial';
 
 export type DiffResult<T1 = unknown, T2 = T1> = {
@@ -15,15 +15,13 @@ export type DiffValue<T1 = unknown, T2 = T1> = {
 	to: T2;
 };
 
-export type GenericObject = Record<string, unknown>;
-
 export type Key = number | string;
 
 type KeyedDiffValue = {
 	key: string;
 } & DiffValue;
 
-export type ValueObject = ArrayOrObject | Map<unknown, unknown>;
+export type ValueObject = ArrayOrPlainObject | Map<unknown, unknown>;
 
 function _getDiffs(
 	first: unknown,
@@ -38,16 +36,16 @@ function _getDiffs(
 	for (; outer < 2; outer += 1) {
 		const value = outer === 0 ? first : second;
 
-		if (!isArrayOrObject(value)) {
+		if (!value) {
 			continue;
 		}
 
 		const keys = Object.keys(value);
-		const size = keys.length;
+		const {length} = keys;
 
 		let inner = 0;
 
-		for (; inner < size; inner += 1) {
+		for (; inner < length; inner += 1) {
 			const key = keys[inner];
 
 			if (checked.has(key)) {
@@ -66,7 +64,9 @@ function _getDiffs(
 					key: prefixed,
 				});
 
-				changes.push(..._getDiffs(from, to, prefixed));
+				if (isArrayOrPlainObject(from) && isArrayOrPlainObject(to)) {
+					changes.push(..._getDiffs(from, to, prefixed));
+				}
 			}
 
 			checked.add(key);
@@ -121,6 +121,16 @@ export function clone<T>(value: T): T {
 	return structuredClone(value);
 }
 
+/**
+ * - Find the differences between two values
+ * - Returns an object holding the result:
+ * 	- `original` holds the original values
+ * 	- `type` is the type of difference:
+ * 		- `full` if the values are completely different
+ * 		- `none` if the values are the same
+ * 		- `partial` if the values are partially different
+ * 	- `values` holds the differences with dot-notation keys
+ */
 export function diff<T1 = unknown, T2 = T1>(
 	first: T1,
 	second: T2,
@@ -136,8 +146,8 @@ export function diff<T1 = unknown, T2 = T1>(
 
 	const same = Object.is(first, second);
 
-	const firstIsArrayOrObject = isArrayOrObject(first);
-	const secondIsArrayOrObject = isArrayOrObject(second);
+	const firstIsArrayOrObject = isArrayOrPlainObject(first);
+	const secondIsArrayOrObject = isArrayOrPlainObject(second);
 
 	if (same || (!firstIsArrayOrObject && !secondIsArrayOrObject)) {
 		result.type = same ? 'none' : 'full';
@@ -190,37 +200,19 @@ export function get(data: ValueObject, key: Key): unknown {
 	return value;
 }
 
-/**
- * Is the value an array or a generic object?
- */
-export function isArrayOrObject(value: unknown): value is ArrayOrObject {
-	return /^(array|object)$/i.test((value as ArrayOrObject)?.constructor?.name);
-}
-
-/**
- * Is the value undefined or null?
- */
-export function isNullable(value: unknown): value is undefined | null {
-	return value == null;
-}
-
-/**
- * Is the value a generic object?
- */
-export function isObject(value: unknown): value is GenericObject {
-	return /^object$/i.test((value as GenericObject)?.constructor?.name);
-}
-
 /**
  * Merges multiple arrays or objects into a single one
  */
-export function merge<T = ArrayOrObject>(...values: T[]): T {
+export function merge<T = ArrayOrPlainObject>(...values: T[]): T {
 	if (values.length === 0) {
 		return {} as T;
 	}
 
-	const actual = values.filter(isArrayOrObject) as GenericObject[];
-	const result = (actual.every(Array.isArray) ? [] : {}) as GenericObject;
+	const actual = values.filter(value =>
+		isArrayOrPlainObject(value),
+	) as PlainObject[];
+
+	const result = (actual.every(Array.isArray) ? [] : {}) as PlainObject;
 
 	const {length} = actual;
 
@@ -238,8 +230,8 @@ export function merge<T = ArrayOrObject>(...values: T[]): T {
 			const next = item[key];
 			const previous = result[key];
 
-			if (isArrayOrObject(next)) {
-				result[key] = isArrayOrObject(previous)
+			if (isArrayOrPlainObject(next)) {
+				result[key] = isArrayOrPlainObject(previous)
 					? merge(previous, next)
 					: merge(next);
 			} else {
@@ -264,6 +256,7 @@ export function set<T extends ValueObject>(
 ): T {
 	const parts = getString(key).split('.');
 	const {length} = parts;
+	const lastIndex = length - 1;
 
 	let index = 0;
 	let target: ValueObject = typeof data === 'object' ? data ?? {} : {};
@@ -271,7 +264,7 @@ export function set<T extends ValueObject>(
 	for (; index < length; index += 1) {
 		const part = parts[index];
 
-		if (parts.indexOf(part) === parts.length - 1) {
+		if (parts.indexOf(part) === lastIndex) {
 			_setValue(target, part, value);
 
 			break;

package/types/is.d.ts

@@ -0,0 +1,30 @@
+export type ArrayOrPlainObject = unknown[] | PlainObject;
+export type PlainObject = Record<string, unknown>;
+/**
+ * Is the value an array or a plain object?
+ */
+export declare function isArrayOrPlainObject(value: unknown): value is ArrayOrPlainObject;
+/**
+ * Is the value undefined or null?
+ */
+export declare function isNullable(value: unknown): value is undefined | null;
+/**
+ * Is the value undefined, null, or an empty string?
+ */
+export declare function isNullableOrWhitespace(value: unknown): value is undefined | null | '';
+/**
+ * Is the value a number?
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Is the value a number, or a number-like string?
+ */
+export declare function isNumerical(value: unknown): value is number | `${number}`;
+/**
+ * Is the value an object?
+ */
+export declare function isObject(value: unknown): value is object;
+/**
+ * Is the value a generic object?
+ */
+export declare function isPlainObject(value: unknown): value is PlainObject;

package/types/proxy.d.ts

@@ -1,2 +1,11 @@
-import { ArrayOrObject } from './value';
-export declare function proxy<T extends ArrayOrObject>(value: T): T;
+import { ArrayOrPlainObject, PlainObject } from './is';
+declare class Manager<T extends ArrayOrPlainObject = PlainObject> {
+    readonly owner: Proxied<T>;
+    constructor(owner: Proxied<T>);
+    clone(): Proxied<T>;
+}
+export type Proxied<T extends ArrayOrPlainObject = PlainObject> = {
+    $: Manager<T>;
+} & T;
+export declare function proxy<T extends PlainObject>(value: T): Proxied<T>;
+export {};

package/types/string.d.ts

@@ -6,7 +6,3 @@ export declare function createUuid(): string;
  * Get the string value from any value
  */
 export declare function getString(value: unknown): string;
-/**
- * Is the value undefined, null, or an empty string?
- */
-export declare function isNullableOrWhitespace(value: unknown): value is undefined | null | '';

package/types/value.d.ts

@@ -1,4 +1,4 @@
-export type ArrayOrObject = unknown[] | GenericObject;
+import { ArrayOrPlainObject } from './is';
 export type DiffType = 'full' | 'none' | 'partial';
 export type DiffResult<T1 = unknown, T2 = T1> = {
     original: DiffValue<T1, T2>;
@@ -9,13 +9,22 @@ export type DiffValue<T1 = unknown, T2 = T1> = {
     from: T1;
     to: T2;
 };
-export type GenericObject = Record<string, unknown>;
 export type Key = number | string;
-export type ValueObject = ArrayOrObject | Map<unknown, unknown>;
+export type ValueObject = ArrayOrPlainObject | Map<unknown, unknown>;
 /**
  * Clones any kind of value
  */
 export declare function clone<T>(value: T): T;
+/**
+ * - Find the differences between two values
+ * - Returns an object holding the result:
+ * 	- `original` holds the original values
+ * 	- `type` is the type of difference:
+ * 		- `full` if the values are completely different
+ * 		- `none` if the values are the same
+ * 		- `partial` if the values are partially different
+ * 	- `values` holds the differences with dot-notation keys
+ */
 export declare function diff<T1 = unknown, T2 = T1>(first: T1, second: T2): DiffResult<T1, T2>;
 /**
  * - Get the value from an object using a key path
@@ -23,22 +32,10 @@ export declare function diff<T1 = unknown, T2 = T1>(first: T1, second: T2): Diff
  * - Returns `undefined` if the value is not found
  */
 export declare function get(data: ValueObject, key: Key): unknown;
-/**
- * Is the value an array or a generic object?
- */
-export declare function isArrayOrObject(value: unknown): value is ArrayOrObject;
-/**
- * Is the value undefined or null?
- */
-export declare function isNullable(value: unknown): value is undefined | null;
-/**
- * Is the value a generic object?
- */
-export declare function isObject(value: unknown): value is GenericObject;
 /**
  * Merges multiple arrays or objects into a single one
  */
-export declare function merge<T = ArrayOrObject>(...values: T[]): T;
+export declare function merge<T = ArrayOrPlainObject>(...values: T[]): T;
 /**
  * - Set the value in an object using a key path
  * - You can set a nested value by using dot notation, e.g., `foo.bar.baz`

package/dist/js/colour.mjs

@@ -1,124 +0,0 @@
-// src/js/colour.ts
-import {between} from "./number";
-var _normaliseHex = function(value) {
-  return typeof value === "string" ? value.replace(hexTrim, "") : undefined;
-};
-function hexToHSL(value) {
-  return rgbToHSL(hexToRGB(value));
-}
-function hexToRGB(value) {
-  const normalised = _normaliseHex(value);
-  if (!isHexColour(normalised)) {
-    return;
-  }
-  const matches = normalised.match(hexGroups);
-  if (matches === null) {
-    return;
-  }
-  return {
-    blue: parseInt(matches[1], 16),
-    green: parseInt(matches[2], 16),
-    red: parseInt(matches[3], 16)
-  };
-}
-function hslToHex(value) {
-  if (isHSLColour(value)) {
-    return rgbToHex(hslToRGB(value));
-  }
-}
-function hslToRGB(value) {
-  if (!isHSLColour(value)) {
-    return;
-  }
-  function getValue(value2) {
-    const k = (value2 + hue / 30) % 12;
-    const a = saturation * Math.min(lightness, 1 - lightness);
-    return lightness - a * Math.max(-1, Math.min(k - 3, 9 - k, 1));
-  }
-  let hue = Number(value.hue);
-  let lightness = Number(value.lightness);
-  let saturation = Number(value.saturation);
-  hue %= 360;
-  if (hue < 0) {
-    hue += 360;
-  }
-  lightness /= 100;
-  saturation /= 100;
-  return {
-    blue: Math.round(getValue(4) * 255),
-    green: Math.round(getValue(8) * 255),
-    red: Math.round(getValue(0) * 255)
-  };
-}
-function isHexColour(value) {
-  return typeof value === "string" && hexValue.test(value);
-}
-function isHSLColour(value) {
-  return ["hue", "lightness", "saturation"].every((key) => between(value?.[key], 0, key === "hue" ? 360 : 100));
-}
-function isRGBColour(value) {
-  return ["red", "green", "blue"].every((key) => between(value?.[key], 0, 255));
-}
-function rgbToHex(value) {
-  if (isRGBColour(value)) {
-    return `#${(value.blue | value.green << 8 | value.red << 16 | 1 << 24).toString(16).slice(1)}`;
-  }
-}
-function rgbToHSL(value) {
-  if (!isRGBColour(value)) {
-    return;
-  }
-  let red = Number(value.red);
-  let green = Number(value.green);
-  let blue = Number(value.blue);
-  red /= 255;
-  green /= 255;
-  blue /= 255;
-  const min = Math.min(red, green, blue);
-  const max = Math.max(red, green, blue);
-  const chroma = max - min;
-  const lightness = max - chroma / 2;
-  let hue = 0;
-  let saturation = 0;
-  switch (chroma) {
-    case red: {
-      hue = (green - blue) / chroma % 6;
-      break;
-    }
-    case green: {
-      hue = (blue - red) / chroma + 2;
-      break;
-    }
-    case blue: {
-      hue = (red - green) / chroma + 2;
-      break;
-    }
-    default: {
-      break;
-    }
-  }
-  saturation = max === 0 || lightness === 0 || lightness === 0 ? 0 : (max - lightness) / Math.min(lightness, 1 - lightness);
-  hue *= 60;
-  if (hue < 0) {
-    hue += 360;
-  }
-  return {
-    hue: Math.round(hue),
-    saturation: Math.round(saturation * 100),
-    lightness: Math.round(lightness * 100)
-  };
-}
-var hexGroups = /^([\da-f]{2})([\da-f]{2})([\da-f]{2})$/i;
-var hexTrim = /^(#|\s)|\s$/g;
-var hexValue = /^([\da-f]{3}){1,2}$/i;
-export {
-  rgbToHex,
-  rgbToHSL,
-  isRGBColour,
-  isHexColour,
-  isHSLColour,
-  hslToRGB,
-  hslToHex,
-  hexToRGB,
-  hexToHSL
-};