collatz-utils/README.md

Utility functions for Collatz conjecture operations

# collatz-utils

Utility functions for Collatz conjecture operations.

## Installation

```bash
npm install collatz-utils
```

## Usage

```js
const { collatzSteps, isCollatzCandidate, applyCollatzNTimes } = require('collatz-utils');

console.log(collatzSteps(12));           // Number of steps to reach 1
console.log(isCollatzCandidate(12));     // true if n != 1
console.log(applyCollatzNTimes(12, 3));  // Apply Collatz rule 3 times
```

## Functions

collatzSteps(n): Returns number of steps for n to reach 1.

isCollatzCandidate(n): Returns true if n is not 1.

applyCollatzNTimes(n, count): Applies Collatz function count times to n.