docx_creator 1.1.2

docx_creator: ^1.1.2 copied to clipboard

Added #

• PDF Reader Improvements: Major enhancements for broader PDF compatibility:

  • XRef Stream Support: Complete parsing of PDF 1.5+ cross-reference streams with /W array, /Index array, and proper decompression.
  • Object Stream Support: Parse compressed objects stored within object streams (PDF 1.5+).
  • Fallback Object Scanning: Automatic object recovery when xref table/stream is corrupted or malformed.
  • LZW Decoding: Full implementation of LZWDecode filter for older PDFs.
  • PNG Image Encoding: Raw RGB pixel data (from FlateDecode images) is now properly encoded as PNG format for direct use in Flutter.
  • Improved Font Parsing: Balanced bracket matching for nested dictionary structures.

• PDF Exporter Improvements:

  • Helvetica-Bold Width Table: Added complete character width table for Helvetica-Bold with accurate per-character measurements.
  • Fixed Binary Stream Handling: Corrected compression corruption issue where binary compressed data was incorrectly converted through String encoding.

Fixed #

• Bold Text Spacing: Fixed issue where bold text characters appeared too close together due to inaccurate width calculations using only a 1.05x multiplier instead of proper Helvetica-Bold metrics.
• Blank PDF Generation: Fixed blank PDFs caused by binary FlateDecode stream data being corrupted during intermediate String conversions.
• Image Extraction: Fixed image extraction returning raw RGB bytes instead of usable image format. Images are now properly encoded as PNG.

Improved #

• PdfDocument Documentation: Enhanced documentation explaining the purpose of both elements and images lists.
• Error Handling: Better error recovery during PDF parsing with informative warnings.

Fixed #

• Code Cleanup: Removed unused optional parameters (isStrikethrough, isUnderline) in PDF reader classes to fix analyzer warnings.
• Internal Optimization: Improved code quality in pdf_classes.dart by removing unused fields.

Added #

• PDF Export: New PdfExporter class for exporting documents directly to PDF format.
  • Pure Dart implementation with no native dependencies
  • Supports text formatting (bold, italic, underline, strikethrough)
  • Per-character font metrics for accurate text measurement (Helvetica)
  • Bold font width scaling (1.05x) for proper heading layout
  • Superscript and subscript support with proper positioning
  • Custom font sizes with per-line height calculation
  • Background colors for paragraphs and inline text
  • Table rendering with cell backgrounds and borders
  • List rendering (bullet and numbered)
  • Image embedding (PNG format)
  • Multi-page support with configurable page sizes (Letter, A4)
  • Text alignment (left, center, right, justify)

Example #

import 'package:docx_creator/docx_creator.dart';

final doc = docx().h1('Title').p('Content').build();
await PdfExporter().exportToFile(doc, 'output.pdf');

Fixed #

• Table Border Fidelity: Fixed critical issues with conditional table borders (first row, last row, first column, last column, banding) not being correctly applied or inherited.
  • Resolved conflicts between cell-level borders, table-level borders, and named style borders.
  • Ensures correct visual rendering of complex table styles like "Grid Table 4 - Accent 1".
• Table Color Resolution: Fixed logic where 'auto' colors in tables were not correctly resolving to black/transparent based on context.
• Fallback Logic: Improved fallback logic for table borders when specific side borders are undefined.

Improved #

• High-Fidelity Round-Trip: Enhanced the preservation of table style properties during read/write cycles.

Fixed #

• Advanced Style Inheritance: Implemented proper docDefaults resolution for paragraph and run properties.
• Table Text Styling: Fixed text styling in tables to respect paragraph-level run properties (w:rPr).

Added #

• Theme Color Support: Added support for themeColor, themeTint, and themeShade in text and styling.
• Character Spacing: Added support for parsing w:spacing in run properties.

Fixed #

• Table Row Heights: Fixed missing w:trHeight parsing and export. Calendar tables and other tables with explicit row heights now preserve their dimensions.
• Table Overlap: Added parsing and export for w:tblOverlap attribute on floating tables.
• Embedded Font Variants: Fixed font reading to parse all font embed types (w:embedRegular, w:embedBold, w:embedItalic, w:embedBoldItalic) instead of only Regular. This fixes missing font files during round-trip.
• Table Border Export: Tables with a styleId (e.g., "Calendar3", "LightList-Accent3") no longer emit explicit <w:tblBorders> that was incorrectly overriding the named style definition.
• Text Style Inheritance: Fixed inline parser to only emit direct run properties (color, font size, fonts), not inherited ones from styles. This allows table cell text to properly inherit styling from table styles via cnfStyle conditional formatting.

Fixed #

• Table Style Fidelity: Fixed critical issue where table cell borders defined in Named Table Styles (via w:tblStylePr) were ignored.
  • Updated DocxStyle parser to correctly extract w:tcBorders from table style conditionals.
  • Fixed logic to properly prioritize table style borders when paragraph borders are absent.

Fixed #

• Font Fidelity: Fixed critical issue where embedded fonts were lost during the read-export cycle due to mismatched relationship IDs and filenames.
  • Preserved exact filenames and relationship IDs from the original document.
  • Updated fontTable.xml.rels handling to ensure valid links to embedded font files.
• Line Spacing Fidelity: Fixed issue where specific line spacing rules (e.g., 'Exactly' vs 'At Least') were ignored.
  • Added support for parsing and exporting w:lineRule attribute in paragraphs and styles.
  • Ensures visual vertical spacing matches the original document precisely.
