@ac-kit/core 0.1.0

package/dist/iterable/windowed.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Yields every overlapping window of `size` consecutive elements.
+ *
+ * Not `chunk`: windows overlap, chunks do not. `windowed([1, 2, 3], 2)` yields
+ * `[1, 2]` then `[2, 3]`, where `chunk([1, 2, 3], 2)` yields `[1, 2]` then
+ * `[3]`. Passing `step` equal to `size` makes the two agree, except that a
+ * short trailing group is never yielded here.
+ *
+ * An input shorter than `size` yields nothing, and so does the tail left over
+ * when the length is not reached again — a window is only ever yielded at full
+ * width.
+ *
+ * Time complexity: O(n), allocating one array per window.
+ *
+ * @param iterable The input iterable.
+ * @param size How many elements per window. Must be a positive integer.
+ * @param step How far to advance between windows. Must be a positive integer; a
+ *   value above `size` skips elements entirely.
+ * @returns An iterator over the windows.
+ * @throws {RangeError} If `size` or `step` is not a positive integer.
+ */
+export declare function windowed<T>(iterable: Iterable<T>, size: number, step?: number): IterableIterator<T[]>;
+//# sourceMappingURL=windowed.d.ts.map

package/dist/iterable/windowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowed.d.ts","sourceRoot":"","sources":["../../src/iterable/windowed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAiB,QAAQ,CAAC,CAAC,EAC1B,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,SAAI,GACN,gBAAgB,CAAC,CAAC,EAAE,CAAC,CA8BvB"}

package/dist/iterable/windowed.js

@@ -0,0 +1,49 @@
+/**
+ * Yields every overlapping window of `size` consecutive elements.
+ *
+ * Not `chunk`: windows overlap, chunks do not. `windowed([1, 2, 3], 2)` yields
+ * `[1, 2]` then `[2, 3]`, where `chunk([1, 2, 3], 2)` yields `[1, 2]` then
+ * `[3]`. Passing `step` equal to `size` makes the two agree, except that a
+ * short trailing group is never yielded here.
+ *
+ * An input shorter than `size` yields nothing, and so does the tail left over
+ * when the length is not reached again — a window is only ever yielded at full
+ * width.
+ *
+ * Time complexity: O(n), allocating one array per window.
+ *
+ * @param iterable The input iterable.
+ * @param size How many elements per window. Must be a positive integer.
+ * @param step How far to advance between windows. Must be a positive integer; a
+ *   value above `size` skips elements entirely.
+ * @returns An iterator over the windows.
+ * @throws {RangeError} If `size` or `step` is not a positive integer.
+ */
+export function* windowed(iterable, size, step = 1) {
+    if (!Number.isInteger(size) || size < 1) {
+        throw new RangeError("windowed size must be a positive integer");
+    }
+    if (!Number.isInteger(step) || step < 1) {
+        throw new RangeError("windowed step must be a positive integer");
+    }
+    const buffer = [];
+    let skip = 0;
+    for (const item of iterable) {
+        if (skip > 0) {
+            skip--;
+            continue;
+        }
+        buffer.push(item);
+        if (buffer.length === size) {
+            yield [...buffer];
+            if (step >= size) {
+                buffer.length = 0;
+                skip = step - size;
+            }
+            else {
+                buffer.splice(0, step);
+            }
+        }
+    }
+}
+//# sourceMappingURL=windowed.js.map

package/dist/iterable/windowed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowed.js","sourceRoot":"","sources":["../../src/iterable/windowed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,SAAS,CAAC,CAAC,QAAQ,CACxB,QAAqB,EACrB,IAAY,EACZ,IAAI,GAAG,CAAC;IAER,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,EAAE,CAAC;YACP,SAAS;QACV,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElB,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;YAElB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBAClB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;gBAClB,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACxB,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/iterable/zip-longest.d.ts

