thephpleague/commonmark

Added

• Added ListBlock::setTight() method

Fixed

• Fixed incorrect version constant value (#322)

Added

• Added new RegexHelper::isEscapable() method

Fixed

• Fixed spec compliance bug where escaped spaces should not be allowed in link destinations

Added

• Added a new constant containing the current version: CommonMarkConverter::VERSION (#314)

This release contains several breaking changes and a minimum PHP version bump - see UPGRADE.md for more details.

Added

• Added new max_nesting_level setting (#243)
• Added minor performance optimizations to Cursor

Changed

• Minimum PHP version is now 5.6.5.
• All full and partial regular expressions in RegexHelper are now defined as constants instead of being built on-the-fly.
• Cursor::saveState() now returns an array instead of a CursorState object.
• Cursor::restoreState() now accepts an array parameter instead of a CursorState object.
• Saving/restoring the Cursor state no longer tracks things that don't change (like the text content).
• RegexHelper is now final.
• References to InlineContainer changed to new InlineContainerInterface interface.
• MiscExtension::addInlineParser() and MiscExtension::addBlockRenderer() now return $this instead of nothing.

Fixed

• Fixed Reference::normalizeReference() not properly collapsing whitespace to a single space

Deprecated

• RegexHelper::getInstance() and all instance (non-static) methods have been deprecated.
• The InlineContainer interface has been deprecated. Use InlineContainerInterface instead.

Removed

• Removed support for PHP 5.4 and 5.5.
• Removed CursorState class
• Removed all previous deprecations:
  • Cursor::getFirstNonSpacePosition()
  • Cursor::getFirstNonSpaceCharacter()
  • Cursor::advanceWhileMatches()
  • Cursor::advanceToFirstNonSpace()
  • ElementRendererInterface::escape()
  • HtmlRenderer::escape()
  • RegexHelper::REGEX_UNICODE_WHITESPACE
  • RegexHelper::getLinkDestinationRegex()

This release contains breaking changes, several performance improvements, and two deprecations:

Added

• Added new Xml utility class; moved HTML/XML escaping logic into there (see deprecations below)

Changed

• Environment::getInlineParsersForCharacter() now returns an empty array (instead of null) when no matching parsers are found
• Three utility classes are now marked final:
  • Html5Entities
  • LinkParserHelper
  • UrlEncoder

Fixed

• Improved performance of several methods (for a 10% overall performance boost - #292)

Deprecated

The following methods were deprecated and are scheduled for removal in 0.17.0 or 1.0.0 (whichever comes first). See UPGRADE.md for more information.

• Cursor::advanceWhileMatches() deprecated; use Cursor::match() instead.
• HtmlRenderer::escape() deprecated; use Xml::escape() instead.

Removed

• Removed DelimiterStack::findFirstMatchingOpener() which was previously deprecated in 0.15.0

Fixed

• Improved performance of Cursor::advanceBy() (for a 16% performance boost!) 🎉

Fixed

• Fixed URI normalization not properly encoding/decoding special characters in certain cases (#287)

This release bumps spec compliance to 0.28 without breaking changes to the API.

Added

• Project is now tested against PHP 7.2

Changed

• Bumped CommonMark spec target to 0.28
• Changed internal implementation of LinkParserHelper::parseLinkDestination() to allow nested parens
• Changed precedence of strong/emph when both nestings are possible (rule 14)
• Allow tabs before and after ATX closing header

Fixed

• Fixed HTML type 6 block regex matching against <pre> (it shouldn't) and not matching <iframe> (it should)
• Fixed reference parser incorrectly handling escaped ] characters
• Fixed "multiple of 3" delimiter run calculations

Deprecated

An unused constant and static method were deprecated and will be removed in a future release. See <UPGRADE.md> for more information.

• Deprecated RegexHelper::REGEX_UNICODE_WHITESPACE (no longer used)
• Deprecated RegexHelper::getLinkDestinationRegex() (no longer used)