@ezez/utils 1.1.0 → 1.4.0

package/.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Build docs and push to ezez.dev
+
+on:
+  push:
+    branches: [ master ]
+
+
+env:
+  PROJECT_NAME: utils
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          persist-credentials: false
+
+      - name: Build documentation
+        run: |
+          VER=$(cat ./package.json | jq -r .version)
+          echo Detected version: $VER
+          if [[ "$VER" == *"+"* ]]; then echo "WIP/+ version detected, skipping"; exit 1; fi
+          yarn
+          yarn docs
+          echo "APP_VERSION=$VER" >> "$GITHUB_ENV"
+          cat $GITHUB_ENV
+
+      - name: Deploy versioned documentation
+        uses: easingthemes/ssh-deploy@main
+        env:
+          SSH_PRIVATE_KEY: ${{ secrets.DOCS_SERVER_PRIVATE_KEY }}
+          REMOTE_HOST: ${{ secrets.DOCS_SERVER_HOST }}
+          REMOTE_USER: ${{ secrets.DOCS_SERVER_USER }}
+          REMOTE_PORT: ${{ secrets.DOCS_SERVER_PORT }}
+          SOURCE: "docs/"
+          TARGET: "/docs/${{ env.PROJECT_NAME }}/${{ env.APP_VERSION }}"
+
+      - name: Deploy latest documentation
+        uses: easingthemes/ssh-deploy@main
+        env:
+          SSH_PRIVATE_KEY: ${{ secrets.DOCS_SERVER_PRIVATE_KEY }}
+          REMOTE_HOST: ${{ secrets.DOCS_SERVER_HOST }}
+          REMOTE_USER: ${{ secrets.DOCS_SERVER_USER }}
+          REMOTE_PORT: ${{ secrets.DOCS_SERVER_PORT }}
+          ARGS: "-rlgoDzvc -i --delete"
+          SOURCE: "docs/"
+          TARGET: "/docs/${{ env.PROJECT_NAME }}/latest"
+

package/CHANGELOG.md

@@ -3,6 +3,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2023-05-11
+### Added
+- `escapeRegExp` method
+- `replace` method
+- `sortProps` method
+
+## [1.3.0] - 2023-05-07
+### Added
+- `safe` method
+### Dev
+- upgraded some jsdocs
+- upgraded deps
+
+## [1.2.0] - 2023-03-01
+### Added
+- `ensureDate` method
+- `ensurePrefix` method
+- `ensureSuffix` method
+- `ensureTimestamp` method
+- `stripPrefix` method
+- `stripSuffix` method
+
 ## [1.1.0] - 2023-02-20
 ### Added
 - `isNumericString` method

package/README.md

@@ -29,40 +29,65 @@ object, with just some properties copied. Easy, right? Few lines of code? Lodash
 
 ## Supported methods
 
-- `cap` - cap a value between lower and upper bound
+### String related
+- `addPrefix` - add prefix to a string if not already present
+- `addSuffix` - add suffix to a string if not already present
 - `capitalize` - capitalize a string, optionally lower casing the rest
-- `coalesce` - return first non-nullish value
+- `isNumericString` - check if given value is a numeric string, features configurable
+- `occurrences` - count occurrences of a substring in a string, optionally allow overlapping
+- `replace` - replace all occurrences of a substring using a map of replacements
+- `stripPrefix` - strip prefix from a string
+- `stripSuffix` - strip suffix from a string
+
+### Number related
+- `cap` - cap a value between lower and upper bound
+- `scale` - scale given value from old range to new range
+
+### Array related
 - `ensureArray` - ensure that given value is an array
-- `ensureError` - ensure that given value is an error
-- `get` - extract a value from a deep object using specified path, optionally with a default value
-- `getMultiple` - same as above, but test multiple paths
 - `insertSeparator` - insert a separator between every character in an array
-- `isEmpty` - check if given value is empty
-- `isPlainObject` - check if given value is a plain object
-- `isNumericString` - check if given value is a numeric string, features configurable
 - `last` - get last element of an array
-- `mapAsync` - map an array asynchronously if sync version blocks your event loop for too long
-- `mapValues` - map values of an object
 - `match` - split your array into two groups - one that matches given predicate, and one that doesn't