@@ -0,0 +1,24 @@
+import type { MaybeAsyncIterable } from "../types/iterator.js";
+import type { Zipped } from "./zip.js";
+/** The element type of each iterable in `T`, widened by the fill value. */
+export type ZippedLongest<T extends readonly MaybeAsyncIterable<unknown>[], F> = {
+    [K in keyof Zipped<T>]: Zipped<T>[K] | F;
+};
+/**
+ * Yields tuples pairing the first element of every iterable, then the second,
+ * and so on, continuing until the _longest_ one runs out and substituting
+ * `fill` for every iterable that has already ended.
+ *
+ * The counterpart of `zip`, which stops at the shortest instead.
+ *
+ * Every source iterator is closed when iteration ends, whether it ended by
+ * exhaustion or because the consumer stopped pulling.
+ *
+ * Time complexity: O(1) per tuple, allocating one tuple per yield.
+ *
+ * @param iterables The iterables to advance in lockstep.
+ * @param fill The value standing in for an iterable that has already ended.
+ * @returns An iterator over the tuples. Empty when no iterables were given.
+ */
+export declare function zipLongest<const T extends readonly Iterable<unknown>[], F>(iterables: T, fill: F): IterableIterator<ZippedLongest<T, F>>;
+//# sourceMappingURL=zip-longest.d.ts.map

package/dist/iterable/zip-longest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-longest.d.ts","sourceRoot":"","sources":["../../src/iterable/zip-longest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,2EAA2E;AAC3E,MAAM,MAAM,aAAa,CACxB,CAAC,SAAS,SAAS,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAChD,CAAC,IACE;KACF,CAAC,IAAI,MAAM,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAiB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,EAC1E,SAAS,EAAE,CAAC,EACZ,IAAI,EAAE,CAAC,GACL,gBAAgB,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA8CvC"}

package/dist/iterable/zip-longest.js

@@ -0,0 +1,55 @@
+/**
+ * Yields tuples pairing the first element of every iterable, then the second,
+ * and so on, continuing until the _longest_ one runs out and substituting
+ * `fill` for every iterable that has already ended.
+ *
+ * The counterpart of `zip`, which stops at the shortest instead.
+ *
+ * Every source iterator is closed when iteration ends, whether it ended by
+ * exhaustion or because the consumer stopped pulling.
+ *
+ * Time complexity: O(1) per tuple, allocating one tuple per yield.
+ *
+ * @param iterables The iterables to advance in lockstep.
+ * @param fill The value standing in for an iterable that has already ended.
+ * @returns An iterator over the tuples. Empty when no iterables were given.
+ */
+export function* zipLongest(iterables, fill) {
+    if (iterables.length === 0) {
+        return;
+    }
+    const iterators = iterables.map((iterable) => iterable[Symbol.iterator]());
+    const exhausted = Array.from({ length: iterators.length }).fill(false);
+    let remaining = iterators.length;
+    try {
+        while (true) {
+            const values = [];
+            for (let index = 0; index < iterators.length; index++) {
+                if (exhausted[index] === true) {
+                    values.push(fill);
+                    continue;
+                }
+                const result = iterators[index].next();
+                if (result.done === true) {
+                    exhausted[index] = true;
+                    remaining--;
+                    values.push(fill);
+                    continue;
+                }
+                values.push(result.value);
+            }
+            if (remaining === 0) {
+                return;
+            }
+            // Safe: one value was pushed per iterable, in order, so the array has
+            // exactly the arity and element types `ZippedLongest<T, F>` describes.
+            yield values;
+        }
+    }
+    finally {
+        for (const iterator of iterators) {
+            iterator.return?.();
+        }
+    }
+}
+//# sourceMappingURL=zip-longest.js.map

package/dist/iterable/zip-longest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-longest.js","sourceRoot":"","sources":["../../src/iterable/zip-longest.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,SAAS,CAAC,CAAC,UAAU,CAC1B,SAAY,EACZ,IAAO;IAEP,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACR,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAU,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACvE,KAAK,CACL,CAAC;IACF,IAAI,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC;IAEjC,IAAI,CAAC;QACJ,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,MAAM,GAAc,EAAE,CAAC;YAE7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvD,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAClB,SAAS;gBACV,CAAC;gBAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,EAAE,CAAC;gBAExC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBAC1B,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;oBACxB,SAAS,EAAE,CAAC;oBACZ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAClB,SAAS;gBACV,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;gBACrB,OAAO;YACR,CAAC;YAED,sEAAsE;YACtE,uEAAuE;YACvE,MAAM,MAA6B,CAAC;QACrC,CAAC;IACF,CAAC;YAAS,CAAC;QACV,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAClC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACrB,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/iterable/zip.d.ts

