TransformOptions

Pretty print css

const result = await transform(css, {beautify: true});
Copy

Compute css math functions

Compute shorthand properties

Compute css transform functions

Convert color to the specified color space. 'true' will convert to HEX

Current working directory

Experimental, convert css if() function into legacy syntax.

Expand nested rules

Module output file path. it is used to generate the scoped name. if not provided, options.src will be used

Function to generate scoped name

Generated scope hash length. the default is 5

Indention string

Inline css variables

Input source map

Lenient validation. retain nodes that failed validation

Custom URL and file loader.

Enable minification

CSS modules options

optional. function change the case of the scoped name and the class mapping

• ModuleCaseTransformEnum.IgnoreCase: do not change case
• ModuleCaseTransformEnum.CamelCase: camelCase ParseResult.mapping key name
• ModuleCaseTransformEnum.CamelCaseOnly: camelCase ParseResult.mapping key name and the scoped class name
• ModuleCaseTransformEnum.DashCase: dashCase ParseResult.mapping key name
• ModuleCaseTransformEnum.DashCaseOnly: dashCase ParseResult.mapping key name and the scoped class name

Generate nested rules

New line string

Output file. Used for url resolution

Parse color tokens

Define minification passes.

The pattern used to generate scoped names. the supported placeholders are:

• name: the file base name without the extension
• hash: the file path hash
• local: the local name
• path: the file path
• folder: the folder name
• ext: the file extension

the pattern can optionally have a maximum number of characters:

pattern: '[local:2]-[hash:5]'
Copy

the hash pattern can take an algorithm, a maximum number of characters or both:

pattern: '[local]-[hash:base64:5]'
Copy

or

pattern: '[local]-[hash:5]'
Copy

or

pattern: '[local]-[hash:sha1]'
Copy

supported hash algorithms are:

• base64
• hex
• base64url
• sha1
• sha256
• sha384
• sha512

import {transform, ModuleCaseTransformEnum} from '@tbela99/css-parser';
import type {TransformResult} from '@tbela99/css-parser';
css = `
:local(.className) {
  background: red;
  color: yellow;
}

:local(.subClass) {
  composes: className;
  background: blue;
}
`;

let result: TransformResult = await transform(css, {

    beautify:true,
    module: {
        pattern: '[local]-[hash:sha256]'
    }

});

console.log(result.code);
Copy

generated css

.className-b629f {
 background: red;
 color: #ff0
}
.subClass-a0c35 {
 background: blue
}
Copy

Preserve license comments. License comments are comments that start with '/*!'

Remove at-rule charset

Remove comments

Remove duplicate declarations from the same rule. if passed as a string array, duplicated declarations are removed, except for those in the array

import {transform} from '@tbela99/css-parser';

const css = `

.table {

    width: 100%;
    width: calc(100% + 40px);
    margin-left: 20px;
    margin-left: min(100% , 20px)
}

`;
const result = await transform(css, {

    beautify: true,
    validation: true,
    removeDuplicateDeclarations: ['width']
}
);

console.log(result.code);

Copy

Remove empty ast nodes

Remove css prefix

Url and path resolver

Resolve import

Resolve urls

Use local scope vs global scope

Abort signal

Example: abort after 10 seconds

const result = await parse(cssString, {
    signal: AbortSignal.timeout(10000)
});

Copy

Source file to be used for sourcemap

Include sourcemap in the ast. Sourcemap info is always generated

Source file to be used for sourcemap

Source file to be used for sourcemap

Enable CSS validation. Using ValidationLevel as value is deprecated and will be removed

see ValidationLevel

Node visitor VisitorNodeMap[]

Render the node along with its parents