@tbela99/css-parser 0.9.0 → 1.0.0

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Thierry Bela
+Copyright (c) 2023-present Thierry Bela
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,6 +1,6 @@
 [![playground](https://img.shields.io/badge/playground-try%20it%20now-%230a7398
 )](https://tbela99.github.io/css-parser/playground/) [![npm](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Ftbela99%2Fcss-parser%2Fmaster%2Fpackage.json&query=version&logo=npm&label=npm&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2F%40tbela99%2Fcss-parser)](https://www.npmjs.com/package/@tbela99/css-parser) [![npm](https://img.shields.io/jsr/v/%40tbela99/css-parser?link=https%3A%2F%2Fjsr.io%2F%40tbela99%2Fcss-parser
-)](https://jsr.io/@tbela99/css-parser) [![cov](https://tbela99.github.io/css-parser/badges/coverage.svg)](https://github.com/tbela99/css-parser/actions) [![NPM Downloads](https://img.shields.io/npm/dm/%40tbela99%2Fcss-parser)](https://www.npmjs.com/package/@tbela99/css-parser)
+)](https://jsr.io/@tbela99/css-parser) [![cov](https://tbela99.github.io/css-parser/badges/coverage.svg)](https://github.com/tbela99/css-parser/actions) [![NPM Downloads](https://img.shields.io/npm/dm/%40tbela99%2Fcss-parser)](https://www.npmjs.com/package/@tbela99/css-parser) [![bundle size](https://img.shields.io/bundlejs/size/%40tbela99/css-parser%400.9.0?exports=cjs)](https://www.npmjs.com/package/@tbela99/css-parser)
 
 # css-parser
 
@@ -27,15 +27,14 @@ $ deno add @tbela99/css-parser
 - fault-tolerant parser, will try to fix invalid tokens according to the CSS syntax module 3 recommendations.
 - fast and efficient minification without unsafe transforms,
   see [benchmark](https://tbela99.github.io/css-parser/benchmark/index.html)
-- minify colors.
-- support css color level 4 & 5: color(), lab(), lch(), oklab(), oklch(), color-mix(), light-dark(), system colors and
+- minify colors: color(), lab(), lch(), oklab(), oklch(), color-mix(), light-dark(), system colors and
   relative color
 - generate nested css rules
 - convert nested css rules to legacy syntax
 - generate sourcemap
 - compute css shorthands. see supported properties list below
-- evaluate math functions: calc(), clamp(), min(), max(), round(), mod(), rem(), sin(), cos(), tan(), asin(), acos(),
-  atan(), atan2(), pow(), sqrt(), hypot(), log(), exp(), abs(), sign()
+- css transform functions minification
+- evaluate math functions: calc(), clamp(), min(), max(), etc.
 - inline css variables
 - remove duplicate properties
 - flatten @import rules
@@ -65,7 +64,7 @@ import as a module
 
 ```javascript
 
-import {transform} from 'npm:@tbela99/css-parser';
+import {transform} from '@tbela99/css-parser';
 
 // ...
 ```
@@ -96,7 +95,7 @@ Javascript module from cdn
 
 <script type="module">
 
-    import {transform} from 'https://esm.sh/@tbela99/css-parser@0.4.0/web';
+    import {transform} from 'https://esm.sh/@tbela99/css-parser@1.0.0/web';
 
 
     const css = `
@@ -154,10 +153,12 @@ Include ParseOptions and RenderOptions
 > Minify Options
 
 - minify: boolean, optional. default to _true_. optimize ast.
+- pass: number, optional. minification pass. default to 1
 - nestingRules: boolean, optional. automatically generated nested rules.
 - expandNestingRules: boolean, optional. convert nesting rules into separate rules. will automatically set nestingRules
   to false.
 - removeDuplicateDeclarations: boolean, optional. remove duplicate declarations.
+- computeTransform: boolean, optional. compute css transform functions.
 - computeShorthand: boolean, optional. compute shorthand properties.
 - computeCalcExpression: boolean, optional. evaluate calc() expression
 - inlineCssVariables: boolean, optional. replace some css variables with their actual value. they must be declared once
@@ -175,13 +176,18 @@ Include ParseOptions and RenderOptions
 - src: string, optional. original css file location to be used with sourcemap, also used to resolve url().
 - sourcemap: boolean, optional. preserve node location data.
 
-> Misc Options
+> Ast Traversal Options
+
+- visitor: VisitorNodeMap, optional. node visitor used to transform the ast.
 
+> Urls and \@import Options
+
+- resolveImport: boolean, optional. replace @import rule by the content of the referenced stylesheet.
 - resolveUrls: boolean, optional. resolve css 'url()' according to the parameters 'src' and 'cwd'
-- resolveImport: boolean, optional. replace @import rule by the content of its referenced stylesheet.
+
+> Misc Options
 - removeCharset: boolean, optional. remove @charset.
 - cwd: string, optional. destination directory used to resolve url().
-- visitor: VisitorNodeMap, optional. node visitor used to transform the ast.
 - signal: AbortSignal, optional. abort parsing.
 
 #### RenderOptions
@@ -700,7 +706,11 @@ for (const {node, parent, root} of walk(ast)) {
 
 ## Minification
 
-- [x] reduce calc()
+- [x] minify keyframs
+- [x] minify transform
+- [x] evaluate math functions calc(), clamp(), min(), max(), round(), mod(), rem(), sin(), cos(), tan(), asin(),
+  acos(), atan(), atan2(), pow(), sqrt(), hypot(), log(), exp(), abs(), sign()
+- [x] multi-pass minification
 - [x] inline css variables
 - [x] merge identical rules
 - [x] merge adjacent rules
@@ -816,7 +826,7 @@ the visitor is called only on 'height' declarations
 ```typescript
 
 import {AstDeclaration, LengthToken, ParserOptions} from "../src/@types";
-import {EnumToken, EnumToken} from "../src/lib";
+import {EnumToken} from "../src/lib";
 import {transform} from "../src/node";
 
 const options: ParserOptions = {