@@ -0,0 +1,27 @@
+import type { MaybeAsyncIterable } from "../types/iterator.js";
+/**
+ * The element type of each iterable in `T`, as a tuple in the same order.
+ *
+ * Accepts async iterables so `zip` and `zipAsync` share one definition.
+ */
+export type Zipped<T extends readonly MaybeAsyncIterable<unknown>[]> = {
+    [K in keyof T]: T[K] extends Iterable<infer U> ? U : T[K] extends AsyncIterable<infer U> ? U : never;
+};
+/**
+ * Yields tuples pairing the first element of every iterable, then the second,
+ * and so on, stopping as soon as any one of them runs out.
+ *
+ * Takes one array rather than a rest parameter, unlike `concat`: the two shapes
+ * cannot be told apart, because an `Iterable<T>` is very often an array
+ * itself.
+ *
+ * Every source iterator is closed when iteration ends, whether it ended by
+ * exhaustion or because the consumer stopped pulling.
+ *
+ * Time complexity: O(1) per tuple, allocating one tuple per yield.
+ *
+ * @param iterables The iterables to advance in lockstep.
+ * @returns An iterator over the tuples. Empty when no iterables were given.
+ */
+export declare function zip<const T extends readonly Iterable<unknown>[]>(iterables: T): IterableIterator<Zipped<T>>;
+//# sourceMappingURL=zip.d.ts.map

package/dist/iterable/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../src/iterable/zip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,SAAS,kBAAkB,CAAC,OAAO,CAAC,EAAE,IAAI;KACrE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC3C,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAClC,CAAC,GACD,KAAK;CACT,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAiB,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,QAAQ,CAAC,OAAO,CAAC,EAAE,EAChE,SAAS,EAAE,CAAC,GACV,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CA8B7B"}

package/dist/iterable/zip.js

@@ -0,0 +1,43 @@
+/**
+ * Yields tuples pairing the first element of every iterable, then the second,
+ * and so on, stopping as soon as any one of them runs out.
+ *
+ * Takes one array rather than a rest parameter, unlike `concat`: the two shapes
+ * cannot be told apart, because an `Iterable<T>` is very often an array
+ * itself.
+ *
+ * Every source iterator is closed when iteration ends, whether it ended by
+ * exhaustion or because the consumer stopped pulling.
+ *
+ * Time complexity: O(1) per tuple, allocating one tuple per yield.
+ *
+ * @param iterables The iterables to advance in lockstep.
+ * @returns An iterator over the tuples. Empty when no iterables were given.
+ */
+export function* zip(iterables) {
+    if (iterables.length === 0) {
+        return;
+    }
+    const iterators = iterables.map((iterable) => iterable[Symbol.iterator]());
+    try {
+        while (true) {
+            const values = [];
+            for (let index = 0; index < iterators.length; index++) {
+                const result = iterators[index].next();
+                if (result.done === true) {
+                    return;
+                }
+                values.push(result.value);
+            }
+            // Safe: one value was pushed per iterable, in order, so the array has
+            // exactly the arity and element types `Zipped<T>` describes.
+            yield values;
+        }
+    }
+    finally {
+        for (const iterator of iterators) {
+            iterator.return?.();
+        }
+    }
+}
+//# sourceMappingURL=zip.js.map

package/dist/iterable/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../src/iterable/zip.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,SAAS,CAAC,CAAC,GAAG,CACnB,SAAY;IAEZ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACR,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE3E,IAAI,CAAC;QACJ,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,MAAM,GAAc,EAAE,CAAC;YAE7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,EAAE,CAAC;gBAExC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBAC1B,OAAO;gBACR,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAED,sEAAsE;YACtE,6DAA6D;YAC7D,MAAM,MAAmB,CAAC;QAC3B,CAAC;IACF,CAAC;YAAS,CAAC;QACV,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAClC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACrB,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/json/json-make-replacer-function.d.ts

