rics

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

Installation

npm install rics

Usage

import { compile } from "rics";

const css = compile(`
$primary: #f43f5e;

.button {
  background: $primary;

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

API

compile(input, config?)

Compiles rics/SCSS input to CSS.

const css = compile(input);

compileWithDetails(input, config?)

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

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 }

compileAsync(input, config?)

Non-blocking compilation for large inputs.

const result = await compileAsync(largeStylesheet);

Configuration

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.

Performance (ops/sec, higher is better)

Preprocessor	ops/sec	Comparison
rics	919	fastest
stylus	319	2.9x slower
sass	271	3.4x slower
less	211	4.4x slower

Package Size (minzipped, smaller is better)

Package	Size	Dependencies	Comparison
rics	12.4 KB	0	smallest
less	49.3 KB	0	4x larger
stylus	82.8 KB	5	7x larger
sass	675.7 KB	1	54x larger

License

MIT

Built by Better Lyrics