@ezez/utils 2.1.0 → 4.0.0

package/CHANGELOG.md

@@ -3,6 +3,43 @@ All notable changes to this project will be documented in this file.
 The format is based on [EZEZ Changelog](https://ezez.dev/changelog/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [UNRELEASED]
+- (nothing yet)
+
+## [4.0.0] - 2024-05-16
+### Breaking
+- `replaceDeep` will not mutate anything by default anymore — previously it was wrongly documented as always mutating,
+but it was not mutating objects. Mutating behavior can now be enabled and additionally controlled by defining if
+instances properties are allowed to be mutated.
+- [`serialize`] to avoid excessive calls to serializer functions - they are now only called with non-plain objects or
+unknown data types, this breaks some rare use cases
+### Changed
+- `serialize` custom serializers now allow things like `Date` (that defines .toJSON) to be supported as the user would
+expect
+### Added
+- `replaceDeepByFn` method for more granular control over replacing values. `replaceDeep` is a simplified wrapper over
+the new function
+- `trim`, `trimStart`, and `trimEnd` methods
+### Dev
+- upgraded some jsdocs
+
+## [3.0.0] - 2024-03-25
+### Breaking
+- `waitFor` method was upgraded:
+  - now it supports Promises
+  - the check fails only if `undefined`, `null` or `false` is given
+  - function signature is changed (object options)
+  - `maxTries` option is added to have a limit of tries unrelated to time
+  - no wait before the initial check
+### Added
+- `toggle` method
+- `sample` method
+- `samples` method
+- `shuffle` method
+### Dev
+- added `waitFor` unit tests
+- added missing build files to repo (missing since 2.0.0)
+
 ## [2.1.0] - 2023-10-29
 ### Added
 - `round` method

package/dist/index.d.ts

@@ -37,16 +37,23 @@ export * from "./replaceDeep.js";
 export * from "./rethrow.js";
 export * from "./round.js";
 export * from "./safe.js";
+export * from "./sample.js";
+export * from "./samples.js";
 export * from "./scale.js";
 export * from "./seq.js";
 export * from "./serialize.js";
 export * from "./set.js";
 export * from "./setImmutable.js";
+export * from "./shuffle.js";
 export * from "./sortBy.js";
 export * from "./sortProps.js";
 export * from "./stripPrefix.js";
 export * from "./stripSuffix.js";
 export * from "./throttle.js";
+export * from "./toggle.js";
+export * from "./trim.js";
+export * from "./trimEnd.js";
+export * from "./trimStart.js";
 export * from "./truthy.js";
 export * from "./unique.js";
 export * from "./wait.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -53,16 +53,23 @@ __exportStar(require("./replaceDeep.js"), exports);
 __exportStar(require("./rethrow.js"), exports);
 __exportStar(require("./round.js"), exports);
 __exportStar(require("./safe.js"), exports);
+__exportStar(require("./sample.js"), exports);
+__exportStar(require("./samples.js"), exports);
 __exportStar(require("./scale.js"), exports);
 __exportStar(require("./seq.js"), exports);
 __exportStar(require("./serialize.js"), exports);
 __exportStar(require("./set.js"), exports);
 __exportStar(require("./setImmutable.js"), exports);
+__exportStar(require("./shuffle.js"), exports);
 __exportStar(require("./sortBy.js"), exports);
 __exportStar(require("./sortProps.js"), exports);
 __exportStar(require("./stripPrefix.js"), exports);
 __exportStar(require("./stripSuffix.js"), exports);
 __exportStar(require("./throttle.js"), exports);
+__exportStar(require("./toggle.js"), exports);
+__exportStar(require("./trim.js"), exports);
+__exportStar(require("./trimEnd.js"), exports);
+__exportStar(require("./trimStart.js"), exports);
 __exportStar(require("./truthy.js"), exports);
 __exportStar(require("./unique.js"), exports);
 __exportStar(require("./wait.js"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,oDAAkC;AAClC,oDAAkC;AAClC,2CAAyB;AACzB,kDAAgC;AAChC,gDAA8B;AAC9B,qDAAmC;AACnC,oDAAkC;AAClC,mDAAiC;AACjC,mDAAiC;AACjC,kDAAgC;AAChC,mDAAiC;AACjC,uDAAqC;AACrC,oDAAkC;AAClC,kDAAgC;AAChC,2CAAyB;AACzB,mDAAiC;AACjC,uDAAqC;AACrC,+CAA6B;AAC7B,uDAAqC;AACrC,qDAAmC;AACnC,4CAA0B;AAC1B,6CAA2B;AAC3B,gDAA8B;AAC9B,iDAA+B;AAC/B,6CAA2B;AAC3B,6CAA2B;AAC3B,oDAAkC;AAClC,4CAA0B;AAC1B,mDAAiC;AACjC,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,8CAA4B;AAC5B,8DAA4C;AAC5C,+CAA6B;AAC7B,mDAAiC;AACjC,+CAA6B;AAC7B,6CAA2B;AAC3B,4CAA0B;AAC1B,6CAA2B;AAC3B,2CAAyB;AACzB,iDAA+B;AAC/B,2CAAyB;AACzB,oDAAkC;AAClC,8CAA4B;AAC5B,iDAA+B;AAC/B,mDAAiC;AACjC,mDAAiC;AACjC,gDAA8B;AAC9B,8CAA4B;AAC5B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,oDAAkC;AAClC,oDAAkC;AAClC,2CAAyB;AACzB,kDAAgC;AAChC,gDAA8B;AAC9B,qDAAmC;AACnC,oDAAkC;AAClC,mDAAiC;AACjC,mDAAiC;AACjC,kDAAgC;AAChC,mDAAiC;AACjC,uDAAqC;AACrC,oDAAkC;AAClC,kDAAgC;AAChC,2CAAyB;AACzB,mDAAiC;AACjC,uDAAqC;AACrC,+CAA6B;AAC7B,uDAAqC;AACrC,qDAAmC;AACnC,4CAA0B;AAC1B,6CAA2B;AAC3B,gDAA8B;AAC9B,iDAA+B;AAC/B,6CAA2B;AAC3B,6CAA2B;AAC3B,oDAAkC;AAClC,4CAA0B;AAC1B,mDAAiC;AACjC,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,8CAA4B;AAC5B,8DAA4C;AAC5C,+CAA6B;AAC7B,mDAAiC;AACjC,+CAA6B;AAC7B,6CAA2B;AAC3B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B;AAC3B,2CAAyB;AACzB,iDAA+B;AAC/B,2CAAyB;AACzB,oDAAkC;AAClC,+CAA6B;AAC7B,8CAA4B;AAC5B,iDAA+B;AAC/B,mDAAiC;AACjC,mDAAiC;AACjC,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,iDAA+B;AAC/B,8CAA4B;AAC5B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,gDAA8B"}

package/dist/omit.d.ts

@@ -1,4 +1,4 @@
-declare const omit: <T extends object, K extends keyof T>(object: T | null, props: K[]) => T extends null ? {
+declare const omit: <T extends object, K extends keyof T = keyof T>(object: T | null, props: K[]) => T extends null ? {
     [key: string]: never;
 } : Omit<T, K>;
 export { omit };

package/dist/omit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"omit.d.ts","sourceRoot":"","sources":["../src/omit.ts"],"names":[],"mappings":"AAeA,QAAA,MAAM,IAAI;;cAyBT,CAAC;AAEF,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"omit.d.ts","sourceRoot":"","sources":["../src/omit.ts"],"names":[],"mappings":"AAqBA,QAAA,MAAM,IAAI;;cAyBT,CAAC;AAEF,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/omit.js.map

@@ -1 +1 @@
-{"version":3,"file":"omit.js","sourceRoot":"","sources":["../src/omit.ts"],"names":[],"mappings":";;;AAeA,MAAM,IAAI,GAAG,CACT,MAAgB,EAAE,KAAU,EAC0B,EAAE;IACxD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,EAAE;QAEzE,OAAO,EAAE,CAAC;KACb;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QAExC,OAAO;YACH,GAAG,MAAM;SACZ,CAAC;KACL;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;QACtB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YACxB,MAAY,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;SACpC;KACJ;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEO,oBAAI"}
+{"version":3,"file":"omit.js","sourceRoot":"","sources":["../src/omit.ts"],"names":[],"mappings":";;;AAqBA,MAAM,IAAI,GAAG,CACT,MAAgB,EAAE,KAAU,EAC0B,EAAE;IACxD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,EAAE;QAEzE,OAAO,EAAE,CAAC;KACb;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QAExC,OAAO;YACH,GAAG,MAAM;SACZ,CAAC;KACL;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;QACtB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YACxB,MAAY,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;SACpC;KACJ;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEO,oBAAI"}

package/dist/replace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,OAAO,WAAY,MAAM,cAAc,OAAO,MAAM,EAAE,MAAM,CAAC,WAQlE,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}
+{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,OAAO,WAAY,MAAM,cAAc,OAAO,MAAM,EAAE,MAAM,CAAC,WAOlE,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}

package/dist/replace.js.map

@@ -1 +1 @@
-{"version":3,"file":"replace.js","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":";;;AAAA,uDAAiD;AASjD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,UAAkC,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACnB,OAAO,MAAM,CAAC;KACjB;IAED,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,8BAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAGE,0BAAO"}
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":";;;AAAA,uDAAiD;AASjD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,UAAkC,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACnB,OAAO,MAAM,CAAC;KACjB;IACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,8BAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAGE,0BAAO"}

package/dist/replaceDeep.d.ts

@@ -1,3 +1,7 @@
-declare const replaceDeep: <T>(source: T, search: unknown, value: unknown) => T;
+type Options = {
+    mutate?: boolean;
+    replaceInstancesProps?: boolean;
+};
+declare const replaceDeep: <T>(source: T, search: unknown, value: unknown, options?: Options) => T;
 export { replaceDeep, };
 //# sourceMappingURL=replaceDeep.d.ts.map

package/dist/replaceDeep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replaceDeep.d.ts","sourceRoot":"","sources":["../src/replaceDeep.ts"],"names":[],"mappings":"AAaA,QAAA,MAAM,WAAW,yBAA0B,OAAO,SAAS,OAAO,MA0BjE,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}
+{"version":3,"file":"replaceDeep.d.ts","sourceRoot":"","sources":["../src/replaceDeep.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IAIX,MAAM,CAAC,EAAE,OAAO,CAAC;IAMjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAmBF,QAAA,MAAM,WAAW,yBAA0B,OAAO,SAAS,OAAO,YAAY,OAAO,MAEpF,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/dist/replaceDeep.js

@@ -1,26 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.replaceDeep = void 0;
-const replaceDeep = (source, search, value) => {
-    if (Object.is(source, search)) {
-        return value;
-    }
-    if (source == null) {
-        return source;
-    }
-    if (typeof source === "object") {
-        if (Array.isArray(source)) {
-            for (let i = 0; i < source.length; i++) {
-                source[i] = replaceDeep(source[i], search, value);
-            }
-            return source;
-        }
-        return Object.keys(source).reduce((acc, key) => {
-            acc[key] = replaceDeep(source[key], search, value);
-            return acc;
-        }, {});
-    }
-    return source;
+const replaceDeepByFn_js_1 = require("./replaceDeepByFn.js");
+const replaceDeep = (source, search, value, options) => {
+    return (0, replaceDeepByFn_js_1.replaceDeepByFn)(source, (v) => Object.is(v, search), () => value, options);
 };
 exports.replaceDeep = replaceDeep;
 //# sourceMappingURL=replaceDeep.js.map

package/dist/replaceDeep.js.map

@@ -1 +1 @@
-{"version":3,"file":"replaceDeep.js","sourceRoot":"","sources":["../src/replaceDeep.ts"],"names":[],"mappings":";;;AAaA,MAAM,WAAW,GAAG,CAAI,MAAS,EAAE,MAAe,EAAE,KAAc,EAAK,EAAE;IACrE,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;QAC3B,OAAO,KAAU,CAAC;KACrB;IAED,IAAI,MAAM,IAAI,IAAI,EAAE;QAChB,OAAO,MAAM,CAAC;KACjB;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBAEpC,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;aACrD;YACD,OAAO,MAAM,CAAC;SACjB;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAEpE,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAE,MAAkC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAChF,OAAO,GAAG,CAAC;QACf,CAAC,EAAE,EAAE,CAAM,CAAC;KACf;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAGE,kCAAW"}
+{"version":3,"file":"replaceDeep.js","sourceRoot":"","sources":["../src/replaceDeep.ts"],"names":[],"mappings":";;;AAAA,6DAAuD;AAgCvD,MAAM,WAAW,GAAG,CAAI,MAAS,EAAE,MAAe,EAAE,KAAc,EAAE,OAAiB,EAAK,EAAE;IACxF,OAAO,IAAA,oCAAe,EAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC,CAAC;AAGE,kCAAW"}

package/dist/replaceDeepByFn.d.ts

@@ -0,0 +1,7 @@
+type Options = {
+    mutate?: boolean;
+    replaceInstancesProps?: boolean;
+};
+declare const replaceDeepByFn: <T>(source: T, search: (value: unknown) => boolean, replaceWith: (value: unknown) => unknown, options?: Options) => T;
+export { replaceDeepByFn, };
+//# sourceMappingURL=replaceDeepByFn.d.ts.map

package/dist/replaceDeepByFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceDeepByFn.d.ts","sourceRoot":"","sources":["../src/replaceDeepByFn.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IAIX,MAAM,CAAC,EAAE,OAAO,CAAC;IAMjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAkBF,QAAA,MAAM,eAAe,iCACU,OAAO,KAAK,OAAO,uBAAuB,OAAO,KAAK,OAAO,YAAY,OAAO,MAwD9G,CAAC;AAEF,OAAO,EACH,eAAe,GAClB,CAAC"}

package/dist/replaceDeepByFn.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceDeepByFn = void 0;
+const isPlainObject_1 = require("./isPlainObject");
+const replaceDeepByFn = (source, search, replaceWith, options) => {
+    if (options?.replaceInstancesProps && !options.mutate) {
+        throw new Error("`replaceInstancesProps` option requires `mutate` to be enabled");
+    }
+    const searchResult = search(source);
+    if (typeof searchResult !== "boolean") {
+        throw new Error("search function must return a boolean");
+    }
+    if (searchResult) {
+        return replaceWith(source);
+    }
+    if (source == null) {
+        return source;
+    }
+    if (typeof source === "object") {
+        if (Array.isArray(source)) {
+            if (options?.mutate) {
+                for (let i = 0; i < source.length; i++) {
+                    source[i] = replaceDeepByFn(source[i], search, replaceWith, options);
+                }
+                return source;
+            }
+            return source.map((item) => replaceDeepByFn(item, search, replaceWith, options));
+        }
+        if (options?.mutate) {
+            if ((0, isPlainObject_1.isPlainObject)(source) || options.replaceInstancesProps) {
+                for (const key of Object.keys(source)) {
+                    source[key] = replaceDeepByFn(source[key], search, replaceWith, options);
+                }
+            }
+            return source;
+        }
+        if ((0, isPlainObject_1.isPlainObject)(source)) {
+            return Object.keys(source).reduce((acc, key) => {
+                acc[key] = replaceDeepByFn(source[key], search, replaceWith, options);
+                return acc;
+            }, {});
+        }
+    }
+    return source;
+};
+exports.replaceDeepByFn = replaceDeepByFn;
+//# sourceMappingURL=replaceDeepByFn.js.map

package/dist/replaceDeepByFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceDeepByFn.js","sourceRoot":"","sources":["../src/replaceDeepByFn.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AA+BhD,MAAM,eAAe,GAAG,CACpB,MAAS,EAAE,MAAmC,EAAE,WAAwC,EAAE,OAAiB,EAC1G,EAAE;IACH,IAAI,OAAO,EAAE,qBAAqB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;QACnD,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;KACrF;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpC,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE;QACnC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;KAC5D;IAED,IAAI,YAAY,EAAE;QACd,OAAO,WAAW,CAAC,MAAM,CAAM,CAAC;KACnC;IAED,IAAI,MAAM,IAAI,IAAI,EAAE;QAChB,OAAO,MAAM,CAAC;KACjB;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACvB,IAAI,OAAO,EAAE,MAAM,EAAE;gBACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBAEpC,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;iBACxE;gBACD,OAAO,MAAM,CAAC;aACjB;YAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAiB,CAAC;SACpG;QAED,IAAI,OAAO,EAAE,MAAM,EAAE;YACjB,IAAI,IAAA,6BAAa,EAAC,MAAM,CAAC,IAAI,OAAO,CAAC,qBAAqB,EAAE;gBACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;oBAElC,MAAkC,CAAC,GAAG,CAAC,GAAG,eAAe,CACrD,MAAkC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CACzE,CAAC;iBACL;aACJ;YAED,OAAO,MAAM,CAAC;SACjB;QAED,IAAI,IAAA,6BAAa,EAAC,MAAM,CAAC,EAAE;YACvB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBAEpE,GAAG,CAAC,GAAG,CAAC,GAAG,eAAe,CAAE,MAAkC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;gBACnG,OAAO,GAAG,CAAC;YACf,CAAC,EAAE,EAAE,CAAM,CAAC;SACf;KACJ;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAGE,0CAAe"}

package/dist/safe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAAA,iBAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;AAC7C,iBAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAqBhD,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAAA,iBAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;AAC7C,iBAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAoBhD,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/safe.js.map

@@ -1 +1 @@
-{"version":3,"file":"safe.js","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":";;;AAYA,SAAS,IAAI,CAAO,EAAW,EAAE,GAAO;IAEpC,IAAI;QACA,OAAO,EAAE,EAAE,CAAC;KACf;IACD,MAAM;QACF,OAAO,GAAG,CAAC;KACd;AACL,CAAC;AAEQ,oBAAI"}
+{"version":3,"file":"safe.js","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":";;;AAYA,SAAS,IAAI,CAAO,EAAW,EAAE,GAAO;IACpC,IAAI;QACA,OAAO,EAAE,EAAE,CAAC;KACf;IACD,MAAM;QACF,OAAO,GAAG,CAAC;KACd;AACL,CAAC;AAEQ,oBAAI"}

package/dist/sample.d.ts

@@ -0,0 +1,3 @@
+declare const sample: <T>(array: T[]) => T;
+export { sample, };
+//# sourceMappingURL=sample.d.ts.map

package/dist/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../src/sample.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,MAAM,sBAEX,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}

package/dist/sample.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sample = void 0;
+const sample = (array) => {
+    return array[Math.floor(Math.random() * array.length)];
+};
+exports.sample = sample;
+//# sourceMappingURL=sample.js.map

package/dist/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../src/sample.ts"],"names":[],"mappings":";;;AAIA,MAAM,MAAM,GAAG,CAAI,KAAU,EAAK,EAAE;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAE,CAAC;AAC5D,CAAC,CAAC;AAGE,wBAAM"}

package/dist/samples.d.ts

@@ -0,0 +1,3 @@
+declare const samples: <T>(array: T[], elementsToPick: number, allowShuffle?: boolean) => T[];
+export { samples, };
+//# sourceMappingURL=samples.d.ts.map

package/dist/samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../src/samples.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,OAAO,kCAAmC,MAAM,gCA0BrD,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}

package/dist/samples.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.samples = void 0;
+const samples = (array, elementsToPick, allowShuffle = false) => {
+    if (elementsToPick < 0) {
+        throw new Error("elementsToPick must be a positive number");
+    }
+    if (elementsToPick === 0) {
+        return [];
+    }
+    if (!allowShuffle && elementsToPick >= array.length) {
+        return array;
+    }
+    const keys = Object.keys(array);
+    let picked = 0;
+    const result = [];
+    while (picked < elementsToPick) {
+        const indexOfKey = Math.floor(Math.random() * keys.length);
+        const indexOfArray = Number(keys[indexOfKey]);
+        const element = array[indexOfArray];
+        result.push(element);
+        keys.splice(indexOfKey, 1);
+        picked++;
+    }
+    return result;
+};
+exports.samples = samples;
+//# sourceMappingURL=samples.js.map

package/dist/samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.js","sourceRoot":"","sources":["../src/samples.ts"],"names":[],"mappings":";;;AAUA,MAAM,OAAO,GAAG,CAAI,KAAU,EAAE,cAAsB,EAAE,YAAY,GAAG,KAAK,EAAO,EAAE;IACjF,IAAI,cAAc,GAAG,CAAC,EAAE;QACpB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;KAC/D;IACD,IAAI,cAAc,KAAK,CAAC,EAAE;QACtB,OAAO,EAAE,CAAC;KACb;IAED,IAAI,CAAC,YAAY,IAAI,cAAc,IAAI,KAAK,CAAC,MAAM,EAAE;QACjD,OAAO,KAAK,CAAC;KAChB;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,OAAO,MAAM,GAAG,cAAc,EAAE;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC3B,MAAM,EAAE,CAAC;KACZ;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAGE,0BAAO"}

package/dist/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAEA,KAAK,iBAAiB,GAAG;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,KAAK,OAAO,GAAG;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAoBF,QAAA,MAAM,SAAS,SAAU,OAAO,sBAAsB,iBAAiB,YAAY,OAAO,WAgEzF,CAAC;AAEF,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAKA,KAAK,iBAAiB,GAAG;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;IACV,CAAC,CAAC,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,KAAK,OAAO,GAAG;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAoBF,QAAA,MAAM,SAAS,SAAU,OAAO,sBAAsB,iBAAiB,YAAY,OAAO,WA4GzF,CAAC;AAEF,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/serialize.js

@@ -2,7 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serialize = void 0;
 const sortProps_js_1 = require("./sortProps.js");
+const replaceDeepByFn_js_1 = require("./replaceDeepByFn.js");
+const isPlainObject_js_1 = require("./isPlainObject.js");
+const utils_js_1 = require("./utils/utils.js");
 const serialize = (data, customSerializers, options) => {
+    const sourceData = Object.keys(customSerializers ?? {}).length
+        ? (0, replaceDeepByFn_js_1.replaceDeepByFn)(data, value => {
+            if (["string", "number", "bigint", "undefined", "boolean"].includes(typeof value)) {
+                return false;
+            }
+            if (value === null || Array.isArray(value)) {
+                return false;
+            }
+            if ((0, isPlainObject_js_1.isPlainObject)(value)) {
+                return false;
+            }
+            const serializerKeys = Object.keys(customSerializers ?? {});
+            for (const key of serializerKeys) {
+                const serialized = customSerializers[key](value);
+                if (typeof serialized === "string") {
+                    return true;
+                }
+            }
+            return false;
+        }, value => new utils_js_1.DataWrapper(value))
+        : data;
     const replacer = (_key, value) => {
         if (typeof value === "string") {
             return `s:${value}`;
@@ -22,40 +46,54 @@ const serialize = (data, customSerializers, options) => {
         if (value === null) {
             return "l:";
         }
+        if (Array.isArray(value)) {
+            return value;
+        }
+        if ((0, isPlainObject_js_1.isPlainObject)(value)) {
+            return value;
+        }
         const serializerKeys = Object.keys(customSerializers ?? {});
         for (const key of serializerKeys) {
-            const serialized = customSerializers[key](value);
+            const serialized = customSerializers[key](value instanceof utils_js_1.DataWrapper ? value.data : value);
             if (typeof serialized === "string") {
                 return `${key}:${serialized}`;
             }
+            if (serialized !== null) {
+                throw new Error(`Custom serializer for key ${key} returned a non-string value: ${String(serialized)}`);
+            }
         }
         if (typeof value === "object") {
             return value;
         }
         throw new Error(`Unsupported data type: ${typeof value}`);
     };
-    if (data == null
-        || typeof data === "string"
-        || typeof data === "number"
-        || typeof data === "bigint"
-        || typeof data === "undefined"
-        || typeof data === "boolean"
-        || Array.isArray(data)) {
-        return JSON.stringify(data, replacer);
+    if (sourceData == null
+        || typeof sourceData === "string"
+        || typeof sourceData === "number"
+        || typeof sourceData === "bigint"
+        || typeof sourceData === "undefined"
+        || typeof sourceData === "boolean"
+        || Array.isArray(sourceData)) {
+        return JSON.stringify(sourceData, replacer);
     }
-    const serializerKeysGlobal = Object.keys(customSerializers ?? {});
-    for (const key of serializerKeysGlobal) {
-        const serialized = customSerializers[key](data);
-        if (typeof serialized === "string") {
-            return `"${key}:${serialized}"`;
+    if (!(0, isPlainObject_js_1.isPlainObject)(sourceData)) {
+        const serializerKeysGlobal = Object.keys(customSerializers ?? {});
+        for (const key of serializerKeysGlobal) {
+            const serialized = customSerializers[key](sourceData instanceof utils_js_1.DataWrapper ? sourceData.data : sourceData);
+            if (typeof serialized === "string") {
+                return `"${key}:${serialized}"`;
+            }
+            if (serialized !== null) {
+                throw new Error(`Custom serializer for key ${key} returned a non-string value: ${String(serialized)}`);
+            }
         }
     }
-    if (typeof data === "object") {
+    if (typeof sourceData === "object") {
         return JSON.stringify(options?.sortProps === false
-            ? data
-            : (0, sortProps_js_1.sortProps)(data), replacer);
+            ? sourceData
+            : (0, sortProps_js_1.sortProps)(sourceData), replacer);
     }
-    throw new Error(`Unsupported data type: ${typeof data}`);
+    throw new Error(`Unsupported data type: ${typeof sourceData}`);
 };
 exports.serialize = serialize;
 //# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":";;;AAAA,iDAA2C;AAkC3C,MAAM,SAAS,GAAG,CAAC,IAAa,EAAE,iBAAqC,EAAE,OAAiB,EAAE,EAAE;IAC1F,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;QAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC3B,OAAO,KAAK,KAAK,EAAE,CAAC;SACvB;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC3B,OAAO,KAAK,KAAK,EAAE,CAAC;SACvB;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC3B,OAAO,KAAK,KAAK,EAAE,CAAC;SACvB;QACD,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE;YAC9B,OAAO,IAAI,CAAC;SACf;QACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE;YAC5B,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACpC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE;YAChB,OAAO,IAAI,CAAC;SACf;QACD,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE;YAC9B,MAAM,UAAU,GAAG,iBAAkB,CAAC,GAAG,CAAE,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;gBAChC,OAAO,GAAG,GAAG,IAAI,UAAU,EAAE,CAAC;aACjC;SACJ;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC3B,OAAO,KAAK,CAAC;SAChB;QAED,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC;IAEF,IACI,IAAI,IAAI,IAAI;WACT,OAAO,IAAI,KAAK,QAAQ;WACxB,OAAO,IAAI,KAAK,QAAQ;WACxB,OAAO,IAAI,KAAK,QAAQ;WACxB,OAAO,IAAI,KAAK,WAAW;WAC3B,OAAO,IAAI,KAAK,SAAS;WACzB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EACxB;QACE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KACzC;IAED,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE;QACpC,MAAM,UAAU,GAAG,iBAAkB,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;YAChC,OAAO,IAAI,GAAG,IAAI,UAAU,GAAG,CAAC;SACnC;KACJ;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC1B,OAAO,IAAI,CAAC,SAAS,CACjB,OAAO,EAAE,SAAS,KAAK,KAAK;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAA,wBAAS,EAAC,IAA+B,CAAC,EAChD,QAAQ,CACX,CAAC;KACL;IAED,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC;AAGO,8BAAS"}
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"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"}

package/dist/shuffle.d.ts

@@ -0,0 +1,3 @@
+declare const shuffle: <T>(array: T[]) => T[];
+export { shuffle, };
+//# sourceMappingURL=shuffle.d.ts.map

package/dist/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../src/shuffle.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,OAAO,wBAEZ,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}

package/dist/shuffle.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shuffle = void 0;
+const samples_js_1 = require("./samples.js");
+const shuffle = (array) => {
+    return (0, samples_js_1.samples)(array, array.length, true);
+};
+exports.shuffle = shuffle;
+//# sourceMappingURL=shuffle.js.map

package/dist/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.js","sourceRoot":"","sources":["../src/shuffle.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAMvC,MAAM,OAAO,GAAG,CAAI,KAAU,EAAO,EAAE;IACnC,OAAO,IAAA,oBAAO,EAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC,CAAC;AAGE,0BAAO"}

package/dist/toggle.d.ts

@@ -0,0 +1,3 @@
+declare const toggle: <T>(array: T[], item: T) => T[];
+export { toggle, };
+//# sourceMappingURL=toggle.d.ts.map

package/dist/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../src/toggle.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,MAAM,iCAUX,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}

package/dist/toggle.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toggle = void 0;
+const toggle = (array, item) => {
+    const index = array.findIndex((i) => Object.is(i, item));
+    if (index === -1) {
+        array.push(item);
+    }
+    else {
+        array.splice(index, 1);
+    }
+    return array;
+};
+exports.toggle = toggle;
+//# sourceMappingURL=toggle.js.map

package/dist/toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../src/toggle.ts"],"names":[],"mappings":";;;AAOA,MAAM,MAAM,GAAG,CAAI,KAAU,EAAE,IAAO,EAAO,EAAE;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAEzD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KACpB;SACI;QACD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;KAC1B;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAGE,wBAAM"}

package/dist/trim.d.ts

@@ -0,0 +1,3 @@
+declare const trim: (source: string, characters: string) => string;
+export { trim, };
+//# sourceMappingURL=trim.d.ts.map

package/dist/trim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim.d.ts","sourceRoot":"","sources":["../src/trim.ts"],"names":[],"mappings":"AAgBA,QAAA,MAAM,IAAI,WAAY,MAAM,cAAc,MAAM,WAE/C,CAAC;AAEF,OAAO,EACH,IAAI,GACP,CAAC"}

package/dist/trim.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trim = void 0;
+const trimStart_js_1 = require("./trimStart.js");
+const trimEnd_js_1 = require("./trimEnd.js");
+const trim = (source, characters) => {
+    return (0, trimStart_js_1.trimStart)((0, trimEnd_js_1.trimEnd)(source, characters), characters);
+};
+exports.trim = trim;
+//# sourceMappingURL=trim.js.map

package/dist/trim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim.js","sourceRoot":"","sources":["../src/trim.ts"],"names":[],"mappings":";;;AAAA,iDAA2C;AAC3C,6CAAuC;AAevC,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,UAAkB,EAAE,EAAE;IAChD,OAAO,IAAA,wBAAS,EAAC,IAAA,oBAAO,EAAC,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC,CAAC;AAGE,oBAAI"}

package/dist/trimEnd.d.ts

@@ -0,0 +1,3 @@
+declare const trimEnd: (source: string, characters: string) => string;
+export { trimEnd, };
+//# sourceMappingURL=trimEnd.d.ts.map

package/dist/trimEnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trimEnd.d.ts","sourceRoot":"","sources":["../src/trimEnd.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,OAAO,WAAY,MAAM,cAAc,MAAM,WAMlD,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}

package/dist/trimEnd.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trimEnd = void 0;
+const trimEnd = (source, characters) => {
+    let s = source;
+    while (s.endsWith(characters)) {
+        s = s.slice(0, -characters.length);
+    }
+    return s;
+};
+exports.trimEnd = trimEnd;
+//# sourceMappingURL=trimEnd.js.map

package/dist/trimEnd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trimEnd.js","sourceRoot":"","sources":["../src/trimEnd.ts"],"names":[],"mappings":";;;AAWA,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,UAAkB,EAAE,EAAE;IACnD,IAAI,CAAC,GAAG,MAAM,CAAC;IACf,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAC3B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;KACtC;IACD,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AAGE,0BAAO"}

package/dist/trimStart.d.ts

@@ -0,0 +1,3 @@
+declare const trimStart: (source: string, characters: string) => string;
+export { trimStart, };
+//# sourceMappingURL=trimStart.d.ts.map

package/dist/trimStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trimStart.d.ts","sourceRoot":"","sources":["../src/trimStart.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,SAAS,WAAY,MAAM,cAAc,MAAM,WAMpD,CAAC;AAEF,OAAO,EACH,SAAS,GACZ,CAAC"}

package/dist/trimStart.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trimStart = void 0;
+const trimStart = (source, characters) => {
+    let s = source;
+    while (s.startsWith(characters)) {
+        s = s.slice(characters.length);
+    }
+    return s;
+};
+exports.trimStart = trimStart;
+//# sourceMappingURL=trimStart.js.map

package/dist/trimStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trimStart.js","sourceRoot":"","sources":["../src/trimStart.ts"],"names":[],"mappings":";;;AAWA,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,UAAkB,EAAE,EAAE;IACrD,IAAI,CAAC,GAAG,MAAM,CAAC;IACf,OAAO,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAC7B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;KAClC;IACD,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AAGE,8BAAS"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,6 @@
+declare class DataWrapper<T> {
+    data: T;
+    constructor(data: T);
+}
+export { DataWrapper, };
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,cAAM,WAAW,CAAC,CAAC;IACR,IAAI,EAAE,CAAC,CAAC;gBAEI,IAAI,EAAE,CAAC;CAG7B;AAED,OAAO,EACH,WAAW,GACd,CAAC"}