@tbela99/css-parser 1.2.0 → 1.3.1

package/dist/node.js

@@ -0,0 +1,229 @@
+import process from 'node:process';
+export { ColorType, EnumToken, ValidationLevel } from './lib/ast/types.js';
+export { minify } from './lib/ast/minify.js';
+export { WalkerOptionEnum, WalkerValueEvent, walk, walkValues } from './lib/ast/walk.js';
+export { expand } from './lib/ast/expand.js';
+import { doRender } from './lib/renderer/render.js';
+export { renderToken } from './lib/renderer/render.js';
+export { SourceMap } from './lib/renderer/sourcemap/sourcemap.js';
+import { doParse } from './lib/parser/parse.js';
+export { parseDeclarations, parseString, parseTokens } from './lib/parser/parse.js';
+import { tokenizeStream, tokenize } from './lib/parser/tokenize.js';
+import './lib/parser/utils/config.js';
+export { convertColor } from './lib/syntax/color/color.js';
+import './lib/syntax/color/utils/constants.js';
+export { isOkLabClose, okLabDistance } from './lib/syntax/color/utils/distance.js';
+import './lib/validation/config.js';
+import './lib/validation/parser/types.js';
+import './lib/validation/parser/parse.js';
+import './lib/validation/syntaxes/complex-selector.js';
+import './lib/validation/syntax.js';
+import { resolve, matchUrl, dirname } from './lib/fs/resolve.js';
+import { Readable } from 'node:stream';
+import { createReadStream } from 'node:fs';
+export { FeatureWalkMode } from './lib/ast/features/type.js';
+
+/**
+ * node module entry point
+ * @module node
+ */
+/**
+ * load file or url as stream
+ * @param url
+ * @param currentFile
+ *
+ * @private
+ */
+async function getStream(url, currentFile = '.') {
+    const resolved = resolve(url, currentFile);
+    // @ts-ignore
+    return matchUrl.test(resolved.absolute) ? fetch(resolved.absolute).then((response) => {
+        if (!response.ok) {
+            throw new Error(`${response.status} ${response.statusText} ${response.url}`);
+        }
+        return response.body;
+    }) : Readable.toWeb(createReadStream(resolved.absolute));
+}
+/**
+ * render ast tree
+ * @param data
+ * @param options
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ *  import {render, ColorType} from '@tbela99/css-parser';
+ *
+ *  // remote file
+ * let result = render(ast);
+ * console.log(result.code);
+ *
+ * // local file
+ * result = await parseFile(ast, {beatify: true, convertColor: ColorType.SRGB});
+ * console.log(result.code);
+ * ```
+ */
+function render(data, options = {}) {
+    return doRender(data, Object.assign(options, { getStream, resolve, dirname, cwd: options.cwd ?? process.cwd() }));
+}
+/**
+ * parse css file
+ * @param file url or path
+ * @param options
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ *  import {parseFile} from '@tbela99/css-parser';
+ *
+ *  // remote file
+ * let result = await parseFile('https://docs.deno.com/styles.css');
+ * console.log(result.ast);
+ *
+ * // local file
+ * result = await parseFile('./css/styles.css');
+ * console.log(result.ast);
+ * ```
+ */
+async function parseFile(file, options = {}) {
+    return getStream(file).then(stream => parse(stream, { src: file, ...options }));
+}
+/**
+ * parse css
+ * @param stream
+ * @param opt
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ * import {transform} from '@tbela99/css-parser';
+ *
+ *  // css string
+ *  let result = await transform(css);
+ *  console.log(result.code);
+ * ```
+ *
+ * Example using stream
+ *
+ * ```ts
+ *
+ * import {parse} from '@tbela99/css-parser';
+ * import {Readable} from "node:stream";
+ *
+ * // usage: node index.ts < styles.css or cat styles.css | node index.ts
+ *
+ *  const readableStream = Readable.toWeb(process.stdin);
+ *  const result = await parse(readableStream, {beautify: true});
+ *
+ *  console.log(result.ast);
+ * ```
+ *
+ * Example using fetch
+ *
+ * ```ts
+ *
+ *  import {parse} from '@tbela99/css-parser';
+ *
+ *  const response = await fetch('https://docs.deno.com/styles.css');
+ *  result = await parse(response.body, {beautify: true});
+ *
+ *  console.log(result.ast);
+ * ```
+ */
+async function parse(stream, opt = {}) {
+    return doParse(stream instanceof ReadableStream ? tokenizeStream(stream) : tokenize({
+        stream,
+        buffer: '',
+        position: { ind: 0, lin: 1, col: 1 },
+        currentPosition: { ind: -1, lin: 1, col: 0 }
+    }), Object.assign(opt, { getStream, resolve, dirname, cwd: opt.cwd ?? process.cwd() }));
+}
+/**
+ * transform css file
+ * @param file url or path
+ * @param options
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ *  import {transformFile} from '@tbela99/css-parser';
+ *
+ *  // remote file
+ * let result = await transformFile('https://docs.deno.com/styles.css');
+ * console.log(result.code);
+ *
+ * // local file
+ * result = await transformFile('./css/styles.css');
+ * console.log(result.code);
+ * ```
+ */
+async function transformFile(file, options = {}) {
+    return getStream(file).then(stream => transform(stream, { src: file, ...options }));
+}
+/**
+ * transform css
+ * @param css
+ * @param options
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ * import {transform} from '@tbela99/css-parser';
+ *
+ *  // css string
+ *  let result = await transform(css);
+ *  console.log(result.code);
+ * ```
+ *
+ * Example using stream
+ *
+ * ```ts
+ *
+ * import {transform} from '@tbela99/css-parser';
+ * import {Readable} from "node:stream";
+ *
+ * // usage: node index.ts < styles.css or cat styles.css | node index.ts
+ *
+ *  const readableStream = Readable.toWeb(process.stdin);
+ *  const result = await transform(readableStream, {beautify: true});
+ *
+ *  console.log(result.code);
+ * ```
+ *
+ * Example using fetch
+ *
+ * ```ts
+ *
+ *  import {transform} from '@tbela99/css-parser';
+ *
+ *  const response = await fetch('https://docs.deno.com/styles.css');
+ *  result = await transform(response.body, {beautify: true});
+ *
+ *  console.log(result.code);
+ * ```
+ */
+async function transform(css, options = {}) {
+    options = { minify: true, removeEmpty: true, removeCharset: true, ...options };
+    const startTime = performance.now();
+    return parse(css, options).then((parseResult) => {
+        const rendered = render(parseResult.ast, options);
+        return {
+            ...parseResult,
+            ...rendered,
+            errors: parseResult.errors.concat(rendered.errors),
+            stats: {
+                bytesOut: rendered.code.length,
+                ...parseResult.stats,
+                render: rendered.stats.total,
+                total: `${(performance.now() - startTime).toFixed(2)}ms`
+            }
+        };
+    });
+}
+
+export { dirname, getStream, parse, parseFile, render, resolve, transform, transformFile };

