rics

Core compiler for the rics CSS preprocessor. A fast, lightweight SCSS-like preprocessor that runs anywhere JavaScript runs.

Installation

``bash
npm install rics
`

Usage

`typescript
import { compile } from "rics";

const css = compile(
$primary: #f43f5e;

.button {
background: $primary;

&:hover {
background: darken($primary, 10%);
}
}
);
`

API

$3

Compiles rics/SCSS input to CSS.

`typescript
const css = compile(input);
`

$3

Returns full compilation result including errors, warnings, and stats.

`typescript
const result = compileWithDetails(input);

console.log(result.css);
console.log(result.errors); // CompileError[]
console.log(result.warnings); // CompileWarning[]
console.log(result.stats); // { duration, rules, iterations, inputSize, outputSize }
`

$3

Non-blocking compilation for large inputs.

`typescript
const result = await compileAsync(largeStylesheet);
`

Configuration

`typescript
compile(input, {
timeout: 5000, // Max compilation time (ms)
maxIterations: 10000, // Max loop iterations
maxNestingDepth: 64, // Max selector nesting
minify: false, // Minify output
strictMode: false, // Throw on first error
});
`

Features

- Variables and math operations
- Nesting with & parent selector
- Mixins with parameters, default values, and named arguments
- Custom functions with @function and @return
- Control flow: @if, @else, @for, @each, @while
- Color functions: darken, lighten, mix, saturate, and more
- String interpolation with #{}
- Native CSS pass-through for modern features

Benchmarks

> Auto-generated. Run pnpm bench` in the benchmarks folder to regenerate.

$3

| Preprocessor | ops/sec | Comparison |
|--------------|---------|------------|
| rics | 897 | fastest |
| stylus | 334 | 2.7x slower |
| sass | 279 | 3.2x slower |
| less | 221 | 4.1x slower |

$3

| Package | Size | Dependencies | Comparison |
|---------|------|--------------|------------|
| rics | 12.7 KB | 0 | smallest |
| less | 49.0 KB | 0 | 4x larger |
| stylus | 82.8 KB | 5 | 7x larger |
| sass | 686.0 KB | 1 | 54x larger |

License

MIT

---

Built by Better Lyrics