-- `merge` - merge two objects shallowly, allowing to remove properties while doing so
 - `mostFrequent` - find most frequent value in an array
-- `noop` - do nothing
-- `occurrences` - count occurrences of a substring in a string, optionally allow overlapping
-- `omit` - omit properties from an object
-- `pick` - pick some properties from an object
 - `pull` - remove values from an array (by mutating)
 - `remove` - remove values from an array (by mutating) using predicate function and return removed values
+- `sortBy` - sort an array by given property (create callback function for `Array.prototype.sort`)
+
+### Object related
+- `isPlainObject` - check if given value is a plain object
+- `mapValues` - map values of an object
+- `merge` - merge two objects shallowly, allowing to remove properties while doing so
+- `omit` - omit properties from an object
+- `pick` - pick some properties from an object
+- `sortProps` - sort object properties by key
+
+### Date related
+- `ensureDate` - ensure that given value is a Date instance
+- `ensureTimestamp` - ensure that given value is a numeric timestamp
+
+### Type/data safety
+- `coalesce` - return first non-nullish value
+- `ensureError` - ensure that given value is an error
+- `escapeRegExp` - escape a string to be used in a regular expression
+- `safe` - runs function and returns its result or default value if function throws an error
+
+### Flow related
+- `mapAsync` - map an array asynchronously if sync version blocks your event loop for too long
+- `noop` - do nothing
 - `rethrow` - throw given value
-- `scale` - scale given value from old range to new range
 - `seq` - sequentially execute Promise-returning functions until one returns a value
+- `wait` - wait given amount of time (async)
+- `waitSync` - wait given amount of time (sync)
+- `waitFor` - wait for a condition to be true, checking every given amount of time
+
+### Various
+- `get` - extract a value from a deep object using specified path, optionally with a default value
+- `getMultiple` - same as above, but test multiple paths
 - `set` - set a value in a deep object using specified path
 - `setImmutable` - set a value in a deep object using specified path, but return a new object
-- `sortBy` - sort an array by given property (create callback function for `Array.prototype.sort`)
+- `isEmpty` - check if given value is empty
 - `throttle` - throttle a function, very configurable
 - `truthy` - is value truthy? (useful for filtering with more correct TypeScript support than `filter(Boolean)`)
-- `wait` - wait given amount of time (async)
-- `waitSync` - wait given amount of time (sync)
-- `waitFor` - wait for a condition to be true, checking every given amount of time
 
 Methods will be added as I need them. I am open for suggestions and PRs. See next heading for list of methods that I
 want to add.

package/dist/ensureDate.d.ts

@@ -0,0 +1,3 @@
+declare const ensureDate: (date: Date | number) => Date;
+export { ensureDate, };
+//# sourceMappingURL=ensureDate.d.ts.map

package/dist/ensureDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureDate.d.ts","sourceRoot":"","sources":["../src/ensureDate.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,UAAU,SAAU,IAAI,GAAG,MAAM,KAAG,IAKzC,CAAC;AAEF,OAAO,EACH,UAAU,GACb,CAAC"}

package/dist/ensureDate.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDate = void 0;
+const ensureDate = (date) => {
+    if (typeof date === "number") {
+        return new Date(date);
+    }
+    return date;
+};
+exports.ensureDate = ensureDate;
+//# sourceMappingURL=ensureDate.js.map

package/dist/ensureDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureDate.js","sourceRoot":"","sources":["../src/ensureDate.ts"],"names":[],"mappings":";;;AAQA,MAAM,UAAU,GAAG,CAAC,IAAmB,EAAQ,EAAE;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC1B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;KACzB;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAGE,gCAAU"}

