Bumped source-map version to ^0.6.1 to fix source map generation inconsistency across node.js versions due to mappings sorting bug and v8 moving to a stable Array#sort (fix commit in source-map)
1.0.0-alpha.36 (October 13, 2019)
Dropped support for Node < 8
Updated dev deps (fixed npm audit issues)
Reworked build pipeline
Package provides dist/csstree.js and dist/csstree.min.js now (instead of single dist/csstree.js that was a min version)
Bundle size (min version) reduced from 191Kb to 158Kb due to some optimisations
Definition syntax
Renamed grammar into definitionSyntax (named per spec)
Added compact option to generate() method to avoid formatting (spaces) when possible
Lexer
Changed dump() method to produce syntaxes in compact form by default
1.0.0-alpha.35 (October 7, 2019)
Walker
Changed implementation to avoid runtime compilation due to CSP issues (see #91, #109)
Removed <number-zero-one>, <number-one-or-greater> and <positive-integer> from generic types. In fact, types moved to patch, because those types can be expressed in a regular grammar due to bracketed range notation implemented
Added support for multiple token string matching
Improved <custom-ident> production matching to claim the keyword only if no other unfulfilled production can claim it (#101)
Improved <length> production matching to claim "unitless zero" only if no other unfulfilled production can claim it
Changed lexer's constructor to prevent generic types override when used
Fixed large ||- and &&-group matching, matching continues from the beginning on term match (#85)
Fixed checking that value has var() occurrences when value is a string (such values can't be matched on syntax currently and fail with specific error that can be used for ignorance in validation tools)
Fixed <declaration-value> and <any-value> matching when a value contains a function, parentheses or braces
1.0.0-alpha.30 (July 3, 2019)
Bumped mdn/data to ~2.0.3
Removed type removals from mdn/data due to lack of some generic types and specific lexer restictions (since lexer was reworked, see below)
Changed parsing algorithms to work with new token type set
Changed HexColor consumption in way to relax checking a value, i.e. now value is a sequence of one or more name chars
Added & as a property hack
Relaxed var() parsing to only check that a first arguments is an identifier (not a custom property name as before)
Lexer
Reworked syntax matching to relay on token set only (having AST is optional now)
Extended Lexer#match(), Lexer#matchType() and Lexer#matchProperty() methods to take a string as value, beside AST as a value
Extended Lexer#match() method to take a string as a syntax, beside of syntax descriptor
Reworked generic types:
Removed <attr()>, <url> (moved to patch) and <progid> types
Added types:
Related to token types: <ident-token>, <function-token>, <at-keyword-token>, <hash-token>, <string-token>, <bad-string-token>, <url-token>, <bad-url-token>, <delim-token>, <number-token>, <percentage-token>, <dimension-token>, <whitespace-token>, <CDO-token>, <CDC-token>, <colon-token>, <semicolon-token>, <comma-token>, <[-token>, <]-token>, <(-token>, <)-token>, <{-token> and <}-token>
Complex types: <an-plus-b>, <urange>, <custom-property-name>, <declaration-value>, <any-value> and <zero>
Renamed <unicode-range> to <urange> as per spec
Renamed <expression> (IE legacy extension) to <-ms-legacy-expression> and may to be removed in next releases
1.0.0-alpha.29 (May 30, 2018)
Lexer
Syntax matching was completely reworked. Now it's token-based and uses state machine. Public API has not changed. However, some internal data structures have changed. Most significal change in syntax match result tree structure, it's became token-based instead of node-based.
Grammar
Changed grammar tree format:
Added Token node type to represent a single code point (<delim-token>)
Added Multiplier that wraps a single node (term property)
Added AtKeyword to represent <at-keyword-token>
Removed Slash and Percent node types, they are replaced for a node with Token type
Changed Function to represent <function-token> with no children
Removed multiplier property from Group
Changed generate() method:
Method takes an options as second argument now (generate(node, forceBraces, decorator) -> generate(node, options)). Two options are supported: forceBraces and decorator
When a second parameter is a function it treats as decorate option value, i.e. generate(node, fn) -> generate(node, { decorate: fn })
Decorate function invokes with additional parameter – a reference to a node
Tokenizer
Renamed Atrule const to AtKeyword
1.0.0-alpha.28 (February 19, 2018)
Renamed lexer.grammar.translate() method into generate()
Fixed <'-webkit-font-smoothing'> and <'-moz-osx-font-smoothing'> syntaxes (#75)
Added vendor keywords for <'overflow'> property syntax (#76)
Pinned mdn-data to ~1.1.0 and fixed issues with some updated property syntaxes
1.0.0-alpha.27 (January 14, 2018)
Generator
Changed node's generate() methods invocation, methods now take a node as a single argument and context (i.e. this) that have methods: chunk(), node() and children()
Renamed translate() to generate() and changed to take options argument
Removed translateWithSourceMap(ast), use generate(ast, { sourceMap: true }) instead
Changed to support for children as an array
Walker
Changed walk() to take an options argument instead of handler, with enter, leave, visit and reverse options (walk(ast, fn) is still works and equivalent to walk(ast, { enter: fn }))
Removed walkUp(ast, fn), use walk(ast, { leave: fn })
Changed to support for children as array in most cases (reverse: true will fail on arrays since they have no forEachRight() method)
Misc
List
Added List#forEach() method
Added List#forEachRight() method
Added List#filter() method
Changed List#map() method to return a List instance instead of Array
Added List#push() method, similar to List#appendData() but returns nothing
Added List#pop() method
Added List#unshift() method, similar to List#prependData() but returns nothing
Added List#shift() method
Added List#prependList() method
Changed List#insert(), List#insertData(), List#appendList() and List#insertList() methods to return a list that performed an operation
Changed keyword() method
Changed name field to include a vendor prefix
Added basename field to contain a name without a vendor prefix
Added custom field that contain a true when keyword is a custom property reference
Changed property() method
Changed name field to include a vendor prefix
Added basename field to contain a name without any prefixes, i.e. a hack and a vendor prefix
Added vendorPrefix() method
Added isCustomProperty() method
1.0.0-alpha.26 (November 9, 2017)
Tokenizer
Added Tokenizer#isBalanceEdge() method
Removed Tokenizer.endsWith() method
Parser
Made the parser tolerant to errors by default
Removed tolerant parser option (no parsing modes anymore)
Removed property parser option (a value parsing does not depend on property name anymore)
Canceled error for a handing semicolon in a block
Canceled error for unclosed Brackets, Function and Parentheses when EOF is reached
Fixed error when prelude ends with a comment for at-rules with custom prelude consumer
Relaxed at-rule parsing:
Canceled error when EOF is reached after a prelude
Canceled error for an at-rule with custom block consumer when at-rule has no block (just don't apply consumer in that case)
Canceled error on at-rule parsing when it occurs outside prelude or block (at-rule is converting to Raw node)
Allowed for any at-rule to have a prelude and a block, even if it's invalid per at-rule syntax (the responsibility for this check is moved to lexer, since it's possible to construct a AST with such errors)
Made a declaration value a safe parsing point (i.e. error on value parsing lead to a value is turning into Raw node, not a declaration as before)
Excluded surrounding white spaces and comments from a Raw node that represents a declaration value
Changed Value parse handler to return a node only with type Value (previously it returned a Raw node in some cases)
Fixed issue with onParseError() is not invoked for errors occured on selector or declaration value parsing in some cases
Changed using of onParseError() to stop parsing if handler throws an exception
Lexer
Changed grammar.walk() to invoke passed handler on entering to node rather than on leaving the node
Improved grammar.walk() to take a walk handler pair as an object, i.e. walk(node, { enter: fn, leave: fn })
Changed Lexer#match*() methods to take a node of any type, but with a children field
Added Lexer#match(syntax, node) method
Fixed Lexer#matchType() method to stop return a positive result for the CSS wide keywords
1.0.0-alpha25 (October 9, 2017)
Parser
Added fallback node as argument to onParseError() handler
Fixed raw consuming in tolerant mode when selector is invalid (greedy consuming and redundant warnings)
Fixed exception in tolerant mode caused by unknown at-rule with unclosed block
Changed handling of semicolons:
Hanging semicolon inside declaration blocks raise an error or turns into a Raw node in tolerant mode instead of being ignored
Semicolon outside of declaration blocks opens a Rule node as part of selector instead of being ignored
Aligned parseAtrulePrelude behaviour to parseRulePrelude
Removed Raw node wraping into AtrulePrelude when parseAtrulePrelude is disabled
Removed error emitting when at-rule has a custom prelude customer but no prelude is found (it should be validated by a lexer later)
Generator
Fixed performance issue with translateWithSourceMap(), flattening the string (because of mixing building string and indexing into it) turned it into a quadratic algorithm (approximate numbers can be found in the quiz created by this case)
Added support for a single solidus hack for property()
Minor fixes for custom errors
1.0.0-alpha24 (September 14, 2017)
Improved CSSTree to be stable for standart build-in objects extension (#58)
Parser
Renamed rule's selector to prelude. The reasons: spec names this part so, and this branch can contain not only a selector (SelectorList) but also a raw payload (Raw). What's changed:
Renamed Rule.selector to Rule.prelude
Renamed parseSelector parser option to parseRulePrelude
Removed option for selector parse in SelectorList
Lexer
Fixed undefined positions in a error when match a syntax to empty or white space only value
Improved Lexer#checkStructure()
Return a warning as an object with node reference and message
No exception on unknown node type, return a warning instead
1.0.0-alpha23 (September 10, 2017)
Fixed Tokenizer#getRawLength()'s false positive balance match to the end of input in some cases (#56)
Rename walker's entry point methods to be the same as CSSTree exposed methods (i.e. walk(), walkUp() etc)
atruleExpression walk context reference → atrulePrelude
1.0.0-alpha22 (September 8, 2017)
Parser
Fixed exception on parsing of unclosed {}-block in tolerant mode
Added tolerant mode support for DeclarationList
Added standalone entry point, i.e. default parser can be used via require('css-tree/lib/parser') (#47)
Generator
Changed generator to produce +n when AnPlusB.a is +1 to be "round-trip" with parser
Added standalone entry point, i.e. default generators can be used via require('css-tree/lib/generator')
Walker
Added standalone entry point, i.e. default walkers can be used via require('css-tree/lib/walker') (#47)
Lexer
Added default keyword to the list of invalid values for <custom-ident> (since it reversed per spec)
Convertors (toPlainObject() and fromPlainObject()) moved to lib/convertor (entry point is require('css-tree/lib/convertor'))
1.0.0-alpha21 (September 5, 2017)
Tokenizer
Added Raw token type
Improved tokenization of url() with raw as url to be more spec complient
Added Tokenizer#balance array computation on token layout
Added Tokenizer#getRawLength() to compute a raw length with respect of block balance
Added Tokenizer#getTokenStart(offset) method to get token start offset by token index
Added idx and balance fields to each token of Tokenizer#dump() method result
Parser
Added onParseError option
Reworked node parsers that consume a Raw node to use a new approach. Since now a Raw node builds in parser#Raw() function only
Changed semantic of parser#Raw(), it takes 5 parameters now (it might to be changed in future)
Changed parser#tolerantParse() to pass a start token index to fallback function instead of source offset
Fixed AtruleExpression consuming in tolerant mode
Atrule handler to convert an empty AtruleExpression node into null
Changed AtruleExpression handler to always return a node (before it could return a null in some cases)
Lexer
Fixed comma match node for # multiplier
Added reference name to SyntaxReferenceError
Additional fixes on custom errors
Reduced possible corruption of base config by syntax.fork()
1.0.0-alpha20 (August 28, 2017)
Tokenizer
Added Atrule token type (<at-rule-token> per spec)
Added Function token type (<function-token> per spec)
Added Url token type
Replaced Tokenizer#getTypes() method with Tokenizer#dump() to get all tokens as an array
Renamed Tokenizer.TYPE.Whitespace to Tokenizer.TYPE.WhiteSpace
Renamed Tokenizer.findWhitespaceEnd() to Tokenizer.findWhiteSpaceEnd()
Parser
Added initial implementation of tollerant mode (turn on by passing tolerant: true option). In this mode parse errors are never occour and any invalid part of CSS turns into a Raw node. Current safe points: Atrule, AtruleExpression, Rule, Selector and Declaration. Feature is experimental and further improvements are planned.
Changed Atrule.expression to contain a AtruleExpression node or null only (other node types is wrapping into a AtruleExpression node)
Renamed AttributeSelector.operator to AttributeSelector.matcher
Generator
translate() method is now can take a function as second argument, that recieves every generated chunk. When no function is passed, default handler is used, it concats all the chunks and method returns a string.
Lexer
Used mdn/data package as source of lexer's grammar instead of local dictionaries
Added x unit to <resolution> generic type
Improved match tree:
Omited Group (sequences) match nodes
Omited empty match nodes (for terms with zero or more multipliers)
Added ASTNode node type to contain a reference to AST node
Fixed node duplication (uncompleted match were added to tree)
Added AST node reference in match nodes
Added comma match node by # multiplier
Grammar
Changed translate() function to get a handler as third argument (optional). That handler recieves result of node traslation and can be used for decoration purposes. See example
Added SyntaxParseError to grammar export
Reworked group and multipliers representation in syntax tree:
Replaced Sequence for Group node type (Sequence node type removed)
Added explicit boolean property for Group
Only groups can have a multiplier now (other node types is wrapping into a single term implicit group when multiplier is applied)
Renamed nonEmpty Group's property to disallowEmpty
Added optimisation for syntax tree by dropping redundant root Group when it contains a single Group term (return this Group as a result)
Changed lexer's match functionality
Changed Lexer#matchProperty() and Lexer#matchType() to return an object instead of match tree. A match tree stores in matched field when AST is matched to grammar successfully, otherwise an error in error field. The result object also has some methods to test AST node against a match tree: getTrace(), isType(), isProperty() and isKeyword()
Added Lexer#matchDeclaration() method
Removed Lexer#lastMatchError (error stores in match result object in error field)
Added initial implementation of search for AST segments (new lexer methods: Lexer#findValueSegments(), Lexer#findDeclarationValueSegments() and Lexer#findAllSegments)
Implemented SyntaxReferenceError for unknown property and type references
Renamed field in resulting object of property() function: variable → custom
Fixed issue with readonly properties (e.g. line and column) of Error and exception on attempt to write in iOS Safari
Implemented DeclarationList, MediaQueryList, MediaQuery, MediaFeature and Ratio node types
Implemented declarationList context (useful to parse HTML style attribute content)
Implemented custom consumers for @import, @media, @page and @supports at-rules
Implemented atrule option for parse() config, is used for atruleExpession context to specify custom consumer for at-rule if any
Added Scanner#skipWS(), Scanner#eatNonWS(), Scanner#consume() and Scanner#consumeNonWS() helper methods
Added custom consumers for known functional-pseudos, consume unknown functional-pseudo content as balanced Raw
Allowed any PseudoElement to be a functional-pseudo (#33)
Improved walker implementations to reduce GC thrashing by reusing cursors
Changed Atrule.block to contain a Block node type only if any
Changed Block.loc positions to include curly brackets
Changed Atrule.expression to store a null if no expression
Changed parser to use StyleSheet node type only for top level node (when context is stylesheet, that's by default)
Changed Parentheses, Brackets and Function consumers to use passed sequence reader instead of its own
Changed Value and AtruleExpression consumers to use common sequence reader (that reader was used by Value consumer before)
Changed default sequence reader to exclude storage of spaces around Comma
Changed processing of custom properties:
Consume declaration value as balanced Raw
Consume var() fallback value as balanced Raw
Validate first argument of var() starts with double dash
Custom property's value and fallback includes spaces around
Fixed Nth to have a loc property
Fixed SelectorList.loc and Selector.loc positions to exclude spaces
Fixed issue Browserify build fail with default-syntax.json is not found error (#32, @philschatz)
Disallowed Type selector starting with dash (parser throws an error in this case now)
Disallowed empty selectors for Rule (not sure if it's correct but looks reasonable)
Removed >> combinator support until any browser support (no signals about that yet)
Removed PseudoElement.legacy property
Removed special case for :before, :after, :first-letter and :first-line to represent them as PseudoElement, now those pseudos are represented as PseudoClass nodes
Removed deprecated Syntax#match() method
Parser was splitted into modules and related changes, one step closer to an extensible parser
Various fixes and improvements, all changes have negligible impact on performance
1.0.0-alpha13 (January 19, 2017)
Changed location storing in SyntaxMatchError
Changed property to store mismatch offset to mismatchOffset
Changed offset property to store bad node offset in source CSS if any
Added loc property that stores bad node loc if any
1.0.0-alpha12 (January 19, 2017)
Fixed Syntax#matchProperty() method to always return a positive result for custom properties since syntax is never defined for them (#31)
Implemented fromPlainObject() and toPlainObject() to convert plain object to AST or AST to plain object (currently converts List <-> Array)
