|
1 |
| -# Utilities (`@studiohyperdrive/utils`) |
| 1 | +# Javascript Tools: Utils (`@studiohyperdrive/utils`) |
| 2 | + |
| 3 | +`@studiohyperdrive/utils` is a set of common Javascript based utils. |
| 4 | + |
| 5 | +## Installation |
2 | 6 |
|
3 | 7 | Install the package first:
|
| 8 | + |
4 | 9 | ```shell
|
5 | 10 | npm install @studiohyperdrive/utils
|
6 | 11 | ```
|
7 | 12 |
|
8 |
| -## 1. Object |
9 |
| - |
10 |
| -A set of Object based helpers. |
11 |
| - |
12 |
| -### getKeyByValue |
13 |
| -The getKeyByValue helper function will search for a key within an object, based on the provided value. |
14 |
| - |
15 |
| -[Full documentation.](./docs/object/get-key-by-value/get-key-by-value.util.md) |
16 |
| - |
17 |
| -### merge |
18 |
| -Merges all arguments into a single object, as long as the property has a value. |
19 |
| - |
20 |
| -[Full documentation.](./docs/object/merge/merge.util.md) |
21 |
| - |
22 |
| -## 2. String |
23 |
| - |
24 |
| -A set of String based helpers. |
25 |
| - |
26 |
| -### camelCaseToSentence |
27 |
| -Converts a camelCase string to a human-readable sentence. |
28 |
| - |
29 |
| -[Full documentation.](./docs/string/camel-case-to-sentence/camel-case-to-sentence.util.md) |
30 |
| - |
31 |
| -### replaceHtmlWhitespace |
32 |
| -Returns the filtered html as a string that has replaced the non-breakable whitespaces with regular spaces. |
33 |
| - |
34 |
| -[Full documentation.](./docs/string/replace-whitespace/replace-whitespace.util.md) |
35 |
| - |
36 |
| -### stringComparator |
37 |
| -Compares two strings alphabetically using localeCompare. |
38 |
| - |
39 |
| -[Full documentation.](./docs/string/string-comparator/string-comparator.util.md) |
| 13 | +## Versioning and build information |
40 | 14 |
|
41 |
| -## build information |
42 |
| -This project has been build with: |
43 |
| -- nodejs: `18.17.0` |
44 |
| -- npm: `9.6.7` |
| 15 | +This package will follow a semver-like format, `major.minor.patch`, in which: |
45 | 16 |
|
46 |
| -For a complete list of packages and version check out the `package.json` file. |
| 17 | +- `major`: Introduces new features or breaking changes |
| 18 | +- `minor`: Introduces minor non-breaking changes |
| 19 | +- `patch`: Introduces bugfixes |
47 | 20 |
|
48 |
| -## Team |
| 21 | +For more information about the build process, authors, contributions and issues, we refer to the [hyperdrive-opensource](https://github.com/studiohyperdrive/hyperdrive-opensource) repository. |
49 | 22 |
|
50 |
| -This bundle of tools has been created and is maintained by [Studio Hyperdrive](https://studiohyperdrive.be). |
| 23 | +## Documentation |
51 | 24 |
|
52 |
| -Contributors: |
53 |
| -- [Denis Valcke](https://github.com/DenisValcke) |
54 |
| -- [Iben Van de Veire](https://github.com/IbenTesara) |
55 |
| -- [Wouter Heirstrate](https://github.com/WHeirstrate) |
| 25 | +To find more information regarding this package, we refer to [our documentation platform](https://open-source.studiohyperdrive.be/docs/javascript/utils/introduction). |
0 commit comments