@tbela99/css-parser 1.4.1 → 1.4.3

package/dist/web.d.ts

@@ -0,0 +1,169 @@
+import type { AstNode, ParseResult, ParserOptions, RenderOptions, RenderResult, TransformOptions, TransformResult } from "./@types/index.d.ts";
+import { dirname, resolve } from "./lib/fs/resolve.ts";
+import { ResponseType } from "./types.ts";
+export type * from "./@types/index.d.ts";
+export type * from "./@types/ast.d.ts";
+export type * from "./@types/token.d.ts";
+export type * from "./@types/parse.d.ts";
+export type * from "./@types/validation.d.ts";
+export type * from "./@types/walker.d.ts";
+export type { AstNode, ParseResult, ParserOptions, RenderOptions, RenderResult, TransformOptions, TransformResult, } from "./@types/index.d.ts";
+export { minify } from "./lib/ast/minify.ts";
+export { expand } from "./lib/ast/expand.ts";
+export { walk, walkValues, WalkerEvent, WalkerOptionEnum } from "./lib/ast/walk.ts";
+export { parseString } from "./lib/parser/parse.ts";
+export { renderToken } from "./lib/renderer/render.ts";
+export { convertColor } from "./lib/syntax/color/color.ts";
+export { isOkLabClose, okLabDistance } from "./lib/syntax/color/utils/distance.ts";
+export { parseDeclarations } from "./lib/parser/parse.ts";
+export { find, findLast, findByValue, findAll } from "./lib/ast/find.ts";
+export { cloneNode } from "./lib/ast/clone.ts";
+export { EnumToken, ColorType, ValidationLevel, ModuleScopeEnumOptions, ModuleCaseTransformEnum, } from "./lib/ast/types.ts";
+export { SourceMap } from "./lib/renderer/sourcemap/sourcemap.ts";
+export type { ValidationToken } from "./lib/validation/parser/types.d.ts";
+export { FeatureWalkMode } from "./lib/ast/features/type.ts";
+export { dirname, resolve, ResponseType };
+/**
+ * load file or url
+ * @param url
+ * @param currentDirectory
+ * @param responseType
+ * @throws Error file not found
+ *
+ * ```ts
+ * import {load, ResponseType} from '@tbela99/css-parser';
+ * const result = await load(file, '.', ResponseType.ArrayBuffer) as ArrayBuffer;
+ * ```
+ */
+export declare function load(url: string, currentDirectory?: string, responseType?: boolean | ResponseType): Promise<string | ArrayBuffer | ReadableStream<Uint8Array<ArrayBufferLike>>>;
+/**
+ * render the ast tree
+ * @param data
+ * @param options
+ * @param mapping
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ *  import {render, ColorType} from '@tbela99/css-parser';
+ *
+ *  const css = 'body { color: color(from hsl(0 100% 50%) xyz x y z); }';
+ *  const parseResult = await parse(css);
+ *
+ * let renderResult = render(parseResult.ast);
+ * console.log(result.code);
+ *
+ * // body{color:red}
+ *
+ *
+ * renderResult = render(parseResult.ast, {beautify: true, convertColor: ColorType.SRGB});
+ * console.log(renderResult.code);
+ *
+ * // body {
+ * //  color: color(srgb 1 0 0)
+ * // }
+ * ```
+ */
+export declare function render(data: AstNode, options?: RenderOptions, mapping?: {
+    mapping: Record<string, string>;
+    importMapping: Record<string, Record<string, string>> | null;
+} | null): RenderResult;
+/**
+ * parse css file
+ * @param file url or path
+ * @param options
+ * @param asStream load file as stream
+ *
+ * @throws Error file not found
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ *  import {parseFile} from '@tbela99/css-parser/web';
+ *
+ *  // 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);
+ * ```
+ */
+export declare function parseFile(file: string, options?: ParserOptions, asStream?: boolean): Promise<ParseResult>;
+/**
+ * parse css
+ * @param stream
+ * @param options
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ * import {parse} from '@tbela99/css-parser/web';
+ *
+ *  // css string
+ *  const result = await parse(css);
+ *  console.log(result.ast);
+ * ```
+ *
+ * Example using fetch and readable stream
+ *
+ * ```ts
+ *
+ *  import {parse} from '@tbela99/css-parser/web';
+ *
+ *  const response = await fetch('https://docs.deno.com/styles.css');
+ *  const result = await parse(response.body, {beautify: true});
+ *
+ *  console.log(result.ast);
+ * ```
+ */
+export declare function parse(stream: string | ReadableStream<Uint8Array>, options?: ParserOptions): Promise<ParseResult>;
+/**
+ * transform css file
+ * @param file url or path
+ * @param options
+ * @param asStream load file as stream
+ *
+ * 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);
+ * ```
+ */
+export declare function transformFile(file: string, options?: TransformOptions, asStream?: boolean): Promise<TransformResult>;
+/**
+ * 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);
+ * ```
+ */
+export declare function transform(css: string | ReadableStream<Uint8Array>, options?: TransformOptions): Promise<TransformResult>;

