@tbela99/css-parser 0.9.1 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,265 @@
+# Changelog
+
+## v1.1.0
+
+- [x] inline sourcemap
+- [x] CSS validation using mdn-data
+- [x] prefix removal now remove prefixes from all nodes. prefixed linear gradients are not supported
+
+# v1.0.0
+
+- [x] current color parse error when used in color functions
+- [x] minification : CSS transform module level 2
+  - [x] translate
+  - [x] scale
+  - [x] rotate
+  - [x] skew
+  - [x] perspective                                  
+  - [x] matrix
+  - [x] matrix3d
+- [x] keyframes
+    - [x] remove consecutive keyframes with the same name
+    - [x] reduce keyframe selector 'from' to '0%'
+    - [x] reduce keyframe selector '100%' to 'to'
+    - [x] remove keyframe selector ignored declarations
+    - [x] merge keyframe rules and declarations
+- [x] trim extra space in declaration value 'url() 15%' -> 'url()15%', '1% !important' -> '1%!important'
+- [x] allow empty value for css variable declaration '--color: ;'
+- [x] change generate nesting rule default to true
+
+# v0.9.1
+
+- [x] minification passes #66
+- [x] nesting selector cannot match pseudo element #67
+
+# v0.9.0
+
+validation
+- [x] validate invalid pseudo classes
+- [x] rewrite selector validation
+- [x] lenient mode that preserves 
+  - [x] unknown at-rules
+  - [x] unknown declarations 
+  - [x] unknown pseudo classes
+
+media query level 5
+- [x] at-rule custom-media
+- [x] at-rule when-else custom media
+- [x] at-rule charset validation
+- [x] media query error handling
+- [x] at-rule container
+- [ ] expand at-rule custom-media
+- [ ] expand at-rule when-else
+
+selector validation
+- [ ] pseudo class arguments validation
+- [ ] pseudo class validation
+
+declaration validation
+- [ ] validate declaration
+
+error validation
+- [ ] when a parent is marked as invalid node, do not parse or validate descendant nodes
+
+# v0.8.0
+
+- [x] validate selectors using mdn data
+- [x] at-rules prefix removal
+- [x] at rules validation
+    - [x] at-rule prelude
+    - [x] at-rule body
+    - [x] keyframe validation
+    - [ ] :not() does not accept pseudo classes
+    - [ ] do not validate declarations in @supports
+- [ ] declarations validation
+- [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() #49
+- [x] incorrectly parse compound selector #51
+
+# v0.7.1
+
+- [x] fix nesting rules expansion #45
+
+# v0.7.0
+
+- [x] fix merging rules
+- [ ] experimental CSS prefix removal
+    - [x] declaration name
+    - [ ] declaration value
+    - [ ] exclude -webkit-* gradients
+- [x] css selector validation
+    - [x] pseudo element
+    - [x] partial pseudo class validation. does not validate parameters
+    - [x] attribute selector
+    - [x] combinator
+    - [x] simple selector
+    - [x] nested selector
+    - [x] strict vs permissive validation: allow unknown items such as pseudo classes
+        - [x] allow unknown pseudo classes
+        - [x] allow unknown attribute selectors
+- [x] strip universal selector when possible
+
+# v0.6.0
+
+- [x] light-dark() color
+- [x] system color
+
+## V0.5.4
+
+- [x] incorrectly expand css nesting rules
+
+## v0.5.3
+
+- [x] incorrectly expand css nesting rules
+
+## v0.5.1
+
+- [x] failed to flatten @import when using url() syntax
+
+## v0.5.0
+
+- [x] render node with parents
+- [x] fix relative color from xyz
+- [x] fix bug when inlineCss is true but no css variable exists
+- [x] compute more shorthands
+- [x] (web) fetch imported css files from external domains using cors
+
+## v0.4.1
+
+no code change
+
+## v0.4.0
+
+Parsing
+
+- [x] allow async node visitors
+- [x] adding declaration parsing helper async parseDeclarations(source: string): Promise<AstDeclarations[]>
+
+CSS color level 4 & 5
+
+- [x] color space: srgb, srgb-linear, display-p3, prophoto-rgb, a98-rgb, rec2020, xyz, xyz-d50
+- [x] color-mix()
+- [x] color()
+- [x] relative color
+- [x] lab()
+- [x] lch()
+- [x] oklab()
+- [x] oklch()
+
+## v0.3.0
+
+### shorthands
+
+- [x] column-rule
+- [x] columns
+- [x] container
+- [x] flex
+- [x] flex-flow
+- [x] gap
+
+### Other
+
+- [x] renamed RenderOptions.colorConvert to RenderOptions.convertColor
+- [x] support none keyword in color
+- [x] css relative color syntax for rgb(), hsl() and hwb() colors https://www.w3.org/TR/css-color-5/#relative-colors
+    - [x] rgb
+    - [x] hex
+    - [x] hsl
+    - [x] hwb
+    - [x] calc()
+    - [x] calc() and inline var()
+
+## v0.2.0
+
+- [x] cancellable parser promise using abortSignal
+- [x] node visitor (callback) :
+    - [x] Declaration visitor
+    - [x] selector visitor
+    - [x] at-rule visitor
+- [x] support mixing units with calc()
+
+### shorthands
+
+- [x] transition
+- [x] list-style
+- [x] text-emphasis
+- [x] animation
+
+### Minification
+
+- [x] parsing column combinator
+- [x] css selector level 4 attribute modifiers
+- [x] selector-4 parsing https://www.w3.org/TR/selectors-4/
+
+## v0.1.0
+
+- [x] sourcemap generation
+- [x] reduce calc():
+- [x] inline css variables
+- [x] configure duplicate declarations removal
+- [x] configure shorthand properties computation
+
+## v0.0.1
+
+### Minification
+
+- [x] merge identical rules
+- [x] merge adjacent rules
+- [x] minify colors
+- [x] minify numbers and Dimensions tokens
+- [x] compute shorthand: see the list below
+- [x] remove redundant declarations
+- [x] simple shorthand properties (padding, margin, etc). must have all required properties
+- [x] complex shorthand properties (background, font, etc.). may have optional properties
+- [x] conditionally unwrap :is()
+- [x] automatic css nesting
+- [x] automatically wrap selectors using :is()
+- [x] multi-level shorthand properties (
+  border - [border-width, border-color, border-style, etc.]) https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties
+- [x] avoid reparsing (declarations, selectors, at-rule)
+- [x] node and browser versions
+- [x] decode and replace utf-8 escape sequence
+
+### Computed shorthands
+
+- [x] background
+- [x] border
+- [x] border-bottom
+- [x] border-color
+- [x] border-left
+- [x] border-radius
+- [x] border-right
+- [x] border-style
+- [x] border-top
+- [x] border-width
+- [x] font
+- [x] inset
+- [x] margin
+- [x] outline
+- [x] overflow
+- [x] padding
+- [x] text-decoration
+
+### Performance
+
+- [x] flatten @import
+
+### Error handling
+
+- [x] parse bad comments / cdo comments
+- [x] parse bad string 1
+- [x] parse bad string 2
+- [x] parse empty declaration
+- [x] parse unclosed rule
+- [x] parse unclosed at-rule
+- [x] parse bad import
+
+# Testing
+
+- [x] node tests
+- [x] browser tests
+
+# Code Coverage
+
+- [x] node
+- [x] browser

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

@@ -23,22 +23,22 @@ $ deno add @tbela99/css-parser
 ## Features
 
 - no dependency
-- partial css validation based upon mdn-data: at-rules and selectors validation
+- CSS validation based upon mdn-data
 - 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
+- experimental CSS prefix removal
 
 ## Playground
 
@@ -96,7 +96,7 @@ Javascript module from cdn
 
 <script type="module">
 
-    import {transform} from 'https://esm.sh/@tbela99/css-parser@0.9.0/web';
+    import {transform} from 'https://esm.sh/@tbela99/css-parser@1.1.0/web';
 
 
     const css = `
@@ -159,30 +159,44 @@ Include ParseOptions and RenderOptions
 - 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
   in the :root {} or html {} rule.
 - removeEmpty: boolean, optional. remove empty rule lists from the ast.
 
+> CSS Prefix Removal Options
+
+- removePrefix: boolean, optional. remove CSS prefixes.
+
 > Validation Options
 
-- validation: boolean, optional. enable strict css validation using (mdn data)[https://github.com/mdn/data]. only the
-  selector is validated at this time.
-- lenient: boolean, optional. ignore unknown at-rules, pseudo-classes and declarations.
+- validation: ValidationLevel | boolean, optional. enable validation. permitted values are:
+    - ValidationLevel.None: no validation
+    - ValidationLevel.Default: validate selectors and at-rules (default)
+    - ValidationLevel.All. validate all nodes
+    - true: same as ValidationLevel.All.
+    - false: same as ValidationLevel.None
+- lenient: boolean, optional. preserve invalid tokens.
 
 > Sourcemap Options
 
 - 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
@@ -200,7 +214,7 @@ Include ParseOptions and RenderOptions
 
 > Sourcemap Options
 
-- sourcemap: boolean, optional. generate sourcemap
+- sourcemap: boolean | 'inline', optional. generate sourcemap. 
 
 > Misc Options
 
@@ -701,6 +715,8 @@ for (const {node, parent, root} of walk(ast)) {
 
 ## Minification
 
+- [x] minify keyframes
+- [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
@@ -1023,7 +1039,3 @@ console.debug(await transform(css, options));
 // .foo{width:3px}
 
 ```
-
----
-
-Thanks to [Jetbrains](https://jetbrains.com) for sponsoring this project with a free license