@@ -0,0 +1,16 @@
+import { JsonReplacer, JsonReplacerFunction } from "../types/json.js";
+/**
+ * Create a JSON replacer function that combines a base replacer function with
+ * an optional user-defined replacer (function or property list).
+ *
+ * The resulting function applies the base replacer first, then the user
+ * replacer if provided, and finally filters properties based on the property
+ * list if provided.
+ *
+ * @param baseReplacerFunction The base replacer function to apply first.
+ * @param userReplacer An optional user-defined replacer (function or property
+ *   list).
+ * @returns A combined JSON replacer function.
+ */
+export declare function jsonMakeReplacerFunction(baseReplacerFunction: JsonReplacerFunction, userReplacer?: JsonReplacer): JsonReplacerFunction;
+//# sourceMappingURL=json-make-replacer-function.d.ts.map

package/dist/json/json-make-replacer-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-make-replacer-function.d.ts","sourceRoot":"","sources":["../../src/json/json-make-replacer-function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACvC,oBAAoB,EAAE,oBAAoB,EAC1C,YAAY,CAAC,EAAE,YAAY,GACzB,oBAAoB,CA4BtB"}

package/dist/json/json-make-replacer-function.js

@@ -0,0 +1,37 @@
+/**
+ * Create a JSON replacer function that combines a base replacer function with
+ * an optional user-defined replacer (function or property list).
+ *
+ * The resulting function applies the base replacer first, then the user
+ * replacer if provided, and finally filters properties based on the property
+ * list if provided.
+ *
+ * @param baseReplacerFunction The base replacer function to apply first.
+ * @param userReplacer An optional user-defined replacer (function or property
+ *   list).
+ * @returns A combined JSON replacer function.
+ */
+export function jsonMakeReplacerFunction(baseReplacerFunction, userReplacer) {
+    if (userReplacer === null || userReplacer === undefined) {
+        return baseReplacerFunction;
+    }
+    const userPropertyList = Array.isArray(userReplacer) ? userReplacer : null;
+    const userReplacerFn = typeof userReplacer === "function" ? userReplacer : null;
+    return function (key, value) {
+        value = baseReplacerFunction.call(this, key, value);
+        // Apply user replacer function if provided
+        if (userReplacerFn) {
+            value = userReplacerFn.call(this, key, value);
+        }
+        // Apply property list filtering if provided
+        if (userPropertyList) {
+            if (this && typeof this === "object" && !Array.isArray(this)) {
+                if (!userPropertyList.includes(key)) {
+                    return;
+                }
+            }
+        }
+        return value;
+    };
+}
+//# sourceMappingURL=json-make-replacer-function.js.map

package/dist/json/json-make-replacer-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-make-replacer-function.js","sourceRoot":"","sources":["../../src/json/json-make-replacer-function.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACvC,oBAA0C,EAC1C,YAA2B;IAE3B,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,oBAAoB,CAAC;IAC7B,CAAC;IAED,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,cAAc,GACnB,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,OAAO,UAAU,GAAG,EAAE,KAAK;QAC1B,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAEpD,2CAA2C;QAC3C,IAAI,cAAc,EAAE,CAAC;YACpB,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QAED,4CAA4C;QAC5C,IAAI,gBAAgB,EAAE,CAAC;YACtB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,OAAO;gBACR,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;AACH,CAAC"}

package/dist/json/json-serialize-safe.d.ts

@@ -0,0 +1,20 @@
+import { JsonReplacer } from "../types/json.js";
+import { JsonifySafe, JsonSerializeSafeResult } from "./jsonify-safe.js";
+import { type JsonMakeAllReplacersFunctionOptions } from "./replacers/all-replacers.js";
+export type JsonSerializeSafeOptions = JsonMakeAllReplacersFunctionOptions;
+/**
+ * Serialize a value to a JSON-compatible format.
+ *
+ * The function follows the same rules as `JSON.stringify`, but instead of
+ * returning a string, it returns the serialized value directly.
+ *
+ * @param value The value to serialize.
+ * @param replacer A function that transforms the result
+ * @param options Options to customize the behavior of the serialization, such
+ *   as handling circular references.
+ * @returns A JSON representation of the value, or `undefined` if a "pure" value
+ *   has been passed in argument.
+ */
+export declare function jsonSerializeSafe<T>(value: T, replacer?: (string | number)[] | null, options?: JsonSerializeSafeOptions): JsonSerializeSafeResult<T>;
+export declare function jsonSerializeSafe<T>(value: T, replacer?: JsonReplacer, options?: JsonSerializeSafeOptions): JsonifySafe<T> | undefined;
+//# sourceMappingURL=json-serialize-safe.d.ts.map

