Package Exports

@prishelets/utils
@prishelets/utils/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@prishelets/utils) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@prishelets/utils

📦 Description

@prishelets/utils is a modern, type-safe utility library for working with strings, numbers, and general data types. It’s fully typed, tested, and optimized for Node.js and TypeScript projects.

✨ Features

🧠 Fully typed with TypeScript
🧪 Tested with Jest
⚡ Lightweight and modular
📚 Useful for everyday string and number manipulation
🔧 Tree-shakable and ESM/CommonJS compatible

📥 Installation

npm install @prishelets/utils
# or
pnpm add @prishelets/utils
# or
yarn add @prishelets/utils

🚀 Usage

import { clamp, isEven, roundTo, randomInRange } from "@prishelets/utils";

clamp(5, 0, 10); // 5
isEven(4); // true
roundTo(3.14159, 2); // 3.14
randomInRange(1, 5); // e.g., 3

🔢 Number Utilities

`clamp(value, min, max)`

Clamp a number between a min and max range.

clamp(5, 0, 10); // 5
clamp(-1, 0, 10); // 0
clamp(15, 0, 10); // 10

`isEven(value)`

Check if a number is even.

isEven(4); // true
isEven(3); // false

`roundTo(value, decimals)`

Round a number to a specific number of decimal places.

roundTo(3.14159, 2); // 3.14
roundTo(1.005, 2); // 1.01

`randomInRange(min, max)`

Generate a random integer between min and max (inclusive).

randomInRange(1, 3); // e.g., 2

🛠 Roadmap

String utilities
Array helpers
Object type guards
Functional programming tools
Performance benchmarks
TypeScript documentation generator

📂 Project Structure

├── src/
│   └── numbers/
│       ├── clamp.ts
│       ├── isEven.ts
│       ├── randomInRange.ts
│       └── roundTo.ts
├── dist/ (compiled output)
├── .github/workflows/ (CI)
└── package.json

🧪 Testing

npm run test

This runs all tests via Jest. Test files are colocated with source files or kept in a __tests__ directory.

🧾 License

💬 Feedback & Contributions

Feel free to open issues or pull requests. Ideas, bug reports, and feature requests are welcome!

🔗 GitHub: github.com/Curslo/prishelets