@rimbu/base 2.0.2 → 2.0.3

package/dist/cjs/arr.cjs

@@ -27,17 +27,46 @@ exports.copySparse = copySparse;
 exports.mapSparse = mapSparse;
 var tslib_1 = require("tslib");
 var common_1 = require("@rimbu/common");
+/**
+ * Internal helper that appends a value using the modern immutable `toSpliced` API.
+ * @internal
+ * @typeparam T - the array element type
+ * @param array - the source array (not mutated)
+ * @param value - the value to append
+ * @returns a new non-empty array with the value at the end
+ */
 function _appendNew(array, value) {
     return array.toSpliced(array.length, 0, value);
 }
+/**
+ * Internal helper that appends a value by cloning and pushing (legacy fallback).
+ * @internal
+ * @typeparam T - the array element type
+ * @param array - the source array (not mutated)
+ * @param value - the value to append
+ * @returns a new non-empty array with the value at the end
+ */
 function _appendOld(array, value) {
     var clone = array.slice();
     clone.push(value);
     return clone;
 }
-// Returns a copy of the array with the given value appended
+/**
+ * Returns a copy of the array with the given value appended.
+ * Chooses an implementation depending on environment capabilities.
+ * @typeparam T - the array element type
+ * @param array - the source array (not mutated)
+ * @param value - the value to append
+ * @returns a new array with the value at the end
+ */
 exports.append = "toSpliced" in Array.prototype ? _appendNew : _appendOld;