package/dist/ensureError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensureError.d.ts","sourceRoot":"","sources":["../src/ensureError.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,WAAW,MAAO,OAAO,UAK9B,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}
+{"version":3,"file":"ensureError.d.ts","sourceRoot":"","sources":["../src/ensureError.ts"],"names":[],"mappings":"AAYA,QAAA,MAAM,WAAW,MAAO,OAAO,UAK9B,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/dist/ensureError.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensureError.js","sourceRoot":"","sources":["../src/ensureError.ts"],"names":[],"mappings":";;;AAKA,MAAM,WAAW,GAAG,CAAC,CAAU,EAAE,EAAE;IAC/B,IAAI,CAAC,YAAY,KAAK,EAAE;QACpB,OAAO,CAAC,CAAC;KACZ;IACD,OAAO,IAAI,KAAK,CAAC,+CAA+C,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAGE,kCAAW"}
+{"version":3,"file":"ensureError.js","sourceRoot":"","sources":["../src/ensureError.ts"],"names":[],"mappings":";;;AAYA,MAAM,WAAW,GAAG,CAAC,CAAU,EAAE,EAAE;IAC/B,IAAI,CAAC,YAAY,KAAK,EAAE;QACpB,OAAO,CAAC,CAAC;KACZ;IACD,OAAO,IAAI,KAAK,CAAC,+CAA+C,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAGE,kCAAW"}

package/dist/ensurePrefix.d.ts

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

package/dist/ensurePrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensurePrefix.d.ts","sourceRoot":"","sources":["../src/ensurePrefix.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,YAAY,WAAY,MAAM,UAAU,MAAM,WAKnD,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/dist/ensurePrefix.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensurePrefix = void 0;
+const ensurePrefix = (string, prefix) => {
+    if (string.startsWith(prefix)) {
+        return string;
+    }
+    return prefix + string;
+};
+exports.ensurePrefix = ensurePrefix;
+//# sourceMappingURL=ensurePrefix.js.map

package/dist/ensurePrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensurePrefix.js","sourceRoot":"","sources":["../src/ensurePrefix.ts"],"names":[],"mappings":";;;AAQA,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE;IACpD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QAC3B,OAAO,MAAM,CAAC;KACjB;IACD,OAAO,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC,CAAC;AAGE,oCAAY"}

package/dist/ensureSuffix.d.ts

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

package/dist/ensureSuffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureSuffix.d.ts","sourceRoot":"","sources":["../src/ensureSuffix.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,YAAY,WAAY,MAAM,UAAU,MAAM,WAKnD,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/dist/ensureSuffix.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureSuffix = void 0;
+const ensureSuffix = (string, suffix) => {
+    if (string.endsWith(suffix)) {
+        return string;
+    }
+    return string + suffix;
+};
+exports.ensureSuffix = ensureSuffix;
+//# sourceMappingURL=ensureSuffix.js.map

package/dist/ensureSuffix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureSuffix.js","sourceRoot":"","sources":["../src/ensureSuffix.ts"],"names":[],"mappings":";;;AAQA,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE;IACpD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACzB,OAAO,MAAM,CAAC;KACjB;IACD,OAAO,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC,CAAC;AAGE,oCAAY"}

package/dist/ensureTimestamp.d.ts

@@ -0,0 +1,3 @@
+declare const ensureTimestamp: (date: Date | number) => number;
+export { ensureTimestamp, };
+//# sourceMappingURL=ensureTimestamp.d.ts.map

package/dist/ensureTimestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureTimestamp.d.ts","sourceRoot":"","sources":["../src/ensureTimestamp.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,eAAe,SAAU,IAAI,GAAG,MAAM,KAAG,MAK9C,CAAC;AAEF,OAAO,EACH,eAAe,GAClB,CAAC"}

package/dist/ensureTimestamp.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureTimestamp = void 0;
+const ensureTimestamp = (date) => {
+    if (typeof date === "number") {
+        return date;
+    }
+    return date.getTime();
+};
+exports.ensureTimestamp = ensureTimestamp;
+//# sourceMappingURL=ensureTimestamp.js.map

package/dist/ensureTimestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureTimestamp.js","sourceRoot":"","sources":["../src/ensureTimestamp.ts"],"names":[],"mappings":";;;AAQA,MAAM,eAAe,GAAG,CAAC,IAAmB,EAAU,EAAE;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC1B,OAAO,IAAI,CAAC;KACf;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC,CAAC;AAGE,0CAAe"}

package/dist/escapeRegExp.d.ts

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

