# @yuragi-labs/compiler

Build-time compiler wrapper for Yuragi text outlines.

This package invokes the native Rust compiler through Cargo at runtime.
Consumers must have Rust and Cargo available on `PATH`. Cargo build artifacts
are written to a deterministic cache directory under the OS temp directory, not
inside the installed package.

## API

```ts
import { compileOutlines, type FontAxes } from "@yuragi-labs/compiler";

const axes = { wght: 900 } satisfies FontAxes;

const bundle = await compileOutlines({
  font: "./fonts/title.otf",
  axes,
  titles: ["Dashboard", "Settings"],
});
```

The compiler deduplicates title strings before invoking the native compiler.
Title discovery and output writing stay in the calling build script so this
package is independent of any framework or bundler.

## Options

- `font`: font file path.
- `axes`: optional `FontAxes` variation axis values for variable fonts.
- `titles`: a readonly array of explicit strings to compile.

The output is a `TextOutlineBundle` from `@yuragi-labs/core`.

See [`examples/react-static-vite`](../../examples/react-static-vite) for a
complete script that writes the outline map to JSON and renders it through
`@yuragi-labs/react/static`.

## Native Compiler

The package ships the Rust source under `native/` and runs Cargo against it.
The compiled binary is cached outside the package directory so installed package
contents are not mutated.
