@idot-digital/generic-helpers

This package/repo provides a collection of useful helper functions for various tasks.

Installation

You can install this package via npm or yarn.

``bash
npm install @idot-digital/generic-helpers
`

or

`bash
yarn add @idot-digital/generic-helpers
`

Features

$3

- wait(ms: number): Promise: A helper function that returns a promise that resolves after a given amount of time in milliseconds.

$3

- Arrays.filterNull(array: (T | null | undefined)[]): T[]: A static method that filters out null and undefined values from an array.

$3

The Colors class provides several color-related helper methods, including:

- hexToRgba(hex: HEX): RGBA | null: Converts a hex color to rgba values.
- rgbaToHex(color: RGB | RGBA): HEX: Converts rgb values to hex color format.
- getContrastColor(color: Color, settings?: {...}): string: Calculates a contrast text color for a given background color.
- And many more!

$3

The Dates class provides date-related helper methods, such as:

- getRelativeTimeString(date: Date, date2: Date = new Date(), short: boolean = false, roundToDate = false): string: Represents the difference between two dates as a string.
- onSameDay(date1: Date, date2?: Date): boolean: Checks if two dates are on the same day.
- And more!

$3

The Iterators class provides helper methods for working with iterators, such as:

- toArray(iterator: AsyncGenerator | Generator | IterableIterator | AsyncIterableIterator, limit?: number): Promise: Converts an iterator to an array.
- fromArray(array: (T | Promise)[]): AsyncGenerator: Converts an array with promise items to an async iterator.
- And more!

$3

The Objects class provides object-related helper methods:

- deepEqual(a: T, b: T): boolean: Deeply compares two objects and returns true if they are equal.
- deepClone(obj: T): T: Deeply clones an object and returns the cloned object.

$3

The Text class provides text-related helper methods:

- bigNumbers(num: number): string: Formats big numbers to a more readable format.
- grades(percentage: number): string`: Converts a percent value to a corresponding letter grade.

Conclusion

This package offers various functionalities, including array manipulation, color conversion, date handling, iterator operations, object comparison/cloning, and text formatting.

Contributing

If you are an employee of idot digital or one of its subsidiaries, you can create issues or pull/merge requests. They will regularly be reviewed and merged. The code standards are your default company standards.

If you are someone who just found the package on npm and you have feedback or additional functions you want to see in the package, please send us an email to contact@idot-digital.de with "[generic-helpers]" in the subject.

License

The package is licensed under the ISC License or MIT License.