aberdeen 1.13.0 → 1.14.0

package/dist/src/aberdeen.d.ts

@@ -896,6 +896,20 @@ export declare function partition<IN_K extends string | number | symbol, OUT_K e
  * ```
  */
 export declare function dump<T>(data: T): T;
+/**
+ * When set on an object or its prototype chain, {@link dump} calls this as a render function
+ * (with the object as `this`) instead of its default recursive rendering. When `false` this
+ * inhibits `dump` from rendering object properties.
+ *
+ * @example
+ * ```typescript
+ * class Color {
+ *   constructor(public r: number, public g: number, public b: number) {}
+ *   [CUSTOM_DUMP]() { A(`#rgb(${this.r}, ${this.g}, ${this.b})`); }
+ * }
+ * ```
+ */
+export declare const CUSTOM_DUMP: unique symbol;
 /**
  * The main Aberdeen API. `A` is itself a callable function for building reactive DOM trees
  * (creating elements, setting attributes, adding content). All other Aberdeen functions and
@@ -918,6 +932,7 @@ declare const _default: typeof A & {
     /** {@inheritDoc copy} */ copy: typeof copy;
     /** {@inheritDoc count} */ count: typeof count;
     /** {@inheritDoc cssVars} */ cssVars: Record<string, string>;
+    /** {@inheritDoc CUSTOM_DUMP} */ CUSTOM_DUMP: symbol;
     /** {@inheritDoc darkMode} */ darkMode: typeof darkMode;
     /** {@inheritDoc derive} */ derive: typeof derive;
     /** {@inheritDoc disableCreateDestroy} */ disableCreateDestroy: typeof disableCreateDestroy;

package/dist/src/aberdeen.js

@@ -981,7 +981,7 @@ var setHandler = {
 };
 var proxyMap = new WeakMap;
 function optProxy(value) {
-  if (typeof value !== "object" || !value || value[TARGET_SYMBOL] !== undefined || value[OPAQUE]) {
+  if (typeof value !== "object" || !value || value[TARGET_SYMBOL] !== undefined || value[OPAQUE] || value instanceof Date) {
     return value;
   }
   let proxied = proxyMap.get(value);
@@ -1733,26 +1733,49 @@ function partition(source, func) {
   return out;
 }
 function dump(data) {
+  const org = dumpSeen;
+  dumpSeen ||= new Set;
+  try {
+    rawDump(data, dumpSeen);
+  } finally {
+    dumpSeen = org;
+  }
+  return data;
+}
+var dumpSeen;
+function rawDump(data, seen) {
   if (data && typeof data === "object") {
-    const name = data.constructor.name.toLowerCase() || "unknown object";
-    A(`#<${name}>`);
-    if (OPAQUE in data) {
-      A("# [OPAQUE]");
-    } else {
-      A("ul", () => {
-        onEach(data, (value, key) => {
-          A("li", () => {
+    const name = data.constructor.name || "unknown object";
+    if (seen.has(data)) {
+      A(`#<${name}: circular reference>`);
+      return;
+    }
+    seen.add(data);
+    const customDump = data[CUSTOM_DUMP];
+    if (customDump !== undefined) {
+      if (typeof customDump === "function")
+        customDump.call(data, seen);
+      return;
+    }
+    A(`#<${name}>`, "ul", () => {
+      onEach(data, (value, key) => {
+        A("li", () => {
+          if (!(data instanceof Array))
             A(`#${JSON.stringify(key)}: `);
-            dump(value);
-          });
+          rawDump(value, seen);
         });
       });
-    }
-  } else if (data !== undefined) {
+    });
+  } else if (data === undefined) {
+    A("#undefined");
+  } else {
     A("#" + JSON.stringify(data));
   }
-  return data;
 }
+var CUSTOM_DUMP = Symbol("CUSTOM_DUMP");
+Date.prototype[CUSTOM_DUMP] = function() {
+  A("#<Date> " + this.toISOString());
+};
 function internalError(code) {
   throw new Error(`Aberdeen internal error ${code}`);
 }
@@ -1810,6 +1833,7 @@ var aberdeen_default = Object.assign(A, {
   copy,
   count,
   cssVars,
+  CUSTOM_DUMP,
   darkMode,
   derive,
   disableCreateDestroy,
@@ -1871,8 +1895,9 @@ export {
   NO_COPY,
   MAP_SIZE_SYMBOL,
   EMPTY,
+  CUSTOM_DUMP,
   A
 };
 
-//# debugId=B5E9F155214345E564756E2164756E21
+//# debugId=34A0CA77D4CA212064756E2164756E21
 //# sourceMappingURL=aberdeen.js.map