flutter_quill_to_pdf 2.0.0

Create PDF'S using deltas from Quill, with configurable attributes, fonts, and custom pdf widgets

2.0.0

¡BREAKING CHANGES!

The way of build the PDF's it's different and better

Before implementation (using vsc_quill_delta_to_html and html2md with RegExp patterns)

The PDF is builded: first the Delta is converted to a custom implementation, then, after it will be transformed to a Markdown with some HTML styles to avoid losing align attrs or colors.

On the creation of the PDF (using PdfService) all of this HTML with Markdown are detected using RegExp that made more difficult had a correct performance. Some devices even could crash on the building of that PDF way.

New implementation (using flutter_quill_delta_easy_parser)

Transform directly a Delta to a Structured-Document type that it's more easy to be readed by a human, and getting the attributes from any Line or the block attributes from the current Paragraph.

Other Changes

• Fix: app crashed when use createDocument method.
• Fix: bad perfomance while building a PDF.
• Chore: deprecated customConverters param from PDFConverter to avoid using after this release
• Fix: removed most of the RegExp used on Constant class.
• Fix: removed MarkdownRules class since is not necessary now.
• Fix: removed vsc_quill_delta_to_html and html2md since are not used now.
• Fix: removed HTMLConverterOptions local implementation since is not used now.
• Chore: removed setCustomRules method from Converter
• Chore: moved some const values to example since wont be necessary be in the package.

By now this version is not using CustomPDFWidget or PdfWidgetGenerator. This is just a temporary issue that will be fixed on next releases

1.2.2

• [Fix] delta to html doesn't detect double values

1.2.1

• [Fix] renamed WidgetGenerator to PdfWidgetGenerator
• [Fix] renamed file markdown_rules_custom to markdown_rules
• [Chore] changed ConverterOptions from converter delta to html from HTMLConverterOptions to ConverterOptions.forEmail()
• [Feat] exposed PdfService
• [Feat] added support for strikethrough in PdfService
• [Feat] All params on DeltaAttributesOptions are supported
• [BREAKING CHANGES] rgbColor was renamed as hexColor and now is an int at DeltaAttributesOptions
• [BREAKING CHANGES] levelHeader was removed on DeltaAttributesOptions

1.2.0

• Removed unnecessary code
• Writed more documentation about classes and functions
• [Fix] rename at MarkdownRules by bad name of file
• [Fix] bad list formatting. The list block function generator didn't detect the span styles into itself
• [Feat] added support for image links
• [Feat] added support for colors
• [Feat] added support for blockquote
• [Feat] added support for codeblock
• [Feat] added support to render custom html using renderCustomCallback param from convertDeltaToHtml

//it looks like
String convertDeltaToHtml(Delta delta, [ConverterOptions? options,String Function(DeltaInsertOp customOp, DeltaInsertOp? contextOp)? customRenderCallback]) {
  final QuillDeltaToHtmlConverter converterDeltaToHTML = QuillDeltaToHtmlConverter(
    delta.toJson(),
    options ?? HTMLConverterOptions.options(),
  );
  converterDeltaToHTML.renderCustomWith = customRenderCallback;
  return converterDeltaToHTML.convert();
}

• [Feat] added support for customize properties in blockquote and codeblock without create a custom widget

  ///If you need [customize] exactly how the [code block looks], then you use this [theme]
  final pw.TextStyle? codeBlockTextStyle;

  ///If you need just a different [font] to show your code blocks, use this font [(by default is pw.Font.courier())]
  final pw.Font? codeBlockFont;

  ///Customize the background color of the code block
  final PdfColor? codeBlockBackgroundColor;

  ///Customize the style of the num lines in code block
  final pw.TextStyle? codeBlockNumLinesTextStyle;

  ///Define the text style of the general blockquote. [This overrides any style detected like: line-height, size, font families, color]
  final pw.TextStyle? blockQuoteTextStyle;

  ///Define the left space between divider and text
  final double? blockQuotePaddingLeft;
  final double? blockQuotePaddingRight;

  ///Define the width of the divider
  final double? blockQuotethicknessDividerColor;

  ///Customize the background of the blockquote
  final PdfColor? blockQuoteBackgroundColor;

  ///Customize the left/right divider color to blockquotes
  final PdfColor? blockQuoteDividerColor;

1.1.4

• [Fix] README bad dependecy name

1.1.1

• [Feat] improved README
• [Fix] bad unnecessary args remove
• [Fix] bad names in some classes and functions
• [Fix] bad test (by now cannot be created a test)

1.1.0

• [Feat] added support to custom delta to html converter
• [Feat] added support to custom html to markdown converter
• [Feat] added new factory to create document and write file
• [Feat] improved params descriptions
• [Feat] added support to customize markdown rules
• [Feat] now we can add a custom theme to pdf document
• [Feat] now we can pass functions to when the create doc ends sucessfully or when throws and exception
• [Fix] removed lineHeight attribute since flutt_quill and html2md has Rule class and creates conflicts on imports
• README now has better documentation, to be more accurate on how use this library

1.0.2

• [Fix] inconfortable name. PDFConvertersParam was changed to PDFPageFormat
• [Feat] improved README to make more easy read how works the package

1.0.1

• [Fix] minimal errors
• [Fix] issue where list (bullet, check, and ordered) takes a more space that it needs on top

1.0.0

• First commit