package/dist/json/json-serialize-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-serialize-safe.d.ts","sourceRoot":"","sources":["../../src/json/json-serialize-safe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACN,KAAK,mCAAmC,EAExC,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,wBAAwB,GAAG,mCAAmC,CAAC;AAE3E;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,EACrC,OAAO,CAAC,EAAE,wBAAwB,GAChC,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAC9B,wBAAgB,iBAAiB,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,wBAAwB,GAChC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC"}

package/dist/json/json-serialize-safe.js

@@ -0,0 +1,7 @@
+import { jsonSerialize } from "./json-serialize.js";
+import { jsonMakeAllReplacersFunction, } from "./replacers/all-replacers.js";
+export function jsonSerializeSafe(value, replacer, options) {
+    const allReplacers = jsonMakeAllReplacersFunction(replacer, options);
+    return jsonSerialize(value, allReplacers);
+}
+//# sourceMappingURL=json-serialize-safe.js.map

package/dist/json/json-serialize-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-serialize-safe.js","sourceRoot":"","sources":["../../src/json/json-serialize-safe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAEN,4BAA4B,GAC5B,MAAM,8BAA8B,CAAC;AA2BtC,MAAM,UAAU,iBAAiB,CAChC,KAAQ,EACR,QAAuB,EACvB,OAAkC;IAElC,MAAM,YAAY,GAAG,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAErE,OAAO,aAAa,CAAC,KAAK,EAAE,YAAY,CAA+B,CAAC;AACzE,CAAC"}

package/dist/json/json-serialize.d.ts

@@ -0,0 +1,16 @@
+import type { Jsonify } from "type-fest";
+import { JsonReplacer, JsonSerializeResult } from "../types/json.js";
+/**
+ * Serialize a value to a JSON-compatible format.
+ *
+ * The function follows the same rules as `JSON.stringify`, but instead of
+ * returning a string, it returns the serialized value directly.
+ *
+ * @param value The value to serialize.
+ * @param replacer A function that transforms the result
+ * @returns A JSON representation of the value, or `undefined` if a "pure" value
+ *   has been passed in argument.
+ */
+export declare function jsonSerialize<T>(value: T, replacer?: (string | number)[] | null): JsonSerializeResult<T>;
+export declare function jsonSerialize<T>(value: T, replacer?: JsonReplacer): Jsonify<T> | undefined;
+//# sourceMappingURL=json-serialize.d.ts.map

package/dist/json/json-serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-serialize.d.ts","sourceRoot":"","sources":["../../src/json/json-serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,GACnC,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAC1B,wBAAgB,aAAa,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC"}

package/dist/json/json-serialize.js

@@ -0,0 +1,8 @@
+export function jsonSerialize(value, replacer) {
+    const jsonString = JSON.stringify(value, replacer, "");
+    if (jsonString === undefined) {
+        return;
+    }
+    return JSON.parse(jsonString);
+}
+//# sourceMappingURL=json-serialize.js.map

package/dist/json/json-serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-serialize.js","sourceRoot":"","sources":["../../src/json/json-serialize.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,aAAa,CAC5B,KAAQ,EACR,QAAuB;IAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEvD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;IACR,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAe,CAAC;AAC7C,CAAC"}

package/dist/json/json-stringify-safe.d.ts

@@ -0,0 +1,23 @@
+import { JsonReplacer, JsonStringifyResult } from "../types/json.js";
+import { type JsonMakeAllReplacersFunctionOptions } from "./replacers/all-replacers.js";
+export type JsonStringifySafeOptions = JsonMakeAllReplacersFunctionOptions;
+/**
+ * Stringify a value to a JSON string, handling circular references, Error
+ * objects, and BigInt values gracefully.
+ *
+ * @param value The value to stringify.
+ * @param replacer A function that alters the behavior of the stringification
+ *   process, or an array of String and Number objects that serve as a whitelist
+ *   for selecting/filtering the properties of the value object to be included
+ *   in the JSON string. If this value is null or not provided, all properties
+ *   of the object are included in the resulting JSON string.
+ * @param space The number of spaces to use for indentation or a string to use
+ *   as whitespace.
+ * @param options Options to customize the behavior of the stringification, such
+ *   as handling circular references.
+ * @returns A JSON string representation of the value, or undefined if the value
+ *   cannot be stringified.
+ */
+export declare function jsonStringifySafe<T>(value: T, replacer?: (string | number)[] | null, space?: string | number, options?: JsonStringifySafeOptions): JsonStringifyResult<T>;
+export declare function jsonStringifySafe(value: unknown, replacer?: JsonReplacer, space?: string | number, options?: JsonStringifySafeOptions): string | undefined;
+//# sourceMappingURL=json-stringify-safe.d.ts.map

