website/node_modules/css-tree/HISTORY.md

In JohnCoene/chirp: 'Twitter' Networks Analyser

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)
• Pined 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 translateMarkup(ast, enter, leave) method, use generate(ast, { decorator: (handlers) => { ... }}) instead
  • 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 })
  • Removed walkRules(ast, fn), use walk(ast, { visit: 'Rule', enter: fn }) instead
  • Removed walkRulesRight(ast, fn), use walk(ast, { visit: 'Rule', reverse: true, enter: fn }) instead
  • Removed walkDeclarations(ast, fn), use walk(ast, { visit: 'Declaration', enter: fn }) instead
  • 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)
• Rename at-rule's expression to prelude (since spec names it so)
  • AtruleExpression node type → AtrulePrelude
  • Atrule.expression field → Atrule.prelude
  • parseAtruleExpression parser's option → parseAtrulePrelude
  • atruleExpression parse context → atrulePrelude
  • 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

1.0.0-alpha19 (April 24, 2017)

• Extended List class with new methods:
  • List#prepend(item)
  • List#prependData(data)
  • List#insertData(data)
  • List#insertList(list)
  • List#replace(item, itemOrList)

1.0.0-alpha18 (April 3, 2017)

• Added atrule walk context (#39)
• Changed a result of generate method for AnPlusB, AttributeSelector, Function, MediaFeature and Ratio (1e95877)
• Fixed typo in List exception messages (@strarsis, #42)
• Improved tokenizer to convert an input to a string

1.0.0-alpha17 (March 13, 2017)

• Implemented new concept of syntax
  • Changed main exports to expose a default syntax
  • Defined initial CSS syntax
  • Implemented createSyntax() method to create a new syntax from scratch
  • Implemented fork() method to create a new syntax based on given via extension
• Parser
  • Implemented mediaQueryList and mediaQuery parsing contexts
  • Implemented CDO and CDC node types
  • Implemented additional declaration property prefix hacks (# and +)
  • Added support for UTF-16LE BOM
  • Added support for @font-face at-rule
  • Added chroma() to legacy IE filter functions
  • Improved HexColor to consume hex only
  • Improved support for \0 and \9 hacks (#2)
  • Relaxed number check for Ratio terms
    • Allowed fractal values as a Ratio term
    • Disallowed zero number as a Ratio term
  • Changed important clause parsing
    • Allowed any identifier for important (to support hacks like !ie)
    • Store true for important field in case identifier equals to important and string otherwise
  • Fixed parse error formatted message rendering to take into account tabs
  • Removed exposing of Parser class
  • Removed readSelectorSequence(), readSequenceFallback() and readSelectorSequenceFallback methods
  • Used single universal sequence consumer for AtruleExpression, Selector and Value
• Generator
  • Reworked generator to use auto-generated functions based on syntax definition (additional work to be done in next releases)
  • Implemented translateMarkup(ast, before, after) method for complex cases
  • Reworked translateWithSourceMap to be more flexible (based on translateMarkup, additional work to be done in next releases)
• Walker
  • Reworked walker to use auto-generated function based on syntax definition (additional work to be done in next releases)
• Lexer
  • Prepared for better extensibility (additional work to be done in next releases)
  • Implemented checkStructure(ast) method to check AST structure based on syntax definition
  • Update syntax dictionaries to latest mdn/data
    • Add missing <'offset-position'> syntax
    • Extended <position> property with -webkit-sticky (@sergejmueller, #37)
  • Improved mismatch error position
• Implemented script (gen:syntax) to generate AST format reference page (docs/ast.md) using syntax definition

1.0.0-alpha16 (February 12, 2017)

• Exposed Parser class
• Added startOffset option to Tokenizer (constructor and setSource() method)
• Added fallback functions for default (readSequenceFallback) and selector (readSelectorSequenceFallback) sequence readers
• Fixed edge cases for AnPlusB
• Fixed wrong whitespace ignoring in Selector consumer

1.0.0-alpha15 (February 8, 2017)

• Fixed broken atruleExpression context
• Fixed vendor prefix detection in keyword() and property()
• Fixed property() to not lowercase custom property names
• Added variable boolean flag in property() result
• Renamed scanner into tokenizer
• Ranamed syntax into lexer
• Moved docs/*.html files to csstree/docs repo
• Added element() function for Value context (-moz-element() supported as well)
• Merged Universal node type into Type
• Renamed node types:
  • Id -> IdSelector
  • Class -> ClassSelector
  • Type -> TypeSelector
  • Attribute -> AttributeSelector
  • PseudoClass -> PseudoClassSelector
  • PseudoElement -> PseudoElementSelector
  • Hash -> HexColor
  • Space -> WhiteSpace
  • An+B -> AnPlusB
• Removed Progid node type
• Relaxed MediaQuery consumer to not validate syntax on parse and to include whitespaces in children sequence as is
• Added WhiteSpace.value property to store whitespace sequence
• Implemented parser options to specify what should be parsed in details (when option is false some part of CSS represents as balanced Raw):
  • parseAtruleExpression – to parse at-rule expressions (true by default)
  • parseSelector – to parse rule's selector (true by default)
  • parseValue - to parse declaration's value (true by default)
  • parseCustomProperty – to parse value and fallback of custom property (false by default)
• Changed tokenization to stick leading hyphen minus to identifier token
• Changed selector parsing:
  • Don't convert spaces into descendant combinator
  • Don't validate selector structure on parsing (selectors may be checked by lexer later)
• Initial refactoring of docs
• Various improvements and fixes

1.0.0-alpha14 (February 3, 2017)

• 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)

1.0.0-alpha11 (January 18, 2017)

• Added support for :matches(<selector-list>) (#28)
• Added support for :has(<relative-selector-list>)
• Added support for ::slotted(<compound-selector>)
• Implemented Brackets node type
• Implemented basic support for at-rule inside rule block (#24)
• Renamed Selector node type to SelectorList
• Renamed SimpleSelector node type to Selector
• Renamed UnicodeRange.name property to UnicodeRange.value
• Replaced Negation node type for regular PseudoClass
• Unified name of node property to store nested nodes, it always children now:
  • StyleSheet.rules -> StyleSheet.children
  • SelectorList.selectors -> SelectorList.children
  • Block.declarations -> Block.children
  • *.sequence -> *.children
• Fixed edge cases in parsing Hex and UnicodeRange when number not an integer
• Changed nth- pseudos parsing
  • Implemented An+B node type to represent expressions like 2n + 1 or -3n
  • Fixed edge cases when a or b is not an integer
  • Changed odd and even keywords processing, keywords are storing as Identifier node type now
  • Changed Nth node type format to store a nth-query and an optional selector
  • Implemented of clause for nth- pseudos (a.e. :nth-child(2n + 1 of li, img))
  • Limited Nth parsing rules to :nth-child(), :nth-last-child(), :nth-of-type() and :nth-last-of-type() pseudos
• Changed the way to store locations
  • Renamed info node property to loc
  • Changed format of loc to store start and end positions

1.0.0-alpha10 (January 11, 2017)

• Reworked Scanner to be a single point to its functionality
• Exposed Scanner class to be useful for external projects
• Changed walk() function behaviour to traverse AST nodes in natural order
• Implemented walkUp() function to traverse AST nodes from deepest to parent (behaves as walk() before)

1.0.0-alpha9 (December 21, 2016)

• Fixed <angle> generic according to specs that allow a <number> equals to zero to be used as valid value (#30)

1.0.0-alpha8 (November 11, 2016)

• Fixed Scanner#skip() issue method when cursor is moving to the end of source
• Simplified Progid node
• Changed behaviour for bad selector processing, now parsing fails instead of selector ignoring
• Fixed <id-selector> generic syntax
• Added q unit for <length> generic syntax
• Refactored syntax parser (performance)
• Reduced startup time by implementing lazy syntax parsing (default syntax doesn't parse on module load)
• Updated syntax dictionaries and used mdn/data instead of Template:CSSData
• Renamed syntax.stringify() method to syntax.translate()
• Simplified generic syntax functions, those functions receive a single AST node for checking and should return true or false
• Added exception for values that contains var(), those values are always valid for now
• Added more tests and increase code coverage to 98.5%

1.0.0-alpha7 (October 7, 2016)

• Added support for explicit descendant combinator (>>)
• Implemented Type and Universal type nodes
• Improved Number parsing by including sign and exponent (#26)
• Parse before, after, first-letter and first-line pseudos with single colon as PseudoElement
• Changed FunctionalPseudo node type to PseudoClass
• Fixed attribute selector name parsing (namespace edge cases)
• Fixed location calculation for specified offset when eof is reached
• Added more non-standard colors (#25)
• Removed obsolete Syntax#getAll() method
• Fixed various edge cases, code clean up and performance improvements

1.0.0-alpha6 (September 23, 2016)

• More accurate positions for syntax mismatch errors
• Added apple specific font keywords (#20)
• Changed Property node stucture from object to string
• Renamed Ruleset node type to Rule
• Removed Argument node type
• Fixed Dimension and Percentage position computation
• Fixed bad selector parsing (temporary solution)
• Fixed location computation for CSS with very long lines that may lead to really long parsing with positions:true (even freeze)
• Fixed line and column computation for SyntaxMatch error
• Improved performance of parsing and translation. Now CSSTree is under 10ms in PostCSS benchmark.

JohnCoene/chirp documentation built on May 25, 2021, 6:33 p.m.