@tbela99/css-parser 1.4.2 → 1.4.3

package/dist/index.d.ts

@@ -369,7 +369,7 @@ declare enum EnumToken {
     /**
      * invalid rule token type
      */
-    InvalidRuleTokenType = 81,
+    InvalidRuleNodeType = 81,
     /**
      * invalid class selector token type
      */
@@ -381,7 +381,7 @@ declare enum EnumToken {
     /**
      * invalid at rule token type
      */
-    InvalidAtRuleTokenType = 84,
+    InvalidAtRuleNodeType = 84,
     /**
      * media query condition token type
      */
@@ -393,19 +393,19 @@ declare enum EnumToken {
     /**
      * media feature only token type
      */
-    MediaFeatureOnlyTokenType = 87,
+    OnlyTokenType = 87,
     /**
      * media feature not token type
      */
-    MediaFeatureNotTokenType = 88,
+    NotTokenType = 88,
     /**
      * media feature and token type
      */
-    MediaFeatureAndTokenType = 89,
+    AndTokenType = 89,
     /**
      * media feature or token type
      */
-    MediaFeatureOrTokenType = 90,
+    OrTokenType = 90,
     /**
      * pseudo page token type
      */
@@ -438,6 +438,172 @@ declare enum EnumToken {
      * css variable declaration map token type
      */
     CssVariableDeclarationMapTokenType = 98,
+    /**
+     * media range query token type
+     */
+    MediaRangeQueryTokenType = 99,
+    /**
+     * invalid media query token type
+     */
+    InvalidMediaQueryTokenType = 100,
+    /**
+     * supports query condition token type
+     */
+    SupportsQueryConditionTokenType = 101,
+    /**
+     * supports query unary condition token type
+     */
+    SupportsQueryUnaryConditionTokenType = 102,
+    /**
+     * when else query condition token type
+     */
+    WhenElseQueryConditionTokenType = 103,
+    /**
+     * when else query unary condition token type
+     */
+    WhenElseUnaryConditionTokenType = 104,
+    /**
+     * container style range token type
+     */
+    ContainerStyleRangeTokenType = 105,
+    /**
+     * '*'
+     */
+    Star = 106,
+    /**
+     * '+'
+     */
+    Plus = 107,
+    /**
+     * '~'
+     */
+    Tilda = 108,
+    /**
+     * '|'
+     */
+    Pipe = 109,
+    /**
+     * '::'
+     */
+    DoubleColonTokenType = 110,
+    /**
+     * math function token type  such as'calc(' etc.
+     */
+    MathFunctionTokenType = 111,
+    /**
+     * transform function token type such as 'translate(' etc.
+     */
+    TransformFunctionTokenType = 112,
+    /**
+     * when function token type such as 'supports(' etc.
+     */
+    WhenElseFunctionTokenType = 113,
+    /**
+     * general enclosed function token type 'font-tech(' etc.
+     */
+    GeneralEnclosedFunctionTokenType = 114,
+    /**
+     * supports function token type such as 'at-rule('
+     */
+    SupportsFunctionTokenType = 115,
+    /**
+     * container function token type such as 'style(' or 'scroll-state('
+     */
+    ContainerFunctionTokenType = 116,
+    /**
+     * unrecognized node token type
+     */
+    RawNodeTokenType = 117,
+    /**
+     * media query boolean token type
+     * @media not ()
+     * @media only ()
+     */
+    MediaQueryUnaryFeatureTokenType = 118,
+    /**
+     * grid template function token type such as 'minmax('
+     */
+    GridTemplateFuncTokenDefType = 119,
+    /**
+     * image function token type such as 'image(' etc.
+     */
+    ImageFunctionTokenDefType = 120,
+    /**
+     * function token type such as 'view(' etc.
+     */
+    TimelineFunctionTokenDefType = 121,
+    /**
+     * function token type
+     */
+    FunctionTokenDefType = 122,
+    /**
+     * timing function token type such as 'linear(' etc.
+     */
+    TimingFunctionTokenDefType = 123,
+    /**
+     * color function token type such as 'rgb(' etc.
+     */
+    ColorFunctionTokenDefType = 124,
+    /**
+     * math function token type such as 'calc(' etc.
+     */
+    MathFunctionTokenDefType = 125,
+    /**
+     * container function token type such as 'style(' or 'scroll-state('
+     */
+    ContainerFunctionTokenDefType = 126,
+    /**
+     * url function token type 'url('
+     */
+    UrlFunctionTokenDefType = 127,
+    /**
+     * pseudo-class function token type
+     */
+    PseudoClassFunctionTokenDefType = 128,
+    /**
+     * transform function token type such as 'translate(' etc.
+     */
+    TransformFunctionTokenDefType = 129,
+    /**
+     * when function token type such as 'supports(' or 'media('
+     */
+    WhenElseFunctionTokenDefType = 130,
+    /**
+     * general enclosed function token type 'font-tech(' etc.
+     */
+    GeneralEnclosedFunctionTokenDefType = 131,
+    /**
+     * supports function token type 'font-tech('
+     */
+    SupportsFunctionTokenDefType = 132,
+    /**
+     *  CDOCOMMTokenType not allowed in this context
+     */
+    InvalidCommentTokenType = 133,
+    /**
+     * custom function token type '--function-name('
+     */
+    CustomFunctionTokenDefType = 134,
+    /**
+     * custom function token type
+     */
+    CustomFunctionTokenType = 135,
+    /**
+     * function tokens such as 'var(', 'env(', 'if(')
+     */
+    WildCardFunctionTokenDefType = 136,
+    /**
+     * function such as 'var()', 'env()', 'if()'
+     */
+    WildCardFunctionTokenType = 137,
+    /**
+     * if condition token
+     */
+    IfConditionTokenType = 138,
+    /**
+     * if-Else condition token
+     */
+    IfElseConditionTokenType = 139,
     /**
      * alias for time token type
      */
@@ -550,7 +716,7 @@ declare enum EnumToken {
 /**
  * supported color types enum
  */
-declare enum ColorType {
+declare enum ColorType$1 {
     /**
      * deprecated system colors
      */
@@ -572,31 +738,31 @@ declare enum ColorType {
      */
     RGBA = 4,
     /**
-     * colors as hsl values
+     * colors using rgb
      */
     HSLA = 5,
     /**
-     * colors as hwb values
+     * colors using hwb
      */
     HWB = 6,
     /**
-     * colors as cmyk values
+     * colors using cmyk
      */
     CMYK = 7,
     /**
-     * colors as oklab values
+     * colors using oklab
      * */
     OKLAB = 8,
     /**
-     * colors as oklch values
+     * colors using oklch
      * */
     OKLCH = 9,
     /**
-     * colors as lab values
+     * colors using lab
      */
     LAB = 10,
     /**
-     * colors as lch values
+     * colors using lch
      */
     LCH = 11,
     /**
@@ -604,35 +770,35 @@ declare enum ColorType {
      */
     COLOR = 12,
     /**
-     * color using srgb values
+     * color using srgb
      */
     SRGB = 13,
     /**
-     * color using prophoto-rgb values
+     * color using prophoto-rgb
      */
     PROPHOTO_RGB = 14,
     /**
-     * color using a98-rgb values
+     * color using a98-rgb
      */
     A98_RGB = 15,
     /**
-     * color using rec2020 values
+     * color using rec2020
      */
     REC2020 = 16,
     /**
-     * color using display-p3 values
+     * color using display-p3
      */
     DISPLAY_P3 = 17,
     /**
-     * color using srgb-linear values
+     * color using srgb-linear
      */
     SRGB_LINEAR = 18,
     /**
-     * color using xyz-d50 values
+     * color using xyz-d50
      */
     XYZ_D50 = 19,
     /**
-     * color using xyz-d65 values
+     * color using xyz-d65
      */
     XYZ_D65 = 20,
     /**
@@ -643,6 +809,14 @@ declare enum ColorType {
      * color-mix() color function
      */
     COLOR_MIX = 22,
+    /**
+     * non-standard color
+     */
+    NON_STD = 23,
+    /**
+     * custom color
+     */
+    CUSTOM_COLOR = 24,
     /**
      * alias for rgba
      */
@@ -698,421 +872,161 @@ declare enum ModuleScopeEnumOptions {
     /**
      * export using ICSS module format
      */
-    ICSS = 256
+    ICSS = 256,
+    /**
+     * use the shortest name possible. pattern is ignored.
+     * it will produce names such as
+     *
+     * ```css
+     *  .a {
+     *      content: 'a';
+     *  }
+     *
+     *  .b {
+     *      content: 'b';
+     *  }
+     *
+     *  .c {
+     *      content: 'c';
+     *  }
+     *  ...
+     * ```
+     */
+    Shortest = 512
 }
 
 /**
- * apply minification rules to the ast tree
- * @param ast
- * @param options
- * @param recursive
- * @param errors
- * @param nestingContent
- *
- * @private
+ * Literal token
  */
-declare function minify(ast: AstNode$1, options: ParserOptions | MinifyFeatureOptions, recursive: boolean, errors?: ErrorDescription[], nestingContent?: boolean): AstNode$1;
+declare interface LiteralToken extends BaseToken {
+    typ: EnumToken.LiteralTokenType;
+    val: string;
+}
 
 /**
- * options for the walk function
+ * Class selector token
  */
-declare enum WalkerOptionEnum {
-    /**
-     * ignore the current node and its children
-     */
-    Ignore = 1,
-    /**
-     * stop walking the tree
-     */
-    Stop = 2,
-    /**
-     * ignore the current node and process its children
-     */
-    Children = 4,
-    /**
-     * ignore the current node children
-     */
-    IgnoreChildren = 8
+declare interface ClassSelectorToken extends BaseToken {
+    typ: EnumToken.ClassSelectorTokenType;
+    val: string;
 }
+
 /**
- * event types for the walkValues function
+ * Invalid class selector token
  */
-declare enum WalkerEvent {
-    /**
-     * enter node
-     */
-    Enter = 1,
-    /**
-     * leave node
-     */
-    Leave = 2
+declare interface InvalidClassSelectorToken extends BaseToken {
+    typ: EnumToken.InvalidClassSelectorTokenType;
+    val: string;
 }
+
 /**
- * walk ast nodes
- * @param node initial node
- * @param filter control the walk process
- * @param reverse walk in reverse order
- *
- * ```ts
- *
- * import {walk} from '@tbela99/css-parser';
- *
- * const css = `
- * body { color:    color(from var(--base-color) display-p3 r calc(g + 0.24) calc(b + 0.15)); }
- *
- * html,
- * body {
- *     line-height: 1.474;
- * }
- *
- * .ruler {
- *
- *     height: 10px;
- * }
- * `;
- *
- * for (const {node, parent, root} of walk(ast)) {
- *
- *     // do something with node
- * }
- * ```
- *
- * Using a {@link filter} function to control the ast traversal.  the filter function returns a value of type {@link WalkerOption}.
- *
- * ```ts
- * import {EnumToken, transform, walk, WalkerOptionEnum} from '@tbela99/css-parser';
- *
- * const css = `
- * body { color:    color(from var(--base-color) display-p3 r calc(g + 0.24) calc(b + 0.15)); }
- *
- * html,
- * body {
- *     line-height: 1.474;
- * }
- *
- * .ruler {
- *
- *     height: 10px;
- * }
- * `;
- *
- * function filter(node) {
- *
- *     if (node.typ == EnumToken.AstRule && node.sel.includes('html')) {
- *
- *         // skip the children of the current node
- *         return WalkerOptionEnum.IgnoreChildren;
- *     }
- * }
- *
- * const result = await transform(css);
- * for (const {node} of walk(result.ast, filter)) {
- *
- *     console.error([EnumToken[node.typ]]);
- * }
- *
- * // [ "StyleSheetNodeType" ]
- * // [ "RuleNodeType" ]
- * // [ "DeclarationNodeType" ]
- * // [ "RuleNodeType" ]
- * // [ "DeclarationNodeType" ]
- * // [ "RuleNodeType" ]
- * // [ "DeclarationNodeType" ]
- * ```
+ * Universal selector token
  */
-declare function walk(node: AstNode$1, filter?: WalkerFilter | null, reverse?: boolean): Generator<WalkResult>;
-/**
- * walk ast node value tokens
- * @param values
- * @param root
- * @param filter
- * @param reverse
- *
- * Example:
- *
- * ```ts
- *
- * import {AstDeclaration, EnumToken, transform, walkValues} from '@tbela99/css-parser';
- *
- * const css = `
- * body { color:    color(from var(--base-color) display-p3 r calc(g + 0.24) calc(b + 0.15)); }
- * `;
- *
- * const result = await transform(css);
- * const declaration = result.ast.chi[0].chi[0] as AstDeclaration;
- *
- * // walk the node attribute's tokens in reverse order
- * for (const {value} of walkValues(declaration.val, null, null,true)) {
- *
- *     console.error([EnumToken[value.typ], value.val]);
- * }
- *
- * // [ "Color", "color" ]
- * // [ "FunctionTokenType", "calc" ]
- * // [ "Number", 0.15 ]
- * // [ "Add", undefined ]
- * // [ "Iden", "b" ]
- * // [ "Whitespace", undefined ]
- * // [ "FunctionTokenType", "calc" ]
- * // [ "Number", 0.24 ]
- * // [ "Add", undefined ]
- * // [ "Iden", "g" ]
- * // [ "Whitespace", undefined ]
- * // [ "Iden", "r" ]
- * // [ "Whitespace", undefined ]
- * // [ "Iden", "display-p3" ]
- * // [ "Whitespace", undefined ]
- * // [ "FunctionTokenType", "var" ]
- * // [ "DashedIden", "--base-color" ]
- * // [ "Whitespace", undefined ]
- * // [ "Iden", "from" ]
- * ```
- */
-declare function walkValues(values: Token$1[], root?: AstNode$1 | Token$1 | null, filter?: WalkerValueFilter | null | {
-    event?: WalkerEvent;
-    fn?: WalkerValueFilter;
-    type?: EnumToken | EnumToken[] | ((token: Token$1) => boolean);
-}, reverse?: boolean): Generator<WalkAttributesResult>;
-
-/**
- * expand css nesting ast nodes
- * @param ast
- *
- * @private
- */
-declare function expand(ast: AstStyleSheet | AstAtRule | AstRule): AstNode$1;
-
-/**
- *
- * @param token
- * @param options
- *
- * @private
- */
-declare function renderToken(token: Token$1, options?: RenderOptions, cache?: {
-    [key: string]: any;
-}, reducer?: (acc: string, curr: Token$1) => string, errors?: ErrorDescription[]): string;
-
-/**
- * Source map class
- * @internal
- */
-declare class SourceMap {
-    #private;
-    /**
-     * Last location
-     */
-    lastLocation: Location | null;
-    /**
-     * Add a location
-     * @param source
-     * @param original
-     */
-    add(source: Location, original: Location): void;
-    /**
-     * Convert to URL encoded string
-     */
-    toUrl(): string;
-    /**
-     * Convert to JSON object
-     */
-    toJSON(): SourceMapObject;
-}
-
-/**
- * parse a string as an array of declaration nodes
- * @param declaration
- *
- * Example:
- * ````ts
- *
- * const declarations = await parseDeclarations('color: red; background: blue');
- * console.log(declarations);
- * ```
- */
-declare function parseDeclarations(declaration: string): Promise<Array<AstDeclaration | AstComment>>;
-/**
- * parse css string and return an array of tokens
- * @param src
- * @param options
- *
- * @private
- *
- * Example:
- *
- * ```ts
- *
- * import {parseString} from '@tbela99/css-parser';
- *
- * let tokens = parseString('body { color: red; }');
- * console.log(tokens);
- *
- *  tokens = parseString('#c322c980');
- * console.log(tokens);
- * ```
- */
-declare function parseString(src: string, options?: {
-    location: boolean;
-}): Token$1[];
-/**
- * parse function tokens in a token array
- * @param tokens
- * @param options
- *
- * Example:
- *
- * ```ts
- *
- * import {parseString, parseTokens} from '@tbela99/css-parser';
- *
- * let tokens = parseString('body { color: red; }');
- * console.log(parseTokens(tokens));
- *
- *  tokens = parseString('#c322c980');
- * console.log(parseTokens(tokens));
- * ```
- *
- * @private
- */
-declare function parseTokens(tokens: Token$1[], options?: ParseTokenOptions): Token$1[];
-
-/**
- * Literal token
- */
-export declare interface LiteralToken extends BaseToken {
-
-    typ: EnumToken.LiteralTokenType;
-    val: string;
-}
-
-/**
- * Class selector token
- */
-export declare interface ClassSelectorToken extends BaseToken {
-
-    typ: EnumToken.ClassSelectorTokenType;
-    val: string;
-}
-
-/**
- * Invalid class selector token
- */
-export declare interface InvalidClassSelectorToken extends BaseToken {
-
-    typ: EnumToken.InvalidClassSelectorTokenType;
-    val: string;
-}
-
-/**
- * Universal selector token
- */
-export declare interface UniversalSelectorToken extends BaseToken {
-
-    typ: EnumToken.UniversalSelectorTokenType;
-}
-
+declare interface UniversalSelectorToken extends BaseToken {
+    typ: EnumToken.UniversalSelectorTokenType;
+}
+
 /**
  * Ident token
  */
-export declare interface IdentToken extends BaseToken {
-
-    typ: EnumToken.IdenTokenType,
+declare interface IdentToken extends BaseToken {
+    typ: EnumToken.IdenTokenType;
     val: string;
 }
 
 /**
  * Ident list token
  */
-export declare interface IdentListToken extends BaseToken {
-
-    typ: EnumToken.IdenListTokenType,
+declare interface IdentListToken extends BaseToken {
+    typ: EnumToken.IdenListTokenType;
     val: string;
 }
 
 /**
  * Dashed ident token
  */
-export declare interface DashedIdentToken extends BaseToken {
-
-    typ: EnumToken.DashedIdenTokenType,
+declare interface DashedIdentToken extends BaseToken {
+    typ: EnumToken.DashedIdenTokenType;
     val: string;
 }
 
 /**
  * Comma token
  */
-export declare interface CommaToken extends BaseToken {
-
-    typ: EnumToken.CommaTokenType
+declare interface CommaToken extends BaseToken {
+    typ: EnumToken.CommaTokenType;
 }
 
 /**
  * Colon token
  */
-export declare interface ColonToken extends BaseToken {
-
-    typ: EnumToken.ColonTokenType
+declare interface ColonToken extends BaseToken {
+    typ: EnumToken.ColonTokenType;
 }
 
 /**
  * Semicolon token
  */
-export declare interface SemiColonToken extends BaseToken {
-
-    typ: EnumToken.SemiColonTokenType
+declare interface SemiColonToken extends BaseToken {
+    typ: EnumToken.SemiColonTokenType;
 }
 
 /**
  * Nesting selector token
  */
-export declare interface NestingSelectorToken extends BaseToken {
-
-    typ: EnumToken.NestingSelectorTokenType
+declare interface NestingSelectorToken extends BaseToken {
+    typ: EnumToken.NestingSelectorTokenType;
 }
 
 /**
  * Number token
  */
-export declare interface NumberToken extends BaseToken {
-
-    typ: EnumToken.NumberTokenType,
+declare interface NumberToken extends BaseToken {
+    typ: EnumToken.NumberTokenType;
+    sign?: "-" | "+";
     val: number | FractionToken;
 }
 
 /**
  * At rule token
  */
-export declare interface AtRuleToken extends BaseToken {
-
-    typ: EnumToken.AtRuleTokenType,
-    val: string;
-    pre: string;
+declare interface AtRuleToken extends BaseToken {
+    typ: EnumToken.AtRuleTokenType;
+    nam: string;
+    val?: string;
 }
 
 /**
  * Percentage token
  */
-export declare interface PercentageToken extends BaseToken {
-
-    typ: EnumToken.PercentageTokenType,
+declare interface PercentageToken extends BaseToken {
+    typ: EnumToken.PercentageTokenType;
     val: number | FractionToken;
 }
 
 /**
  * Flex token
  */
-export declare interface FlexToken extends BaseToken {
-
-    typ: EnumToken.FlexTokenType,
+declare interface FlexToken extends BaseToken {
+    typ: EnumToken.FlexTokenType;
     val: number | FractionToken;
 }
 
 /**
  * Function token
  */
-export declare interface FunctionToken extends BaseToken {
-
-    typ: EnumToken.FunctionTokenType,
+declare interface FunctionToken extends BaseToken {
+    typ:
+        | EnumToken.FunctionTokenType
+        | EnumToken.UrlFunctionTokenType
+        | EnumToken.GridTemplateFuncTokenType
+        | EnumToken.ImageFunctionTokenType
+        | EnumToken.TimelineFunctionTokenType
+        | EnumToken.TimingFunctionTokenType
+        | EnumToken.ColorFunctionTokenType
+        | EnumToken.MathFunctionTokenType
+        | EnumToken.PseudoClassFunctionTokenType
+        | EnumToken.TransformFunctionTokenType;
     val: string;
     chi: Token$1[];
 }
@@ -1120,9 +1034,8 @@ export declare interface FunctionToken extends BaseToken {
 /**
  * Grid template function token
  */
-export declare interface GridTemplateFuncToken extends BaseToken {
-
-    typ: EnumToken.GridTemplateFuncTokenType,
+declare interface GridTemplateFuncToken extends BaseToken {
+    typ: EnumToken.GridTemplateFuncTokenType;
     val: string;
     chi: Token$1[];
 }
@@ -1130,28 +1043,34 @@ export declare interface GridTemplateFuncToken extends BaseToken {
 /**
  * Function URL token
  */
-export declare interface FunctionURLToken extends BaseToken {
-
-    typ: EnumToken.UrlFunctionTokenType,
-    val: 'url';
+declare interface FunctionURLToken extends BaseToken {
+    typ: EnumToken.UrlFunctionTokenType;
+    val: "url";
     chi: Array<UrlToken | StringToken | CommentToken>;
 }
 
 /**
  * Function image token
  */
-export declare interface FunctionImageToken extends BaseToken {
-
-    typ: EnumToken.ImageFunctionTokenType,
-    val: 'linear-gradient' | 'radial-gradient' | 'repeating-linear-gradient' | 'repeating-radial-gradient' | 'conic-gradient' | 'image' | 'image-set' | 'element' | 'cross-fade';
+declare interface FunctionImageToken extends BaseToken {
+    typ: EnumToken.ImageFunctionTokenType;
+    val:
+        | "linear-gradient"
+        | "radial-gradient"
+        | "repeating-linear-gradient"
+        | "repeating-radial-gradient"
+        | "conic-gradient"
+        | "image"
+        | "image-set"
+        | "element"
+        | "cross-fade";
     chi: Array<UrlToken | CommentToken>;
 }
 
 /**
  * Timing function token
  */
-export declare interface TimingFunctionToken extends BaseToken {
-
+declare interface TimingFunctionToken extends BaseToken {
     typ: EnumToken.TimingFunctionTokenType;
     val: string;
     chi: Token$1[];
@@ -1160,8 +1079,7 @@ export declare interface TimingFunctionToken extends BaseToken {
 /**
  * Timeline function token
  */
-export declare interface TimelineFunctionToken extends BaseToken {
-
+declare interface TimelineFunctionToken extends BaseToken {
     typ: EnumToken.TimelineFunctionTokenType;
     val: string;
     chi: Token$1[];
@@ -1170,8 +1088,7 @@ export declare interface TimelineFunctionToken extends BaseToken {
 /**
  * String token
  */
-export declare interface StringToken extends BaseToken {
-
+declare interface StringToken extends BaseToken {
     typ: EnumToken.StringTokenType;
     val: string;
 }
@@ -1179,8 +1096,7 @@ export declare interface StringToken extends BaseToken {
 /**
  * Bad string token
  */
-export declare interface BadStringToken extends BaseToken {
-
+declare interface BadStringToken extends BaseToken {
     typ: EnumToken.BadStringTokenType;
     val: string;
 }
@@ -1188,8 +1104,7 @@ export declare interface BadStringToken extends BaseToken {
 /**
  * Unclosed string token
  */
-export declare interface UnclosedStringToken extends BaseToken {
-
+declare interface UnclosedStringToken extends BaseToken {
     typ: EnumToken.UnclosedStringTokenType;
     val: string;
 }
@@ -1197,8 +1112,7 @@ export declare interface UnclosedStringToken extends BaseToken {
 /**
  * Dimension token
  */
-export declare interface DimensionToken extends BaseToken {
-
+declare interface DimensionToken extends BaseToken {
     typ: EnumToken.DimensionTokenType;
     val: number | FractionToken;
     unit: string;
@@ -1207,8 +1121,7 @@ export declare interface DimensionToken extends BaseToken {
 /**
  * Length token
  */
-export declare interface LengthToken extends BaseToken {
-
+declare interface LengthToken extends BaseToken {
     typ: EnumToken.LengthTokenType;
     val: number | FractionToken;
     unit: string;
@@ -1217,8 +1130,7 @@ export declare interface LengthToken extends BaseToken {
 /**
  * Angle token
  */
-export declare interface AngleToken extends BaseToken {
-
+declare interface AngleToken extends BaseToken {
     typ: EnumToken.AngleTokenType;
     val: number | FractionToken;
     unit: string;
@@ -1227,38 +1139,34 @@ export declare interface AngleToken extends BaseToken {
 /**
  * Time token
  */
-export declare interface TimeToken extends BaseToken {
-
+declare interface TimeToken extends BaseToken {
     typ: EnumToken.TimeTokenType;
     val: number | FractionToken;
-    unit: 'ms' | 's';
+    unit: "ms" | "s";
 }
 
 /**
  * Frequency token
  */
-export declare interface FrequencyToken extends BaseToken {
-
+declare interface FrequencyToken extends BaseToken {
     typ: EnumToken.FrequencyTokenType;
     val: number | FractionToken;
-    unit: 'Hz' | 'Khz';
+    unit: "Hz" | "Khz";
 }
 
 /**
  * Resolution token
  */
-export declare interface ResolutionToken extends BaseToken {
-
+declare interface ResolutionToken extends BaseToken {
     typ: EnumToken.ResolutionTokenType;
     val: number | FractionToken;
-    unit: 'dpi' | 'dpcm' | 'dppx' | 'x';
+    unit: "dpi" | "dpcm" | "dppx" | "x";
 }
 
 /**
  * Hash token
  */
-export declare interface HashToken extends BaseToken {
-
+declare interface HashToken extends BaseToken {
     typ: EnumToken.HashTokenType;
     val: string;
 }
@@ -1266,24 +1174,21 @@ export declare interface HashToken extends BaseToken {
 /**
  * Block start token
  */
-export declare interface BlockStartToken extends BaseToken {
-
-    typ: EnumToken.BlockStartTokenType
+declare interface BlockStartToken extends BaseToken {
+    typ: EnumToken.BlockStartTokenType;
 }
 
 /**
  * Block end token
  */
-export declare interface BlockEndToken extends BaseToken {
-
-    typ: EnumToken.BlockEndTokenType
+declare interface BlockEndToken extends BaseToken {
+    typ: EnumToken.BlockEndTokenType;
 }
 
 /**
  * Attribute start token
  */
-export declare interface AttrStartToken extends BaseToken {
-
+declare interface AttrStartToken extends BaseToken {
     typ: EnumToken.AttrStartTokenType;
     chi?: Token$1[];
 }
@@ -1291,32 +1196,28 @@ export declare interface AttrStartToken extends BaseToken {
 /**
  * Attribute end token
  */
-export declare interface AttrEndToken extends BaseToken {
-
-    typ: EnumToken.AttrEndTokenType
+declare interface AttrEndToken extends BaseToken {
+    typ: EnumToken.AttrEndTokenType;
 }
 
 /**
  * Parenthesis start token
  */
-export declare interface ParensStartToken extends BaseToken {
-
+declare interface ParensStartToken extends BaseToken {
     typ: EnumToken.StartParensTokenType;
 }
 
 /**
  * Parenthesis end token
  */
-export declare interface ParensEndToken extends BaseToken {
-
-    typ: EnumToken.EndParensTokenType
+declare interface ParensEndToken extends BaseToken {
+    typ: EnumToken.EndParensTokenType;
 }
 
 /**
  * Parenthesis token
  */
-export declare interface ParensToken extends BaseToken {
-
+declare interface ParensToken extends BaseToken {
     typ: EnumToken.ParensTokenType;
     chi: Token$1[];
 }
@@ -1324,16 +1225,15 @@ export declare interface ParensToken extends BaseToken {
 /**
  * Whitespace token
  */
-export declare interface WhitespaceToken extends BaseToken {
-
-    typ: EnumToken.WhitespaceTokenType
+declare interface WhitespaceToken extends BaseToken {
+    typ: EnumToken.WhitespaceTokenType;
+    val?: string;
 }
 
 /**
  * Comment token
  */
-export declare interface CommentToken extends BaseToken {
-
+declare interface CommentToken extends BaseToken {
     typ: EnumToken.CommentTokenType;
     val: string;
 }
@@ -1341,8 +1241,7 @@ export declare interface CommentToken extends BaseToken {
 /**
  * Bad comment token
  */
-export declare interface BadCommentToken extends BaseToken {
-
+declare interface BadCommentToken extends BaseToken {
     typ: EnumToken.BadCommentTokenType;
     val: string;
 }
@@ -1350,8 +1249,7 @@ export declare interface BadCommentToken extends BaseToken {
 /**
  * CDO comment token
  */
-export declare interface CDOCommentToken extends BaseToken {
-
+declare interface CDOCommentToken extends BaseToken {
     typ: EnumToken.CDOCOMMTokenType;
     val: string;
 }
@@ -1359,8 +1257,7 @@ export declare interface CDOCommentToken extends BaseToken {
 /**
  * Bad CDO comment token
  */
-export declare interface BadCDOCommentToken extends BaseToken {
-
+declare interface BadCDOCommentToken extends BaseToken {
     typ: EnumToken.BadCdoTokenType;
     val: string;
 }
@@ -1368,8 +1265,7 @@ export declare interface BadCDOCommentToken extends BaseToken {
 /**
  * Include match token
  */
-export declare interface IncludeMatchToken extends BaseToken {
-
+declare interface IncludeMatchToken extends BaseToken {
     typ: EnumToken.IncludeMatchTokenType;
     // val: '~=';
 }
@@ -1377,8 +1273,7 @@ export declare interface IncludeMatchToken extends BaseToken {
 /**
  * Dash match token
  */
-export declare interface DashMatchToken extends BaseToken {
-
+declare interface DashMatchToken extends BaseToken {
     typ: EnumToken.DashMatchTokenType;
     // val: '|=';
 }
@@ -1386,8 +1281,7 @@ export declare interface DashMatchToken extends BaseToken {
 /**
  * Equal match token
  */
-export declare interface EqualMatchToken extends BaseToken {
-
+declare interface EqualMatchToken extends BaseToken {
     typ: EnumToken.EqualMatchTokenType;
     // val: '|=';
 }
@@ -1395,8 +1289,7 @@ export declare interface EqualMatchToken extends BaseToken {
 /**
  * Start match token
  */
-export declare interface StartMatchToken extends BaseToken {
-
+declare interface StartMatchToken extends BaseToken {
     typ: EnumToken.StartMatchTokenType;
     // val: '^=';
 }
@@ -1404,8 +1297,7 @@ export declare interface StartMatchToken extends BaseToken {
 /**
  * End match token
  */
-export declare interface EndMatchToken extends BaseToken {
-
+declare interface EndMatchToken extends BaseToken {
     typ: EnumToken.EndMatchTokenType;
     // val: '|=';
 }
@@ -1413,8 +1305,7 @@ export declare interface EndMatchToken extends BaseToken {
 /**
  * Contain match token
  */
-export declare interface ContainMatchToken extends BaseToken {
-
+declare interface ContainMatchToken extends BaseToken {
     typ: EnumToken.ContainMatchTokenType;
     // val: '|=';
 }
@@ -1422,48 +1313,42 @@ export declare interface ContainMatchToken extends BaseToken {
 /**
  * Less than token
  */
-export declare interface LessThanToken extends BaseToken {
-
+declare interface LessThanToken extends BaseToken {
     typ: EnumToken.LtTokenType;
 }
 
 /**
  * Less than or equal token
  */
-export declare interface LessThanOrEqualToken extends BaseToken {
-
+declare interface LessThanOrEqualToken extends BaseToken {
     typ: EnumToken.LteTokenType;
 }
 
 /**
  * Greater than token
  */
-export declare interface GreaterThanToken extends BaseToken {
-
+declare interface GreaterThanToken extends BaseToken {
     typ: EnumToken.GtTokenType;
 }
 
 /**
  * Greater than or equal token
  */
-export declare interface GreaterThanOrEqualToken extends BaseToken {
-
+declare interface GreaterThanOrEqualToken extends BaseToken {
     typ: EnumToken.GteTokenType;
 }
 
 /**
  * Column combinator token
  */
-export declare interface ColumnCombinatorToken extends BaseToken {
-
+declare interface ColumnCombinatorToken extends BaseToken {
     typ: EnumToken.ColumnCombinatorTokenType;
 }
 
 /**
  * Pseudo class token
  */
-export declare interface PseudoClassToken extends BaseToken {
-
+declare interface PseudoClassToken extends BaseToken {
     typ: EnumToken.PseudoClassTokenType;
     val: string;
 }
@@ -1471,8 +1356,7 @@ export declare interface PseudoClassToken extends BaseToken {
 /**
  * Pseudo element token
  */
-export declare interface PseudoElementToken extends BaseToken {
-
+declare interface PseudoElementToken extends BaseToken {
     typ: EnumToken.PseudoElementTokenType;
     val: string;
 }
@@ -1480,8 +1364,7 @@ export declare interface PseudoElementToken extends BaseToken {
 /**
  * Pseudo page token
  */
-export declare interface PseudoPageToken extends BaseToken {
-
+declare interface PseudoPageToken extends BaseToken {
     typ: EnumToken.PseudoPageTokenType;
     val: string;
 }
@@ -1489,8 +1372,7 @@ export declare interface PseudoPageToken extends BaseToken {
 /**
  * Pseudo class function token
  */
-export declare interface PseudoClassFunctionToken extends BaseToken {
-
+declare interface PseudoClassFunctionToken extends BaseToken {
     typ: EnumToken.PseudoClassFuncTokenType;
     val: string;
     chi: Token$1[];
@@ -1499,200 +1381,250 @@ export declare interface PseudoClassFunctionToken extends BaseToken {
 /**
  * Delim token
  */
-export declare interface DelimToken extends BaseToken {
-
+declare interface DelimToken extends BaseToken {
     typ: EnumToken.DelimTokenType;
 }
 
 /**
  * Bad URL token
  */
-export declare interface BadUrlToken extends BaseToken {
-
-    typ: EnumToken.BadUrlTokenType,
+declare interface BadUrlToken extends BaseToken {
+    typ: EnumToken.BadUrlTokenType;
     val: string;
 }
 
 /**
  * URL token
  */
-export declare interface UrlToken extends BaseToken {
-
-    typ: EnumToken.UrlTokenTokenType,
+declare interface UrlToken extends BaseToken {
+    typ: EnumToken.UrlTokenTokenType;
     val: string;
 }
 
 /**
  * EOF token
  */
-export declare interface EOFToken extends BaseToken {
-
+declare interface EOFToken extends BaseToken {
     typ: EnumToken.EOFTokenType;
 }
 
 /**
  * Important token
  */
-export declare interface ImportantToken extends BaseToken {
-
+declare interface ImportantToken extends BaseToken {
     typ: EnumToken.ImportantTokenType;
 }
 
 /**
  * Color token
  */
-export declare interface ColorToken extends BaseToken {
-
+declare interface ColorToken extends BaseToken {
     typ: EnumToken.ColorTokenType;
     val: string;
-    kin: ColorType;
+    kin: ColorType$1;
     chi?: Token$1[];
     /* calculated */
-    cal?: 'rel' | 'mix';
+    cal?: "rel" | "mix" | "col";
 }
 
 /**
  * Attribute token
  */
-export declare interface AttrToken extends BaseToken {
-
-    typ: EnumToken.AttrTokenType,
-    chi: Token$1[]
+declare interface AttrToken extends BaseToken {
+    typ: EnumToken.AttrTokenType;
+    chi: Token$1[];
 }
 
 /**
  * Invalid attribute token
  */
-export declare interface InvalidAttrToken extends BaseToken {
-
-    typ: EnumToken.InvalidAttrTokenType,
-    chi: Token$1[]
+declare interface InvalidAttrToken extends BaseToken {
+    typ: EnumToken.InvalidAttrTokenType;
+    chi: Token$1[];
 }
 
 /**
  * Child combinator token
  */
-export declare interface ChildCombinatorToken extends BaseToken {
-
-    typ: EnumToken.ChildCombinatorTokenType
+declare interface ChildCombinatorToken extends BaseToken {
+    typ: EnumToken.ChildCombinatorTokenType;
 }
 
 /**
  * Media feature token
  */
-export declare interface MediaFeatureToken extends BaseToken {
-
-    typ: EnumToken.MediaFeatureTokenType,
+declare interface MediaFeatureToken extends BaseToken {
+    typ: EnumToken.MediaFeatureTokenType;
     val: string;
 }
 
 /**
  * Media feature not token
  */
-export declare interface MediaFeatureNotToken extends BaseToken {
-
-    typ: EnumToken.MediaFeatureNotTokenType,
+declare interface NotToken extends BaseToken {
+    typ: EnumToken.NotTokenType;
     val: Token$1;
 }
 
 /**
  * Media feature only token
  */
-export declare interface MediaFeatureOnlyToken extends BaseToken {
-
-    typ: EnumToken.MediaFeatureOnlyTokenType,
+declare interface MediaFeatureOnlyToken extends BaseToken {
+    typ: EnumToken.OnlyTokenType;
     val: Token$1;
 }
 
 /**
  * Media feature and token
  */
-export declare interface MediaFeatureAndToken extends BaseToken {
-
-    typ: EnumToken.MediaFeatureAndTokenType;
+declare interface AndToken extends BaseToken {
+    typ: EnumToken.AndTokenType;
 }
 
 /**
  * Media feature or token
  */
-export declare interface MediaFeatureOrToken extends BaseToken {
-
-    typ: EnumToken.MediaFeatureOrTokenType;
+declare interface OrToken extends BaseToken {
+    typ: EnumToken.OrTokenType;
 }
 
 /**
  * Media query condition token
  */
-export declare interface MediaQueryConditionToken extends BaseToken {
+declare interface MediaQueryUnaryFeatureToken extends BaseToken {
+    typ: EnumToken.MediaQueryUnaryFeatureTokenType;
+    l: Token$1;
+    r: Token$1[];
+}
+
+declare interface SupportsQueryUnaryConditionToken extends BaseToken {
+    typ: EnumToken.SupportsQueryUnaryConditionTokenType;
+    l: Token$1;
+    r: Token$1[];
+}
+
+declare interface SupportsQueryConditionToken extends BaseToken {
+    typ: EnumToken.SupportsQueryConditionTokenType;
+    op: AndToken | OrToken;
+    l: Token$1[];
+    r: Token$1[];
+}
 
-    typ: EnumToken.MediaQueryConditionTokenType,
-    l: Token$1,
-    op: ColonToken | GreaterThanToken | LessThanToken | GreaterThanOrEqualToken | LessThanOrEqualToken,
-    r: Token$1[]
+declare interface WhenElseQueryConditionToken extends BaseToken {
+    typ: EnumToken.WhenElseQueryConditionTokenType;
+    op: AndToken | OrToken;
+    l: Token$1[];
+    r: Token$1[];
+}
+
+declare interface WhenElseUnaryConditionToken extends BaseToken {
+    typ: EnumToken.WhenElseUnaryConditionTokenType;
+    l: Token$1;
+    r: Token$1[];
+}
+
+declare interface MediaQueryConditionToken extends BaseToken {
+    typ: EnumToken.MediaQueryConditionTokenType;
+    l: Token$1[];
+    op:
+        | ColonToken
+        | DelimToken
+        | GreaterThanToken
+        | LessThanToken
+        | GreaterThanOrEqualToken
+        | LessThanOrEqualToken
+        | AndToken
+        | OrToken;
+    r: Token$1[];
+}
+
+declare interface IfConditionToken extends BaseToken {
+    typ: EnumToken.IfConditionTokenType;
+    l: Token$1[];
+    r: Token$1[];
+}
+
+declare interface IfElseConditionToken extends BaseToken {
+    typ: EnumToken.IfElseConditionTokenType;
+    l: IfConditionToken;
+    r: IfConditionToken;
+}
+
+declare interface ContainerStyleRangeToken extends BaseToken {
+    typ: EnumToken.ContainerStyleRangeTokenType;
+    l: Token$1[];
+    op: Token$1[];
+    r: Token$1[];
+}
+
+declare interface MediaRangeQueryToken extends BaseToken {
+    typ: EnumToken.MediaRangeQueryTokenType;
+    l: Token$1[];
+    val: Token$1[];
+    op1: LessThanToken | GreaterThanToken | LessThanOrEqualToken | GreaterThanOrEqualToken;
+    op2: LessThanToken | GreaterThanToken | LessThanOrEqualToken | GreaterThanOrEqualToken;
+    r: Token$1[];
+}
+
+declare interface InvalidMediaQueryToken extends BaseToken {
+    typ: EnumToken.InvalidMediaQueryTokenType;
+    chi: Token$1[];
 }
 
 /**
  * Descendant combinator token
  */
-export declare interface DescendantCombinatorToken extends BaseToken {
-
-    typ: EnumToken.DescendantCombinatorTokenType
+declare interface DescendantCombinatorToken extends BaseToken {
+    typ: EnumToken.DescendantCombinatorTokenType;
 }
 
 /**
  * Next sibling combinator token
  */
-export declare interface NextSiblingCombinatorToken extends BaseToken {
-
-    typ: EnumToken.NextSiblingCombinatorTokenType
+declare interface NextSiblingCombinatorToken extends BaseToken {
+    typ: EnumToken.NextSiblingCombinatorTokenType;
 }
 
 /**
  * Subsequent sibling combinator token
  */
-export declare interface SubsequentCombinatorToken extends BaseToken {
-
-    typ: EnumToken.SubsequentSiblingCombinatorTokenType
+declare interface SubsequentCombinatorToken extends BaseToken {
+    typ: EnumToken.SubsequentSiblingCombinatorTokenType;
 }
 
 /**
  * Add token
  */
-export declare interface AddToken extends BaseToken {
-
+declare interface AddToken extends BaseToken {
     typ: EnumToken.Add;
 }
 
 /**
  * Sub token
  */
-export declare interface SubToken extends BaseToken {
-
+declare interface SubToken extends BaseToken {
     typ: EnumToken.Sub;
 }
 
 /**
  * Div token
  */
-export declare interface DivToken extends BaseToken {
-
+declare interface DivToken extends BaseToken {
     typ: EnumToken.Div;
 }
 
 /**
  * Mul token
  */
-export declare interface MulToken extends BaseToken {
-
+declare interface MulToken extends BaseToken {
     typ: EnumToken.Mul;
 }
 
 /**
  * Unary expression token
  */
-export declare interface UnaryExpression extends BaseToken {
-
-    typ: EnumToken.UnaryExpressionTokenType
+declare interface UnaryExpression extends BaseToken {
+    typ: EnumToken.UnaryExpressionTokenType;
     sign: EnumToken.Add | EnumToken.Sub;
     val: UnaryExpressionNode;
 }
@@ -1700,8 +1632,7 @@ export declare interface UnaryExpression extends BaseToken {
 /**
  * Fraction token
  */
-export declare interface FractionToken extends BaseToken {
-
+declare interface FractionToken extends BaseToken {
     typ: EnumToken.FractionTokenType;
     l: NumberToken;
     r: NumberToken;
@@ -1710,9 +1641,8 @@ export declare interface FractionToken extends BaseToken {
 /**
  * Binary expression token
  */
-export declare interface BinaryExpressionToken extends BaseToken {
-
-    typ: EnumToken.BinaryExpressionTokenType
+declare interface BinaryExpressionToken extends BaseToken {
+    typ: EnumToken.BinaryExpressionTokenType;
     op: EnumToken.Add | EnumToken.Sub | EnumToken.Div | EnumToken.Mul;
     l: BinaryExpressionNode | Token$1;
     r: BinaryExpressionNode | Token$1;
@@ -1721,21 +1651,19 @@ export declare interface BinaryExpressionToken extends BaseToken {
 /**
  * Match expression token
  */
-export declare interface MatchExpressionToken extends BaseToken {
-
-    typ: EnumToken.MatchExpressionTokenType
+declare interface MatchExpressionToken extends BaseToken {
+    typ: EnumToken.MatchExpressionTokenType;
     op: EqualMatchToken | DashMatchToken | StartMatchToken | ContainMatchToken | EndMatchToken | IncludeMatchToken;
     l: Token$1;
     r: Token$1;
-    attr?: 'i' | 's';
+    attr?: "i" | "s";
 }
 
 /**
  * Name space attribute token
  */
-export declare interface NameSpaceAttributeToken extends BaseToken {
-
-    typ: EnumToken.NameSpaceAttributeTokenType
+declare interface NameSpaceAttributeToken extends BaseToken {
+    typ: EnumToken.NameSpaceAttributeTokenType;
     l?: Token$1;
     r: Token$1;
 }
@@ -1743,17 +1671,15 @@ export declare interface NameSpaceAttributeToken extends BaseToken {
 /**
  * List token
  */
-export declare interface ListToken extends BaseToken {
-
-    typ: EnumToken.ListToken
+declare interface ListToken extends BaseToken {
+    typ: EnumToken.ListToken;
     chi: Token$1[];
 }
 
 /**
  * Composes selector token
  */
-export declare interface ComposesSelectorToken extends BaseToken {
-
+declare interface ComposesSelectorToken extends BaseToken {
     typ: EnumToken.ComposesSelectorTokenType;
     l: Token$1[];
     r: Token$1 | null;
@@ -1762,32 +1688,50 @@ export declare interface ComposesSelectorToken extends BaseToken {
 /**
  * Css variable token
  */
-export declare interface CssVariableToken$1 extends BaseToken {
-
+declare interface CssVariableToken$1 extends BaseToken {
     typ: EnumToken.CssVariableTokenType;
     nam: string;
     val: Token$1[];
 }
 
-export declare interface CssVariableImportTokenType$1 extends BaseToken {
-
+declare interface CssVariableImportTokenType$1 extends BaseToken {
     typ: EnumToken.CssVariableImportTokenType;
     nam: string;
     val: Token$1[];
 }
 
-export declare interface CssVariableMapTokenType extends BaseToken {
-
-    typ: EnumToken.CssVariableMapTokenType;
+declare interface CssVariableMapTokenType extends BaseToken {
+    typ: EnumToken.CssVariableDeclarationMapTokenType;
     vars: Token$1[];
     from: Token$1[];
 }
 
+declare interface FunctionDefToken extends BaseToken {
+    typ:
+        | EnumToken.FunctionDefTokenType
+        | EnumToken.UrlFunctionTokenDefType
+        | EnumToken.GridTemplateFuncTokenDefType
+        | EnumToken.ImageFunctionTokenDefType
+        | EnumToken.TimelineFunctionTokenDefType
+        | EnumToken.TimingFunctionTokenDefType
+        | EnumToken.ColorFunctionTokenDefType
+        | EnumToken.MathFunctionTokenDefType
+        | EnumToken.PseudoClassFunctionTokenDefType
+        | EnumToken.TransformFunctionTokenDefType;
+    nam: string;
+    val: string;
+}
+
+declare interface RawNodeToken extends BaseToken {
+    typ: EnumToken.RawNodeTokenType;
+    chi: Token$1[];
+}
+
 /**
  * Unary expression node
  */
-export declare type UnaryExpressionNode =
-    BinaryExpressionNode
+declare type UnaryExpressionNode =
+    | BinaryExpressionNode
     | NumberToken
     | DimensionToken
     | TimeToken
@@ -1798,17 +1742,26 @@ export declare type UnaryExpressionNode =
 /**
  * Binary expression node
  */
-export declare type BinaryExpressionNode = NumberToken | DimensionToken | PercentageToken | FlexToken | FractionToken |
-    AngleToken | LengthToken | FrequencyToken | BinaryExpressionToken | FunctionToken | ParensToken;
+declare type BinaryExpressionNode =
+    | NumberToken
+    | DimensionToken
+    | PercentageToken
+    | FlexToken
+    | FractionToken
+    | AngleToken
+    | LengthToken
+    | FrequencyToken
+    | BinaryExpressionToken
+    | FunctionToken
+    | ParensToken;
 
 /**
  * Token
  */
-export declare type Token$1 =
-    InvalidClassSelectorToken
+declare type Token$1 =
+    | InvalidClassSelectorToken
     | InvalidAttrToken
-    |
-    LiteralToken
+    | LiteralToken
     | IdentToken
     | IdentListToken
     | DashedIdentToken
@@ -1823,16 +1776,23 @@ export declare type Token$1 =
     | SubsequentCombinatorToken
     | ColumnCombinatorToken
     | NestingSelectorToken
-    |
-    MediaQueryConditionToken
+    | WhenElseUnaryConditionToken
+    | WhenElseQueryConditionToken
+    | SupportsQueryUnaryConditionToken
+    | SupportsQueryConditionToken
+    | MediaQueryConditionToken
     | MediaFeatureToken
-    | MediaFeatureNotToken
+    | MediaQueryUnaryFeatureToken
+    | IfConditionToken
+    | IfElseConditionToken
+    | NotToken
     | MediaFeatureOnlyToken
-    | MediaFeatureAndToken
-    | MediaFeatureOrToken
+    | AndToken
+    | OrToken
+    | MediaRangeQueryToken
+    | ContainerStyleRangeToken
     | AstDeclaration
-    |
-    NumberToken
+    | NumberToken
     | AtRuleToken
     | PercentageToken
     | FlexToken
@@ -1844,27 +1804,23 @@ export declare type Token$1 =
     | GridTemplateFuncToken
     | DimensionToken
     | LengthToken
-    |
-    AngleToken
+    | AngleToken
     | StringToken
     | TimeToken
     | FrequencyToken
     | ResolutionToken
-    |
-    UnclosedStringToken
+    | UnclosedStringToken
     | HashToken
     | BadStringToken
     | BlockStartToken
     | BlockEndToken
-    |
-    AttrStartToken
+    | AttrStartToken
     | AttrEndToken
     | ParensStartToken
     | ParensEndToken
     | ParensToken
     | CDOCommentToken
-    |
-    BadCDOCommentToken
+    | BadCDOCommentToken
     | CommentToken
     | BadCommentToken
     | WhitespaceToken
@@ -1876,15 +1832,13 @@ export declare type Token$1 =
     | NameSpaceAttributeToken
     | ComposesSelectorToken
     | CssVariableToken$1
-    |
-    DashMatchToken
+    | DashMatchToken
     | EqualMatchToken
     | LessThanToken
     | LessThanOrEqualToken
     | GreaterThanToken
     | GreaterThanOrEqualToken
-    |
-    ListToken
+    | ListToken
     | PseudoClassToken
     | PseudoPageToken
     | PseudoElementToken
@@ -1893,200 +1847,24 @@ export declare type Token$1 =
     | BinaryExpressionToken
     | UnaryExpression
     | FractionToken
-    |
-    AddToken
+    | AddToken
     | SubToken
     | DivToken
     | MulToken
-    |
-    BadUrlToken
+    | BadUrlToken
     | UrlToken
     | ImportantToken
     | ColorToken
     | AttrToken
+    | FunctionDefToken
+    | RawNodeToken
+    | InvalidMediaQueryToken
     | EOFToken;
 
-declare enum ValidationTokenEnum {
-    Root = 0,
-    Keyword = 1,
-    PropertyType = 2,
-    DeclarationType = 3,
-    AtRule = 4,
-    ValidationFunctionDefinition = 5,
-    OpenBracket = 6,
-    CloseBracket = 7,
-    OpenParenthesis = 8,
-    CloseParenthesis = 9,
-    Comma = 10,
-    Pipe = 11,
-    Column = 12,
-    Star = 13,
-    OpenCurlyBrace = 14,
-    CloseCurlyBrace = 15,
-    HashMark = 16,
-    QuestionMark = 17,
-    Function = 18,
-    Number = 19,
-    Whitespace = 20,
-    Parenthesis = 21,
-    Bracket = 22,
-    Block = 23,
-    AtLeastOnce = 24,
-    Separator = 25,
-    Exclamation = 26,
-    Ampersand = 27,
-    PipeToken = 28,
-    ColumnToken = 29,
-    AmpersandToken = 30,
-    Parens = 31,
-    PseudoClassToken = 32,
-    PseudoClassFunctionToken = 33,
-    StringToken = 34,
-    AtRuleDefinition = 35,
-    DeclarationNameToken = 36,
-    DeclarationDefinitionToken = 37,
-    SemiColon = 38,
-    Character = 39,
-    InfinityToken = 40
-}
-declare const enum ValidationSyntaxGroupEnum {
-    Declarations = "declarations",
-    Functions = "functions",
-    Syntaxes = "syntaxes",
-    Selectors = "selectors",
-    AtRules = "atRules"
-}
-
-interface Position$1 {
-
-    ind: number;
-    lin: number;
-    col: number;
-}
-
-interface ValidationToken$1 {
-
-    typ: ValidationTokenEnum;
-    pos: Position$1;
-    isList?: boolean;
-    text?: string;
-    isRepeatable?: boolean;
-    atLeastOnce?: boolean;
-    isOptional?: boolean;
-    isRepeatableGroup?: boolean;
-    occurence?: {
-        min: number;
-        max: number | null;
-    }
-}
-
-export declare interface ValidationSyntaxNode {
-
-    syntax: string;
-    ast?: ValidationToken$1[];
-}
-
-interface ValidationSelectorOptions extends ValidationOptions {
-
-    nestedSelector?: boolean;
-}
-
-export declare interface ValidationConfiguration {
-
-    [ValidationSyntaxGroupEnum.Declarations]: ValidationSyntaxNode;
-    [ValidationSyntaxGroupEnum.Functions]: ValidationSyntaxNode;
-    [ValidationSyntaxGroupEnum.Syntaxes]: ValidationSyntaxNode;
-    [ValidationSyntaxGroupEnum.Selectors]: ValidationSyntaxNode;
-    [ValidationSyntaxGroupEnum.AtRules]: ValidationSyntaxNode;
-}
-
-//= Record<keyof ValidationSyntaxGroupEnum, ValidationSyntaxNode>;
-
-interface ValidationResult {
-
-    valid: SyntaxValidationResult;
-    node: AstNode$1 | Token$1 | null;
-    syntax: ValidationToken$1 | string | null;
-    error: string;
-    cycle?: boolean;
-}
-
-interface ValidationSyntaxResult extends ValidationResult {
-
-    syntax: ValidationToken$1 | string | null;
-    context: Context<Token$1> | Token$1[];
-}
-
-interface Context<Type> {
-
-    index: number;
-
-    /**
-     * The length of the context tokens to be consumed
-     */
-
-    readonly length: number;
-
-    current<Type>(): Type | null;
-
-    update<Type>(context: Context<Type>): void;
-
-    consume<Type>(token: Type, howMany?: number): boolean;
-
-    peek<Type>(): Type | null;
-
-    // tokens<Type>(): Type[];
-
-    next<Type>(): Type | null;
-
-    consume<Type>(token: Type, howMany?: number): boolean;
-
-    slice<Type>(): Type[];
-
-    clone<Type>(): Context<Type>;
-
-    done(): boolean;
-}
-
-/**
- * Converts a color to another color space
- * @param token
- * @param to
- *
- * @private
- *
- * <code>
- *
- *     const token = {typ: EnumToken.ColorTokenType, kin: ColorType.HEX, val: '#F00'}
- *     const result = convertColor(token, ColorType.LCH);
- *
- * </code>
- */
-declare function convertColor(token: ColorToken, to: ColorType): ColorToken | null;
-
-/**
- * Calculate the distance between two okLab colors.
- * @param okLab1
- * @param okLab2
- *
- * @private
- */
-declare function okLabDistance(okLab1: [number, number, number], okLab2: [number, number, number]): number;
-/**
- * Check if two colors are close in okLab space.
- * @param color1
- * @param color2
- * @param threshold
- *
- * @private
- */
-declare function isOkLabClose(color1: ColorToken, color2: ColorToken, threshold?: number): boolean;
-
 /**
  * Position
  */
-export declare interface Position {
-
+declare interface Position$1 {
     /**
      * index in the source
      */
@@ -2104,24 +1882,22 @@ export declare interface Position {
 /**
  * token or node location
  */
-export declare interface Location {
-
+declare interface Location {
     /**
      * start position
      */
-    sta: Position;
+    sta: Position$1;
     /**
      * end position
      */
-    end: Position;
+    end: Position$1;
     /**
      * source file
      */
     src: string;
 }
 
-export declare interface BaseToken {
-
+declare interface BaseToken {
     /**
      * token type
      */
@@ -2147,9 +1923,8 @@ export declare interface BaseToken {
 /**
  * comment node
  */
-export declare interface AstComment extends BaseToken {
-
-    typ: EnumToken.CommentNodeType | EnumToken.CDOCOMMNodeType,
+declare interface AstComment extends BaseToken {
+    typ: EnumToken.CommentNodeType | EnumToken.CDOCOMMNodeType;
     tokens?: null;
     val: string;
 }
@@ -2157,22 +1932,22 @@ export declare interface AstComment extends BaseToken {
 /**
  * declaration node
  */
-export declare interface AstDeclaration extends BaseToken {
-
-    nam: string,
+declare interface AstDeclaration extends BaseToken {
+    nam: string;
     tokens?: null;
     val: Token$1[];
-    typ: EnumToken.DeclarationNodeType
+    typ: EnumToken.DeclarationNodeType;
 }
 
 /**
  * rule node
  */
-export declare interface AstRule extends BaseToken {
-
+declare interface AstRule extends BaseToken {
     typ: EnumToken.RuleNodeType;
     sel: string;
-    chi: Array<AstDeclaration | AstComment | AstRule | AstAtRule | AstInvalidRule | AstInvalidDeclaration | AstInvalidAtRule>;
+    chi: Array<
+        AstDeclaration | AstComment | AstRule | AstAtRule | AstInvalidRule | AstInvalidDeclaration | AstInvalidAtRule
+    >;
     optimized?: OptimizedSelector | null;
     raw?: RawSelectorTokens | null;
 }
@@ -2180,9 +1955,8 @@ export declare interface AstRule extends BaseToken {
 /**
  * invalid rule node
  */
-export declare interface AstInvalidRule extends BaseToken {
-
-    typ: EnumToken.InvalidRuleTokenType;
+declare interface AstInvalidRule extends BaseToken {
+    typ: EnumToken.InvalidRuleNodeType;
     sel: string;
     chi: Array<AstNode$1>;
 }
@@ -2190,8 +1964,7 @@ export declare interface AstInvalidRule extends BaseToken {
 /**
  * invalid declaration node
  */
-export declare interface AstInvalidDeclaration extends BaseToken {
-
+declare interface AstInvalidDeclaration extends BaseToken {
     typ: EnumToken.InvalidDeclarationNodeType;
     tokens?: null;
     val: Array<Token$1>;
@@ -2200,9 +1973,8 @@ export declare interface AstInvalidDeclaration extends BaseToken {
 /**
  * invalid at rule node
  */
-export declare interface AstInvalidAtRule extends BaseToken {
-
-    typ: EnumToken.InvalidAtRuleTokenType;
+declare interface AstInvalidAtRule extends BaseToken {
+    typ: EnumToken.InvalidAtRuleNodeType;
     nam: string;
     val: string;
     chi?: Array<AstNode$1>;
@@ -2211,30 +1983,29 @@ export declare interface AstInvalidAtRule extends BaseToken {
 /**
  * keyframe rule node
  */
-export declare interface AstKeyFrameRule extends BaseToken {
-
+declare interface AstKeyFrameRule extends BaseToken {
     typ: EnumToken.KeyFramesRuleNodeType;
     sel: string;
     chi: Array<AstDeclaration | AstComment | AstInvalidDeclaration>;
     optimized?: OptimizedSelector;
     raw?: RawSelectorTokens;
-    tokens?: Token$1[]
+    tokens?: Token$1[];
 }
 
 /**
  * raw selector tokens
  */
-export declare type RawSelectorTokens = string[][];
+declare type RawSelectorTokens = string[][];
 
 /**
  * optimized selector
  *
  * @private
  */
-export declare interface OptimizedSelector {
+declare interface OptimizedSelector {
     match: boolean;
     optimized: string[];
-    selector: string[][],
+    selector: string[][];
     reducible: boolean;
 }
 
@@ -2243,29 +2014,27 @@ export declare interface OptimizedSelector {
  *
  * @private
  */
-export declare interface OptimizedSelectorToken {
+declare interface OptimizedSelectorToken {
     match: boolean;
     optimized: Token$1[];
-    selector: Token$1[][],
+    selector: Token$1[][];
     reducible: boolean;
 }
 
 /**
  * at rule node
  */
-export declare interface AstAtRule extends BaseToken {
-
-    typ: EnumToken.AtRuleNodeType,
+declare interface AstAtRule extends BaseToken {
+    typ: EnumToken.AtRuleNodeType;
     nam: string;
     val: string;
-    chi?: Array<AstDeclaration | AstInvalidDeclaration | AstComment> | Array<AstRule | AstComment>
+    chi?: Array<AstNode$1>;
 }
 
 /**
  * keyframe rule node
  */
-export declare interface AstKeyframesRule extends BaseToken {
-
+declare interface AstKeyframesRule extends BaseToken {
     typ: EnumToken.KeyFramesRuleNodeType;
     sel: string;
     chi: Array<AstDeclaration | AstInvalidDeclaration | AstComment | AstRuleList>;
@@ -2276,9 +2045,8 @@ export declare interface AstKeyframesRule extends BaseToken {
 /**
  * keyframe at rule node
  */
-export declare interface AstKeyframesAtRule extends BaseToken {
-
-    typ: EnumToken.KeyframesAtRuleNodeType,
+declare interface AstKeyframesAtRule extends BaseToken {
+    typ: EnumToken.KeyframesAtRuleNodeType;
     nam: string;
     val: string;
     chi: Array<AstKeyframesRule | AstComment>;
@@ -2287,8 +2055,8 @@ export declare interface AstKeyframesAtRule extends BaseToken {
 /**
  * rule list node
  */
-export declare type AstRuleList =
-    AstStyleSheet
+declare type AstRuleList =
+    | AstStyleSheet
     | AstAtRule
     | AstRule
     | AstKeyframesAtRule
@@ -2298,60 +2066,234 @@ export declare type AstRuleList =
 /**
  * stylesheet node
  */
-export declare interface AstStyleSheet extends BaseToken {
-    typ: EnumToken.StyleSheetNodeType,
-    chi: Array<AstRule | AstAtRule | astKeyframesAtRule | AstComment | AstInvalidAtRule | AstInvalidRule>;
-    tokens?: null;
-}
-
+declare interface AstStyleSheet extends BaseToken {
+    typ: EnumToken.StyleSheetNodeType;
+    chi: Array<AstRule | AstAtRule | astKeyframesAtRule | AstComment | AstInvalidAtRule | AstInvalidRule>;
+    tokens?: null;
+}
+
+/**
+ * ast node
+ */
+declare type AstNode$1 =
+    | AstStyleSheet
+    | AstRuleList
+    | AstComment
+    | AstAtRule
+    | AstRule
+    | AstDeclaration
+    | AstKeyframesAtRule
+    | AstKeyFrameRule
+    | AstInvalidRule
+    | AstInvalidAtRule
+    | AstInvalidDeclaration
+    | CssVariableToken
+    | CssVariableImportTokenType;
+
+    
+interface TokenSearchResult {
+    node: Token$1 | null;
+    parent: AstNode$1 | Token$1 | null;
+    root: AstNode$1 | Token$1 | null;
+    parents: Generator<Token$1> | null;
+}
+
+type AstValueMatcher = ((value: Token$1) => boolean) | ((token: Token$1, node: AstNode$1) => boolean);
+
+/**
+ * options for the walk function
+ */
+declare enum WalkerOptionEnum {
+    /**
+     * ignore the current node and its children
+     */
+    Ignore = 1,
+    /**
+     * stop walking the tree
+     */
+    Stop = 2,
+    /**
+     * ignore the current node and process its children
+     */
+    Children = 4,
+    /**
+     * ignore the current node children
+     */
+    IgnoreChildren = 8
+}
+/**
+ * event types for the walkValues function
+ */
+declare enum WalkerEvent {
+    /**
+     * enter node
+     */
+    Enter = 1,
+    /**
+     * leave node
+     */
+    Leave = 2
+}
+/**
+ * walk ast nodes
+ * @param node initial node
+ * @param filter control the walk process
+ * @param reverse walk in reverse order
+ *
+ * ```ts
+ *
+ * import {walk} from '@tbela99/css-parser';
+ *
+ * const css = `
+ * body { color:    color(from var(--base-color) display-p3 r calc(g + 0.24) calc(b + 0.15)); }
+ *
+ * html,
+ * body {
+ *     line-height: 1.474;
+ * }
+ *
+ * .ruler {
+ *
+ *     height: 10px;
+ * }
+ * `;
+ *
+ * for (const {node, parent, root} of walk(ast)) {
+ *
+ *     // do something with node
+ * }
+ * ```
+ *
+ * Using a {@link filter} function to control the ast traversal.  the filter function returns a value of type {@link WalkerOption}.
+ *
+ * ```ts
+ * import {EnumToken, transform, walk, WalkerOptionEnum} from '@tbela99/css-parser';
+ *
+ * const css = `
+ * body { color:    color(from var(--base-color) display-p3 r calc(g + 0.24) calc(b + 0.15)); }
+ *
+ * html,
+ * body {
+ *     line-height: 1.474;
+ * }
+ *
+ * .ruler {
+ *
+ *     height: 10px;
+ * }
+ * `;
+ *
+ * function filter(node) {
+ *
+ *     if (node.typ == EnumToken.AstRule && node.sel.includes('html')) {
+ *
+ *         // skip the children of the current node
+ *         return WalkerOptionEnum.IgnoreChildren;
+ *     }
+ * }
+ *
+ * const result = await transform(css);
+ * for (const {node} of walk(result.ast, filter)) {
+ *
+ *     console.error([EnumToken[node.typ]]);
+ * }
+ *
+ * // [ "StyleSheetNodeType" ]
+ * // [ "RuleNodeType" ]
+ * // [ "DeclarationNodeType" ]
+ * // [ "RuleNodeType" ]
+ * // [ "DeclarationNodeType" ]
+ * // [ "RuleNodeType" ]
+ * // [ "DeclarationNodeType" ]
+ * ```
+ */
+declare function walk(node: AstNode$1, filter?: WalkerFilter | null, reverse?: boolean): Generator<WalkResult>;
 /**
- * ast node
+ * walk ast node value tokens
+ * @param values
+ * @param root
+ * @param filter
+ * @param reverse
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ * import {AstDeclaration, EnumToken, transform, walkValues} from '@tbela99/css-parser';
+ *
+ * const css = `
+ * body { color:    color(from var(--base-color) display-p3 r calc(g + 0.24) calc(b + 0.15)); }
+ * `;
+ *
+ * const result = await transform(css);
+ * const declaration = result.ast.chi[0].chi[0] as AstDeclaration;
+ *
+ * // walk the node attribute's tokens in reverse order
+ * for (const {value} of walkValues(declaration.val, null, null,true)) {
+ *
+ *     console.error([EnumToken[value.typ], value.val]);
+ * }
+ *
+ * // [ "Color", "color" ]
+ * // [ "FunctionTokenType", "calc" ]
+ * // [ "Number", 0.15 ]
+ * // [ "Add", undefined ]
+ * // [ "Iden", "b" ]
+ * // [ "Whitespace", undefined ]
+ * // [ "FunctionTokenType", "calc" ]
+ * // [ "Number", 0.24 ]
+ * // [ "Add", undefined ]
+ * // [ "Iden", "g" ]
+ * // [ "Whitespace", undefined ]
+ * // [ "Iden", "r" ]
+ * // [ "Whitespace", undefined ]
+ * // [ "Iden", "display-p3" ]
+ * // [ "Whitespace", undefined ]
+ * // [ "FunctionTokenType", "var" ]
+ * // [ "DashedIden", "--base-color" ]
+ * // [ "Whitespace", undefined ]
+ * // [ "Iden", "from" ]
+ * ```
  */
-export declare type AstNode$1 =
-    AstStyleSheet
-    | AstRuleList
-    | AstComment
-    | AstAtRule
-    | AstRule
-    | AstDeclaration
-    | AstKeyframesAtRule
-    | AstKeyFrameRule
-    | AstInvalidRule
-    | AstInvalidAtRule
-    | AstInvalidDeclaration
-    | CssVariableToken
-    | CssVariableImportTokenType;
+declare function walkValues(values: Token$1[], root?: AstNode$1 | Token$1 | null, filter?: WalkerValueFilter | null | {
+    event?: WalkerEvent;
+    fn?: WalkerValueFilter;
+    type?: EnumToken | EnumToken[] | ((token: Token$1) => boolean);
+}, reverse?: boolean): Generator<WalkAttributesResult>;
 
-export declare type GenericVisitorResult<T> = T | T[] | Promise<T> | Promise<T[]> | null | Promise<null>;
-export declare type GenericVisitorHandler<T> = ((node: T, parent?: AstNode | Token, root?: AstNode | Token) => GenericVisitorResult<T>);
-export declare type GenericVisitorAstNodeHandlerMap<T> =
-    Record<string, GenericVisitorHandler<T>>
+declare type GenericVisitorResult<T> = T | T[] | Promise<T> | Promise<T[]> | null | Promise<null>;
+declare type GenericVisitorHandler<T> = (
+    node: T,
+    parent?: AstNode | Token,
+    root?: AstNode | Token,
+) => GenericVisitorResult<T>;
+declare type GenericVisitorAstNodeHandlerMap<T> =
+    | Record<string, GenericVisitorHandler<T>>
     | GenericVisitorHandler<T>
-    | { type: WalkerEvent, handler: GenericVisitorHandler<T> }
-    | { type: WalkerEvent, handler: Record<string, GenericVisitorHandler<T>> };
+    | { type: WalkerEvent; handler: GenericVisitorHandler<T> }
+    | { type: WalkerEvent; handler: Record<string, GenericVisitorHandler<T>> };
 
-export declare type ValueVisitorHandler = GenericVisitorHandler<Token>;
+declare type ValueVisitorHandler = GenericVisitorHandler<Token>;
 
 /**
  * Declaration visitor handler
  */
-export declare type DeclarationVisitorHandler = GenericVisitorHandler<AstDeclaration>;
+declare type DeclarationVisitorHandler = GenericVisitorHandler<AstDeclaration>;
 /**
  * Rule visitor handler
  */
-export declare type RuleVisitorHandler = GenericVisitorHandler<AstRule>;
+declare type RuleVisitorHandler = GenericVisitorHandler<AstRule>;
 
 /**
  * AtRule visitor handler
  */
-export declare type AtRuleVisitorHandler = GenericVisitorHandler<AstAtRule>;
+declare type AtRuleVisitorHandler = GenericVisitorHandler<AstAtRule>;
 
 /**
  * node visitor callback map
  *
  */
-export declare interface VisitorNodeMap {
-
+declare interface VisitorNodeMap {
     /**
      * at rule visitor
      *
@@ -2596,10 +2538,36 @@ export declare interface VisitorNodeMap {
      * // body {color:#f3fff0}
      * ```
      */
-    [key : keyof typeof EnumToken]: GenericVisitorAstNodeHandlerMap<Token> | GenericVisitorAstNodeHandlerMap<AstNode>;
+    [key: keyof typeof EnumToken]: GenericVisitorAstNodeHandlerMap<Token> | GenericVisitorAstNodeHandlerMap<AstNode>;
+}
+
+/**
+ * Source map class
+ * @internal
+ */
+declare class SourceMap {
+    #private;
+    /**
+     * Last location
+     */
+    lastLocation: Location | null;
+    /**
+     * Add a location
+     * @param source
+     * @param original
+     */
+    add(source: Location, original: Location): void;
+    /**
+     * Convert to URL encoded string
+     */
+    toUrl(): string;
+    /**
+     * Convert to JSON object
+     */
+    toJSON(): SourceMapObject;
 }
 
-export declare interface PropertyListOptions {
+declare interface PropertyListOptions {
 
     removeDuplicateDeclarations?: boolean | string | string[];
     computeShorthand?: boolean;
@@ -2608,7 +2576,12 @@ export declare interface PropertyListOptions {
 /**
  * parse info
  */
-export declare interface ParseInfo {
+declare interface ParseInfo$1 {
+
+    /**
+     * source file or url
+     */
+    src: string;
 
     /**
      * read buffer
@@ -2618,19 +2591,30 @@ export declare interface ParseInfo {
      * stream
      */
     stream: string;
+
+    /**
+     * the accumulated css string
+     */
+    // acc: string;
+    
     /**
      * last token position
      */
-    position: Position;
+    position: Position$1;
     /**
      * current parsing position
      */
-    currentPosition: Position;
+    currentPosition: Position$1;
 
     /**
      * offset
      */
     offset: number;
+
+    /**
+     * tokenizing time
+     */
+    time: number;
 }
 
 /**
@@ -2649,18 +2633,159 @@ declare enum FeatureWalkMode {
     Post = 2
 }
 
-/**
- * supported transform functions
- *
- * @internal
- */
-declare const transformFunctions: string[];
-/**
- * supported math functions
- *
- * @internal
- */
-declare const mathFuncs: string[];
+declare enum ValidationTokenEnum {
+    Root = 0,
+    Keyword = 1,
+    PropertyType = 2,
+    DeclarationType = 3,
+    AtRule = 4,
+    FunctionDefinition = 5,
+    OpenBracket = 6,
+    CloseBracket = 7,
+    OpenParenthesis = 8,
+    CloseParenthesis = 9,
+    Comma = 10,
+    Pipe = 11,
+    Column = 12,
+    Star = 13,
+    OpenCurlyBrace = 14,
+    CloseCurlyBrace = 15,
+    HashMark = 16,
+    QuestionMark = 17,
+    Function = 18,
+    Number = 19,
+    Whitespace = 20,
+    Parenthesis = 21,
+    Bracket = 22,
+    Block = 23,
+    Plus = 24,
+    Separator = 25,
+    Exclamation = 26,
+    Ampersand = 27,
+    PipeToken = 28,
+    ColumnToken = 29,
+    AmpersandToken = 30,
+    Parens = 31,
+    PseudoClassToken = 32,
+    PseudoClassFunctionToken = 33,
+    StringToken = 34,
+    AtRuleDefinition = 35,
+    DeclarationNameToken = 36,
+    DeclarationDefinitionToken = 37,
+    SemiColon = 38,
+    Character = 39,
+    InfinityToken = 40,
+    LessThan = 41,
+    GreaterThan = 42,
+    /**
+     * end of token stream
+     */
+    EOF = 43,
+    /**
+     * optional group or tokens, used to group validation tokens
+     *
+     * ```ts
+     * // <bg-layer>#? , <final-bg-layer> -> [<bg-layer>#? ,]? <final-bg-layer>
+     * // , <angular-color-stop> ]#? -> [, <angular-color-stop> ]#?]?
+     * ```
+     */
+    OptionalGroupToken = 44,
+    /**
+     * dimension token
+     *
+     * ```ts
+     * // <time [0s,∞]> -> {
+     * //     typ: ValidationTokenEnum.PropertyType
+     * //     val: 'time',
+     * //     range: {
+     * //         min: ValidationNumberToken,
+     * //         max: null | ValidationNumberToken | ValidationInfinityToken
+     * //     }
+     * // }
+     * ```
+     */
+    Dimension = 45,
+    DisallowWhitespace = 46,
+    Colon = 47
+}
+declare enum ValidationSyntaxGroupEnum {
+    Declarations = "declarations",
+    Functions = "functions",
+    Syntaxes = "syntaxes",
+    Selectors = "selectors",
+    AtRules = "atRules",
+    Units = "units",
+    Languages = "languages",
+    mediaFeatures = "mediaFeatures"
+}
+declare enum MediaFeatureType {
+    BooleanType = "boolean",
+    IntergerType = "integer",
+    KeywordType = "keyword",
+    LengthType = "length",
+    NumberType = "number",
+    RatioType = "ratio",
+    ResolutionType = "resolution",
+    StringType = "string"
+}
+
+interface Position {
+
+    ind: number;
+    lin: number;
+    col: number;
+}
+
+interface ValidationValueRangeMatch {
+        min: ValidationNumberToken;
+        max: ValidationNumberToken | null;
+}
+
+interface ValidationDimensionRangeMatch {
+        min: ValidationDimensionToken;
+        max: ValidationDimensionToken | null;
+}
+
+interface ValidationToken$1 {
+
+    typ: ValidationTokenEnum;
+    pos: Position;
+    // a#
+    isList?: boolean;
+    text?: string;
+    // https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Values_and_units/Value_definition_syntax
+    // a*
+    isRepeatable?: boolean;
+    // https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Values_and_units/Value_definition_syntax
+    // a+
+    isRepeatableAtLeastOnce?: boolean;
+    // https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Values_and_units/Value_definition_syntax
+    // a?
+    isOptional?: boolean;
+    // https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Values_and_units/Value_definition_syntax
+    // a!
+    isMandatatoryGroup?: boolean;
+    // a{1,2}
+    match?: {
+        min: ValidationNumberToken;
+        max: ValidationNumberToken | null;
+    },
+    range?: ValidationValueRangeMatch |  ValidationDimensionRangeMatch
+}
+
+interface ValidationNumberToken extends ValidationToken$1 {
+
+    typ: ValidationTokenEnum.Number;
+    val: number;
+}
+
+interface ValidationDimensionToken extends ValidationToken$1 {
+
+    typ: ValidationTokenEnum.AtRuleName;
+    val: number;
+    unitText: string;
+    unit: keyof EnumToken
+}
 
 interface PropertyType {
 
@@ -2678,6 +2803,10 @@ interface ShorthandPropertyType {
         typ: keyof EnumToken;
         val: string
     };
+    valueSeparator?: {
+        typ: keyof EnumToken;
+        val: string
+    };
     keywords: string[];
 }
 
@@ -2760,7 +2889,7 @@ interface ShorthandType {
 /**
  * @private
  */
-export declare interface PropertiesConfig {
+declare interface PropertiesConfig {
     properties: PropertiesConfigProperties;
     map:        Map$1;
 }
@@ -3160,7 +3289,18 @@ interface BorderRadius {
 /**
  * node walker option
  */
-export declare type WalkerOption = WalkerOptionEnum | AstNode$1 | Token$1 | null;
+declare type WalkerOption = WalkerOptionEnum | AstNode$1 | Token$1 | null;
+/**
+ * returned value:
+ * - {@link WalkerOptionEnum.Ignore}: ignore this node and its children
+ * - {@link WalkerOptionEnum.Stop}: stop walking the tree
+ * - {@link WalkerOptionEnum.Children}: walk the children and ignore the current node
+ * - {@link WalkerOptionEnum.IgnoreChildren}: walk the node and ignore children
+ * - {@link AstNode}:
+ * - {@link Token}:
+ */
+declare type WalkerFilter = (node: AstNode$1) => WalkerOption;
+
 /**
  * returned value:
  * - {@link WalkerOptionEnum.Ignore}: ignore this node and its children
@@ -3170,37 +3310,38 @@ export declare type WalkerOption = WalkerOptionEnum | AstNode$1 | Token$1 | null
  * - {@link AstNode}:
  * - {@link Token}:
  */
-export declare type WalkerFilter = (node: AstNode$1) => WalkerOption;
+declare type WalkerValueFilter = (
+    node: AstNode$1 | Token$1,
+    parent?: AstNode$1 | Token$1 | AstNode$1[] | Token$1[] | null,
+    event?: WalkerEvent,
+    parents?: Generator<Token$1>,
+) => WalkerOption | null;
 
-/**
- * filter nodes
- */
-export declare type WalkerValueFilter = (node: AstNode$1 | Token$1, parent?: AstNode$1 | Token$1 | AstNode$1[] | Token$1[] | null, event?: WalkerEvent) => WalkerOption | null;
-
-export declare interface WalkResult {
+declare interface WalkResult {
     node: AstNode$1;
     parent?: AstRuleList;
     root?: AstNode$1;
+    parents: Generator<AstNode$1>;
 }
 
-export declare interface WalkAttributesResult {
+declare interface WalkAttributesResult {
     value: Token$1;
     previousValue: Token$1 | null;
     nextValue: Token$1 | null;
     root?: AstNode$1 | Token$1 | null;
     parent: AstNode$1 | Token$1 | null;
+    parents: Generator<Token$1>;
 }
 
 /**
  * error description
  */
-export declare interface ErrorDescription {
-
+declare interface ErrorDescription {
     /**
      *  drop rule or declaration
      */
 
-    action: 'drop' | 'ignore';
+    action: "drop" | "ignore";
     /**
      * error message
      */
@@ -3208,7 +3349,7 @@ export declare interface ErrorDescription {
     /**
      * syntax error description
      */
-    syntax?: string | null;
+    syntax?: string | ValidationToken$1 | null;
     /**
      * error node
      */
@@ -3232,46 +3373,58 @@ export declare interface ErrorDescription {
  */
 interface ValidationOptions {
 
+    /**
+     * nested rule context
+     */
+    nestedRule?: boolean;
+
     /**
      * enable css validation
      *
      * see {@link ValidationLevel}
      */
     validation?: boolean | ValidationLevel;
+
     /**
      * lenient validation. retain nodes that failed validation
      */
     lenient?: boolean;
+
     /**
      * visited tokens
      *
      * @private
      */
-    visited?: WeakMap<Token$1, Map<string, Set<ValidationToken>>>;
+    visited?: Map<Token$1, Set<ValidationToken$1>>;
+    
     /**
      * is optional
      *
      * @private
      */
     isOptional?: boolean | null;
+
     /**
      * is repeatable
      *
      * @private
      */
     isRepeatable?: boolean | null;
+
     /**
      * is list
      *
      * @private
      */
     isList?: boolean | null;
+
     /**
      * occurence
      *
      * @private
      */
     occurrence?: boolean | null;
+
     /**
      * at least once
      *
@@ -3284,7 +3437,6 @@ interface ValidationOptions {
  * minify options
  */
 interface MinifyOptions {
-
     /**
      * enable minification
      */
@@ -3361,14 +3513,13 @@ interface MinifyOptions {
     pass?: number;
 }
 
-export declare type LoadResult =
-    Promise<ReadableStream<Uint8Array>>
+declare type LoadResult =
+    | Promise<ReadableStream<Uint8Array>>
     | ReadableStream<Uint8Array>
     | string
     | Promise<string>;
 
-export declare interface ModuleOptions {
-
+declare interface ModuleOptions {
     /**
      * use local scope vs global scope
      */
@@ -3470,7 +3621,7 @@ export declare interface ModuleOptions {
      * - {@link ModuleCaseTransformEnum.DashCaseOnly}: dashCase {@link ParseResult.mapping} key name and the scoped class name
      *
      */
-    naming?: ModuleCaseTransformEnum,
+    naming?: ModuleCaseTransformEnum;
 
     /**
      * optional function to generate scoped name
@@ -3483,15 +3634,15 @@ export declare interface ModuleOptions {
         localName: string,
         filePath: string,
         pattern: string,
-        hashLength?: number
+        hashLength?: number,
     ) => string | Promise<string>;
 }
 
 /**
  * parser options
  */
-export declare interface ParserOptions extends MinifyOptions, MinifyFeatureOptions, ValidationOptions, PropertyListOptions {
-
+declare interface ParserOptions
+    extends MinifyOptions, MinifyFeatureOptions, ValidationOptions, PropertyListOptions {
     /**
      * source file to be used for sourcemap
      */
@@ -3499,7 +3650,7 @@ export declare interface ParserOptions extends MinifyOptions, MinifyFeatureOptio
     /**
      * include sourcemap in the ast. sourcemap info is always generated
      */
-    sourcemap?: boolean | 'inline';
+    sourcemap?: boolean | "inline";
     /**
      * remove at-rule charset
      */
@@ -3518,6 +3669,12 @@ export declare interface ParserOptions extends MinifyOptions, MinifyFeatureOptio
      * expand nested rules
      */
     expandNestingRules?: boolean;
+
+    /**
+     * experimental, convert css if() function into legacy syntax.
+     */
+    expandIfSyntax?: boolean;
+
     /**
      * url and file loader
      * @param url
@@ -3525,7 +3682,11 @@ export declare interface ParserOptions extends MinifyOptions, MinifyFeatureOptio
      * @param responseType
      *
      */
-    load?: (url: string, currentDirectory: string, responseType?: boolean | ResponseType) => Promise<string | ArrayBuffer | ReadableStream<Uint8Array<ArrayBufferLike>>>;
+    load?: (
+        url: string,
+        currentDirectory: string,
+        responseType?: boolean | ResponseType,
+    ) => Promise<string | ArrayBuffer | ReadableStream<Uint8Array<ArrayBufferLike>>>;
     /**
      * get directory name
      * @param path
@@ -3544,7 +3705,11 @@ export declare interface ParserOptions extends MinifyOptions, MinifyFeatureOptio
      * @param currentWorkingDirectory
      *
      */
-    resolve?: (url: string, currentUrl: string, currentWorkingDirectory?: string) => {
+    resolve?: (
+        url: string,
+        currentUrl: string,
+        currentWorkingDirectory?: string,
+    ) => {
         absolute: string;
         relative: string;
     };
@@ -3583,7 +3748,13 @@ export declare interface ParserOptions extends MinifyOptions, MinifyFeatureOptio
     /**
      * css modules options
      */
-    module?: boolean | ModuleCaseTransformEnum | ModuleScopeEnumOptions | ModuleOptions
+    module?: boolean | ModuleCaseTransformEnum | ModuleScopeEnumOptions | ModuleOptions;
+
+    /**
+     * tokenizing info
+     * @private
+     */
+    parseInfo?: ParseInfo;
 }
 
 /**
@@ -3591,8 +3762,7 @@ export declare interface ParserOptions extends MinifyOptions, MinifyFeatureOptio
  *
  * @internal
  */
-export declare interface MinifyFeatureOptions {
-
+declare interface MinifyFeatureOptions {
     /**
      * minify features
      *
@@ -3606,8 +3776,7 @@ export declare interface MinifyFeatureOptions {
  *
  * @internal
  */
-export declare interface MinifyFeature {
-
+declare interface MinifyFeature {
     /**
      * accepted tokens
      */
@@ -3634,16 +3803,22 @@ export declare interface MinifyFeature {
      * @param context
      * @param mode
      */
-    run: (ast: AstRule | AstAtRule, options: ParserOptions, parent: AstRule | AstAtRule | AstStyleSheet, context: {
-        [key: string]: any
-    }, mode: FeatureWalkMode) => AstNode$1 | null;
+    run: (
+        ast: AstRule | AstAtRule,
+        options: ParserOptions,
+        parent: AstRule | AstAtRule | AstStyleSheet,
+        context: {
+            [key: string]: any;
+        },
+        mode: FeatureWalkMode,
+    ) => AstNode$1 | null;
 }
 
 /**
  * resolved path
  * @internal
  */
-export declare interface ResolvedPath {
+declare interface ResolvedPath {
     /**
      * absolute path
      */
@@ -3657,8 +3832,7 @@ export declare interface ResolvedPath {
 /**
  * ast node render options
  */
-export declare interface RenderOptions {
-
+declare interface RenderOptions {
     /**
      * minify css values.
      */
@@ -3698,7 +3872,7 @@ export declare interface RenderOptions {
     /**
      * generate sourcemap object. 'inline' will embed it in the css
      */
-    sourcemap?: boolean | 'inline';
+    sourcemap?: boolean | "inline";
     /**
      * indent string
      */
@@ -3739,14 +3913,12 @@ export declare interface RenderOptions {
 /**
  * transform options
  */
-export declare interface TransformOptions extends ParserOptions, RenderOptions {
-
-}
+declare interface TransformOptions extends ParserOptions, RenderOptions {}
 
 /**
  * parse result stats object
  */
-export declare interface ParseResultStats {
+declare interface ParseResultStats {
     /**
      * source file
      */
@@ -3759,12 +3931,18 @@ export declare interface ParseResultStats {
      * bytes read from imported files
      */
     importedBytesIn: number;
+
+    /**
+     * tokenizing processing time
+     */
+
+    tokenize: string;
     /**
-     * parse processing time
+     * parsing processing time
      */
     parse: string;
     /**
-     * minify processing time
+     * minification processing time
      */
     minify: string;
     /**
@@ -3778,7 +3956,7 @@ export declare interface ParseResultStats {
     /**
      * imported files stats
      */
-    imports: ParseResultStats[],
+    imports: ParseResultStats[];
 
     /**
      * nodes count
@@ -3794,7 +3972,7 @@ export declare interface ParseResultStats {
 /**
  * parse result object
  */
-export declare interface ParseResult {
+declare interface ParseResult {
     /**
      * parsed ast tree
      */
@@ -3827,7 +4005,7 @@ export declare interface ParseResult {
 /**
  * render result object
  */
-export declare interface RenderResult {
+declare interface RenderResult {
     /**
      * rendered css
      */
@@ -3844,18 +4022,17 @@ export declare interface RenderResult {
          * render time
          */
         total: string;
-    },
+    };
     /**
      * source map
      */
-    map?: SourceMap
+    map?: SourceMap;
 }
 
 /**
  * transform result object
  */
-export declare interface TransformResult extends ParseResult, RenderResult {
-
+declare interface TransformResult extends ParseResult, RenderResult {
     /**
      * transform stats
      */
@@ -3896,40 +4073,23 @@ export declare interface TransformResult extends ParseResult, RenderResult {
          * imported files stats
          */
         imports: ParseResultStats[];
-    }
+    };
 }
 
 /**
  * parse token options
  */
-export declare interface ParseTokenOptions extends ParserOptions {
-}
+declare interface ParseTokenOptions extends ParserOptions {}
 
 /**
  * tokenize result object
  * @internal
  */
-export declare interface TokenizeResult {
+declare interface TokenizeResult {
     /**
      * token
      */
-    token: string;
-    /**
-     * token length
-     */
-    len: number;
-    /**
-     * token type hint
-     */
-    hint?: EnumToken;
-    /**
-     * token start position
-     */
-    sta: Position;
-    /**
-     * token end position
-     */
-    end: Position;
+    token: Token$1;
     /**
      * bytes in
      */
@@ -3940,7 +4100,7 @@ export declare interface TokenizeResult {
  * matched selector object
  * @internal
  */
-export declare interface MatchedSelector {
+declare interface MatchedSelector {
     /**
      * matched selector
      */
@@ -3956,14 +4116,14 @@ export declare interface MatchedSelector {
     /**
      * selectors partially match
      */
-    eq: boolean
+    eq: boolean;
 }
 
 /**
  * variable scope info object
  * @internal
  */
-export declare interface VariableScopeInfo {
+declare interface VariableScopeInfo {
     /**
      * global scope
      */
@@ -3994,7 +4154,7 @@ export declare interface VariableScopeInfo {
  * source map object
  * @internal
  */
-export declare interface SourceMapObject {
+declare interface SourceMapObject {
     version: number;
     file?: string;
     sourceRoot?: string;
@@ -4042,6 +4202,313 @@ declare enum ResponseType$1 {
     ArrayBuffer = 2
 }
 
+declare interface ValidationSyntaxNode {
+    syntax: string;
+    ast?: ValidationToken[];
+    descriptors?: Record<string, Record<string, string>>;
+}
+
+interface ValidationSelectorOptions extends ValidationOptions {
+    nestedSelector?: boolean;
+}
+
+declare interface ValidationMediaFeature {
+    type: MediaFeatureType;
+    status?: string;
+    category: string;
+    values?: Array<string> | Array<number>;
+}
+
+declare type ValidationConfiguration = Record<
+    ValidationSyntaxGroupEnum,
+    ValidationSyntaxNode | Record<string, string[]> | Record<string, ValidationMediaFeature>
+>;
+
+interface ValidationResult {
+    valid: SyntaxValidationResult;
+    node: AstNode$1 | Token$1 | null;
+    syntax: ValidationToken | string | null;
+    error: string;
+    cycle?: boolean;
+}
+
+interface ValidationSyntaxResult extends ValidationResult {
+    syntax: ValidationToken | string | null;
+    context: Context<Token$1> | Token$1[];
+}
+
+interface Context<Type> {
+    index: number;
+
+    /**
+     * The length of the context tokens to be consumed
+     */
+
+    readonly length: number;
+
+    current<Type>(): Type | null;
+
+    update<Type>(context: Context<Type>): void;
+
+    consume<Type>(token: Type, howMany?: number): boolean;
+
+    peek<Type>(): Type | null;
+
+    // tokens<Type>(): Type[];
+
+    next<Type>(): Type | null;
+
+    consume<Type>(token: Type, howMany?: number): boolean;
+
+    slice<Type>(): Type[];
+
+    clone<Type>(): Context<Type>;
+
+    done(): boolean;
+}
+
+/**
+ * apply minification rules to the ast tree
+ * @param ast
+ * @param options
+ * @param recursive
+ * @param errors
+ * @param nestingContent
+ *
+ * @private
+ */
+declare function minify(ast: AstNode$1, options: ParserOptions | MinifyFeatureOptions, recursive: boolean, errors?: ErrorDescription[], nestingContent?: boolean): AstNode$1;
+
+/**
+ * expand css nesting ast nodes
+ * @param ast
+ *
+ * @private
+ */
+declare function expand(ast: AstStyleSheet | AstAtRule | AstRule): AstNode$1;
+
+/**
+ * parse a string as an array of declaration nodes
+ * @param declaration
+ *
+ * Example:
+ * ````ts
+ *
+ * const declarations = await parseDeclarations('color: red; background: blue');
+ * console.log(declarations);
+ * ```
+ */
+declare function parseDeclarations(declaration: string): Promise<Array<AstDeclaration | AstComment>>;
+/**
+ * parse css string and return an array of tokens
+ * @param src
+ * @param options
+ *
+ * @private
+ *
+ * Example:
+ *
+ * ```ts
+ *
+ * import {parseString} from '@tbela99/css-parser';
+ *
+ * let tokens = parseString('body { color: red; }');
+ * console.log(tokens);
+ *
+ *  tokens = parseString('#c322c980');
+ * console.log(tokens);
+ * ```
+ */
+declare function parseString(src: string, options?: {
+    location: boolean;
+    src?: string;
+}): Token$1[];
+
+/**
+ * render ast token
+ * @param token
+ * @param options
+ * @private
+ */
+declare function renderToken(token: Token$1, options?: RenderOptions, cache?: {
+    [key: string]: any;
+}, reducer?: (acc: string, curr: Token$1) => string, errors?: ErrorDescription[]): string;
+
+/**
+ * Converts a color to another color space
+ * @param token
+ * @param to
+ *
+ * @private
+ *
+ * ```ts
+ *
+ *     const token = {typ: EnumToken.ColorTokenType, kin: ColorType.HEX, val: '#F00'}
+ *     const result = convertColor(token, ColorType.LCH);
+ *
+ * ```
+ */
+declare function convertColor(token: ColorToken, to: ColorType$1): ColorToken | null;
+
+/**
+ * Calculate the distance between two okLab colors.
+ * @param okLab1
+ * @param okLab2
+ *
+ * @private
+ */
+declare function okLabDistance(okLab1: [number, number, number], okLab2: [number, number, number]): number;
+/**
+ * Check if two colors are close in okLab space.
+ * @param color1
+ * @param color2
+ * @param threshold
+ *
+ * @private
+ */
+declare function isOkLabClose(color1: ColorToken, color2: ColorToken, threshold?: number): boolean;
+
+/**
+ * search the ast tree and return the first match
+ *
+ * ```ts
+ *  // find the first ast declaration node which name is 'aspect-ratio'
+import { find, EnumToken, transform } from "@tbela99/css-parser";
+import type { AstNode } from "@tbela99/css-parser";
+
+ * const css = `
+
+button {
+  aspect-ratio: 1;
+  width: if(media(any-pointer: fine): 30px; else: 44px);
+}
+    `;
+
+ // find declaration which contain a '30px'
+  const nodeMatcher = (node: AstNode) =>
+      return node.typ == EnumToken.DeclarationNodeType && (node as AstDeclaration).nam == 'aspect-ratio';
+
+     const result  = await transform(css);
+     const node = find(result.ast, nodeMatcher);
+
+     console.log({node});
+ 
+    ```
+ *
+ * @param ast
+ * @param matcher
+ * @returns
+ */
+declare function find(ast: AstNode$1, matcher: (node: AstNode$1) => boolean): AstNode$1 | null;
+/**
+ * search the ast tree by checking each node's value and return the first match
+ *
+ * ```ts
+ *  // find the first ast node which contains the length token '30px'
+import { findByValue, EnumToken, transform } from "@tbela99/css-parser";
+import type { AstNode } from "@tbela99/css-parser";
+
+ * const css = `
+
+button {
+  aspect-ratio: 1;
+  width: if(media(any-pointer: fine): 30px; else: 44px);
+}
+    `;
+
+ // find declaration which contain a '30px'
+  const nodeMatcher = (value: Token) =>
+      return value.typ == EnumToken.LengthTokenType && (value as LengthToken).val == 30 && (value as LengthToken).unit == 'px' ;
+
+     const result  = await transform(css);
+     const { node, value } = findByValue(result.ast, nodeMatcher) ?? {};
+
+     console.log({node, value});
+ 
+    ```
+ *
+ * @param ast
+ * @param matcher
+ * @returns
+ */
+declare function findByValue(ast: AstNode$1, matcher: AstValueMatcher): {
+    node: AstNode$1;
+    value: TokenSearchResult;
+} | null;
+/**
+ * search the ast tree and return all matches
+ *
+ * ```ts
+ *  // find the first ast declaration node which name is 'aspect-ratio'
+import { findAll, EnumToken, transform } from "@tbela99/css-parser";
+import type { AstNode } from "@tbela99/css-parser";
+
+ * const css = `
+
+button {
+  aspect-ratio: 1;
+  width: if(media(any-pointer: fine): 30px; else: 44px);
+}
+    `;
+
+ // find declaration which contain a '30px'
+  const nodeMatcher = (node: AstNode) =>
+      return node.typ == EnumToken.DeclarationNodeType && (node as AstDeclaration).nam == 'aspect-ratio';
+
+     const result  = await transform(css);
+     const nodes = findAll(result.ast, nodeMatcher);
+
+     console.log({nodes});
+ 
+    ```
+ *
+ * @param ast
+ * @param matcher
+ * @returns
+ */
+declare function findAll(ast: AstNode$1, matcher: (node: AstNode$1) => boolean): AstNode$1[];
+/**
+ * search the ast tree and return the last match
+ *
+ * ```ts
+ *  // find the first ast declaration node which name is 'aspect-ratio'
+import { findLast, EnumToken, transform } from "@tbela99/css-parser";
+import type { AstNode } from "@tbela99/css-parser";
+
+ * const css = `
+
+button {
+  aspect-ratio: 1;
+  width: if(media(any-pointer: fine): 30px; else: 44px);
+}
+    `;
+
+ // find declaration which contain a '30px'
+  const nodeMatcher = (node: AstNode) =>
+      return node.typ == EnumToken.DeclarationNodeType && (node as AstDeclaration).nam == 'aspect-ratio';
+
+     const result  = await transform(css);
+     const node = findLast(result.ast, nodeMatcher);
+
+     console.log({node});
+ 
+    ```
+ *
+ * @param ast
+ * @param matcher
+ * @returns
+ */
+declare function findLast(ast: AstNode$1, matcher: (node: AstNode$1) => boolean): AstNode$1 | null;
+
+/**
+ *
+ * @param node he nod to clone
+ * @param cloneChildren deep clone
+ * @param cloneMap a map of existing children as keys and their clones as values
+ * @returns
+ */
+declare function cloneNode(node: AstNode$1, cloneChildren?: boolean, cloneMap?: Map<Token$1 | AstNode$1, Token$1 | AstNode$1> | null): AstNode$1;
+
 /**
  * load file or url
  * @param url
@@ -4225,5 +4692,5 @@ declare function transformFile(file: string, options?: TransformOptions, asStrea
  */
 declare function transform(css: string | ReadableStream<Uint8Array>, options?: TransformOptions): Promise<TransformResult>;
 
-export { ColorType, EnumToken, FeatureWalkMode, ModuleCaseTransformEnum, ModuleScopeEnumOptions, ResponseType$1 as ResponseType, SourceMap, ValidationLevel, WalkerEvent, WalkerOptionEnum, convertColor, dirname, expand, isOkLabClose, load, mathFuncs, minify, okLabDistance, parse, parseDeclarations, parseFile, parseString, parseTokens, render, renderToken, resolve, transform, transformFile, transformFunctions, walk, walkValues };
-export type { AddToken, AngleToken, AstAtRule, AstComment, AstDeclaration, AstInvalidAtRule, AstInvalidDeclaration, AstInvalidRule, AstKeyFrameRule, AstKeyframesAtRule, AstKeyframesRule, AstNode$1 as AstNode, AstRule, AstRuleList, AstStyleSheet, AtRuleToken, AtRuleVisitorHandler, AttrEndToken, AttrStartToken, AttrToken, Background, BackgroundAttachmentMapping, BackgroundPosition, BackgroundPositionClass, BackgroundPositionConstraints, BackgroundPositionMapping, BackgroundProperties, BackgroundRepeat, BackgroundRepeatMapping, BackgroundSize, BackgroundSizeMapping, BadCDOCommentToken, BadCommentToken, BadStringToken, BadUrlToken, BaseToken, BinaryExpressionNode, BinaryExpressionToken, BlockEndToken, BlockStartToken, Border, BorderColor, BorderColorClass, BorderProperties, BorderRadius, CDOCommentToken, ChildCombinatorToken, ClassSelectorToken, ColonToken, ColorToken, ColumnCombinatorToken, CommaToken, CommentToken, ComposesSelectorToken, ConstraintsMapping, ContainMatchToken, Context, CssVariableImportTokenType$1 as CssVariableImportTokenType, CssVariableMapTokenType, CssVariableToken$1 as CssVariableToken, DashMatchToken, DashedIdentToken, DeclarationVisitorHandler, DelimToken, DescendantCombinatorToken, DimensionToken, DivToken, EOFToken, EndMatchToken, EqualMatchToken, ErrorDescription, FlexToken, Font, FontFamily, FontProperties, FontWeight, FontWeightConstraints, FontWeightMapping, FractionToken, FrequencyToken, FunctionImageToken, FunctionToken, FunctionURLToken, GenericVisitorAstNodeHandlerMap, GenericVisitorHandler, GenericVisitorResult, GreaterThanOrEqualToken, GreaterThanToken, GridTemplateFuncToken, HashToken, IdentListToken, IdentToken, ImportantToken, IncludeMatchToken, InvalidAttrToken, InvalidClassSelectorToken, LengthToken, LessThanOrEqualToken, LessThanToken, LineHeight, ListToken, LiteralToken, LoadResult, Location, Map$1 as Map, MatchExpressionToken, MatchedSelector, MediaFeatureAndToken, MediaFeatureNotToken, MediaFeatureOnlyToken, MediaFeatureOrToken, MediaFeatureToken, MediaQueryConditionToken, MinifyFeature, MinifyFeatureOptions, MinifyOptions, ModuleOptions, MulToken, NameSpaceAttributeToken, NestingSelectorToken, NextSiblingCombinatorToken, NumberToken, OptimizedSelector, OptimizedSelectorToken, Outline, OutlineProperties, ParensEndToken, ParensStartToken, ParensToken, ParseInfo, ParseResult, ParseResultStats, ParseTokenOptions, ParserOptions, PercentageToken, Position, Prefix, PropertiesConfig, PropertiesConfigProperties, PropertyListOptions, PropertyMapType, PropertySetType, PropertyType, PseudoClassFunctionToken, PseudoClassToken, PseudoElementToken, PseudoPageToken, PurpleBackgroundAttachment, RawSelectorTokens, RenderOptions, RenderResult, ResolutionToken, ResolvedPath, RuleVisitorHandler, SemiColonToken, Separator, ShorthandDef, ShorthandMapType, ShorthandProperties, ShorthandPropertyType, ShorthandType, SourceMapObject, StartMatchToken, StringToken, SubToken, SubsequentCombinatorToken, TimeToken, TimelineFunctionToken, TimingFunctionToken, Token$1 as Token, TokenizeResult, TransformOptions, TransformResult, UnaryExpression, UnaryExpressionNode, UnclosedStringToken, UniversalSelectorToken, UrlToken, ValidationConfiguration, ValidationOptions, ValidationResult, ValidationSelectorOptions, ValidationSyntaxNode, ValidationSyntaxResult, Value, ValueVisitorHandler, VariableScopeInfo, VisitorNodeMap, WalkAttributesResult, WalkResult, WalkerFilter, WalkerOption, WalkerValueFilter, WhitespaceToken };
+export { ColorType$1 as ColorType, EnumToken, FeatureWalkMode, ModuleCaseTransformEnum, ModuleScopeEnumOptions, ResponseType$1 as ResponseType, SourceMap, ValidationLevel, WalkerEvent, WalkerOptionEnum, cloneNode, convertColor, dirname, expand, find, findAll, findByValue, findLast, isOkLabClose, load, minify, okLabDistance, parse, parseDeclarations, parseFile, parseString, render, renderToken, resolve, transform, transformFile, walk, walkValues };
+export type { AddToken, AndToken, AngleToken, AstAtRule, AstComment, AstDeclaration, AstInvalidAtRule, AstInvalidDeclaration, AstInvalidRule, AstKeyFrameRule, AstKeyframesAtRule, AstKeyframesRule, AstNode$1 as AstNode, AstRule, AstRuleList, AstStyleSheet, AstValueMatcher, AtRuleToken, AtRuleVisitorHandler, AttrEndToken, AttrStartToken, AttrToken, Background, BackgroundAttachmentMapping, BackgroundPosition, BackgroundPositionClass, BackgroundPositionConstraints, BackgroundPositionMapping, BackgroundProperties, BackgroundRepeat, BackgroundRepeatMapping, BackgroundSize, BackgroundSizeMapping, BadCDOCommentToken, BadCommentToken, BadStringToken, BadUrlToken, BaseToken, BinaryExpressionNode, BinaryExpressionToken, BlockEndToken, BlockStartToken, Border, BorderColor, BorderColorClass, BorderProperties, BorderRadius, CDOCommentToken, ChildCombinatorToken, ClassSelectorToken, ColonToken, ColorToken, ColumnCombinatorToken, CommaToken, CommentToken, ComposesSelectorToken, ConstraintsMapping, ContainMatchToken, ContainerStyleRangeToken, Context, CssVariableImportTokenType$1 as CssVariableImportTokenType, CssVariableMapTokenType, CssVariableToken$1 as CssVariableToken, DashMatchToken, DashedIdentToken, DeclarationVisitorHandler, DelimToken, DescendantCombinatorToken, DimensionToken, DivToken, EOFToken, EndMatchToken, EqualMatchToken, ErrorDescription, FlexToken, Font, FontFamily, FontProperties, FontWeight, FontWeightConstraints, FontWeightMapping, FractionToken, FrequencyToken, FunctionDefToken, FunctionImageToken, FunctionToken, FunctionURLToken, GenericVisitorAstNodeHandlerMap, GenericVisitorHandler, GenericVisitorResult, GreaterThanOrEqualToken, GreaterThanToken, GridTemplateFuncToken, HashToken, IdentListToken, IdentToken, IfConditionToken, IfElseConditionToken, ImportantToken, IncludeMatchToken, InvalidAttrToken, InvalidClassSelectorToken, InvalidMediaQueryToken, LengthToken, LessThanOrEqualToken, LessThanToken, LineHeight, ListToken, LiteralToken, LoadResult, Location, Map$1 as Map, MatchExpressionToken, MatchedSelector, MediaFeatureOnlyToken, MediaFeatureToken, MediaQueryConditionToken, MediaQueryUnaryFeatureToken, MediaRangeQueryToken, MinifyFeature, MinifyFeatureOptions, MinifyOptions, ModuleOptions, MulToken, NameSpaceAttributeToken, NestingSelectorToken, NextSiblingCombinatorToken, NotToken, NumberToken, OptimizedSelector, OptimizedSelectorToken, OrToken, Outline, OutlineProperties, ParensEndToken, ParensStartToken, ParensToken, ParseInfo$1 as ParseInfo, ParseResult, ParseResultStats, ParseTokenOptions, ParserOptions, PercentageToken, Position$1 as Position, Prefix, PropertiesConfig, PropertiesConfigProperties, PropertyListOptions, PropertyMapType, PropertySetType, PropertyType, PseudoClassFunctionToken, PseudoClassToken, PseudoElementToken, PseudoPageToken, PurpleBackgroundAttachment, RawNodeToken, RawSelectorTokens, RenderOptions, RenderResult, ResolutionToken, ResolvedPath, RuleVisitorHandler, SemiColonToken, Separator, ShorthandDef, ShorthandMapType, ShorthandProperties, ShorthandPropertyType, ShorthandType, SourceMapObject, StartMatchToken, StringToken, SubToken, SubsequentCombinatorToken, SupportsQueryConditionToken, SupportsQueryUnaryConditionToken, TimeToken, TimelineFunctionToken, TimingFunctionToken, Token$1 as Token, TokenSearchResult, TokenizeResult, TransformOptions, TransformResult, UnaryExpression, UnaryExpressionNode, UnclosedStringToken, UniversalSelectorToken, UrlToken, ValidationConfiguration, ValidationMediaFeature, ValidationOptions, ValidationResult, ValidationSelectorOptions, ValidationSyntaxNode, ValidationSyntaxResult, ValidationToken$1 as ValidationToken, Value, ValueVisitorHandler, VariableScopeInfo, VisitorNodeMap, WalkAttributesResult, WalkResult, WalkerFilter, WalkerOption, WalkerValueFilter, WhenElseQueryConditionToken, WhenElseUnaryConditionToken, WhitespaceToken };