commonmark

Fixed

• Fixed declaration parser being too strict
• FencedCodeRenderer: don't add language- to class if already prefixed

New Contributors

• @sergiy-petrov made their first contribution in https://github.com/thephpleague/commonmark/pull/997
• @clustermin made their first contribution in https://github.com/thephpleague/commonmark/pull/988
• @peter279k made their first contribution in https://github.com/thephpleague/commonmark/pull/996

Full Changelog: https://github.com/thephpleague/commonmark/compare/2.4.1...2.4.2

Fixed

• Fixed ExternalLinkProcessor not fully disabling the rel attribute when configured to do so (#992)

See the upgrading guide for more information about the exception-related changes

Added

• Added generic CommonMarkException marker interface for all exceptions thrown by the library
• Added several new specific exception types implementing that marker interface:
  • AlreadyInitializedException
  • InvalidArgumentException
  • IOException
  • LogicException
  • MissingDependencyException
  • NoMatchingRendererException
  • ParserLogicException
• Added more configuration options to the Heading Permalinks extension (#939):
  • heading_permalink/apply_id_to_heading - When true, the id attribute will be applied to the heading element itself instead of the <a> tag
  • heading_permalink/heading_class - class to apply to the heading element
  • heading_permalink/insert - now accepts none to prevent the creation of the <a> link
• Added new table/alignment_attributes configuration option to control how table cell alignment is rendered (#959)

Changed

• Change several thrown exceptions from RuntimeException to LogicException (or something extending it), including:
  • CallbackGenerators that fail to set a URL or return an expected value
  • MarkdownParser when deactivating the last block parser or attempting to get an active block parser when they've all been closed
  • Adding items to an already-initialized Environment
  • Rendering a Node when no renderer has been registered for it
• HeadingPermalinkProcessor now throws InvalidConfigurationException instead of RuntimeException when invalid config values are given.
• HtmlElement::setAttribute() no longer requires the second parameter for boolean attributes
• Several small micro-optimizations
• Changed Strikethrough to only allow 1 or 2 tildes per the updated GFM spec

Fixed

• Fixed inaccurate @throws docblocks throughout the codebase, including ConverterInterface, MarkdownConverter, and MarkdownConverterInterface.
  • These previously suggested that only \RuntimeExceptions were thrown, which was inaccurate as \LogicExceptions were also possible.

Fixed

• Fixed autolink extension not detecting some URIs with underscores (#956)

Fixed

• Fixed parsing issues when mb_internal_encoding() is set to something other than UTF-8 (#951)

Fixed

• Fixed TaskListItemMarkerRenderer not including HTML attributes set on the node by other extensions (#947)

Fixed

• Fixed unquoted attribute parsing when closing curly brace is followed by certain characters (like a .) (#943)

Fixed

• Fixed error using InlineParserEngine when no inline parsers are registered in the Environment (#908)

Changed

• Made a number of small tweaks to the embed extension's parsing behavior to fix #898:
  • Changed EmbedStartParser to always capture embed-like lines in container blocks, regardless of parent block type
  • Changed EmbedProcessor to also remove Embed blocks that aren't direct children of the Document
  • Increased the priority of EmbedProcessor to 1010

Fixed

• Fixed EmbedExtension not parsing embeds following a list block (#898)

Fixed

• Fixed DomainFilteringAdapter not reindexing the embed list (#884, #885)

Fixed

• Fixed FootnoteExtension stripping extra characters from tab-indented footnotes (#881)

Fixed

• Fixed FootnoteExtension stripping extra characters from tab-indented footnotes (#881)

Fixed

• Fixed AutolinkExtension not ignoring trailing strikethrough syntax (#867)

Fixed

• Fixed AutolinkExtension not ignoring trailing strikethrough syntax (#867)

Added

• Added new EmbedExtension (#805)
• Added DocumentRendererInterface as a replacement for the now-deprecated MarkdownRendererInterface

Deprecated

• Deprecated MarkdownRendererInterface; use DocumentRendererInterface instead

Fixed

• Fixed front matter parsing with Windows line endings (#821)

Fixed

• Fixed front matter parsing with Windows line endings (#821)

Fixed

• Fixed front matter parsing with Windows line endings (#821)

Fixed

• Fixed double-escaping of image alt text (#806, #810)
• Fixed Psalm typehints for event class names

Fixed

• Fixed double-escaping of image alt text (#806, #810)
• Fixed Psalm typehints for event class names