pixelsrc 0.2.0

# @pixelsrc/wasm

WebAssembly build of [pixelsrc](https://github.com/pixelsrc/pixelsrc) - a GenAI-native pixel art format and renderer.

## Installation

```bash
npm install @pixelsrc/wasm
```

## Usage (Browser)

```javascript
import init, { render_to_png, render_to_rgba, list_sprites } from '@pixelsrc/wasm';

// Initialize WASM module (required before first use)
await init();

// Define a sprite in pixelsrc JSONL format
const jsonl = `{"type":"sprite","name":"heart","palette":{"{_}":"#00000000","{r}":"#FF0000"},"grid":["{_}{r}{r}{_}{r}{r}{_}","{r}{r}{r}{r}{r}{r}{r}","{_}{r}{r}{r}{r}{r}{_}","{_}{_}{r}{r}{r}{_}{_}","{_}{_}{_}{r}{_}{_}{_}"]}`;

// Render to PNG bytes
const pngBytes = render_to_png(jsonl);

// Display in an <img> element
const blob = new Blob([pngBytes], { type: 'image/png' });
const url = URL.createObjectURL(blob);
document.getElementById('preview').src = url;

// Or render to RGBA for canvas
const result = render_to_rgba(jsonl);
const imageData = new ImageData(
  new Uint8ClampedArray(result.pixels),
  result.width,
  result.height
);
ctx.putImageData(imageData, 0, 0);

// List available sprites
const sprites = list_sprites(jsonl);
console.log('Sprites:', sprites);
```

## Usage (Node.js)

```javascript
import { readFileSync, writeFileSync } from 'fs';
import init, { render_to_png } from '@pixelsrc/wasm';

await init();

const jsonl = readFileSync('sprite.jsonl', 'utf8');
const pngBytes = render_to_png(jsonl);
writeFileSync('sprite.png', pngBytes);
```

## API

### `init(): Promise<void>`
Initialize the WASM module. Must be called before any other function.

### `render_to_png(jsonl: string, spriteName?: string): Uint8Array`
Render JSONL input to PNG bytes. Optionally specify which sprite to render.

### `render_to_rgba(jsonl: string, spriteName?: string): RenderResult`
Render to raw RGBA pixels. Returns an object with:
- `width: number` - Image width in pixels
- `height: number` - Image height in pixels
- `pixels: Uint8Array` - Raw RGBA pixel data
- `warnings: string[]` - Any rendering warnings

### `list_sprites(jsonl: string): string[]`
Get list of sprite and composition names in the input.

### `validate(jsonl: string): string[]`
Validate JSONL without rendering. Returns array of error/warning messages.

## pixelsrc Format

pixelsrc uses JSONL (JSON Lines) format. Each line is a self-contained JSON object:

```jsonl
{"type":"palette","name":"mono","colors":{"{_}":"#00000000","{on}":"#FFFFFF","{off}":"#000000"}}
{"type":"sprite","name":"checker","palette":"mono","grid":["{on}{off}{on}{off}","{off}{on}{off}{on}"]}
```

See the [full documentation](https://github.com/pixelsrc/pixelsrc) for more details.

## License

MIT