cssnano-utils

cssnano-utils

Utility methods and plugins for cssnano projects.

API

PostCSS Utilities

Utility	Description
rawCache	PostCSS plugin that sets default formatting for generated AST nodes on result.root.rawCache.
sameParent	Recursively check whether two PostCSS nodes share the same parent ancestry.

CSS Tokenizer and Value Utilities

Utility	Description
TokenType	Re-exported TokenType enum from @csstools/css-tokenizer.
tokens	Tokenize a CSS string into a CSSToken[] array with trailing EOF tokens stripped.
tokenStart	Return the inclusive start character offset of a token (token[2]).
tokenEnd	Return the exclusive end character offset of a token (token[3] + 1) for string slicing.
decoded	Return the decoded string value of a token, falling back to its raw representation.
numeric	Parse a single token into { number, unit }, or false if not a numeric token.
numericSource	Capture a numeric token or multi-token sequence (e.g. 1.em) with exclusive source bounds.
balancedTokens	Parse CSS into a BalancedTokens index of matching delimiters ((), [], {}), or undefined if unbalanced.
applyEdits	Apply validated, non-overlapping string edits. Invalid bounds or overlaps fail closed by returning the complete original source.

BalancedTokens Methods

Instances returned by balancedTokens(source) provide:

• endForOpening(index): Returns the closing token index for an opening delimiter token at index.
• topLevelSegments(startIndex?, endIndex?, delimiter?): Splits a balanced token range by a top-level delimiter (defaults to comma).

Usage

import cssnanoUtils from 'cssnano-utils';

const { tokens, balancedTokens, applyEdits } = cssnanoUtils;

const structure = balancedTokens('cubic-bezier(0.1, 0.7, 1.0, 0.1)');
if (structure) {
  const segments = structure.topLevelSegments();
  // Process balanced segments
}

Contributors

See CONTRIBUTORS.md.

License

MIT

Similar packages

Other packages similar to cssnano-utils

postcss-value-parser

Parses CSS values into a traversable node structure, including functions, words, and separators. It offers more detailed parsing and editing capabilities; cssnano-utils provides a narrower convenience helper for extracting function arguments.

postcss

Provides a CSS parser, AST, and plugin framework for transforming stylesheets. It operates on whole stylesheet syntax, whereas cssnano-utils focuses on small helpers used alongside CSS-processing tools.

postcss-selector-parser

Parses and transforms CSS selectors as structured nodes. It is specialized for selector syntax, while cssnano-utils is a smaller general-purpose helper collection for cssnano-related transformations.