shelving 1.89.4 → 1.89.5

package/package.json

@@ -11,7 +11,7 @@
 		"state-management",
 		"query-builder"
 	],
-	"version": "1.89.4",
+	"version": "1.89.5",
 	"repository": "https://github.com/dhoulb/shelving",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"license": "0BSD",

package/util/debug.d.ts

@@ -2,16 +2,15 @@
 import type { ImmutableArray } from "./array.js";
 import type { ImmutableMap } from "./map.js";
 import type { ImmutableSet } from "./set.js";
-import type { ImmutableObject } from "./object.js";
 /** Debug a random value as a string. */
-export declare function debug(value: unknown): string;
+export declare function debug(value: unknown, depth?: number): string;
 /** Debug a string. */
 export declare const debugString: (value: string) => string;
 /** Debug an array. */
-export declare function debugArray(value: ImmutableArray): string;
+export declare function debugArray(value: ImmutableArray, depth?: number): string;
 /** Debug a set. */
-export declare function debugSet(value: ImmutableSet): string;
+export declare function debugSet(value: ImmutableSet, depth?: number): string;
 /** Debug a map. */
-export declare function debugMap(value: ImmutableMap): string;
+export declare function debugMap(value: ImmutableMap, depth?: number): string;
 /** Debug an object. */
-export declare function debugObject(value: ImmutableObject): string;
+export declare function debugObject(value: object, depth?: number): string;

package/util/debug.js

@@ -1,6 +1,6 @@
 /* eslint-disable no-control-regex */
 /** Debug a random value as a string. */
-export function debug(value) {
+export function debug(value, depth = 1) {
     if (value === null)
         return "null";
     if (value === undefined)
@@ -21,12 +21,12 @@ export function debug(value) {
         if (value instanceof Error)
             return value.toString();
         if (value instanceof Array)
-            return debugArray(value);
+            return debugArray(value, depth);
         if (value instanceof Map)
-            return debugMap(value);
+            return debugMap(value, depth);
         if (value instanceof Set)
-            return debugSet(value);
-        return debugObject(value);
+            return debugSet(value, depth);
+        return debugObject(value, depth);
     }
     return typeof value;
 }
@@ -36,29 +36,42 @@ const ESCAPE_REGEXP = /[\x00-\x08\x0B-\x1F\x7F-\x9F"\\]/g; // Match control char
 const ESCAPE_LIST = { '"': '\\"', "\\": "\\\\", "\r": "\\r", "\n": "\\n", "\t": "\\t", "\b": "\\b", "\f": "\\f", "\v": "\\v" };
 const _escapeChar = (char) => ESCAPE_LIST[char] || `\\x${char.charCodeAt(0).toString(16).padStart(2, "00")}`;
 /** Debug an array. */
-export function debugArray(value) {
+export function debugArray(value, depth = 1) {
     const prototype = Object.getPrototypeOf(value);
     const name = prototype === Array.prototype ? "" : prototype.constructor.name || "";
-    return `${name ? `${name} ` : ""}${value.length ? `[\n\t${value.map(debug).join(",\n\t")}\n]` : "[]"}`;
+    const items = depth > 0 && value.length ? value.map(v => debug(v, depth - 1)).join(",\n\t") : "";
+    return `${name ? `${name} ` : ""}${value.length ? `[\n\t${items}\n]` : "[]"}`;
 }
 /** Debug a set. */
-export function debugSet(value) {
+export function debugSet(value, depth = 1) {
     const prototype = Object.getPrototypeOf(value);
     const name = prototype === Set.prototype ? "" : prototype.constructor.name || "Set";
-    return `${name}(value.size) ${value.size ? `{\n\t${Array.from(value).map(debug).join(",\n\t")}\n}` : "{}"}`;
+    const items = depth > 0 && value.size
+        ? Array.from(value)
+            .map(v => debug(v, depth - 1))
+            .join(",\n\t")
+        : "";
+    return `${name}(value.size) ${items ? `{\n\t${items}\n}` : "{}"}`;
 }
 /** Debug a map. */
-export function debugMap(value) {
+export function debugMap(value, depth = 1) {
     const prototype = Object.getPrototypeOf(value);
     const name = prototype === Map.prototype ? "" : prototype.constructor.name || "Map";
-    return `${name}(value.size) ${value.size ? `{\n\t${Array.from(value).map(_debugProp).join(",\n\t")}\n}` : "{}"}`;
+    const entries = depth > 0 && value.size
+        ? Array.from(value)
+            .map(([k, v]) => `${debug(k)}: ${debug(v, depth - 1)}`)
+            .join(",\n\t")
+        : "";
+    return `${name}(value.size) ${entries ? `{\n\t${entries}\n}` : "{}"}`;
 }
 /** Debug an object. */
-export function debugObject(value) {
+export function debugObject(value, depth = 1) {
     const prototype = Object.getPrototypeOf(value);
     const name = prototype === Object.prototype ? "" : prototype.constructor.name || "";
-    const props = Object.entries(value).map(_debugProp);
-    return `${name ? `${name} ` : ""}${props.length ? `{\n\t${props.join(",\n\t")}\n}` : "{}"}`;
+    const entries = depth > 0
+        ? Object.entries(value)
+            .map(([k, v]) => `${debug(k)}: ${debug(v, depth - 1)}`)
+            .join(",\n\t")
+        : "";
+    return `${name ? `${name} ` : ""}${entries ? `{\n\t${entries}\n}` : "{}"}`;
 }
-/** Debug a prop. */
-const _debugProp = ([key, value]) => `${debug(key)}: ${debug(value)}`;