veryfront 0.1.323 → 0.1.326

package/esm/cli/commands/extension/init-command.js

@@ -63,8 +63,8 @@ export default ${camelCase(name)};
  * @module extensions/${name}/test
  */
 
-import { assertEquals } from "#veryfront/testing/assert.ts";
-import { describe, it } from "#veryfront/testing/bdd.ts";
+import { assertEquals } from "veryfront/testing/assert";
+import { describe, it } from "veryfront/testing/bdd";
 import factory from "./index.ts";
 
 describe("${name} extension", () => {

package/esm/cli/commands/extension/validate-command.js

@@ -4,7 +4,7 @@
  * @module cli/commands/extension/validate-command
  */
 import * as dntShim from "../../../_dnt.shims.js";
-import { validateExtension } from "../../../src/extensions/validation.js";
+import { validateExtension } from "../../../src/extensions/index.js";
 /**
  * Validate an extension at the given directory path.
  */

package/esm/deno.d.ts

@@ -43,6 +43,9 @@ declare namespace _default {
         "./embedding": string;
         "./extensions": string;
         "./extensions/interfaces": string;
+        "./testing": string;
+        "./testing/assert": string;
+        "./testing/bdd": string;
         "./cli": string;
         "./chat/conversation": string;
         "./chat/message-prep": string;
@@ -117,6 +120,9 @@ declare namespace _default {
         "veryfront/tool/schema": string;
         "veryfront/agent/composition": string;
         "veryfront/extensions": string;
+        "veryfront/testing": string;
+        "veryfront/testing/assert": string;
+        "veryfront/testing/bdd": string;
         "#veryfront": string;
         "#veryfront/agent": string;
         "#veryfront/agent/react": string;
@@ -235,6 +241,7 @@ declare namespace _default {
         "react/jsx-dev-runtime": string;
         "@mdx-js/mdx": string;
         "@mdx-js/react": string;
+        "@babel/parser": string;
         "unist-util-visit": string;
         "mdast-util-to-string": string;
         "github-slugger": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.323",
+    "version": "0.1.326",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [
@@ -63,6 +63,9 @@ export default {
         "./embedding": "./src/embedding/index.ts",
         "./extensions": "./src/extensions/index.ts",
         "./extensions/interfaces": "./src/extensions/interfaces/index.ts",
+        "./testing": "./src/testing/index.ts",
+        "./testing/assert": "./src/testing/assert.ts",
+        "./testing/bdd": "./src/testing/bdd.ts",
         "./cli": "./cli/main.ts",
         "./chat/conversation": "./src/chat/conversation.ts",
         "./chat/message-prep": "./src/chat/message-prep.ts",
@@ -137,6 +140,9 @@ export default {
         "veryfront/tool/schema": "./src/tool/schema/index.ts",
         "veryfront/agent/composition": "./src/agent/composition/index.ts",
         "veryfront/extensions": "./src/extensions/index.ts",
+        "veryfront/testing": "./src/testing/index.ts",
+        "veryfront/testing/assert": "./src/testing/assert.ts",
+        "veryfront/testing/bdd": "./src/testing/bdd.ts",
         "#veryfront": "./src/index.ts",
         "#veryfront/agent": "./src/agent/index.ts",
         "#veryfront/agent/react": "./src/agent/react/index.ts",
@@ -255,6 +261,7 @@ export default {
         "react/jsx-dev-runtime": "https://esm.sh/react@19.2.4/jsx-dev-runtime?external=react&target=es2022&deps=csstype@3.2.3",
         "@mdx-js/mdx": "npm:@mdx-js/mdx@3.1.1",
         "@mdx-js/react": "npm:@mdx-js/react@3.1.1",
+        "@babel/parser": "npm:@babel/parser@7.29.2",
         "unist-util-visit": "npm:unist-util-visit@5.1.0",
         "mdast-util-to-string": "npm:mdast-util-to-string@4.0.0",
         "github-slugger": "npm:github-slugger@2.0.0",

package/esm/deps/esm.sh/react-dom@19.2.4/client.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.d.ts.map

package/esm/deps/esm.sh/react-dom@19.2.4/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/deps/esm.sh/react-dom@19.2.4/client.js"],"names":[],"mappings":""}

package/esm/deps/esm.sh/react-dom@19.2.4/client.js

@@ -0,0 +1,5 @@
+/* esm.sh - react-dom@19.2.4/client */
+import "react-dom/X-ZGNzc3R5cGVAMy4yLjMKZXJlYWN0/es2022/react-dom.mjs";
+import "../scheduler@^0.27.0.js";
+export * from "react-dom/X-ZGNzc3R5cGVAMy4yLjMKZXJlYWN0/es2022/client.mjs";
+export { default } from "react-dom/X-ZGNzc3R5cGVAMy4yLjMKZXJlYWN0/es2022/client.mjs";

package/esm/deps/esm.sh/scheduler@^0.27.0.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scheduler@%5E0.27.0.d.ts.map

package/esm/deps/esm.sh/scheduler@^0.27.0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler@^0.27.0.d.ts","sourceRoot":"","sources":["../../../src/deps/esm.sh/scheduler@^0.27.0.js"],"names":[],"mappings":""}

package/esm/deps/esm.sh/scheduler@^0.27.0.js

@@ -0,0 +1,3 @@
+/* esm.sh - scheduler@0.27.0 */
+export * from "scheduler/es2022/scheduler.mjs";
+export { default } from "scheduler/es2022/scheduler.mjs";

package/esm/deps/jsr.io/@std/assert/1.0.19/almost_equals.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Make an assertion that `actual` and `expected` are almost equal numbers
+ * through a given tolerance. It can be used to take into account IEEE-754
+ * double-precision floating-point representation limitations. If the values
+ * are not almost equal then throw.
+ *
+ * The default tolerance is one hundred thousandth of a percent of the
+ * expected value.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { assertAlmostEquals } from "@std/assert";
+ *
+ * assertAlmostEquals(0.01, 0.02); // Throws
+ * assertAlmostEquals(1e-8, 1e-9); // Throws
+ * assertAlmostEquals(1.000000001e-8, 1.000000002e-8); // Doesn't throw
+ * assertAlmostEquals(0.01, 0.02, 0.1); // Doesn't throw
+ * assertAlmostEquals(0.1 + 0.2, 0.3, 1e-16); // Doesn't throw
+ * assertAlmostEquals(0.1 + 0.2, 0.3, 1e-17); // Throws
+ * ```
+ *
+ * @param actual The actual value to compare.
+ * @param expected The expected value to compare.
+ * @param tolerance The tolerance to consider the values almost equal. The
+ * default is one hundred thousandth of a percent of the expected value.
+ * @param msg The optional message to include in the error.
+ * @throws {AssertionError} If the values are not almost equal.
+ */
+export declare function assertAlmostEquals(actual: number, expected: number, tolerance?: number, msg?: string): void;
+//# sourceMappingURL=almost_equals.d.ts.map

package/esm/deps/jsr.io/@std/assert/1.0.19/almost_equals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"almost_equals.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.19/almost_equals.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,QAmBb"}

package/esm/deps/jsr.io/@std/assert/1.0.19/almost_equals.js

@@ -0,0 +1,47 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+import { AssertionError } from "./assertion_error.js";
+/**
+ * Make an assertion that `actual` and `expected` are almost equal numbers
+ * through a given tolerance. It can be used to take into account IEEE-754
+ * double-precision floating-point representation limitations. If the values
+ * are not almost equal then throw.
+ *
+ * The default tolerance is one hundred thousandth of a percent of the
+ * expected value.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { assertAlmostEquals } from "@std/assert";
+ *
+ * assertAlmostEquals(0.01, 0.02); // Throws
+ * assertAlmostEquals(1e-8, 1e-9); // Throws
+ * assertAlmostEquals(1.000000001e-8, 1.000000002e-8); // Doesn't throw
+ * assertAlmostEquals(0.01, 0.02, 0.1); // Doesn't throw
+ * assertAlmostEquals(0.1 + 0.2, 0.3, 1e-16); // Doesn't throw
+ * assertAlmostEquals(0.1 + 0.2, 0.3, 1e-17); // Throws
+ * ```
+ *
+ * @param actual The actual value to compare.
+ * @param expected The expected value to compare.
+ * @param tolerance The tolerance to consider the values almost equal. The
+ * default is one hundred thousandth of a percent of the expected value.
+ * @param msg The optional message to include in the error.
+ * @throws {AssertionError} If the values are not almost equal.
+ */
+export function assertAlmostEquals(actual, expected, tolerance, msg) {
+    if (Object.is(actual, expected)) {
+        return;
+    }
+    const delta = Math.abs(expected - actual);
+    if (tolerance === undefined) {
+        tolerance = isFinite(expected) ? Math.abs(expected * 1e-7) : 1e-7;
+    }
+    if (delta <= tolerance) {
+        return;
+    }
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    const f = (n) => Number.isInteger(n) ? n : n.toExponential();
+    throw new AssertionError(`Expected actual: "${f(actual)}" to be close to "${f(expected)}": \
+delta "${f(delta)}" is greater than "${f(tolerance)}"${msgSuffix}`);
+}

package/esm/deps/jsr.io/@std/assert/1.0.19/array_includes.d.ts

@@ -0,0 +1,29 @@
+/** An array-like object (`Array`, `Uint8Array`, `NodeList`, etc.) that is not a string */
+export type ArrayLikeArg<T> = ArrayLike<T> & object;
+/**
+ * Asserts that `actual` contains all values in `expected`, using deep equality
+ * for non-primitive values.
+ *
+ * @example Usage with primitives
+ * ```ts ignore
+ * import { assertArrayIncludes } from "@std/assert";
+ *
+ * assertArrayIncludes([1, 2, 3], [2, 3]); // Passes
+ * assertArrayIncludes([1, 2, 3], [4]); // Throws
+ * ```
+ *
+ * @example Usage with objects (deep equality)
+ * ```ts ignore
+ * import { assertArrayIncludes } from "@std/assert";
+ *
+ * assertArrayIncludes([{ a: 1 }, { b: 2 }], [{ a: 1 }]); // Passes
+ * ```
+ *
+ * @typeParam T The element type of the arrays.
+ * @param actual The array-like object to search within.
+ * @param expected The values that must be present in `actual`.
+ * @param msg Optional message to display on failure.
+ * @throws {AssertionError} If any value in `expected` is not found in `actual`.
+ */
+export declare function assertArrayIncludes<T>(actual: ArrayLikeArg<T>, expected: ArrayLikeArg<T>, msg?: string): void;
+//# sourceMappingURL=array_includes.d.ts.map

package/esm/deps/jsr.io/@std/assert/1.0.19/array_includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array_includes.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.19/array_includes.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAOpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAgCN"}

package/esm/deps/jsr.io/@std/assert/1.0.19/array_includes.js

@@ -0,0 +1,65 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+import { equal } from "./equal.js";
+import { format } from "../../internal/1.0.13/format.js";
+import { AssertionError } from "./assertion_error.js";
+function isPrimitive(value) {
+    return value === null ||
+        typeof value !== "object" && typeof value !== "function";
+}
+/**
+ * Asserts that `actual` contains all values in `expected`, using deep equality
+ * for non-primitive values.
+ *
+ * @example Usage with primitives
+ * ```ts ignore
+ * import { assertArrayIncludes } from "@std/assert";
+ *
+ * assertArrayIncludes([1, 2, 3], [2, 3]); // Passes
+ * assertArrayIncludes([1, 2, 3], [4]); // Throws
+ * ```
+ *
+ * @example Usage with objects (deep equality)
+ * ```ts ignore
+ * import { assertArrayIncludes } from "@std/assert";
+ *
+ * assertArrayIncludes([{ a: 1 }, { b: 2 }], [{ a: 1 }]); // Passes
+ * ```
+ *
+ * @typeParam T The element type of the arrays.
+ * @param actual The array-like object to search within.
+ * @param expected The values that must be present in `actual`.
+ * @param msg Optional message to display on failure.
+ * @throws {AssertionError} If any value in `expected` is not found in `actual`.
+ */
+export function assertArrayIncludes(actual, expected, msg) {
+    const missing = [];
+    const expectedLen = expected.length;
+    const actualLen = actual.length;
+    for (let i = 0; i < expectedLen; i++) {
+        const item = expected[i];
+        let found;
+        if (isPrimitive(item)) {
+            // Fast path
+            found = Array.prototype.includes.call(actual, item);
+        }
+        else {
+            found = false;
+            for (let j = 0; j < actualLen; j++) {
+                if (equal(item, actual[j])) {
+                    found = true;
+                    break;
+                }
+            }
+        }
+        if (!found) {
+            missing.push(item);
+        }
+    }
+    if (missing.length === 0) {
+        return;
+    }
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    msg = `Expected actual: "${format(actual)}" to include: "${format(expected)}"${msgSuffix}\nmissing: ${format(missing)}`;
+    throw new AssertionError(msg);
+}

package/esm/deps/jsr.io/@std/assert/1.0.19/assert.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Make an assertion, an error will be thrown if `expr` does not have a truthy value.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { assert } from "@std/assert";
+ *
+ * assert("hello".includes("ello")); // Doesn't throw
+ * assert("hello".includes("world")); // Throws
+ * ```
+ *
+ * @param expr The expression to test.
+ * @param msg The optional message to display if the assertion fails.
+ * @throws {AssertionError} If `expr` is falsy.
+ */
+export declare function assert(expr: unknown, msg?: string): asserts expr;
+//# sourceMappingURL=assert.d.ts.map

package/esm/deps/jsr.io/@std/assert/1.0.19/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.19/assert.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAI5D"}

package/esm/deps/jsr.io/@std/assert/1.0.19/assert.js

@@ -0,0 +1,23 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+import { AssertionError } from "./assertion_error.js";
+/**
+ * Make an assertion, an error will be thrown if `expr` does not have a truthy value.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { assert } from "@std/assert";
+ *
+ * assert("hello".includes("ello")); // Doesn't throw
+ * assert("hello".includes("world")); // Throws
+ * ```
+ *
+ * @param expr The expression to test.
+ * @param msg The optional message to display if the assertion fails.
+ * @throws {AssertionError} If `expr` is falsy.
+ */
+export function assert(expr, msg = "") {
+    if (!expr) {
+        throw new AssertionError(msg);
+    }
+}

package/esm/deps/jsr.io/@std/assert/1.0.19/assertion_error.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Error thrown when an assertion fails.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { AssertionError } from "@std/assert";
+ *
+ * try {
+ *   throw new AssertionError("foo", { cause: "bar" });
+ * } catch (error) {
+ *   if (error instanceof AssertionError) {
+ *     error.message === "foo"; // true
+ *     error.cause === "bar"; // true
+ *   }
+ * }
+ * ```
+ */
+export declare class AssertionError extends Error {
+    /** Constructs a new instance.
+     *
+     * @param message The error message.
+     * @param options Additional options. This argument is still unstable. It may change in the future release.
+     */
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=assertion_error.d.ts.map

package/esm/deps/jsr.io/@std/assert/1.0.19/assertion_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion_error.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.19/assertion_error.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD"}

package/esm/deps/jsr.io/@std/assert/1.0.19/assertion_error.js

@@ -0,0 +1,30 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+/**
+ * Error thrown when an assertion fails.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import { AssertionError } from "@std/assert";
+ *
+ * try {
+ *   throw new AssertionError("foo", { cause: "bar" });
+ * } catch (error) {
+ *   if (error instanceof AssertionError) {
+ *     error.message === "foo"; // true
+ *     error.cause === "bar"; // true
+ *   }
+ * }
+ * ```
+ */
+export class AssertionError extends Error {
+    /** Constructs a new instance.
+     *
+     * @param message The error message.
+     * @param options Additional options. This argument is still unstable. It may change in the future release.
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AssertionError";
+    }
+}

package/esm/deps/jsr.io/@std/assert/1.0.19/equal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Deep equality comparison used in assertions.
+ *
+ * This function is based on value equality, but for some cases (such as data
+ * that can only be read asynchronously or function properties) value equality
+ * is not possible to determine. In such cases, reference equality is used
+ * instead, which may cause false negatives for objects such as `Blob`s or
+ * `Request`s.
+ *
+ * @param a The actual value
+ * @param b The expected value
+ * @returns `true` if the values are deeply equal, `false` otherwise
+ *
+ * @throws {TypeError} If either value is a `WeakMap` or `WeakSet`.
+ *
+ * @example Usage
+ * ```ts
+ * import { equal } from "@std/assert/equal";
+ *
+ * equal({ foo: "bar" }, { foo: "bar" }); // Returns `true`
+ * equal({ foo: "bar" }, { foo: "baz" }); // Returns `false`
+ * ```
+ */
+export declare function equal(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=equal.d.ts.map

package/esm/deps/jsr.io/@std/assert/1.0.19/equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equal.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/assert/1.0.19/equal.ts"],"names":[],"mappings":"AA0FA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAgHrD"}

package/esm/deps/jsr.io/@std/assert/1.0.19/equal.js

@@ -0,0 +1,194 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+import * as dntShim from "../../../../../_dnt.shims.js";
+function isKeyedCollection(x) {
+    return x instanceof Set || x instanceof Map;
+}
+function prototypesEqual(a, b) {
+    const pa = Object.getPrototypeOf(a);
+    const pb = Object.getPrototypeOf(b);
+    return pa === pb ||
+        pa === Object.prototype && pb === null ||
+        pa === null && pb === Object.prototype;
+}
+function isBasicObjectOrArray(obj) {
+    const proto = Object.getPrototypeOf(obj);
+    return proto === null || proto === Object.prototype ||
+        proto === Array.prototype;
+}
+// Slightly faster than Reflect.ownKeys in V8 as of 12.9.202.13-rusty (2024-10-28)
+function ownKeys(obj) {
+    return [
+        ...Object.getOwnPropertyNames(obj),
+        ...Object.getOwnPropertySymbols(obj),
+    ];
+}
+function getKeysDeep(obj) {
+    const keys = new Set();
+    while (obj !== Object.prototype && obj !== Array.prototype && obj != null) {
+        for (const key of ownKeys(obj)) {
+            keys.add(key);
+        }
+        obj = Object.getPrototypeOf(obj);
+    }
+    return keys;
+}
+// deno-lint-ignore no-explicit-any
+const Temporal = dntShim.dntGlobalThis.Temporal ?? Object.create(null);
+/** A non-exhaustive list of prototypes that can be accurately fast-path compared with `String(instance)` */
+const stringComparablePrototypes = new Set([
+    Intl.Locale,
+    RegExp,
+    Temporal.Duration,
+    Temporal.Instant,
+    Temporal.PlainDate,
+    Temporal.PlainDateTime,
+    Temporal.PlainTime,
+    Temporal.PlainYearMonth,
+    Temporal.PlainMonthDay,
+    Temporal.ZonedDateTime,
+    URL,
+    URLSearchParams,
+].filter((x) => x != null).map((x) => x.prototype));
+function isPrimitive(x) {
+    return typeof x === "string" ||
+        typeof x === "number" ||
+        typeof x === "boolean" ||
+        typeof x === "bigint" ||
+        typeof x === "symbol" ||
+        x == null;
+}
+const TypedArray = Object.getPrototypeOf(Uint8Array);
+function compareTypedArrays(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < b.length; i++) {
+        if (!sameValueZero(a[i], b[i]))
+            return false;
+    }
+    return true;
+}
+/** Check both strict equality (`0 == -0`) and `Object.is` (`NaN == NaN`) */
+function sameValueZero(a, b) {
+    return a === b || Object.is(a, b);
+}
+/**
+ * Deep equality comparison used in assertions.
+ *
+ * This function is based on value equality, but for some cases (such as data
+ * that can only be read asynchronously or function properties) value equality
+ * is not possible to determine. In such cases, reference equality is used
+ * instead, which may cause false negatives for objects such as `Blob`s or
+ * `Request`s.
+ *
+ * @param a The actual value
+ * @param b The expected value
+ * @returns `true` if the values are deeply equal, `false` otherwise
+ *
+ * @throws {TypeError} If either value is a `WeakMap` or `WeakSet`.
+ *
+ * @example Usage
+ * ```ts
+ * import { equal } from "@std/assert/equal";
+ *
+ * equal({ foo: "bar" }, { foo: "bar" }); // Returns `true`
+ * equal({ foo: "bar" }, { foo: "baz" }); // Returns `false`
+ * ```
+ */
+export function equal(a, b) {
+    const seen = new Map();
+    return (function compare(a, b) {
+        if (sameValueZero(a, b))
+            return true;
+        if (isPrimitive(a) || isPrimitive(b))
+            return false;
+        if (a instanceof Date && b instanceof Date) {
+            return Object.is(a.getTime(), b.getTime());
+        }
+        if (a && typeof a === "object" && b && typeof b === "object") {
+            if (!prototypesEqual(a, b)) {
+                return false;
+            }
+            if (a instanceof TypedArray) {
+                return compareTypedArrays(a, b);
+            }
+            if (a instanceof ArrayBuffer ||
+                (globalThis.SharedArrayBuffer && a instanceof SharedArrayBuffer)) {
+                return compareTypedArrays(new Uint8Array(a), new Uint8Array(b));
+            }
+            if (a instanceof WeakMap) {
+                throw new TypeError("Cannot compare WeakMap instances");
+            }
+            if (a instanceof WeakSet) {
+                throw new TypeError("Cannot compare WeakSet instances");
+            }
+            if (a instanceof WeakRef) {
+                return compare(a.deref(), b.deref());
+            }
+            if (seen.get(a) === b) {
+                return true;
+            }
+            if (Object.keys(a).length !== Object.keys(b).length) {
+                return false;
+            }
+            seen.set(a, b);
+            if (isKeyedCollection(a) && isKeyedCollection(b)) {
+                if (a.size !== b.size) {
+                    return false;
+                }
+                const aKeys = [...a.keys()];
+                const primitiveKeysFastPath = aKeys.every(isPrimitive);
+                if (primitiveKeysFastPath) {
+                    if (a instanceof Set) {
+                        return a.symmetricDifference(b).size === 0;
+                    }
+                    for (const key of aKeys) {
+                        if (!b.has(key) ||
+                            !compare(a.get(key), b.get(key))) {
+                            return false;
+                        }
+                    }
+                    return true;
+                }
+                let unmatchedEntries = a.size;
+                for (const [aKey, aValue] of a.entries()) {
+                    for (const [bKey, bValue] of b.entries()) {
+                        /* Given that Map keys can be references, we need
+                         * to ensure that they are also deeply equal */
+                        if (!compare(aKey, bKey))
+                            continue;
+                        if ((aKey === aValue && bKey === bValue) ||
+                            (compare(aValue, bValue))) {
+                            unmatchedEntries--;
+                            break;
+                        }
+                    }
+                }
+                return unmatchedEntries === 0;
+            }
+            let keys;
+            if (isBasicObjectOrArray(a)) {
+                // fast path
+                keys = ownKeys({ ...a, ...b });
+            }
+            else if (stringComparablePrototypes.has(Object.getPrototypeOf(a))) {
+                // medium path
+                return String(a) === String(b);
+            }
+            else {
+                // slow path
+                keys = getKeysDeep(a).union(getKeysDeep(b));
+            }
+            for (const key of keys) {
+                if (!compare(a[key], b[key])) {
+                    return false;
+                }
+                if (((key in a) && (!(key in b))) || ((key in b) && (!(key in a)))) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        return false;
+    })(a, b);
+}