package/dist/json/json-stringify-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-stringify-safe.d.ts","sourceRoot":"","sources":["../../src/json/json-stringify-safe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACN,KAAK,mCAAmC,EAExC,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,wBAAwB,GAAG,mCAAmC,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,EACrC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,wBAAwB,GAChC,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAC1B,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,YAAY,EACvB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,wBAAwB,GAChC,MAAM,GAAG,SAAS,CAAC"}

package/dist/json/json-stringify-safe.js

@@ -0,0 +1,6 @@
+import { jsonMakeAllReplacersFunction, } from "./replacers/all-replacers.js";
+export function jsonStringifySafe(value, replacer, space, options) {
+    const allReplacers = jsonMakeAllReplacersFunction(replacer, options);
+    return JSON.stringify(value, allReplacers, space);
+}
+//# sourceMappingURL=json-stringify-safe.js.map

package/dist/json/json-stringify-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-stringify-safe.js","sourceRoot":"","sources":["../../src/json/json-stringify-safe.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,4BAA4B,GAC5B,MAAM,8BAA8B,CAAC;AAiCtC,MAAM,UAAU,iBAAiB,CAChC,KAAc,EACd,QAAuB,EACvB,KAAuB,EACvB,OAAkC;IAElC,MAAM,YAAY,GAAG,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAErE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC"}

package/dist/json/jsonify-safe.d.ts

@@ -0,0 +1,29 @@
+import type { Jsonify, JsonValue, TypedArray } from "type-fest";
+import { IsJsonUnserializableRoot } from "../types/json.js";
+type JsonSafeErrorProperty_<T, TKey extends PropertyKey> = TKey extends keyof T ? JsonSafeSource_<T[TKey]> : undefined;
+type JsonSafeError_<T extends Error> = {
+    name: string;
+    message: string;
+    stack: string | undefined;
+    cause: JsonSafeErrorProperty_<T, "cause">;
+    errors: JsonSafeErrorProperty_<T, "errors">;
+    suppressed: JsonSafeErrorProperty_<T, "suppressed">;
+    error: JsonSafeErrorProperty_<T, "error">;
+} & JsonSafeSource_<Omit<T, "name" | "message" | "stack" | "cause" | "errors" | "suppressed" | "error">>;
+type JsonSafeSource_<T> = unknown extends T ? JsonValue | undefined : T extends {
+    toJSON(...args: never[]): unknown;
+} ? T : T extends bigint ? number | string : T extends Error ? JsonSafeError_<T> : T extends string | number | boolean | null | undefined | symbol | ((...args: never[]) => unknown) | Map<unknown, unknown> | Set<unknown> | TypedArray ? T : T extends object ? {
+    [K in keyof T]: JsonSafeSource_<T[K]>;
+} : T;
+/**
+ * `Jsonify` corrected for the replacers applied by the `*Safe` JSON helpers:
+ * BigInt becomes a number or a string, and Error objects become plain objects
+ * carrying their non-enumerable properties.
+ *
+ * @template T The value type being serialized.
+ */
+export type JsonifySafe<T> = Jsonify<JsonSafeSource_<T>>;
+/** Return type of `jsonSerializeSafe` for a root value of type `T`. */
+export type JsonSerializeSafeResult<T> = unknown extends T ? JsonifySafe<T> | undefined : T extends unknown ? IsJsonUnserializableRoot<T> extends true ? undefined : JsonifySafe<T> : never;
+export {};
+//# sourceMappingURL=jsonify-safe.d.ts.map

