birdie-ts/README.md

Transportation problem solver with multiple optimization methods

# birdie-ts

Transportation problem solver with multiple optimization methods, written in TypeScript.

## Installation

### NPM
```bash
npm install birdie-ts
```

### CDN
```html
<!-- unpkg -->
<script src="https://unpkg.com/birdie-ts/dist/birdie.min.js"></script>

<!-- or jsdelivr -->
<script src="https://cdn.jsdelivr.net/npm/birdie-ts/dist/birdie.min.js"></script>
```

## Usage

### ES Modules / TypeScript
```typescript
import { solve, createProblem } from 'birdie-ts';

const problem = createProblem(
    [30, 40],     // supplies
    [20, 30, 20], // demands
    [             // costs matrix
        [2, 3, 4],
        [3, 2, 1]
    ]
);

const solution = solve(problem);
console.log(solution);
```

### Browser
```html
<script src="https://unpkg.com/birdie-ts/dist/birdie.min.js"></script>
<script>
    const problem = birdie.createProblem(
        [30, 40],     // supplies
        [20, 30, 20], // demands
        [             // costs matrix
            [2, 3, 4],
            [3, 2, 1]
        ]
    );
    
    const solution = birdie.solve(problem);
    console.log(solution);
</script>
```

## Features

- Solves transportation problems
- Multiple optimization methods
- Written in TypeScript with full type support
- Zero dependencies
- Works in Node.js and browsers

## License

MIT © [Dolhopolov Vladyslav](https://dolhocodev.netlify.app)