package/dist/web.js

@@ -0,0 +1,158 @@
+export { ColorType, EnumToken, ValidationLevel } from './lib/ast/types.js';
+export { minify } from './lib/ast/minify.js';
+export { WalkerOptionEnum, WalkerValueEvent, walk, walkValues } from './lib/ast/walk.js';
+export { expand } from './lib/ast/expand.js';
+import { doRender } from './lib/renderer/render.js';
+export { renderToken } from './lib/renderer/render.js';
+export { SourceMap } from './lib/renderer/sourcemap/sourcemap.js';
+import { doParse } from './lib/parser/parse.js';
+export { parseDeclarations, parseString, parseTokens } from './lib/parser/parse.js';
+import { tokenizeStream, tokenize } from './lib/parser/tokenize.js';
+import './lib/parser/utils/config.js';
+export { convertColor } from './lib/syntax/color/color.js';
+import './lib/syntax/color/utils/constants.js';
+export { isOkLabClose, okLabDistance } from './lib/syntax/color/utils/distance.js';
+import './lib/validation/config.js';
+import './lib/validation/parser/types.js';
+import './lib/validation/parser/parse.js';
+import './lib/validation/syntaxes/complex-selector.js';
+import './lib/validation/syntax.js';
+import { matchUrl, resolve, dirname } from './lib/fs/resolve.js';
+export { FeatureWalkMode } from './lib/ast/features/type.js';
+
+/**
+ * web module entry point
+ * @module web
+ */
+/**
+ * load file or url as stream
+ * @param url
+ * @param currentFile
+ *
+ * @private
+ */
+async function getStream(url, currentFile = '.') {
+    let t;
+    if (matchUrl.test(url)) {
+        t = new URL(url);
+    }
+    else if (currentFile != null && matchUrl.test(currentFile)) {
+        t = new URL(url, currentFile);
+    }
+    else {
+        const path = resolve(url, currentFile).absolute;
+        // @ts-ignore
+        t = new URL(path, self.origin);
+    }
+    // @ts-ignore
+    return fetch(t, t.origin != self.origin ? { mode: 'cors' } : {}).then((response) => {
+        if (!response.ok) {
+            throw new Error(`${response.status} ${response.statusText} ${response.url}`);
+        }
+        return response.body;
+    });
+}
+/**
+ * render ast node
+ * @param data
+ * @param options
+ */
+function render(data, options = {}) {
+    return doRender(data, Object.assign(options, {
+        getStream,
+        resolve,
+        dirname,
+        cwd: options.cwd ?? self.location.pathname.endsWith('/') ? self.location.pathname : dirname(self.location.pathname)
+    }));
+}
+/**
+ * parse css file
+ * @param file url or path
+ * @param options
+ */
+async function parseFile(file, options = {}) {
+    return getStream(file).then(stream => parse(stream, { src: file, ...options }));
+}
+/**
+ * parse css
+ * @param stream
+ * @param opt
+ */
+async function parse(stream, opt = {}) {
+    return doParse(stream instanceof ReadableStream ? tokenizeStream(stream) : tokenize({
+        stream,
+        buffer: '',
+        position: { ind: 0, lin: 1, col: 1 },
+        currentPosition: { ind: -1, lin: 1, col: 0 }
+    }), Object.assign(opt, {
+        getStream,
+        resolve,
+        dirname,
+        cwd: opt.cwd ?? self.location.pathname.endsWith('/') ? self.location.pathname : dirname(self.location.pathname)
+    }));
+}
+/**
+ * transform css file
+ * @param file url or path
+ * @param options
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ * import {transformFile} from '@tbela99/css-parser/web';
+ *
+ * // remote file
+ * let result = await transformFile('https://docs.deno.com/styles.css');
+ * console.log(result.code);
+ *
+ * // local file
+ * result = await transformFile('./css/styles.css');
+ * console.log(result.code);
+ * ```
+ */
+async function transformFile(file, options = {}) {
+    return getStream(file).then(stream => transform(stream, { src: file, ...options }));
+}
+/**
+ * transform css
+ * @param css
+ * @param options
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ *  import {transform} from '@tbela99/css-parser/web';
+ *
+ *  // css string
+ *  let result = await transform(css);
+ *  console.log(result.code);
+ *
+ *  // using readable stream
+ *  const response = await fetch('https://docs.deno.com/styles.css');
+ *  result = await transform(response.body, {beautify: true});
+ *
+ *  console.log(result.code);
+ * ```
+ */
+async function transform(css, options = {}) {
+    options = { minify: true, removeEmpty: true, removeCharset: true, ...options };
+    const startTime = performance.now();
+    return parse(css, options).then((parseResult) => {
+        const rendered = render(parseResult.ast, options);
+        return {
+            ...parseResult,
+            ...rendered,
+            errors: parseResult.errors.concat(rendered.errors),
+            stats: {
+                bytesOut: rendered.code.length,
+                ...parseResult.stats,
+                render: rendered.stats.total,
+                total: `${(performance.now() - startTime).toFixed(2)}ms`
+            }
+        };
+    });
+}
+
+export { dirname, getStream, parse, parseFile, render, resolve, transform, transformFile };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@tbela99/css-parser",
   "description": "CSS parser for node and the browser",