package/dist/json/jsonify-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonify-safe.d.ts","sourceRoot":"","sources":["../../src/json/jsonify-safe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,KAAK,sBAAsB,CAAC,CAAC,EAAE,IAAI,SAAS,WAAW,IAAI,IAAI,SAAS,MAAM,CAAC,GAC5E,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GACxB,SAAS,CAAC;AAEb,KAAK,cAAc,CAAC,CAAC,SAAS,KAAK,IAAI;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,sBAAsB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,EAAE,sBAAsB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5C,UAAU,EAAE,sBAAsB,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACpD,KAAK,EAAE,sBAAsB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;CAC1C,GAAG,eAAe,CAClB,IAAI,CACH,CAAC,EACD,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAC1E,CACD,CAAC;AAGF,KAAK,eAAe,CAAC,CAAC,IAAI,OAAO,SAAS,CAAC,GACxC,SAAS,GAAG,SAAS,GACrB,CAAC,SAAS;IAAE,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;CAAE,GAC9C,CAAC,GACD,CAAC,SAAS,MAAM,GACf,MAAM,GAAG,MAAM,GACf,CAAC,SAAS,KAAK,GACd,cAAc,CAAC,CAAC,CAAC,GACjB,CAAC,SACE,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,MAAM,GACN,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAC/B,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,GACrB,GAAG,CAAC,OAAO,CAAC,GACZ,UAAU,GACZ,CAAC,GACD,CAAC,SAAS,MAAM,GACf;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACzC,CAAC,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzD,uEAAuE;AACvE,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI,OAAO,SAAS,CAAC,GACvD,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,GAC1B,CAAC,SAAS,OAAO,GAChB,wBAAwB,CAAC,CAAC,CAAC,SAAS,IAAI,GACvC,SAAS,GACT,WAAW,CAAC,CAAC,CAAC,GACf,KAAK,CAAC"}

package/dist/json/jsonify-safe.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jsonify-safe.js.map

package/dist/json/jsonify-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonify-safe.js","sourceRoot":"","sources":["../../src/json/jsonify-safe.ts"],"names":[],"mappings":""}

package/dist/json/replacers/all-replacers.d.ts

@@ -0,0 +1,7 @@
+import { JsonReplacer, JsonReplacerFunction } from "../../types/json.js";
+import { type JsonMakeCircularReferenceReplacerFunctionOptions } from "./circular-reference.js";
+export type JsonMakeAllReplacersFunctionOptions = {
+    circularReference?: JsonMakeCircularReferenceReplacerFunctionOptions;
+};
+export declare function jsonMakeAllReplacersFunction(replacer?: JsonReplacer, options?: JsonMakeAllReplacersFunctionOptions): JsonReplacerFunction;
+//# sourceMappingURL=all-replacers.d.ts.map

package/dist/json/replacers/all-replacers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all-replacers.d.ts","sourceRoot":"","sources":["../../../src/json/replacers/all-replacers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EACN,KAAK,gDAAgD,EAErD,MAAM,yBAAyB,CAAC;AAGjC,MAAM,MAAM,mCAAmC,GAAG;IACjD,iBAAiB,CAAC,EAAE,gDAAgD,CAAC;CACrE,CAAC;AAEF,wBAAgB,4BAA4B,CAC3C,QAAQ,CAAC,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,mCAAmC,GAC3C,oBAAoB,CAKtB"}

package/dist/json/replacers/all-replacers.js

@@ -0,0 +1,7 @@
+import { jsonMakeBigIntReplacerFunction } from "./big-int.js";
+import { jsonMakeCircularReferenceReplacerFunction, } from "./circular-reference.js";
+import { jsonMakeErrorReplacerFunction } from "./error.js";
+export function jsonMakeAllReplacersFunction(replacer, options) {
+    return jsonMakeCircularReferenceReplacerFunction(jsonMakeBigIntReplacerFunction(jsonMakeErrorReplacerFunction(replacer)), options?.circularReference);
+}
+//# sourceMappingURL=all-replacers.js.map

package/dist/json/replacers/all-replacers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"all-replacers.js","sourceRoot":"","sources":["../../../src/json/replacers/all-replacers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAEN,yCAAyC,GACzC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAM3D,MAAM,UAAU,4BAA4B,CAC3C,QAAuB,EACvB,OAA6C;IAE7C,OAAO,yCAAyC,CAC/C,8BAA8B,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,EACvE,OAAO,EAAE,iBAAiB,CAC1B,CAAC;AACH,CAAC"}

package/dist/json/replacers/big-int.d.ts

