@tbela99/css-parser 0.0.1-alpha3

package/.gitattributes

@@ -0,0 +1,19 @@
+/test/ export-ignore
+/docs/ export-ignore
+/tools/ export-ignore
+/package-lock.json export-ignore
+/.gitignore export-ignore
+/.gitattributes export-ignore
+/rollup.config.mjs export-ignore
+/tsconfig.json export-ignore
+# exclude all files in test/ from stats
+/test/** linguist-vendored
+/docs/** linguist-vendored
+/tools/** linguist-vendored
+/dist/** linguist-vendored
+#
+# do not replace lf by crlf
+*.css text
+*.json text
+text eol=lf
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+# css-parser
+
+CSS parser for node and the browser
+
+## Installation
+
+```shell
+$ npm install @tbela99/css-parser
+
+```
+
+## Transform
+
+Parse and render css in a single pass.
+
+### Usage
+
+```javascript
+
+transform(css, transformOptions = {})
+```
+
+### Example
+
+```javascript
+
+import {transform} from '@tbela99/css-parser';
+
+const {ast, code, errors, stats} = await transform(css, {compress: true, resolveImport: true, cwd: 'files/css'});
+```
+
+### TransformOptions
+
+Include ParseOptions and RenderOptions
+
+#### ParseOptions
+
+- src: string, optional. css file location to be used with sourcemap.
+- compress: boolean, optional. default to _true_. optimize ast and minify css.
+- removeEmpty: boolean, remove empty nodes from the ast.
+- location: boolean, optional. includes node location in the ast, required for sourcemap generation.
+- cwd: string, optional. the current working directory. when specified url() are resolved using this value
+- resolveImport: boolean, optional. replace @import node by the content of the referenced stylesheet.
+- resolveUrls: boolean, optional. resolve css url() according to the parameters 'src' and 'cwd'
+
+#### RenderOptions
+- compress: boolean, optional. default to _true_. optimize ast and minify css.
+- indent: string, optional. css indention string. uses space character by default.
+- newLine: string, new line character.
+- removeComments: boolean, remove comments in generated css.
+- preserveLicense: boolean, force preserving comments starting with '/\*!' when compress is enabling.
+- colorConvert: boolean, convert colors to hex.
+
+
+## Parsing
+
+```javascript
+import {parse} from '@tbela99/css-parser';
+
+const {ast, errors} = parse(css);
+```
+
+### Usage
+
+```javascript
+
+parse(css, parseOptions = {})
+```
+
+### Example
+
+````javascript
+
+const {ast, errors} = await parse(css);
+````
+
+## Rendering
+
+### Usage
+
+```javascript
+render(ast, RenderOptions = {});
+```
+
+### Example
+
+```javascript
+import {render} from '@tbela99/css-parser';
+
+// minified
+const {code} = render(ast, {compress: true});
+
+console.log(code);
+```
+
+## Node Walker
+
+```javascript
+import {walk} from '@tbela99/css-parser';
+
+for (const {node, parent, root} of walk(ast)) {
+    
+    // do somehting
+}
+```
+
+## Exports
+
+There are several ways to import the library into your application.
+
+### Node exports
+
+import as a module
+
+```javascript
+
+import {transform} from '@tbela99/css-parser';
+
+// ...
+```
+import as a CommonJS module
+
+```javascript
+
+import {transform} from '@tbela99/css-parser/cjs';
+
+// ...
+```
+
+### Web export
+
+Programmatic import
+
+```javascript
+
+import {transform} from '@tbela99/css-parser/web';
+
+// ...
+```
+
+Javascript module
+
+```javascript
+
+<script src="dist/web/index.js" type="module"></script>
+```
+
+Single JavaScript file
+
+```javascript
+
+<script src="dist/index-umd-web.js"></script>
+```
+
+## AST
+
+### Comment
+
+- typ: string 'Comment'
+- val: string, the comment
+
+### Declaration
+
+- typ: string 'Declaration'
+- nam: string, declaration name
+- val: array of tokens
+
+### Rule
+
+- typ: string 'Rule'
+- sel: string, css selector
+- chi: array of children
+
+### AtRule
+
+- typ: string 'AtRule'
+- nam: string. AtRule name
+- val: rule prelude
+
+### AtRuleStyleSheet
+
+- typ: string 'Stylesheet'
+- chi: array of children