-  "version": "v1.2.0",
+  "version": "v1.3.1",
   "exports": {
-    ".": "./dist/node/index.js",
-    "./node": "./dist/node/index.js",
+    ".": "./dist/node.js",
+    "./node": "./dist/node.js",
     "./umd": "./dist/index-umd-web.js",
-    "./web": "./dist/web/index.js",
+    "./web": "./dist/web.js",
     "./cjs": "./dist/index.cjs"
   },
   "type": "module",
@@ -15,10 +15,11 @@
     "test": "test"
   },
   "scripts": {
+    "doc": "typedoc --tsconfig typedoc-tsconfig.jsonc",
     "build": "rollup -c;./build.sh dist/index.d.ts 'declare interface' 'declare type'",
-    "test": "web-test-runner \"test/**/web.spec.js\" --node-resolve --playwright --browsers chromium firefox webkit --root-dir=.; mocha --reporter-options='maxDiffSize=1801920' --timeout=10000 \"test/**/node.spec.js\"",
-    "test:web": "web-test-runner \"test/**/web.spec.js\" --node-resolve --playwright --browsers chromium firefox webkit --root-dir=.",
-    "test:node": "mocha --reporter-options='maxDiffSize=1801920' \"test/**/node.spec.js\"",
+    "test": "web-test-runner \"test/**/web.spec.js\" --timeout=10000 --node-resolve --playwright --browsers chromium firefox webkit --root-dir=.; mocha --reporter-options='maxDiffSize=1801920' --timeout=10000 \"test/**/node.spec.js\"",
+    "test:web": "web-test-runner \"test/**/web.spec.js\" --timeout 30000 --node-resolve --playwright --browsers chromium firefox webkit --root-dir=.",
+    "test:node": "mocha -p --reporter-options='maxDiffSize=1801920' --timeout=10000 \"test/**/node.spec.js\"",
     "test:cov": "c8 -x 'test/specs/**/*.js' --reporter=html --reporter=text --reporter=json-summary mocha --reporter-options='maxDiffSize=1801920' --timeout=10000 \"test/**/node.spec.js\"",
     "test:web-cov": "web-test-runner -x 'test/specs/**/*.js' \"test/**/web.spec.js\" --node-resolve --playwright --browsers chromium firefox webkit --root-dir=. --coverage",
     "profile": "node --enable-source-maps --inspect-brk test/inspect.js",
@@ -65,9 +66,11 @@
     "c8": "^10.1.3",
     "esno": "^4.8.0",
     "mocha": "^11.7.1",
-    "playwright": "^1.54.1",
-    "rollup": "^4.45.1",
+    "playwright": "^1.55.0",
+    "rollup": "^4.48.0",
     "rollup-plugin-dts": "^6.2.1",
-    "tslib": "^2.8.1"
+    "tslib": "^2.8.1",
+    "typedoc": "^0.28.10",
+    "typedoc-material-theme": "^1.4.0"
   }