-// Returns the concatenation of the two arrays, potentially reusing the input array if one of the arrays is empty
+/**
+ * Returns the concatenation of two arrays, reusing an input array when the other is empty.
+ * @typeparam T - the array element type
+ * @param first - the first array
+ * @param second - the second array
+ * @returns a new array containing all elements of both arrays (or one of the originals if the other is empty)
+ */
 function concat(first, second) {
     if (first.length === 0)
         return second;
@@ -45,12 +74,20 @@ function concat(first, second) {
         return first;
     return first.concat(second);
 }
+/**
+ * Internal helper to create a reversed copy using modern `toReversed` with optional slicing.
+ * @internal
+ */
 function _reverseNew(array, start, end) {
     var source = undefined !== start || undefined !== end
         ? array.slice(start !== null && start !== void 0 ? start : 0, (end !== null && end !== void 0 ? end : array.length - 1) + 1)
         : array;
     return source.toReversed();
 }
+/**
+ * Internal helper to create a reversed copy using manual iteration (legacy fallback).
+ * @internal
+ */
 function _reverseOld(array, start, end) {
     var _start = start !== null && start !== void 0 ? start : 0;
     var _end = end !== null && end !== void 0 ? end : array.length - 1;
@@ -62,9 +99,23 @@ function _reverseOld(array, start, end) {
         res[resIndex--] = array[arrayIndex];
     return res;
 }
-// Returns an copy of the array between the start and end indices, with the elements in reversed order.
+/**
+ * Returns a copy of the array (or a slice) with elements in reversed order.
+ * @typeparam T - array element type
+ * @param array - the source array
+ * @param start - optional start index (inclusive)
+ * @param end - optional end index (inclusive)
+ */
 exports.reverse = 'toReversed' in Array.prototype ? _reverseNew : _reverseOld;
-// Performs given function on each element of the array, in reverse order if 'reversed' is true.
+/**
+ * Performs the given function for each element of the array, optionally in reverse order.
+ * Halting is supported through the provided `TraverseState`.
+ * @typeparam T - element type
+ * @param array - the source array
+ * @param f - callback receiving (value, sequential index, halt)
+ * @param state - traversal state (created if omitted)
+ * @param reversed - whether to traverse in reverse order
+ */
 function forEach(array, f, state, reversed) {
     if (state === void 0) { state = (0, common_1.TraverseState)(); }
     if (reversed === void 0) { reversed = false; }
@@ -85,7 +136,15 @@ function forEach(array, f, state, reversed) {
         }
     }
 }
-// Returns a copy of the array where given function is applied to each element
+/**
+ * Returns a copy of the array where the given function is applied to each element.
+ * Supports an index offset useful for composed traversals.
+ * @typeparam T - source element type
+ * @typeparam R - result element type
+ * @param array - the source array
+ * @param f - the mapping function
+ * @param indexOffset - optional start index value passed to `f`
+ */
 function map(array, f, indexOffset) {
     if (indexOffset === void 0) { indexOffset = 0; }
     if (indexOffset === 0) {
@@ -101,7 +160,14 @@ function map(array, f, indexOffset) {
     }
     return result;
 }
-// Returns a copy of the array where given functio is applied to each element in reverse order
+/**
+ * Returns a copy of the array where the given function is applied to each element in reverse order.
+ * @typeparam T - source element type
+ * @typeparam R - result element type
+ * @param array - the source array
+ * @param f - the mapping function
+ * @param indexOffset - optional index offset passed to `f`
+ */
 function reverseMap(array, f, indexOffset) {
     if (indexOffset === void 0) { indexOffset = 0; }
     var result = [];
@@ -112,24 +178,53 @@ function reverseMap(array, f, indexOffset) {
         result[resultIndex++] = f(array[arrayIndex], index++);
     return result;
 }
+/**
+ * Internal helper to prepend a value using `toSpliced`.
+ * @internal
+ */
 function _prependNew(array, value) {
     return array.toSpliced(0, 0, value);
 }
+/**
+ * Internal helper to prepend a value using legacy cloning.
+ * @internal
+ */
 function _prependOld(array, value) {
     var clone = array.slice();
     clone.unshift(value);
     return clone;
 }
-// Returns a copy of the given array with the given value added at the start
+/**
+ * Returns a copy of the array with the given value inserted at the start.
+ * @typeparam T - element type
+ * @param array - the source array
+ * @param value - value to insert at index 0
+ */
 exports.prepend = "toSpliced" in Array.prototype ? _prependNew : _prependOld;
+/**
+ * Internal helper to obtain the last element using modern `at`.
+ * @internal
+ */
 function _lastNew(arr) {
     return arr.at(-1);
 }
+/**
+ * Internal helper to obtain the last element using index arithmetic.
+ * @internal
+ */
 function _lastOld(arr) {
     return arr[arr.length - 1];
 }
-// Returns the last element of the array
+/**
+ * Returns the last element of the array.
+ * @typeparam T - element type
+ * @param arr - the array
+ */
 exports.last = "at" in Array.prototype ? _lastNew : _lastOld;
+/**
+ * Internal helper implementing an immutable index update via `with`.
+ * @internal
+ */
 function _updateNew(arr, index, updater) {
     if (index < 0 || index >= arr.length) {
         return arr;
@@ -141,6 +236,10 @@ function _updateNew(arr, index, updater) {
     }
     return arr.with(index, newValue);
 }
+/**
+ * Internal helper implementing an immutable index update via cloning.
+ * @internal
+ */
 function _updateOld(arr, index, updater) {
     if (index < 0 || index >= arr.length) {
         return arr;
@@ -154,9 +253,19 @@ function _updateOld(arr, index, updater) {
     newArr[index] = newValue;
     return newArr;
 }
-// Returns a copy of the array where the element at given index is replaced by the given updater.
-// If the new element is the same as the old element, the original array is returned
+/**
+ * Returns a copy of the array where the element at the given index is replaced using the provided updater.
+ * If the result value is identical (by `Object.is`) the original array is returned.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param index - the index to update
+ * @param updater - value or function update description
+ */
 exports.update = "with" in Array.prototype ? _updateNew : _updateOld;
+/**
+ * Internal helper applying a modifier function via `with`.
+ * @internal
+ */
 function _modNew(arr, index, f) {
     if (index < 0 || index >= arr.length) {
         return arr;
@@ -168,6 +277,10 @@ function _modNew(arr, index, f) {
     }
     return arr.with(index, newValue);
 }
+/**
+ * Internal helper applying a modifier function via cloning.
+ * @internal
+ */
 function _modOld(arr, index, f) {
     if (index < 0 || index >= arr.length) {
         return arr;
@@ -181,27 +294,59 @@ function _modOld(arr, index, f) {
     newArr[index] = newValue;
     return newArr;
 }
-// Returns a copy of the array where the element at given index is replaced by applying given function.
-// If the new element is the same as the old element, the original array is returned
+/**
+ * Returns a copy of the array where the element at the given index is transformed by a modifier function.
+ * If the result value is identical (by `Object.is`) the original array is returned.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param index - the index to modify
+ * @param f - modifier function receiving the current value
+ */
 exports.mod = "with" in Array.prototype ? _modNew : _modOld;
+/**
+ * Internal helper for inserting a value using `toSpliced`.
+ * @internal
+ */
 function _insertNew(arr, index, value) {
     return arr.toSpliced(index, 0, value);
 }
+/**
+ * Internal helper for inserting a value using legacy `splice` on a clone.
+ * @internal
+ */
 function _insertOld(arr, index, value) {
     var clone = arr.slice();
     clone.splice(index, 0, value);
     return clone;
 }
-// Returns a copy of the array where at given index the given value is inserted
+/**
+ * Returns a copy of the array where at the given index the provided value is inserted.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param index - insertion index
+ * @param value - value to insert
+ */
 exports.insert = "toSpliced" in Array.prototype ? _insertNew : _insertOld;
-// Returns a copy of the array, without its first element
+/**
+ * Returns a copy of the array without its first element.
+ * @typeparam T - element type
+ * @param arr - the source array
+ */
 function tail(arr) {
     return arr.slice(1);
 }
-// Returns a copy of the array, without its last element
+/**
+ * Returns a copy of the array without its last element.
+ * @typeparam T - element type
+ * @param arr - the source array
+ */
 function init(arr) {
     return arr.slice(0, arr.length - 1);
 }
+/**
+ * Internal helper providing an immutable `splice` using `toSpliced`.
+ * @internal
+ */
 function _spliceNew(arr, start, deleteCount) {
     var items = [];
     for (var _i = 3; _i < arguments.length; _i++) {
@@ -209,6 +354,10 @@ function _spliceNew(arr, start, deleteCount) {
     }
     return arr.toSpliced.apply(arr, tslib_1.__spreadArray([start, deleteCount], tslib_1.__read(items), false));
 }
+/**
+ * Internal helper providing an immutable `splice` via cloning.
+ * @internal
+ */
 function _spliceOld(arr, start, deleteCount) {
     var items = [];
     for (var _i = 3; _i < arguments.length; _i++) {
@@ -218,9 +367,20 @@ function _spliceOld(arr, start, deleteCount) {
     clone.splice.apply(clone, tslib_1.__spreadArray([start, deleteCount], tslib_1.__read(items), false));
     return clone;
 }
-// Immutable version of the array .splice command, always returns a new array
+/**
+ * Immutable version of the array `.splice` command, always returning a new array.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param start - start index
+ * @param deleteCount - number of elements to delete
+ * @param items - optional items to insert
+ */
 exports.splice = "toSpliced" in Array.prototype ? _spliceNew : _spliceOld;
-// Returns a copy of the array, where its 'sparse' property is kept (sparse = not all indices have a value)
+/**
+ * Returns a copy of a (potentially) sparse array preserving sparsity (skips holes).
+ * @typeparam T - element type
+ * @param arr - the source sparse array
+ */
 function copySparse(arr) {
     var clone = [];
     for (var key in arr) {
@@ -228,8 +388,13 @@ function copySparse(arr) {
     }
     return clone;
 }
-// Returns a copy of the array with given function applied to each element, where its 'sparse' property is kept
-// (sparse = not all indices have a value)
+/**
+ * Returns a copy of a sparse array applying the given function to each present element, preserving holes.
+ * @typeparam T - source element type
+ * @typeparam T2 - result element type
+ * @param arr - the source sparse array
+ * @param f - mapping function
+ */
 function mapSparse(arr, f) {
     var result = Array(arr.length);
     for (var key in arr) {

package/dist/cjs/arr.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"arr.cjs","sourceRoot":"","sources":["../../_cjs_prepare/arr.cts"],"names":[],"mappings":"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"}
+{"version":3,"file":"arr.cjs","sourceRoot":"","sources":["../../_cjs_prepare/arr.cts"],"names":[],"mappings":"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"}

package/dist/cjs/arr.d.cts

@@ -1,33 +1,217 @@
 import { TraverseState, Update, type ArrayNonEmpty } from '@rimbu/common';
+/**
+ * Internal helper that appends a value using the modern immutable `toSpliced` API.
+ * @internal
+ * @typeparam T - the array element type
+ * @param array - the source array (not mutated)
+ * @param value - the value to append
+ * @returns a new non-empty array with the value at the end
+ */
 export declare function _appendNew<T>(array: readonly T[], value: T): ArrayNonEmpty<T>;
+/**
+ * Internal helper that appends a value by cloning and pushing (legacy fallback).
+ * @internal
+ * @typeparam T - the array element type
+ * @param array - the source array (not mutated)
+ * @param value - the value to append
+ * @returns a new non-empty array with the value at the end
+ */
 export declare function _appendOld<T>(array: readonly T[], value: T): ArrayNonEmpty<T>;
+/**
+ * Returns a copy of the array with the given value appended.
+ * Chooses an implementation depending on environment capabilities.
+ * @typeparam T - the array element type
+ * @param array - the source array (not mutated)
+ * @param value - the value to append
+ * @returns a new array with the value at the end
+ */
 export declare const append: typeof _appendNew;
+/**
+ * Returns the concatenation of two arrays, reusing an input array when the other is empty.
+ * @typeparam T - the array element type
+ * @param first - the first array
+ * @param second - the second array
+ * @returns a new array containing all elements of both arrays (or one of the originals if the other is empty)
+ */
 export declare function concat<T>(first: readonly T[], second: readonly T[]): readonly T[];
+/**
+ * Internal helper to create a reversed copy using modern `toReversed` with optional slicing.
+ * @internal
+ */
 export declare function _reverseNew<T>(array: readonly T[], start?: number, end?: number): T[];
+/**
+ * Internal helper to create a reversed copy using manual iteration (legacy fallback).
+ * @internal
+ */
 export declare function _reverseOld<T>(array: readonly T[], start?: number, end?: number): T[];
+/**
+ * Returns a copy of the array (or a slice) with elements in reversed order.
+ * @typeparam T - array element type
+ * @param array - the source array
+ * @param start - optional start index (inclusive)
+ * @param end - optional end index (inclusive)
+ */
 export declare const reverse: typeof _reverseNew;
+/**
+ * Performs the given function for each element of the array, optionally in reverse order.
+ * Halting is supported through the provided `TraverseState`.
+ * @typeparam T - element type
+ * @param array - the source array
+ * @param f - callback receiving (value, sequential index, halt)
+ * @param state - traversal state (created if omitted)
+ * @param reversed - whether to traverse in reverse order
+ */
 export declare function forEach<T>(array: readonly T[], f: (value: T, index: number, halt: () => void) => void, state?: TraverseState, reversed?: boolean): void;
+/**
+ * Returns a copy of the array where the given function is applied to each element.
+ * Supports an index offset useful for composed traversals.
+ * @typeparam T - source element type
+ * @typeparam R - result element type
+ * @param array - the source array
+ * @param f - the mapping function
+ * @param indexOffset - optional start index value passed to `f`
+ */
 export declare function map<T, R>(array: readonly T[], f: (value: T, index: number) => R, indexOffset?: number): R[];
+/**
+ * Returns a copy of the array where the given function is applied to each element in reverse order.
+ * @typeparam T - source element type
+ * @typeparam R - result element type
+ * @param array - the source array
+ * @param f - the mapping function
+ * @param indexOffset - optional index offset passed to `f`
+ */
 export declare function reverseMap<T, R>(array: readonly T[], f: (value: T, index: number) => R, indexOffset?: number): R[];
+/**
+ * Internal helper to prepend a value using `toSpliced`.
+ * @internal
+ */
 export declare function _prependNew<T>(array: readonly T[], value: T): ArrayNonEmpty<T>;
+/**
+ * Internal helper to prepend a value using legacy cloning.
+ * @internal
+ */
 export declare function _prependOld<T>(array: readonly T[], value: T): ArrayNonEmpty<T>;
+/**
+ * Returns a copy of the array with the given value inserted at the start.
+ * @typeparam T - element type
+ * @param array - the source array
+ * @param value - value to insert at index 0
+ */
 export declare const prepend: typeof _prependNew;
+/**
+ * Internal helper to obtain the last element using modern `at`.
+ * @internal
+ */
 export declare function _lastNew<T>(arr: readonly T[]): T;
+/**
+ * Internal helper to obtain the last element using index arithmetic.
+ * @internal
+ */
 export declare function _lastOld<T>(arr: readonly T[]): T;
+/**
+ * Returns the last element of the array.
+ * @typeparam T - element type
+ * @param arr - the array
+ */
 export declare const last: typeof _lastNew;
+/**
+ * Internal helper implementing an immutable index update via `with`.
+ * @internal
+ */
 export declare function _updateNew<T>(arr: readonly T[], index: number, updater: Update<T>): readonly T[];
+/**
+ * Internal helper implementing an immutable index update via cloning.
+ * @internal
+ */
 export declare function _updateOld<T>(arr: readonly T[], index: number, updater: Update<T>): readonly T[];
+/**
+ * Returns a copy of the array where the element at the given index is replaced using the provided updater.
+ * If the result value is identical (by `Object.is`) the original array is returned.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param index - the index to update
+ * @param updater - value or function update description
+ */
 export declare const update: typeof _updateNew;
+/**
+ * Internal helper applying a modifier function via `with`.
+ * @internal
+ */
 export declare function _modNew<T>(arr: readonly T[], index: number, f: (value: T) => T): readonly T[];
+/**
+ * Internal helper applying a modifier function via cloning.
+ * @internal
+ */
 export declare function _modOld<T>(arr: readonly T[], index: number, f: (value: T) => T): readonly T[];
+/**
+ * Returns a copy of the array where the element at the given index is transformed by a modifier function.
+ * If the result value is identical (by `Object.is`) the original array is returned.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param index - the index to modify
+ * @param f - modifier function receiving the current value
+ */
 export declare const mod: typeof _modNew;
+/**
+ * Internal helper for inserting a value using `toSpliced`.
+ * @internal
+ */
 export declare function _insertNew<T>(arr: readonly T[], index: number, value: T): T[];
+/**
+ * Internal helper for inserting a value using legacy `splice` on a clone.
+ * @internal
+ */
 export declare function _insertOld<T>(arr: readonly T[], index: number, value: T): T[];
+/**
+ * Returns a copy of the array where at the given index the provided value is inserted.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param index - insertion index
+ * @param value - value to insert
+ */
 export declare const insert: typeof _insertNew;
+/**
+ * Returns a copy of the array without its first element.
+ * @typeparam T - element type
+ * @param arr - the source array
+ */
 export declare function tail<T>(arr: readonly T[]): T[];
+/**
+ * Returns a copy of the array without its last element.
+ * @typeparam T - element type
+ * @param arr - the source array
+ */
 export declare function init<T>(arr: readonly T[]): T[];
+/**
+ * Internal helper providing an immutable `splice` using `toSpliced`.
+ * @internal
+ */
 export declare function _spliceNew<T>(arr: readonly T[], start: number, deleteCount: number, ...items: T[]): T[];
+/**
+ * Internal helper providing an immutable `splice` via cloning.
+ * @internal
+ */
 export declare function _spliceOld<T>(arr: readonly T[], start: number, deleteCount: number, ...items: T[]): T[];
+/**
+ * Immutable version of the array `.splice` command, always returning a new array.
+ * @typeparam T - element type
+ * @param arr - the source array
+ * @param start - start index
+ * @param deleteCount - number of elements to delete
+ * @param items - optional items to insert
+ */
 export declare const splice: typeof _spliceNew;
+/**
+ * Returns a copy of a (potentially) sparse array preserving sparsity (skips holes).
+ * @typeparam T - element type
+ * @param arr - the source sparse array
+ */
 export declare function copySparse<T>(arr: readonly T[]): T[];
+/**
+ * Returns a copy of a sparse array applying the given function to each present element, preserving holes.
+ * @typeparam T - source element type
+ * @typeparam T2 - result element type
+ * @param arr - the source sparse array
+ * @param f - mapping function
+ */
 export declare function mapSparse<T, T2>(arr: readonly T[], f: (value: T, index: number) => T2): T2[];

package/dist/cjs/entry.cjs

@@ -2,11 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.first = first;
 exports.second = second;
-// Returns the first element of a 2-Tuple
+/**
+ * Returns the first element of a 2-tuple.
+ * @typeparam K - the first element type
+ * @typeparam V - the second element type
+ * @param entry - the tuple
+ * @returns the first element
+ */
 function first(entry) {
     return entry[0];
 }
-// Returns the second element of a 2-Tuple
+/**
+ * Returns the second element of a 2-tuple.
+ * @typeparam K - the first element type
+ * @typeparam V - the second element type
+ * @param entry - the tuple
+ * @returns the second element
+ */
 function second(entry) {
     return entry[1];
 }

package/dist/cjs/entry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry.cjs","sourceRoot":"","sources":["../../_cjs_prepare/entry.cts"],"names":[],"mappings":";;AACA,sBAEC;AAGD,wBAEC;AARD,yCAAyC;AACzC,SAAgB,KAAK,CAAO,KAAsB;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,0CAA0C;AAC1C,SAAgB,MAAM,CAAO,KAAsB;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"entry.cjs","sourceRoot":"","sources":["../../_cjs_prepare/entry.cts"],"names":[],"mappings":";;AAOA,sBAEC;AASD,wBAEC;AApBD;;;;;;GAMG;AACH,SAAgB,KAAK,CAAO,KAAsB;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,MAAM,CAAO,KAAsB;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/cjs/entry.d.cts

@@ -1,2 +1,16 @@
+/**
+ * Returns the first element of a 2-tuple.
+ * @typeparam K - the first element type
+ * @typeparam V - the second element type
+ * @param entry - the tuple
+ * @returns the first element
+ */
 export declare function first<K, V>(entry: readonly [K, V]): K;
+/**
+ * Returns the second element of a 2-tuple.
+ * @typeparam K - the first element type
+ * @typeparam V - the second element type
+ * @param entry - the tuple
+ * @returns the second element
+ */
 export declare function second<K, V>(entry: readonly [K, V]): V;

package/dist/cjs/index.cjs

@@ -2,9 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RimbuError = exports.Entry = exports.Arr = void 0;
 var tslib_1 = require("tslib");
+/**
+ * @packageDocumentation
+ *
+ * The `@rimbu/base` package provides foundational immutable array utilities, tuple helpers,
+ * plain‑object type predicates and structured error types that power all other Rimbu collections.<br/>
+ * Use it directly when you need low‑level, performance‑aware primitives for persistent data
+ * structures without pulling in the higher‑level collection packages.<br/>
+ * See the Rimbu docs and API reference for more information.
+ */
 exports.Arr = tslib_1.__importStar(require("./arr.cjs"));
 exports.Entry = tslib_1.__importStar(require("./entry.cjs"));
 exports.RimbuError = tslib_1.__importStar(require("./rimbu-error.cjs"));
 tslib_1.__exportStar(require("./plain-object.cjs"), exports);
+// Internal exports (may change without notice)
 tslib_1.__exportStar(require("./internal.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../_cjs_prepare/index.cts"],"names":[],"mappings":";;;;AAAA,yDAAiC;AACjC,6DAAqC;AACrC,wEAAgD;AAChD,6DAAmC;AAEnC,yDAA+B"}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../_cjs_prepare/index.cts"],"names":[],"mappings":";;;;AAAA;;;;;;;;GAQG;AACH,yDAAiC;AACjC,6DAAqC;AACrC,wEAAgD;AAChD,6DAAmC;AAEnC,+CAA+C;AAC/C,yDAA+B"}