@@ -0,0 +1,16 @@
+import { JsonReplacer, JsonReplacerFunction } from "../../types/json.js";
+/**
+ * Create a JSON replacer function that converts BigInt values to either numbers
+ * (if within safe range) or strings.
+ *
+ * This function can be used as a base replacer to ensure that BigInt values are
+ * properly handled during JSON serialization, and can be combined with a
+ * user-defined replacer for additional customization.
+ *
+ * @param replacer An optional user-defined replacer (function or property list)
+ *   to apply after the BigInt replacer.
+ * @returns A JSON replacer function that handles BigInt values and applies the
+ *   user-defined replacer if provided.
+ */
+export declare function jsonMakeBigIntReplacerFunction(replacer?: JsonReplacer): JsonReplacerFunction;
+//# sourceMappingURL=big-int.d.ts.map

package/dist/json/replacers/big-int.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"big-int.d.ts","sourceRoot":"","sources":["../../../src/json/replacers/big-int.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC7C,QAAQ,CAAC,EAAE,YAAY,GACrB,oBAAoB,CAiBtB"}

package/dist/json/replacers/big-int.js

@@ -0,0 +1,28 @@
+import { jsonMakeReplacerFunction } from "../json-make-replacer-function.js";
+/**
+ * Create a JSON replacer function that converts BigInt values to either numbers
+ * (if within safe range) or strings.
+ *
+ * This function can be used as a base replacer to ensure that BigInt values are
+ * properly handled during JSON serialization, and can be combined with a
+ * user-defined replacer for additional customization.
+ *
+ * @param replacer An optional user-defined replacer (function or property list)
+ *   to apply after the BigInt replacer.
+ * @returns A JSON replacer function that handles BigInt values and applies the
+ *   user-defined replacer if provided.
+ */
+export function jsonMakeBigIntReplacerFunction(replacer) {
+    return jsonMakeReplacerFunction((_key, value) => {
+        if (value instanceof BigInt || typeof value === "bigint") {
+            const num = value.valueOf();
+            if (num >= BigInt(Number.MIN_SAFE_INTEGER) &&
+                num <= BigInt(Number.MAX_SAFE_INTEGER)) {
+                return Number(num);
+            }
+            return num.toString();
+        }
+        return value;
+    }, replacer);
+}
+//# sourceMappingURL=big-int.js.map

package/dist/json/replacers/big-int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"big-int.js","sourceRoot":"","sources":["../../../src/json/replacers/big-int.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAE7E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,8BAA8B,CAC7C,QAAuB;IAEvB,OAAO,wBAAwB,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/C,IAAI,KAAK,YAAY,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAE5B,IACC,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACtC,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EACrC,CAAC;gBACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;YAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC,EAAE,QAAQ,CAAC,CAAC;AACd,CAAC"}

package/dist/json/replacers/circular-reference.d.ts

@@ -0,0 +1,22 @@
+import { JsonReplacer, JsonReplacerFunction } from "../../types/json.js";
+export type JsonMakeCircularReferenceReplacerFunctionOptions = {
+    placeholder?: string;
+};
+/**
+ * Create a JSON replacer function that safely handles circular references by
+ * replacing them with a specified placeholder string.
+ *
+ * This function uses a WeakMap to track parent objects during serialization,
+ * allowing it to detect circular references and replace them with the provided
+ * placeholder. It can be combined with an optional user-defined replacer for
+ * additional customization.
+ *
+ * @param replacer An optional user-defined replacer (function or property list)
+ *   to apply after the circular reference handling.
+ * @param options Options for configuring the circular safe replacer function,
+ *   including the placeholder string to use for circular references.
+ * @returns A JSON replacer function that handles circular references and
+ *   applies the user-defined replacer if provided.
+ */
+export declare function jsonMakeCircularReferenceReplacerFunction(replacer?: JsonReplacer, options?: JsonMakeCircularReferenceReplacerFunctionOptions): JsonReplacerFunction;
+//# sourceMappingURL=circular-reference.d.ts.map

package/dist/json/replacers/circular-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circular-reference.d.ts","sourceRoot":"","sources":["../../../src/json/replacers/circular-reference.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,MAAM,MAAM,gDAAgD,GAAG;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAOF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yCAAyC,CACxD,QAAQ,CAAC,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,gDAAgD,GACxD,oBAAoB,CAmCtB"}