package/dist/escapeRegExp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegExp.d.ts","sourceRoot":"","sources":["../src/escapeRegExp.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,YAAY,WAAY,MAAM,WAEnC,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/dist/escapeRegExp.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeRegExp = void 0;
+const escapeRegExp = (string) => {
+    return string.replace(/[/\-\\^$*+?.()|[\]{}]/g, "\\$&");
+};
+exports.escapeRegExp = escapeRegExp;
+//# sourceMappingURL=escapeRegExp.js.map

package/dist/escapeRegExp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegExp.js","sourceRoot":"","sources":["../src/escapeRegExp.ts"],"names":[],"mappings":";;;AAUA,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,EAAE;IACpC,OAAO,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC,CAAC;AAGE,oCAAY"}

package/dist/index.d.ts

@@ -1,8 +1,13 @@
+export * from "./ensurePrefix.js";
+export * from "./ensureSuffix.js";
 export * from "./cap.js";
 export * from "./capitalize.js";
 export * from "./coalesce.js";
 export * from "./ensureArray.js";
+export * from "./ensureDate.js";
 export * from "./ensureError.js";
+export * from "./ensureTimestamp.js";
+export * from "./escapeRegExp.js";
 export * from "./get.js";
 export * from "./getMultiple.js";
 export * from "./insertSeparator.js";
@@ -21,12 +26,17 @@ export * from "./omit.js";
 export * from "./pick.js";
 export * from "./pull.js";
 export * from "./remove.js";
+export * from "./replace.js";
 export * from "./rethrow.js";
+export * from "./safe.js";
 export * from "./scale.js";
 export * from "./seq.js";
 export * from "./set.js";
 export * from "./setImmutable.js";
 export * from "./sortBy.js";
+export * from "./sortProps.js";
+export * from "./stripPrefix.js";
+export * from "./stripSuffix.js";
 export * from "./throttle.js";
 export * from "./truthy.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,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,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,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,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,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,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,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,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,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,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,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -14,11 +14,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ensurePrefix.js"), exports);
+__exportStar(require("./ensureSuffix.js"), exports);
 __exportStar(require("./cap.js"), exports);
 __exportStar(require("./capitalize.js"), exports);
 __exportStar(require("./coalesce.js"), exports);
 __exportStar(require("./ensureArray.js"), exports);
+__exportStar(require("./ensureDate.js"), exports);
 __exportStar(require("./ensureError.js"), exports);
+__exportStar(require("./ensureTimestamp.js"), exports);
+__exportStar(require("./escapeRegExp.js"), exports);
 __exportStar(require("./get.js"), exports);
 __exportStar(require("./getMultiple.js"), exports);
 __exportStar(require("./insertSeparator.js"), exports);
@@ -37,12 +42,17 @@ __exportStar(require("./omit.js"), exports);
 __exportStar(require("./pick.js"), exports);
 __exportStar(require("./pull.js"), exports);
 __exportStar(require("./remove.js"), exports);
+__exportStar(require("./replace.js"), exports);
 __exportStar(require("./rethrow.js"), exports);