-}
+}

package/dist/node/index.js

@@ -1,57 +0,0 @@
-import process from 'node:process';
-export { ColorType, EnumToken, ValidationLevel } from '../lib/ast/types.js';
-export { minify } from '../lib/ast/minify.js';
-export { walk, walkValues } from '../lib/ast/walk.js';
-export { expand } from '../lib/ast/expand.js';
-import { doRender } from '../lib/renderer/render.js';
-export { renderToken } from '../lib/renderer/render.js';
-import '../lib/syntax/color/utils/constants.js';
-export { convertColor } from '../lib/syntax/color/color.js';
-export { isOkLabClose, okLabDistance } from '../lib/syntax/color/utils/distance.js';
-import { doParse } from '../lib/parser/parse.js';
-export { parseString, parseTokens } from '../lib/parser/parse.js';
-import '../lib/parser/tokenize.js';
-import '../lib/parser/utils/config.js';
-import '../lib/validation/config.js';
-import '../lib/validation/parser/types.js';
-import '../lib/validation/parser/parse.js';
-import '../lib/validation/syntaxes/complex-selector.js';
-import '../lib/validation/syntax.js';
-import { dirname, resolve } from '../lib/fs/resolve.js';
-import { load } from './load.js';
-
-/**
- * render ast node
- */
-function render(data, options = {}) {
-    return doRender(data, Object.assign(options, { load, resolve, dirname, cwd: options.cwd ?? process.cwd() }));
-}
-/**
- * parse css
- */
-async function parse(iterator, opt = {}) {
-    return doParse(iterator, Object.assign(opt, { load, resolve, dirname, cwd: opt.cwd ?? process.cwd() }));
-}
-/**
- * parse and render css
- */
-async function transform(css, options = {}) {
-    options = { minify: true, removeEmpty: true, removeCharset: true, ...options };
-    const startTime = performance.now();
-    return parse(css, options).then((parseResult) => {
-        const rendered = render(parseResult.ast, options);
-        return {
-            ...parseResult,
-            ...rendered,
-            errors: parseResult.errors.concat(rendered.errors),
-            stats: {
-                bytesOut: rendered.code.length,
-                ...parseResult.stats,
-                render: rendered.stats.total,
-                total: `${(performance.now() - startTime).toFixed(2)}ms`
-            }
-        };
-    });
-}
-
-export { dirname, load, parse, render, resolve, transform };

