Module Cascade.PpSource

Set of strings, used for theme variable names.

The output sink a formatter writes to: a Buffer for serialisation, or a counter that records only length and last byte for size (no allocation). Abstract - emit through string / char and inspect with last_char.

Formatter context containing output configuration

Core formatter type: writes values of type 'a to a buffer

ctx buf builds a formatter context writing to buf, for the serialise-to-string / measuring helpers.

to_buffer buf formatter value runs the formatter writing into buf. The optional indent sets the per-level indent width (default: None under minify, Some 2 otherwise).

size formatter value is the byte length of to_string formatter value without allocating the result string. Use it for size-based decisions instead of measuring String.length (to_string ...).

to_string formatter value runs the formatter and returns a string. The optional indent sets the per-level indent width (default: None under minify, Some 2 otherwise). enforce_spec suppresses target-dependent shortenings.

nop is a no-op formatter that writes nothing and ignores its input.

string writes a string value to the buffer.

quoted writes a double-quoted string value to the buffer.

char writes a single character to the buffer.

last_char ctx is the most recently emitted byte, or None if nothing has been written yet. Use it for token-boundary spacing decisions instead of reaching into the output sink directly.

quoted_string ?quote writes a quote-delimited string (default '"') with proper escaping of the delimiter quote and backslashes.

sp writes a space character when not minifying (layout whitespace).

token_sp writes a token-boundary space: a regular space in pretty mode, and a space under minify only when the previous output character would otherwise re-tokenise with the next one. Drops the space after ) or % since both cleanly close their token (CSS Syntax 3 sec. 4).

cut writes a newline when not minifying.

indent formatter runs formatter with increased indentation level.

nest n formatter runs formatter with indentation increased by n levels.

f ++ g sequences two formatters: runs f then g on the same input.

pair ~sep f g formats a pair using f for first, g for second, with optional separator between them.

triple ~sep f g h formats a triple using f, g, h for the three components, with optional separator between them.

list ~sep formatter formats a list with separator between elements.

column ctx returns the current column position (chars since last newline).

list_wrap ?threshold ~sep ~wrap_indent formatter formats a list like list but wraps to a new line (indented by wrap_indent spaces) when the current column exceeds threshold (default 80). No-op when minifying.

option ~none formatter formats an option, using none formatter for None.

string_of_float ?drop_leading_zero ?max_decimals f converts a float to a string.

• drop_leading_zero: if true, omits leading zero for 0 < |n| < 1 (.5 instead of 0.5)
• max_decimals: maximum decimal precision (default 8)

float formats floating point numbers with CSS rules:

• Always drops leading zero for 0 < |n| < 1 (outputs .5 not 0.5)
• No scientific notation (uses bounded precision)
• Trims trailing zeros.

float_compact like float but always drops leading zeros regardless of minification mode. Used for oklch chroma values where Tailwind always uses compact format (e.g. .034 not 0.034).

float_n n formats float to exactly n decimal places using round-half-up. Used for CSS color channels and opacity where precision matters.

round_sig n f rounds f to n significant digits.

int formats integers.

hex formats integers as uppercase hexadecimal.

unit ctx f suffix formats a number with a unit suffix, e.g. "3.5px" or "0" for zero.

pct ctx f formats a percentage value with the % suffix. The value is expected to be in the range 0-100. The unit is always emitted: CSS Values 4 sec. 6.5 only allows the unit to drop on a zero <length>, not a zero <percentage>.

comma outputs "," when minifying, ", " when formatting.

semicolon always outputs ";".

slash always outputs "/" (mandatory separator, no spacing control).

space always outputs " " (mandatory lexical space, not layout).

block_open outputs "{" (block formatting controlled elsewhere).

block_close outputs "}" (block formatting controlled elsewhere).

minified ctx queries whether context is in minification mode.

in_feature_query ctx is true while serialising an @supports feature-test value, where lossy rewrites must be suppressed.

enter_feature_query ctx marks ctx as inside an @supports feature-test value.

cond predicate then_fmt else_fmt conditionally chooses formatter based on context predicate.

space_if_pretty is an alias for sp - outputs space when not minifying.

op_char outputs a character with spaces around it when not minifying. Useful for operators like +, -, *, / in expressions.

braces formatter wraps formatter in braces with proper spacing and indentation: { <indented content> } when formatting, {<content>} when minifying.

semicolon_cut outputs a semicolon followed by a layout cut.

braced_list formatter wraps a list in braces with one item per line at one indent level deeper and the closing brace back at the parent's indentation.

braced_semicolon_list formatter is braced_list with items separated by semicolon_cut and, in pretty output, a trailing semicolon after the last item, matching style rule bodies.

call name args formats a function call: name( args ).

call_list name item formats a function call with a comma-separated list of items: name(a, b, c).

call_2 name a b formats a 2-arg function call: name(a, b).

call_3 name a b c formats a 3-arg function call: name(a, b, c).

url formats a CSS url with quotes: url("s").