+__exportStar(require("./safe.js"), exports);
 __exportStar(require("./scale.js"), exports);
 __exportStar(require("./seq.js"), exports);
 __exportStar(require("./set.js"), exports);
 __exportStar(require("./setImmutable.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("./truthy.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,2CAAyB;AACzB,kDAAgC;AAChC,gDAA8B;AAC9B,mDAAiC;AACjC,mDAAiC;AACjC,2CAAyB;AACzB,mDAAiC;AACjC,uDAAqC;AACrC,+CAA6B;AAC7B,uDAAqC;AACrC,qDAAmC;AACnC,4CAA0B;AAC1B,gDAA8B;AAC9B,iDAA+B;AAC/B,6CAA2B;AAC3B,6CAA2B;AAC3B,oDAAkC;AAClC,4CAA0B;AAC1B,mDAAiC;AACjC,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B;AAC3B,2CAAyB;AACzB,2CAAyB;AACzB,oDAAkC;AAClC,8CAA4B;AAC5B,gDAA8B;AAC9B,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,mDAAiC;AACjC,kDAAgC;AAChC,mDAAiC;AACjC,uDAAqC;AACrC,oDAAkC;AAClC,2CAAyB;AACzB,mDAAiC;AACjC,uDAAqC;AACrC,+CAA6B;AAC7B,uDAAqC;AACrC,qDAAmC;AACnC,4CAA0B;AAC1B,gDAA8B;AAC9B,iDAA+B;AAC/B,6CAA2B;AAC3B,6CAA2B;AAC3B,oDAAkC;AAClC,4CAA0B;AAC1B,mDAAiC;AACjC,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,+CAA6B;AAC7B,4CAA0B;AAC1B,6CAA2B;AAC3B,2CAAyB;AACzB,2CAAyB;AACzB,oDAAkC;AAClC,8CAA4B;AAC5B,iDAA+B;AAC/B,mDAAiC;AACjC,mDAAiC;AACjC,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,gDAA8B"}

package/dist/isPlainObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isPlainObject.d.ts","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,aAAa,UAAW,OAAO,YAQpC,CAAC;AAEF,OAAO,EACH,aAAa,GAChB,CAAC"}
+{"version":3,"file":"isPlainObject.d.ts","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,aAAa,UAAW,OAAO,YAQpC,CAAC;AAEF,OAAO,EACH,aAAa,GAChB,CAAC"}

package/dist/isPlainObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"isPlainObject.js","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":";;;AAIA,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAC7C,KAAK;OACF,OAAO,KAAK,KAAK,QAAQ;OACzB,CACC,KAAK,CAAC,WAAW,KAAK,MAAM;WACzB,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC;WACzB,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/D,CACJ,CAAC;AAGE,sCAAa"}
+{"version":3,"file":"isPlainObject.js","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":";;;AASA,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAC7C,KAAK;OACF,OAAO,KAAK,KAAK,QAAQ;OACzB,CACC,KAAK,CAAC,WAAW,KAAK,MAAM;WACzB,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC;WACzB,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/D,CACJ,CAAC;AAGE,sCAAa"}

package/dist/replace.d.ts

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

package/dist/replace.d.ts.map

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

package/dist/replace.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replace = void 0;
+const escapeRegExp_js_1 = require("./escapeRegExp.js");
+const replace = (source, replaceMap) => {
+    const regex = new RegExp(Object.keys(replaceMap).map(escapeRegExp_js_1.escapeRegExp).join("|"), "g");
+    return source.replace(regex, (matched) => replaceMap[matched]);
+};
+exports.replace = replace;
+//# sourceMappingURL=replace.js.map

package/dist/replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":";;;AACA,uDAAiD;AASjD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,UAAkC,EAAE,EAAE;IAEnE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,8BAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAGE,0BAAO"}

package/dist/safe.d.ts

@@ -0,0 +1,4 @@
+declare function safe<T>(fn: () => T): T | undefined;
+declare function safe<T, Y>(fn: () => T, def: Y): T | Y;
+export { safe };
+//# sourceMappingURL=safe.d.ts.map

package/dist/safe.d.ts.map

@@ -0,0 +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;AAsBhD,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/safe.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safe = void 0;
+function safe(fn, def) {
+    try {
+        return fn();
+    }
+    catch (_a) {
+        return def;
+    }
+}
+exports.safe = safe;
+//# sourceMappingURL=safe.js.map

package/dist/safe.js.map

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

package/dist/sortProps.d.ts

@@ -0,0 +1,3 @@
+declare const sortProps: <T extends Record<string, unknown>>(object: T, asc?: boolean) => T;
+export { sortProps, };
+//# sourceMappingURL=sortProps.d.ts.map

package/dist/sortProps.d.ts.map

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

package/dist/sortProps.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortProps = void 0;
+const sortProps = (object, asc = true) => {
+    const sorted = {};
+    const keys = Object.keys(object);
+    if (asc) {
+        keys.sort();
+    }
+    else {
+        keys.sort().reverse();
+    }
+    for (const key of keys) {
+        sorted[key] = object[key];
+    }
+    return sorted;
+};
+exports.sortProps = sortProps;
+//# sourceMappingURL=sortProps.js.map

package/dist/sortProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortProps.js","sourceRoot":"","sources":["../src/sortProps.ts"],"names":[],"mappings":";;;AAOA,MAAM,SAAS,GAAG,CAAoC,MAAS,EAAE,GAAG,GAAG,IAAI,EAAK,EAAE;IAC9E,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,GAAG,EAAE;QAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KAAE;SACpB;QAAE,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;KAAE;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;QACpB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;KAC7B;IACD,OAAO,MAAW,CAAC;AACvB,CAAC,CAAC;AAGE,8BAAS"}

package/dist/stripPrefix.d.ts

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

package/dist/stripPrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripPrefix.d.ts","sourceRoot":"","sources":["../src/stripPrefix.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,WAAW,SAAU,MAAM,UAAU,MAAM,KAAG,MAKnD,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/dist/stripPrefix.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripPrefix = void 0;
+const stripPrefix = (from, prefix) => {
+    if (from.startsWith(prefix)) {
+        return from.slice(prefix.length);
+    }
+    return from;
+};
+exports.stripPrefix = stripPrefix;
+//# sourceMappingURL=stripPrefix.js.map

package/dist/stripPrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripPrefix.js","sourceRoot":"","sources":["../src/stripPrefix.ts"],"names":[],"mappings":";;;AAKA,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IACzD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KACpC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAGE,kCAAW"}

package/dist/stripSuffix.d.ts

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

package/dist/stripSuffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripSuffix.d.ts","sourceRoot":"","sources":["../src/stripSuffix.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,WAAW,SAAU,MAAM,UAAU,MAAM,KAAG,MAKnD,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/dist/stripSuffix.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripSuffix = void 0;
+const stripSuffix = (from, suffix) => {
+    if (from.endsWith(suffix)) {
+        return from.slice(0, -suffix.length);
+    }
+    return from;
+};
+exports.stripSuffix = stripSuffix;
+//# sourceMappingURL=stripSuffix.js.map

package/dist/stripSuffix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripSuffix.js","sourceRoot":"","sources":["../src/stripSuffix.ts"],"names":[],"mappings":";;;AAMA,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KACxC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAGE,kCAAW"}

package/docs/assets/highlight.css

@@ -15,6 +15,10 @@
     --dark-hl-6: #6A9955;
     --light-hl-7: #A31515;
     --dark-hl-7: #CE9178;
+    --light-hl-8: #0070C1;
+    --dark-hl-8: #4FC1FF;
+    --light-hl-9: #000000FF;
+    --dark-hl-9: #D4D4D4;
     --light-code-background: #FFFFFF;
     --dark-code-background: #1E1E1E;
 }
