neu-js-functions

Reusable JavaScript utility functions for Angular and similar applications.
This package provides a collection of helper functions designed to streamline application development by promoting consistency, reducing duplication, and ensuring best practices.

📦 Installation

npm install neu-js-functions

```import syntax
import * as appFunctions from 'neu-js-functions';

```example usage syntax
appFunctions.text.check.valueIsNull('') - This will return null, as the text check is empty.

## 📖 Introduction

This library contains reusable utility functions commonly used across JavaScript and Angular projects.
They are designed to:

- Simplify repetitive tasks
- Improve consistency in codebases
- Ensure maintainability and testability

## 🧩 Function Categories

1. Utility Functions
- Description: General-purpose helpers for common tasks (e.g., formatting, array handling).
- Usage: Use these to avoid duplication and maintain consistency.

2. Data Transformation Functions
- Description: Functions for manipulating and transforming data structures.
- Usage: Ensure data integrity and format consistency across your app.

3. Asynchronous Functions
- Description: Helpers for handling async operations (e.g., fetching data, timers).
- Usage: Use with async/await for smooth, responsive UI flows.

4. Validation Functions
- Description: Validate user inputs, form data, or other data structures.
- Usage: Create robust, reusable validators to maintain accuracy and integrity.

5. Event Handling Functions
- Description: Functions designed to manage user interactions and events.
- Usage: Handle user actions cleanly and keep UI logic consistent.

## ✅ Best Practices

- Reusability: Write generic functions to maximize cross-app reusability.
- Naming Conventions: Use descriptive names for readability and easier debugging.
- Testing: Always create unit tests to ensure function reliability and prevent regressions.

## 🔧 Troubleshooting

- Common issues you may encounter:
- Scope problems: Ensure the function is imported/exported correctly.
- Type errors: Verify TypeScript typings and interfaces.
- Debugging tips: Use console logs or debuggers to trace function execution flow.

## 📌 Versioning

- This package follows semantic versioning (SemVer).
- Breaking changes will be documented in release notes.
- Keep functions updated when upgrading Angular or TypeScript versions to maintain compatibility.

## 💬 Contact & Support

- Issues / Bugs: Open a GitHub Issue
- Contributions: Fork the repo and submit pull requests
- Community: Join the discussions in the repository

## 📜 License

This project is licensed under the **MIT License** – see the [LICENSE](./LICENSE) file for details.