package/dist/web.js

@@ -1,57 +1,57 @@
+import { doParse } from './lib/parser/parse.js';
+export { parseDeclarations, parseString } from './lib/parser/parse.js';
+import { doRender } from './lib/renderer/render.js';
+export { renderToken } from './lib/renderer/render.js';
 import { ModuleScopeEnumOptions } from './lib/ast/types.js';
 export { ColorType, EnumToken, ModuleCaseTransformEnum, ValidationLevel } from './lib/ast/types.js';
+import { tokenizeStream, tokenize } from './lib/parser/tokenize.js';
+import { matchUrl, resolve, dirname } from './lib/fs/resolve.js';
+import { ResponseType } from './types.js';
 export { minify } from './lib/ast/minify.js';
-export { WalkerEvent, WalkerOptionEnum, 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 { WalkerEvent, WalkerOptionEnum, walk, walkValues } from './lib/ast/walk.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/parse.js';
-import './lib/validation/syntaxes/complex-selector.js';
-import './lib/validation/syntax.js';
-import { matchUrl, resolve, dirname } from './lib/fs/resolve.js';
-import { ResponseType } from './types.js';
+export { find, findAll, findByValue, findLast } from './lib/ast/find.js';
+export { cloneNode } from './lib/ast/clone.js';
+export { SourceMap } from './lib/renderer/sourcemap/sourcemap.js';
 export { FeatureWalkMode } from './lib/ast/features/type.js';
 
 /**
- * default file or url loader
+ * load file or url
  * @param url
- * @param currentFile
- *
+ * @param currentDirectory
  * @param responseType
- * @private
+ * @throws Error file not found
+ *
+ * ```ts
+ * import {load, ResponseType} from '@tbela99/css-parser';
+ * const result = await load(file, '.', ResponseType.ArrayBuffer) as ArrayBuffer;
+ * ```
  */
-async function load(url, currentFile = '.', responseType = false) {
-    if (typeof responseType == 'boolean') {
+async function load(url, currentDirectory = ".", responseType = false) {
+    if (typeof responseType == "boolean") {
         responseType = responseType ? ResponseType.ReadableStream : ResponseType.Text;
     }
     let t;
     if (matchUrl.test(url)) {
         t = new URL(url);
     }
-    else if (currentFile != null && matchUrl.test(currentFile)) {
-        t = new URL(url, currentFile);
+    else if (currentDirectory != null && matchUrl.test(currentDirectory)) {
+        t = new URL(url, currentDirectory);
     }
     else {
-        const path = resolve(url, currentFile).absolute;
+        const path = resolve(url, currentDirectory).absolute;
         t = new URL(path, self.origin);
     }
-    return fetch(t, t.origin != self.origin ? { mode: 'cors' } : {}).then(async (response) => {
+    return fetch(t, t.origin != self.origin ? { mode: "cors" } : {}).then(async (response) => {
         if (!response.ok) {
             throw new Error(`${response.status} ${response.statusText} ${response.url}`);
         }
         if (responseType == ResponseType.ArrayBuffer) {
             return response.arrayBuffer();
         }
-        return responseType == ResponseType.ReadableStream ? response.body : await response.text();
+        return responseType == ResponseType.ReadableStream ? response.body : response.text();
     });
 }
 /**
@@ -87,7 +87,9 @@ function render(data, options = {}, mapping) {
     return doRender(data, Object.assign(options, {
         resolve,
         dirname,
-        cwd: options.cwd ?? self.location.pathname.endsWith('/') ? self.location.pathname : dirname(self.location.pathname)
+        cwd: (options.cwd ?? self.location.pathname.endsWith("/"))
+            ? self.location.pathname
+            : dirname(self.location.pathname),
     }), mapping);
 }
 /**
@@ -114,7 +116,7 @@ function render(data, options = {}, mapping) {
  * ```
  */
 async function parseFile(file, options = {}, asStream = false) {
-    return Promise.resolve((options.load ?? load)(file, '.', asStream)).then(stream => parse(stream, { src: file, ...options }));
+    return Promise.resolve((options.load ?? load)(file, ".", asStream)).then((stream) => parse(stream, { src: file, ...options }));
 }
 /**
  * parse css
@@ -145,18 +147,23 @@ async function parseFile(file, options = {}, asStream = false) {
  * ```
  */
 async function parse(stream, options = {}) {
-    return doParse(stream instanceof ReadableStream ? tokenizeStream(stream) : tokenize({
+    options.parseInfo = {
         stream,
-        buffer: '',
+        buffer: "",
         offset: 0,
-        position: { ind: 0, lin: 1, col: 1 },
-        currentPosition: { ind: -1, lin: 1, col: 0 }
-    }), Object.assign(options, {
+        time: 0,
+        src: options.src ?? "",
+        position: { ind: 0, lin: 1, col: 0 },
+        currentPosition: { ind: -1, lin: 1, col: 0 },
+    };
+    return doParse(stream instanceof ReadableStream ? tokenizeStream(stream) : tokenize(options.parseInfo), Object.assign(options, {
         load,
         resolve,
         dirname,
-        cwd: options.cwd ?? self.location.pathname.endsWith('/') ? self.location.pathname : dirname(self.location.pathname)
-    })).then(result => {
+        cwd: (options.cwd ?? self.location.pathname.endsWith("/"))
+            ? self.location.pathname
+            : dirname(self.location.pathname),
+    })).then((result) => {
         const { revMapping, ...res } = result;
         return res;
     });
@@ -183,7 +190,7 @@ async function parse(stream, options = {}) {
  * ```
  */
 async function transformFile(file, options = {}, asStream = false) {
-    return Promise.resolve((options.load ?? load)(file, '.', asStream)).then(stream => transform(stream, { src: file, ...options }));
+    return Promise.resolve((options.load ?? load)(file, ".", asStream)).then((stream) => transform(stream, { src: file, ...options }));
 }
 /**
  * transform css
@@ -213,18 +220,20 @@ async function transform(css, options = {}) {
     return parse(css, options).then((parseResult) => {
         let mapping = null;
         let importMapping = null;
-        if (typeof options.module == 'number' && (options.module & ModuleScopeEnumOptions.ICSS)) {
+        if (typeof options.module == "number" && options.module & ModuleScopeEnumOptions.ICSS) {
             mapping = parseResult.mapping;
             importMapping = parseResult.importMapping;
         }
-        else if (typeof options.module == 'object' && typeof options.module.scoped == 'number' && (options.module.scoped & ModuleScopeEnumOptions.ICSS)) {
+        else if (typeof options.module == "object" &&
+            typeof options.module.scoped == "number" &&
+            options.module.scoped & ModuleScopeEnumOptions.ICSS) {
             mapping = parseResult.mapping;
             importMapping = parseResult.importMapping;
         }
         // ast already expanded by parse
         const rendered = render(parseResult.ast, {
             ...options,
-            expandNestingRules: false
+            expandNestingRules: false,
         }, mapping != null ? { mapping, importMapping } : null);
         return {
             ...parseResult,
@@ -234,8 +243,8 @@ async function transform(css, options = {}) {
                 bytesOut: rendered.code.length,
                 ...parseResult.stats,
                 render: rendered.stats.total,
-                total: `${(performance.now() - startTime).toFixed(2)}ms`
-            }
+                total: `${(performance.now() - startTime).toFixed(2)}ms`,
+            },
         };
     });
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tbela99/css-parser",
   "description": "CSS parser, minifier and validator for node and the browser",
-  "version": "v1.4.1",
+  "version": "1.4.3",
   "exports": {
     ".": "./dist/node.js",
     "./node": "./dist/node.js",
@@ -16,6 +16,8 @@
   "scripts": {
     "doc": "typedoc --tsconfig typedoc-tsconfig.jsonc",
     "build": "rollup -c;./build.sh ./dist/index.d.ts 'declare interface' 'declare type'",
+    "watch": "rollup -c -w",
+    "test:watch": "web-test-runner \"./test/**/web.spec.js\" --timeout 30000 --node-resolve --playwright --browsers chromium firefox webkit --root-dir=. --watch",
     "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\"",
@@ -32,6 +34,8 @@
   "keywords": [
     "parser",
     "css",
+    "modules",
+    "css-modules",
     "css-parser",
     "node",
     "ast",
@@ -48,31 +52,32 @@
     "streaming-parser"
   ],
   "author": "Thierry Bela",
-  "license": "MIT OR LGPL-3.0",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/tbela99/css-parser/issues"
   },
   "homepage": "https://github.com/tbela99/css-parser#readme",
   "devDependencies": {
     "@esm-bundle/chai": "^4.3.4-fix.0",
-    "@rollup/plugin-commonjs": "^28.0.8",
+    "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/chai": "^5.2.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.9.1",
-    "@types/web": "^0.0.274",
+    "@types/node": "^25.9.3",
+    "@types/web": "^0.0.350",
     "@web/test-runner": "^0.20.2",
     "@web/test-runner-playwright": "^0.11.1",
-    "c8": "^10.1.3",
+    "c8": "^11.0.0",
     "esno": "^4.8.0",
-    "mocha": "^11.7.4",
-    "playwright": "^1.56.1",
-    "rollup": "^4.52.5",
-    "rollup-plugin-dts": "^6.2.3",
+    "mocha": "^11.7.6",
+    "playwright": "^1.60.0",
+    "rollup": "^4.61.1",
+    "rollup-plugin-dts": "^6.4.1",
     "tslib": "^2.8.1",
-    "typedoc": "^0.28.14",
-    "typedoc-material-theme": "^1.4.0"
-  }
+    "typedoc": "^0.28.19",
+    "typedoc-material-theme": "^1.4.1"
+  },
+  "sideEffects": false
 }