@@ -28,6 +32,8 @@
     --hl-5: var(--light-hl-5);
     --hl-6: var(--light-hl-6);
     --hl-7: var(--light-hl-7);
+    --hl-8: var(--light-hl-8);
+    --hl-9: var(--light-hl-9);
     --code-background: var(--light-code-background);
 } }
 
@@ -40,6 +46,8 @@
     --hl-5: var(--dark-hl-5);
     --hl-6: var(--dark-hl-6);
     --hl-7: var(--dark-hl-7);
+    --hl-8: var(--dark-hl-8);
+    --hl-9: var(--dark-hl-9);
     --code-background: var(--dark-code-background);
 } }
 
@@ -52,6 +60,8 @@
     --hl-5: var(--light-hl-5);
     --hl-6: var(--light-hl-6);
     --hl-7: var(--light-hl-7);
+    --hl-8: var(--light-hl-8);
+    --hl-9: var(--light-hl-9);
     --code-background: var(--light-code-background);
 }
 
@@ -64,6 +74,8 @@
     --hl-5: var(--dark-hl-5);
     --hl-6: var(--dark-hl-6);
     --hl-7: var(--dark-hl-7);
+    --hl-8: var(--dark-hl-8);
+    --hl-9: var(--dark-hl-9);
     --code-background: var(--dark-code-background);
 }
 
@@ -75,4 +87,6 @@
 .hl-5 { color: var(--hl-5); }
 .hl-6 { color: var(--hl-6); }
 .hl-7 { color: var(--hl-7); }
+.hl-8 { color: var(--hl-8); }
+.hl-9 { color: var(--hl-9); }
 pre, code { background: var(--code-background); }