package/dist/node/load.js

@@ -1,20 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { resolve, matchUrl } from '../lib/fs/resolve.js';
-
-function parseResponse(response) {
-    if (!response.ok) {
-        throw new Error(`${response.status} ${response.statusText} ${response.url}`);
-    }
-    return response.text();
-}
-/**
- * load file
- * @param url
- * @param currentFile
- */
-async function load(url, currentFile = '.') {
-    const resolved = resolve(url, currentFile);
-    return matchUrl.test(resolved.absolute) ? fetch(resolved.absolute).then(parseResponse) : readFile(resolved.absolute, { encoding: 'utf-8' });
-}
-
-export { load };

package/dist/web/index.js

@@ -1,66 +0,0 @@
-export { ColorType, EnumToken, ValidationLevel } from '../lib/ast/types.js';
-export { minify } from '../lib/ast/minify.js';
-export { walk, walkValues } from '../lib/ast/walk.js';
-export { expand } from '../lib/ast/expand.js';
-import { doRender } from '../lib/renderer/render.js';
-export { renderToken } from '../lib/renderer/render.js';
-import '../lib/syntax/color/utils/constants.js';
-export { convertColor } from '../lib/syntax/color/color.js';
-export { isOkLabClose, okLabDistance } from '../lib/syntax/color/utils/distance.js';
-import { doParse } from '../lib/parser/parse.js';
-export { parseString, parseTokens } from '../lib/parser/parse.js';
-import '../lib/parser/tokenize.js';
-import '../lib/parser/utils/config.js';
-import '../lib/validation/config.js';
-import '../lib/validation/parser/types.js';
-import '../lib/validation/parser/parse.js';
-import '../lib/validation/syntaxes/complex-selector.js';
-import '../lib/validation/syntax.js';
-import { dirname, resolve } from '../lib/fs/resolve.js';
-import { load } from './load.js';
-
-/**
- * render ast node
- */
-function render(data, options = {}) {
-    return doRender(data, Object.assign(options, {
-        load,
-        resolve,
-        dirname,
-        cwd: options.cwd ?? self.location.pathname.endsWith('/') ? self.location.pathname : dirname(self.location.pathname)
-    }));
-}
-/**
- * parse css
- */
-async function parse(iterator, opt = {}) {
-    return doParse(iterator, Object.assign(opt, {
-        load,
-        resolve,
-        dirname,
-        cwd: opt.cwd ?? self.location.pathname.endsWith('/') ? self.location.pathname : dirname(self.location.pathname)
-    }));
-}
-/**
- * parse and render css
- */
-async function transform(css, options = {}) {
-    options = { minify: true, removeEmpty: true, removeCharset: true, ...options };
-    const startTime = performance.now();
-    return parse(css, options).then((parseResult) => {
-        const rendered = render(parseResult.ast, options);
-        return {
-            ...parseResult,
-            ...rendered,
-            errors: parseResult.errors.concat(rendered.errors),
-            stats: {
-                bytesOut: rendered.code.length,
-                ...parseResult.stats,
-                render: rendered.stats.total,
-                total: `${(performance.now() - startTime).toFixed(2)}ms`
-            }
-        };
-    });
-}
-
-export { dirname, load, parse, render, resolve, transform };

package/dist/web/load.js

@@ -1,31 +0,0 @@
-import { matchUrl, resolve } from '../lib/fs/resolve.js';
-
-function parseResponse(response) {
-    if (!response.ok) {
-        throw new Error(`${response.status} ${response.statusText} ${response.url}`);
-    }
-    return response.text();
-}
-/**
- * load file
- * @param url
- * @param currentFile
- */
-async function load(url, currentFile) {
-    let t;
-    if (matchUrl.test(url)) {
-        t = new URL(url);
-    }
-    else if (matchUrl.test(currentFile)) {
-        t = new URL(url, currentFile);
-    }
-    else {
-        const path = resolve(url, currentFile).absolute;
-        // @ts-ignore
-        t = new URL(path, self.origin);
-    }
-    // @ts-ignore
-    return fetch(t, t.origin != self.origin ? { mode: 'cors' } : {}).then(parseResponse);
-}
-
-export { load };