# Image Speech Bubble Transformer

A TypeScript library for applying speech bubble effects to images with various transformation options.

## Installation

```bash
npm install image-speech-bubble-transformer
```

## Usage

```typescript
import {
  createSpeechBubbleTransformer,
  Orientation,
} from "image-speech-bubble-transformer";
import fs from "fs/promises";

async function example() {
  // Create transformer instance
  const transformer = createSpeechBubbleTransformer();

  // Read image buffer
  const inputBuffer = await fs.readFile("input.png");

  // Process image with options
  const processedBuffer = await transformer.processSpeechBubble(inputBuffer, {
    mirror: true,
    orientation: Orientation.LEFT,
  });

  // Save processed image
  await transformer.processAndSave(inputBuffer, "output.png", {
    mirror: true,
    orientation: Orientation.LEFT,
  });
}
```

## API

### `createSpeechBubbleTransformer(assetsDir?: string)`

- Creates a transformer instance
- `assetsDir`: Optional path to custom assets directory

### `processSpeechBubble(inputBuffer, options)`

- Applies speech bubble effect to image
- Options:
  - `mirror`: Flip horizontally
  - `orientation`: Rotate speech bubble
  - `speechBubblePath`: Custom speech bubble image

### `processAndSave(inputBuffer, outputPath, options)`

- Processes and saves image in one step

## Supported Formats

- .png, .jpg, .jpeg, .gif, .bmp, .webp, .tiff

## Development

### Setup

1. Clone the repository
2. Install dependencies:

```bash
npm install
```

### Scripts

- `npm run build`: Compile TypeScript
- `npm run lint`: Run ESLint
- `npm test`: Run Jest tests
- `npm run test:coverage`: Run tests with coverage report

### Publishing to NPM

1. Ensure you're logged into NPM:

```bash
npm login
```

2. Update version (use appropriate semver):

```bash
npm version patch  # or minor/major
```

3. Publish:

```bash
npm publish
```

### Continuous Integration

- Ensure `.github/workflows/ci.yml` is set up for automated testing
- Configure NPM token in repository secrets