@oscarpalmer/atoms 0.197.0 → 0.198.0

package/dist/index.mjs

@@ -3412,33 +3412,22 @@ Object.defineProperty(template, "initialize", { value: initializeTemplater });
 //#region src/value/clone.ts
 const CLONE_NAME = "clone";
 function clone(value, options) {
-	switch (true) {
-		case value === null:
-		case value === void 0:
-		case typeof value === "bigint":
-		case typeof value === "boolean":
-		case typeof value === "number":
-		case typeof value === "string": return value;
-		case value instanceof Date: return new Date(value.getTime());
-		default: return cloneAny(value, getCloneParameters(options), 0);
-	}
+	return cloneAny(value, { copy: false }, 0, options);
 }
-clone.handlers = getSelfHandlers(clone, {
-	callback: tryStructuredClone,
-	method: CLONE_NAME
-});
-clone.deregister = deregisterCloner;
-clone.register = registerCloner;
-function cloneAny(value, parameters, depth) {
+function cloneAny(value, parameters, depth, options) {
 	switch (true) {
-		case value == null:
-		case typeof value === "bigint":
-		case typeof value === "boolean":
-		case typeof value === "number":
-		case typeof value === "string": return value;
+		case value === null || CLONE_PRIMITIVES[typeof value]: return value;
 		case value instanceof Date: return new Date(value.getTime());
-		case typeof value === "function": return parameters.options?.copyFunctions ? value : void 0;
-		case typeof value === "symbol": return parameters.options?.copySymbols ? value : Symbol(value.description);
+		case typeof value === "function":
+			parameters.options ??= getCloneOptions(options);
+			return parameters.options.copyFunctions ? value : void 0;
+		case typeof value === "symbol":
+			parameters.options ??= getCloneOptions(options);
+			return parameters.options.copySymbols ? value : Symbol(value.description);
+	}
+	parameters.options ??= getCloneOptions(options);
+	parameters.references ??= /* @__PURE__ */ new WeakMap();
+	switch (true) {
 		case parameters.references.has(value): return parameters.references.get(value);
 		case value instanceof ArrayBuffer: return cloneArrayBuffer(value, parameters, depth);
 		case value instanceof DataView: return cloneDataView(value, parameters, depth);
@@ -3448,18 +3437,18 @@ function cloneAny(value, parameters, depth) {
 		case value instanceof Set: return cloneSet(value, parameters, depth);
 		case isArrayOrPlainObject(value): return cloneObject(value, parameters, depth);
 		case isTypedArray(value): return cloneTypedArray(value, parameters, depth);
-		default: return clone.handlers.handle(value, parameters, depth);
+		default: return parameters.copy ? value : clone.handlers.handle(value, parameters, depth);
 	}
 }
 function cloneArrayBuffer(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const cloned = new ArrayBuffer(value.byteLength);
 	new Uint8Array(cloned).set(new Uint8Array(value));
 	parameters.references.set(value, cloned);
 	return cloned;
 }
 function cloneDataView(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const buffer = cloneArrayBuffer(value.buffer, parameters, depth);
 	const cloned = new DataView(buffer, value.byteOffset, value.byteLength);
 	parameters.references.set(value, cloned);
@@ -3467,22 +3456,22 @@ function cloneDataView(value, parameters, depth) {
 }
 function cloneMap(map, parameters, depth) {
 	if (depth >= CLONE_MAX_DEPTH) return map;
-	const flat = parameters.options?.flat;
+	if (parameters.copy) return new Map(map);
 	const cloned = /* @__PURE__ */ new Map();
-	const entries = map.entries();
-	for (const entry of entries) cloned.set(flat ? entry[0] : cloneAny(entry[0], parameters, depth + 1), flat ? entry[1] : cloneAny(entry[1], parameters, depth + 1));
+	for (const [key, value] of map.entries()) cloned.set(cloneAny(key, parameters, depth + 1), cloneAny(value, parameters, depth + 1));
 	parameters.references.set(map, cloned);
 	return cloned;
 }
 function cloneNode(node, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return node;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return node;
 	const cloned = node.cloneNode(true);
 	parameters.references.set(node, cloned);
 	return cloned;
 }
 function cloneObject(value, parameters, depth) {
+	if (depth >= CLONE_MAX_DEPTH) return value;
 	const isArray = Array.isArray(value);
-	if (parameters.options?.flat || depth >= CLONE_MAX_DEPTH) return isArray ? value.slice() : { ...value };
+	if (parameters.copy) return isArray ? value.slice() : { ...value };
 	const cloned = isArray ? [] : {};
 	const keys = isArray ? void 0 : Object.keys(value);
 	const { length } = keys ?? value;
@@ -3494,7 +3483,7 @@ function cloneObject(value, parameters, depth) {
 	return cloned;
 }
 function cloneRegularExpression(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const cloned = new RegExp(value.source, value.flags);
 	cloned.lastIndex = value.lastIndex;
 	parameters.references.set(value, cloned);
@@ -3502,30 +3491,24 @@ function cloneRegularExpression(value, parameters, depth) {
 }
 function cloneSet(set, parameters, depth) {
 	if (depth >= CLONE_MAX_DEPTH) return set;
+	if (parameters.copy) return new Set(set);
 	const cloned = /* @__PURE__ */ new Set();
-	const values = [...set.values()];
-	const { length } = values;
-	for (let index = 0; index < length; index += 1) cloned.add(parameters.options?.flat ? values[index] : cloneAny(values[index], parameters, depth + 1));
+	for (const value of set.values()) cloned.add(cloneAny(value, parameters, depth + 1));
 	parameters.references.set(set, cloned);
 	return cloned;
 }
 function cloneTypedArray(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const cloned = new value.constructor(value);
 	parameters.references.set(value, cloned);
 	return cloned;
 }
-/**
-* Copy any kind of value
-*
-* - Clones the value shallowly, without cloning nested values
-* - To copy a value deeply, use `clone` instead
-*
-* @param value Value to copy
-* @returns Copied value
-*/
 function copy(value) {
-	return clone(value, CLONE_COPY_OPTIONS);
+	return cloneAny(value, {
+		copy: true,
+		options: CLONE_COPY_OPTIONS,
+		references: void 0
+	}, 0);
 }
 /**
 * Deregister a clone handler for a specific class
@@ -3538,23 +3521,35 @@ function deregisterCloner(constructor) {
 	clone.handlers.deregister(constructor);
 }
 function getCloneOptions(input) {
-	if (typeof input === "boolean") return {
-		copyFunctions: false,
-		copySymbols: false,
-		flat: input === true
-	};
 	if (typeof input !== "object" || input === null) return CLONE_DEFAULT_OPTIONS;
 	return {
 		copyFunctions: input.copyFunctions === true,
-		copySymbols: input.copySymbols === true,
-		flat: input.flat === true
+		copySymbols: input.copySymbols === true
 	};
 }
-function getCloneParameters(input) {
-	return {
-		options: getCloneOptions(input),
-		references: /* @__PURE__ */ new WeakMap()
-	};
+/**
+* Create a cloner with predefined options
+*
+* _Available as `initializeCloner` and `clone.initialize`_
+*
+* @param options Clone options
+* @returns Cloner function
+*/
+function initializeCloner(options) {
+	const opts = getCloneOptions(options);
+	function cloner(value) {
+		return cloneAny(value, {
+			copy: false,
+			options: opts
+		}, 0);
+	}
+	cloner.deregister = deregisterCloner;
+	cloner.register = registerCloner;
+	Object.defineProperties(cloner, {
+		deregister: { value: deregisterCloner },
+		register: { value: registerCloner }
+	});
+	return cloner;
 }
 /**
 * Register a clone handler for a specific class
@@ -3571,24 +3566,46 @@ function tryStructuredClone(value, parameters, depth) {
 	if (depth >= CLONE_MAX_DEPTH) return value;
 	try {
 		const cloned = structuredClone(value);
-		parameters.references?.set(value, cloned);
+		parameters.references.set(value, cloned);
 		return cloned;
 	} catch {
-		parameters.references?.set(value, value);
+		parameters.references.set(value, value);
 		return value;
 	}
 }
 const CLONE_COPY_OPTIONS = {
 	copyFunctions: true,
-	copySymbols: true,
-	flat: true
+	copySymbols: true
 };
 const CLONE_DEFAULT_OPTIONS = {
 	copyFunctions: false,
-	copySymbols: false,
-	flat: false
+	copySymbols: false
 };
 const CLONE_MAX_DEPTH = 100;
+const cloneHandlers = getSelfHandlers(clone, {
+	callback: tryStructuredClone,
+	method: CLONE_NAME
+});
+const CLONE_PRIMITIVES = {
+	bigint: true,
+	boolean: true,
+	function: false,
+	number: true,
+	object: false,
+	string: true,
+	symbol: false,
+	undefined: true
+};
+clone.deregister = deregisterCloner;
+clone.handlers = cloneHandlers;
+clone.initialize = initializeCloner;
+clone.register = registerCloner;
+Object.defineProperties(clone, {
+	deregister: { value: deregisterCloner },
+	handlers: { value: cloneHandlers },
+	initialize: { value: initializeCloner },
+	register: { value: registerCloner }
+});
 //#endregion
 //#region src/value/collection.ts
 function inMap(map, value, key) {
@@ -6383,4 +6400,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, Logger, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isBeacon, isBeaconSubscription, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isHerald, isHeraldEvents, isHeraldSubscription, isHexColor, isHslColor, isHslaColor, isHwbColor, isHwbaColor, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isPlainObject, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbaColor, isSorted, isSubscription, isTimedLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, Logger, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeCloner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isBeacon, isBeaconSubscription, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isHerald, isHeraldEvents, isHeraldSubscription, isHexColor, isHslColor, isHslaColor, isHwbColor, isHwbaColor, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isPlainObject, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbaColor, isSorted, isSubscription, isTimedLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/value/clone.d.mts

@@ -9,19 +9,36 @@ type CloneOptions = {
    * Copy symbols instead of returning `Symbol(description)`? _(defaults to `false`)_
    */
   copySymbols?: boolean;
-  /**
-   * Clone only the value itself, without cloning nested values? _(defaults to `false`)_
-   */
-  flat?: boolean;
 };
 /**
- * Clone any kind of value _(shallowly)_
- *
- * @param value Value to clone
- * @param flat Clone only the value itself, without cloning nested values
- * @returns Cloned value
+ * A cloning function with predefined options
  */
-declare function clone<Value>(value: Value, flat: true): Value;
+type Cloner = {
+  /**
+   * Clone any kind of value
+   *
+   * @param value Value to clone
+   * @returns Cloned value
+   */
+  <Value>(value: Value): Value;
+  /**
+   * Deregister a clone handler for a specific class
+   *
+   * _Available as `deregisterCloner` and `template.deregister`_
+   *
+   * @param constructor Class constructor
+   */
+  deregister: typeof deregisterCloner;
+  /**
+   * Register a clone handler for a specific class
+   *
+   * _Available as `registerCloner` and `template.register`_
+   *
+   * @param constructor Class constructor
+   * @param handler Method name or clone function _(defaults to method name `clone`)_
+   */
+  register: typeof registerCloner;
+};
 /**
  * Clone any kind of value _(deeply, if needed)_
  *
@@ -31,18 +48,19 @@ declare function clone<Value>(value: Value, flat: true): Value;
  */
 declare function clone<Value>(value: Value, options?: CloneOptions): Value;
 declare namespace clone {
+  var deregister: typeof deregisterCloner;
   var handlers: {
     deregister(constructor: Constructor): void;
     handle(value: unknown, ...parameters: unknown[]): unknown;
     register(constructor: Constructor, handler?: string | GenericCallback): void;
   };
-  var deregister: typeof deregisterCloner;
+  var initialize: typeof initializeCloner;
   var register: typeof registerCloner;
 }
 /**
  * Copy any kind of value
  *
- * - Clones the value shallowly, without cloning nested values
+ * - Copies the value shallowly _(if possible)_, without copying or cloning nested values
  * - To copy a value deeply, use `clone` instead
  *
  * @param value Value to copy
@@ -57,6 +75,15 @@ declare function copy<Value>(value: Value): Value;
  * @param constructor Class constructor
  */
 declare function deregisterCloner<Instance>(constructor: Constructor<Instance>): void;
+/**
+ * Create a cloner with predefined options
+ *
+ * _Available as `initializeCloner` and `clone.initialize`_
+ *
+ * @param options Clone options
+ * @returns Cloner function
+ */
+declare function initializeCloner(options?: CloneOptions): Cloner;
 /**
  * Register a clone handler for a specific class
  *
@@ -67,4 +94,4 @@ declare function deregisterCloner<Instance>(constructor: Constructor<Instance>):
  */
 declare function registerCloner<Instance>(constructor: Constructor<Instance>, handler?: string | ((value: Instance) => Instance)): void;
 //#endregion
-export { CloneOptions, clone, copy, deregisterCloner, registerCloner };
+export { CloneOptions, Cloner, clone, copy, deregisterCloner, initializeCloner, registerCloner };

package/dist/value/clone.mjs

@@ -3,33 +3,22 @@ import { getSelfHandlers } from "../internal/value/handlers.mjs";
 //#region src/value/clone.ts
 const CLONE_NAME = "clone";
 function clone(value, options) {
+	return cloneAny(value, { copy: false }, 0, options);
+}
+function cloneAny(value, parameters, depth, options) {
 	switch (true) {
-		case value === null:
-		case value === void 0:
-		case typeof value === "bigint":
-		case typeof value === "boolean":
-		case typeof value === "number":
-		case typeof value === "string": return value;
+		case value === null || CLONE_PRIMITIVES[typeof value]: return value;
 		case value instanceof Date: return new Date(value.getTime());
-		default: return cloneAny(value, getCloneParameters(options), 0);
+		case typeof value === "function":
+			parameters.options ??= getCloneOptions(options);
+			return parameters.options.copyFunctions ? value : void 0;
+		case typeof value === "symbol":
+			parameters.options ??= getCloneOptions(options);
+			return parameters.options.copySymbols ? value : Symbol(value.description);
 	}
-}
-clone.handlers = getSelfHandlers(clone, {
-	callback: tryStructuredClone,
-	method: CLONE_NAME
-});
-clone.deregister = deregisterCloner;
-clone.register = registerCloner;
-function cloneAny(value, parameters, depth) {
+	parameters.options ??= getCloneOptions(options);
+	parameters.references ??= /* @__PURE__ */ new WeakMap();
 	switch (true) {
-		case value == null:
-		case typeof value === "bigint":
-		case typeof value === "boolean":
-		case typeof value === "number":
-		case typeof value === "string": return value;
-		case value instanceof Date: return new Date(value.getTime());
-		case typeof value === "function": return parameters.options?.copyFunctions ? value : void 0;
-		case typeof value === "symbol": return parameters.options?.copySymbols ? value : Symbol(value.description);
 		case parameters.references.has(value): return parameters.references.get(value);
 		case value instanceof ArrayBuffer: return cloneArrayBuffer(value, parameters, depth);
 		case value instanceof DataView: return cloneDataView(value, parameters, depth);
@@ -39,18 +28,18 @@ function cloneAny(value, parameters, depth) {
 		case value instanceof Set: return cloneSet(value, parameters, depth);
 		case isArrayOrPlainObject(value): return cloneObject(value, parameters, depth);
 		case isTypedArray(value): return cloneTypedArray(value, parameters, depth);
-		default: return clone.handlers.handle(value, parameters, depth);
+		default: return parameters.copy ? value : clone.handlers.handle(value, parameters, depth);
 	}
 }
 function cloneArrayBuffer(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const cloned = new ArrayBuffer(value.byteLength);
 	new Uint8Array(cloned).set(new Uint8Array(value));
 	parameters.references.set(value, cloned);
 	return cloned;
 }
 function cloneDataView(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const buffer = cloneArrayBuffer(value.buffer, parameters, depth);
 	const cloned = new DataView(buffer, value.byteOffset, value.byteLength);
 	parameters.references.set(value, cloned);
@@ -58,22 +47,22 @@ function cloneDataView(value, parameters, depth) {
 }
 function cloneMap(map, parameters, depth) {
 	if (depth >= CLONE_MAX_DEPTH) return map;
-	const flat = parameters.options?.flat;
+	if (parameters.copy) return new Map(map);
 	const cloned = /* @__PURE__ */ new Map();
-	const entries = map.entries();
-	for (const entry of entries) cloned.set(flat ? entry[0] : cloneAny(entry[0], parameters, depth + 1), flat ? entry[1] : cloneAny(entry[1], parameters, depth + 1));
+	for (const [key, value] of map.entries()) cloned.set(cloneAny(key, parameters, depth + 1), cloneAny(value, parameters, depth + 1));
 	parameters.references.set(map, cloned);
 	return cloned;
 }
 function cloneNode(node, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return node;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return node;
 	const cloned = node.cloneNode(true);
 	parameters.references.set(node, cloned);
 	return cloned;
 }
 function cloneObject(value, parameters, depth) {
+	if (depth >= CLONE_MAX_DEPTH) return value;
 	const isArray = Array.isArray(value);
-	if (parameters.options?.flat || depth >= CLONE_MAX_DEPTH) return isArray ? value.slice() : { ...value };
+	if (parameters.copy) return isArray ? value.slice() : { ...value };
 	const cloned = isArray ? [] : {};
 	const keys = isArray ? void 0 : Object.keys(value);
 	const { length } = keys ?? value;
@@ -85,7 +74,7 @@ function cloneObject(value, parameters, depth) {
 	return cloned;
 }
 function cloneRegularExpression(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const cloned = new RegExp(value.source, value.flags);
 	cloned.lastIndex = value.lastIndex;
 	parameters.references.set(value, cloned);
@@ -93,30 +82,24 @@ function cloneRegularExpression(value, parameters, depth) {
 }
 function cloneSet(set, parameters, depth) {
 	if (depth >= CLONE_MAX_DEPTH) return set;
+	if (parameters.copy) return new Set(set);
 	const cloned = /* @__PURE__ */ new Set();
-	const values = [...set.values()];
-	const { length } = values;
-	for (let index = 0; index < length; index += 1) cloned.add(parameters.options?.flat ? values[index] : cloneAny(values[index], parameters, depth + 1));
+	for (const value of set.values()) cloned.add(cloneAny(value, parameters, depth + 1));
 	parameters.references.set(set, cloned);
 	return cloned;
 }
 function cloneTypedArray(value, parameters, depth) {
-	if (depth >= CLONE_MAX_DEPTH) return value;
+	if (parameters.copy || depth >= CLONE_MAX_DEPTH) return value;
 	const cloned = new value.constructor(value);
 	parameters.references.set(value, cloned);
 	return cloned;
 }
-/**
-* Copy any kind of value
-*
-* - Clones the value shallowly, without cloning nested values
-* - To copy a value deeply, use `clone` instead
-*
-* @param value Value to copy
-* @returns Copied value
-*/
 function copy(value) {
-	return clone(value, CLONE_COPY_OPTIONS);
+	return cloneAny(value, {
+		copy: true,
+		options: CLONE_COPY_OPTIONS,
+		references: void 0
+	}, 0);
 }
 /**
 * Deregister a clone handler for a specific class
@@ -129,23 +112,35 @@ function deregisterCloner(constructor) {
 	clone.handlers.deregister(constructor);
 }
 function getCloneOptions(input) {
-	if (typeof input === "boolean") return {
-		copyFunctions: false,
-		copySymbols: false,
-		flat: input === true
-	};
 	if (typeof input !== "object" || input === null) return CLONE_DEFAULT_OPTIONS;
 	return {
 		copyFunctions: input.copyFunctions === true,
-		copySymbols: input.copySymbols === true,
-		flat: input.flat === true
+		copySymbols: input.copySymbols === true
 	};
 }
-function getCloneParameters(input) {
-	return {
-		options: getCloneOptions(input),
-		references: /* @__PURE__ */ new WeakMap()
-	};
+/**
+* Create a cloner with predefined options
+*
+* _Available as `initializeCloner` and `clone.initialize`_
+*
+* @param options Clone options
+* @returns Cloner function
+*/
+function initializeCloner(options) {
+	const opts = getCloneOptions(options);
+	function cloner(value) {
+		return cloneAny(value, {
+			copy: false,
+			options: opts
+		}, 0);
+	}
+	cloner.deregister = deregisterCloner;
+	cloner.register = registerCloner;
+	Object.defineProperties(cloner, {
+		deregister: { value: deregisterCloner },
+		register: { value: registerCloner }
+	});
+	return cloner;
 }
 /**
 * Register a clone handler for a specific class
@@ -162,23 +157,45 @@ function tryStructuredClone(value, parameters, depth) {
 	if (depth >= CLONE_MAX_DEPTH) return value;
 	try {
 		const cloned = structuredClone(value);
-		parameters.references?.set(value, cloned);
+		parameters.references.set(value, cloned);
 		return cloned;
 	} catch {
-		parameters.references?.set(value, value);
+		parameters.references.set(value, value);
 		return value;
 	}
 }
 const CLONE_COPY_OPTIONS = {
 	copyFunctions: true,
-	copySymbols: true,
-	flat: true
+	copySymbols: true
 };
 const CLONE_DEFAULT_OPTIONS = {
 	copyFunctions: false,
-	copySymbols: false,
-	flat: false
+	copySymbols: false
 };
 const CLONE_MAX_DEPTH = 100;
+const cloneHandlers = getSelfHandlers(clone, {
+	callback: tryStructuredClone,
+	method: CLONE_NAME
+});
+const CLONE_PRIMITIVES = {
+	bigint: true,
+	boolean: true,
+	function: false,
+	number: true,
+	object: false,
+	string: true,
+	symbol: false,
+	undefined: true
+};
+clone.deregister = deregisterCloner;
+clone.handlers = cloneHandlers;
+clone.initialize = initializeCloner;
+clone.register = registerCloner;
+Object.defineProperties(clone, {
+	deregister: { value: deregisterCloner },
+	handlers: { value: cloneHandlers },
+	initialize: { value: initializeCloner },
+	register: { value: registerCloner }
+});
 //#endregion
-export { clone, copy, deregisterCloner, registerCloner };
+export { clone, copy, deregisterCloner, initializeCloner, registerCloner };

package/package.json

@@ -1,9 +1,10 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.197.0",
+	"version": "0.198.0",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"array",
+		"clone",
 		"color",
 		"helper",
 		"observable",
@@ -282,7 +283,7 @@
 		"@vitest/coverage-istanbul": "^4.1",
 		"eslint": "^10.9",
 		"jsdom": "^30",
-		"tsdown": "^0.22",
+		"tsdown": "^0.23",
 		"typescript": "^6",
 		"vite": "npm:@voidzero-dev/vite-plus-core@latest",
 		"vite-plus": "latest",