garasu 0.1.0

Garasu (硝子) — GPU rendering engine: wgpu pipeline, text rendering, shader system, and winit integration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

# Garasu (硝子)

GPU rendering engine for pleme-io applications. Provides a reusable wgpu + winit + glyphon stack so every GPU-accelerated app shares the same rendering foundation.

## Components

| Module | Purpose |
|--------|---------|
| `context` | wgpu device, adapter, queue, surface lifecycle |
| `text` | glyphon text layout and rasterization |
| `shader` | WGSL post-processing pipeline (ghostty/tobira pattern) |
| `window` | winit window creation with platform defaults |
| `error` | Unified error type |

## Usage

```toml
[dependencies]
garasu = { git = "https://github.com/pleme-io/garasu" }
```

```rust
use garasu::{GpuContext, TextRenderer, ShaderPipeline, AppWindow};

let gpu = pollster::block_on(GpuContext::new())?;
let text = TextRenderer::new(&gpu.device, &gpu.queue, format);
```

## Build

```bash
cargo build
cargo test --lib
```

## Design

- Metal on macOS, Vulkan on Linux (via wgpu backends)
- Shader plugin system: built-in + custom `~/.config/{app}/shaders/*.wgsl`
- Uniforms: `time`, `resolution`, input texture + sampler
- Lock-free text rendering via glyphon