• Style Inheritance: Fixed issue where paragraph styles (like 'Heading 1') were lost on export.
  • Added parsing for w:pStyle property in DocxStyle and DocxParagraph.
• Inline Font Merging: Fixed logic where direct font formatting (e.g., hints) completely overwrote character style fonts.
  • Implemented proper merging of direct font properties with underlying character style fonts.
• Theme Support: Added parsing for theme-related font attributes (w:asciiTheme, w:eastAsiaTheme, etc.) to preserve theme-based font selection.

Added #

• Table Style Resolver: Added full support for Named Table Styles (w:tblStylePr) and Conditional Formatting (w:tblLook).
  • Supports 'First Row', 'Last Row', 'First Column', 'Last Column', and 'Banded Rows/Columns' formatting.
  • Automatically resolves and "bakes" effective styles (shading, borders, fonts) into table cells for visual fidelity.
• Floating Images: Added parser support for floating images with precise positioning.
  • Supports wp:anchor parsing.
  • Handles relativeFrom (margin, page, column) and alignment attributes.
• Drop Caps: Added support for Drop Caps (w:dropCap) in paragraphs.
• Footnotes & Endnotes: Added comprehensive support for parsing and exporting Footnotes and Endnotes.
• Text Borders: Added support for parsing text borders (w:bdr).

Fixed #

• Table Styles: Fixed issue where table styles were not correctly applied to cells during parsing.
• Attribute Export: Fixed invalid hex color format (removed # prefix) in w:fill attribute generation to ensure compatibility with Microsoft Word.
• Cell Copying: Fixed DocxTableCell.copyWith bug that caused style properties to be lost when modifying table cells.

Improved #

• Modular DocxReader Architecture: Refactored 1797-line monolithic docx_reader.dart into 11 focused modules:
  • reader_context.dart - Shared state manager
  • parsers/style_parser.dart - Style resolution
  • parsers/block_parser.dart - Paragraph/list parsing
  • parsers/inline_parser.dart - Text/image/shape parsing
  • parsers/table_parser.dart - Table/rowspan handling
  • parsers/section_parser.dart - Headers/footers/sections
  • handlers/relationship_manager.dart - OOXML relationships
  • handlers/font_reader.dart - Embedded font extraction
• Modular HTML Parser Architecture: Refactored 1259-line html_parser.dart into 8 modules:
  • html/parser_context.dart - CSS class map & shared state
  • html/style_context.dart - Style inheritance context
  • html/color_utils.dart - 141 CSS named colors
  • html/block_parser.dart - Block elements
  • html/inline_parser.dart - Inline elements
  • html/table_parser.dart - Tables with nested support
  • html/list_parser.dart - Ordered/unordered lists
  • html/image_parser.dart - Image elements

Fixed #

• UTF-8 Encoding: Fixed XML content parsing to use proper UTF-8 decoding in DocxReader
• Shape Parsing: Restored full shape dimension/color/preset parsing in refactored reader
• Nested Table Support: HTML parser now correctly handles tables inside table cells
• Background Inheritance: Fixed resetBackground() to properly clear nullable shadingFill values

Added #

• DrawingML Shapes: Full support for 70+ preset shapes (rectangles, ellipses, stars, arrows, flowchart symbols, etc.)
  • Block-level shapes (DocxShapeBlock) and inline shapes (DocxShape)
  • Fill colors, outline colors, and outline widths
  • Text content inside shapes
  • Rotation support
  • Floating and inline positioning
• Shape Reader Support: Shapes are now preserved when reading existing DOCX files
• 141 CSS Named Colors: Full W3C CSS3 Extended Color Keywords support in HTML parser
  • All grey/gray spelling variations supported
  • Includes colors like dodgerblue, mediumvioletred, papayawhip, etc.
• Comprehensive Examples: Added four complete example files:
  • manual_builder_example.dart - All builder API features
  • html_parser_example.dart - All HTML/CSS features
  • markdown_parser_example.dart - All Markdown features
  • reader_editor_example.dart - Full read-edit-write workflow

Improved #

• Documentation: Complete rewrite of README.md and new DOCUMENTATION.md with:
  • Full API reference tables
  • All supported HTML tags and CSS properties
  • Step-by-step DOCX Reader/Editor guide
  • OpenXML internals explanation
  • Troubleshooting section
• Color Handling: Improved color class with automatic hex normalization (strips # and 0x prefixes)
• List Rendering: Enhanced 9-level nested list support with proper abstract numbering

Fixed #

• Background Color Inheritance: Fixed CSS background-color incorrectly inheriting to inline children
• Code Block Visibility: Fixed text visibility in code blocks when used with background colors

Fixed #

• List Rendering: Fixed numbered and bullet lists not displaying markers in Word when multiple lists appear in the same document.
• Color Parsing: Fixed HtmlParser color parsing for font colors and background highlights. Now supports:
  • Hex codes (3-digit and 6-digit)
  • RGB/RGBA formats
  • Extended CSS named colors (including grey, lime, maroon, etc.)
• Highlight Mapping: Fixed incorrect default highlight color (no longer defaults to yellow for unknown colors).

Improved #

• OOXML Compliance: Updated numbering.xml generation to match python-docx patterns for better Word compatibility (w:nsid, w:tmpl, w:tabs).

• Initial version.