Research
Security News
Malicious npm Package Targets Solana Developers and Hijacks Funds
A malicious npm package targets Solana developers, rerouting funds in 2% of transactions to a hardcoded address.
@csstools/css-parser-algorithms
Advanced tools
Algorithms to help you parse CSS from an array of tokens.
@csstools/css-parser-algorithms is a library designed to help parse and manipulate CSS using various algorithms. It provides tools to work with CSS syntax trees, making it easier to analyze and transform CSS code programmatically.
Parsing CSS
This feature allows you to parse a CSS string into an Abstract Syntax Tree (AST). The AST can then be used for further analysis or transformation.
const { parse } = require('@csstools/css-parser-algorithms');
const css = 'body { color: red; }';
const ast = parse(css);
console.log(ast);
Traversing AST
This feature allows you to traverse the AST nodes. You can define enter and leave functions to perform actions when entering or leaving a node.
const { parse, traverse } = require('@csstools/css-parser-algorithms');
const css = 'body { color: red; }';
const ast = parse(css);
traverse(ast, {
enter(node) {
console.log('Entering:', node.type);
},
leave(node) {
console.log('Leaving:', node.type);
}
});
Transforming CSS
This feature allows you to transform the CSS AST. In this example, the color property is changed from red to blue.
const { parse, transform } = require('@csstools/css-parser-algorithms');
const css = 'body { color: red; }';
const ast = parse(css);
const newAst = transform(ast, {
enter(node) {
if (node.type === 'Declaration' && node.property === 'color') {
node.value = 'blue';
}
}
});
console.log(newAst);
PostCSS is a tool for transforming CSS with JavaScript plugins. It provides a similar functionality to @csstools/css-parser-algorithms in terms of parsing and transforming CSS. However, PostCSS has a larger ecosystem of plugins and is more widely used in the industry.
CSS Tree is a toolset for CSS including a fast CSS parser, walker, generator, and lexer. It offers similar capabilities to @csstools/css-parser-algorithms but is known for its performance and detailed error reporting.
CSSTree is a detailed and fast CSS parser and generator. It provides similar functionalities to @csstools/css-parser-algorithms but focuses more on performance and detailed error messages.
Implemented from : https://www.w3.org/TR/2021/CRD-css-syntax-3-20211224/
Add CSS Parser Algorithms to your project:
npm install @csstools/css-parser-algorithms @csstools/css-tokenizer --save-dev
CSS Parser Algorithms only accepts tokenized CSS.
It must be used together with @csstools/css-tokenizer
.
import { tokenizer, TokenType } from '@csstools/css-tokenizer';
import { parseComponentValue } from '@csstools/css-parser-algorithms';
const myCSS = `@media only screen and (min-width: 768rem) {
.foo {
content: 'Some content!' !important;
}
}
`;
const t = tokenizer({
css: myCSS,
});
const tokens = [];
{
while (!t.endOfFile()) {
tokens.push(t.nextToken());
}
tokens.push(t.nextToken()); // EOF-token
}
const options = {
onParseError: ((err) => {
throw err;
}),
};
const result = parseComponentValue(tokens, options);
console.log(result);
gatherNodeAncestry
The AST does not expose the entire ancestry of each node. The walker methods do provide access to the current parent, but also not the entire ancestry.
To gather the entire ancestry for a a given sub tree of the AST you can use gatherNodeAncestry
.
The result is a Map
with the child nodes as keys and the parents as values.
This allows you to lookup any ancestor of any node.
import { parseComponentValue } from '@csstools/css-parser-algorithms';
const result = parseComponentValue(tokens, options);
const ancestry = gatherNodeAncestry(result);
{
onParseError?: (error: ParseError) => void
}
onParseError
The parser algorithms are forgiving and won't stop when a parse error is encountered. Parse errors also aren't tokens.
To receive parsing error information you can set a callback.
Parser errors will try to inform you about the point in the parsing logic the error happened. This tells you the kind of error.
Things this package aims to be:
What it is not:
FAQs
Algorithms to help you parse CSS from an array of tokens.
The npm package @csstools/css-parser-algorithms receives a total of 3,301,313 weekly downloads. As such, @csstools/css-parser-algorithms popularity was classified as popular.
We found that @csstools/css-parser-algorithms demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
A malicious npm package targets Solana developers, rerouting funds in 2% of transactions to a hardcoded address.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.