@digicole/pdfmake-rtl 1.2.0 → 2.1.0

package/.vscode/tasks.json

@@ -0,0 +1,17 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"label": "run tests",
+			"type": "shell",
+			"command": "npm",
+			"args": [
+				"test"
+			],
+			"problemMatcher": [
+				"$eslint-stylish"
+			],
+			"group": "build"
+		}
+	]
+}

package/CHANGELOG.md

@@ -1,128 +1,83 @@
-# Changelog
-
-## 0.2.20 - 2025-05-09
-
-- Fixed text overflow with some non-wrappable texts
-
-## 0.2.19 - 2025-04-26
-
-- Update Roboto font (version 3.011)
-
-## 0.2.18 - 2025-01-01
-
-- Update pdfkit
-- Fixed a potential issue in the minimized library when detecting the orientation of JPEG images
-
-## 0.2.17 - 2024-12-23
-
-- Fixed big size pdfmake bundle for browser
-
-## 0.2.16 - 2024-12-15
-
-- Update pdfkit to 0.15.2
-- Fixed aspect ratio for image with exif orientation tag
-- Fixed font size calculation for watermark if is page orientation is changed
-
-## 0.2.15 - 2024-11-02
-
-- Added support PDF/A and PDF/UA (see [documentation](https://pdfmake.github.io/docs/0.1/document-definition-object/pdfa/))
-- Changed Virtual file system (VFS) format for better compatibility with frameworks (backwards compatibility preserved). **For compatibility with frameworks, rebuild VFS required!**
-- Browser: Added methods for fonts (`addFonts`, `setFonts`, `clearFonts`)
-- Browser: Added methods for table layouts (`addTableLayouts`, `setTableLayouts`, `clearTableLayouts`)
-- Added support `link`, `linkToPage` and `linkToDestination` for SVG
-- Update pdfkit to 0.15.1
-- Fixed bug with how page breaks provoked by cells with rowspan were handled
-- Fixed find where previous cell started with row span and col span combination
-- Fixed calculating correctly the 'y' at the end of a rowSpan with dontBreakRows
-
-## 0.2.14 - 2024-10-09
-
-- Fixed drawing top horizontal line of the table with page break
-- Fixed uncaught Error when rowSpan and dontBreakRows combined
-
-## 0.2.13 - 2024-09-22
-
-- Minimal supported version Node.js 18 LTS
-- Update Roboto font (version 3.010)
-- Fixed page break in a column group
-- Fixed saving margins in an unbreakable block
-- Fixed fillColor items in unbreakable blocks
-- Fixed calculating correctly the 'y' at the end of a rowSpan with dontBreakRows
-- Fixed margins (top/bottom) of nodes and row height are considered for breaking page
-- Fixed margins after page break
-- Fixed margins of nodes with relativePosition or absolutePosition are ignored and don't interfere with the regular flow of the layout
-
-## 0.2.12 - 2024-08-14
-
-- Fixed error message of bad image definition
-
-## 0.2.11 - 2024-08-09
-
-- Fixed and validates input values headerRows and keepWithHeaderRows
-- Fixed numbering nested ordered lists
-- Speed up StyleContextStack.autopush() for large tables
-- Fixed widths of table columns with percentages
-- Fixed storing the correct context in the ending cell of a row span when there were nested column groups (columns or tables)
-
-## 0.2.10 - 2024-03-07
-
-- Removed unused brfs dependency
-
-## 0.2.9 - 2024-01-01
-
-- Added padding option for QR code
-- Allow the document language to be specified
-- Fixed cover image size inside table
-- Fixed "Cannot read properties of undefined (reading 'bottomMost')" if table contains too few rows
-- Fixed invalid source-maps in builded js file
-
-## 0.2.8 - 2023-11-09
-
-- Update pdfkit to 0.14.0
-- Update Roboto font (version 3.008)
-
-## 0.2.7 - 2022-12-17
-
-- Fixed theoretical vulnerability CVE-2022-46161 (**It was never part of version released as npm package or cdnjs or bower or packagist!**)
-
-## 0.2.6 - 2022-10-09
-
-- Updated Roboto font (version 3.005)
-- Fixed calculating auto page height
-- Fixed TrueType Collection loading from URL
-- Fixed refetching fonts from URL
-
-## 0.2.5 - 2022-04-01
-
-- Support passing headers to request for loading font files and images via URL adresses
-
-## 0.2.4 - 2021-11-10
-
-- Fixed destination path argument in VFS build script.
-- Fixed error "Object.isExtensible is not a function" (bug is in core-js version 3.19.1).
-
-## 0.2.3 - 2021-11-06
-
-- Updated [@foliojs-fork/pdfkit](https://github.com/foliojs-fork/pdfkit) to version 0.13.0.
-- Tiling pattern support.
-- svg-to-pdfkit package moved as built-in. Solve not used installation of pdfkit.
-- Fixed passing document metadata.
-
-## 0.2.2 - 2021-08-02
-
-- Fixed compatibility with Internet Explorer 11.
-
-## 0.2.1 - 2021-08-02
-
-- Upgrade Unicode Line Breaking Algorithm (UAX #14) to Unicode 13.0.0.
-- Updated [@foliojs-fork/pdfkit](https://github.com/foliojs-fork/pdfkit) to version 0.12.3.
-- Updated [@foliojs-fork/linebreak](https://github.com/foliojs-fork/linebreak) to version 1.11.1.
-
-## 0.2.0 - 2021-07-05
-
-- Move to [@foliojs-fork](https://github.com/foliojs-fork) packages with up-to-date dependecies and security bug fixes and others. These are the libraries [@foliojs-fork/fontkit](https://github.com/foliojs-fork/fontkit), [@foliojs-fork/restructure](https://github.com/foliojs-fork/restructure), [@foliojs-fork/linebreak](https://github.com/foliojs-fork/linebreak) which are used in [@foliojs-fork/pdfkit](https://github.com/foliojs-fork/pdfkit).
-- Upgrade Unicode Line Breaking Algorithm (UAX #14) to Unicode 12.0.0
-- Introduced new `build-vfs.js` script to build virtual file system for fonts (see [documentation](https://pdfmake.github.io/docs/0.1/fonts/custom-fonts-client-side/vfs/)).
-- Removed support Node.js 8 and 10. Minimum required version is 12 LTS.
-- Removed support Internet Explorer 10. Supported only Internet Explorer 11.
-- Removed gulp.
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.1.0] - 2026-02-08
+
+### Added
+
+- Major version upgrade with significant architectural improvements
+- Full rewrite of RTL processing pipeline for better performance and reliability
+- Support for RTL list tables with proper right-to-left rendering
+- RTL-aware ordered and unordered list handling within table cells
+
+### Improved
+
+- Overall RTL text rendering quality and consistency
+- Performance optimizations for large documents with mixed LTR/RTL content
+
+### Fixed
+
+- Fixed mixed character rendering issues with combined LTR/RTL scripts
+- Fixed mixed language text handling for Arabic, Persian, Urdu alongside Latin characters
+- Corrected bidirectional text reordering in mixed-language paragraphs
+
+### Breaking Changes
+
+- Major version bump; review migration guide for upgrading from v1.x
+
+## [1.3.6] - 2025-08-08
+
+### Added
+
+- Enhanced RTL table handling with improved column reversal for Arabic, Persian, and Urdu text
+- New `reverseTableRowPreserveSpans` function to handle complex table structures with colSpan and rowSpan
+- Automatic RTL detection and processing for tables containing RTL content
+- Support for preserving table header structure in RTL layouts
+- Comprehensive test examples for RTL table scenarios
+
+### Improved
+
+- Auto-RTL detection logic now respects explicit `supportRTL: false` setting
+- Better handling of nested table headers with mixed span attributes
+- Enhanced RTL text processing with proper bidirectional text support
+- Improved column reversal algorithm that preserves span relationships
+
+### Fixed
+
+- Fixed RTL table header positioning issues with colSpan and rowSpan elements
+- Resolved auto-RTL detection overriding explicit RTL settings
+- Fixed column ordering in complex nested header structures
+- Corrected span placeholder handling in RTL table reversal
+
+### Technical Details
+
+- Added `processAutoRTLTable` function for intelligent RTL detection
+- Enhanced `rtlUtils.js` with span-aware reversal algorithms
+- Improved error handling for empty object placeholders in span structures
+- Added comprehensive unit tests for RTL table functionality
+
+### Examples Added
+
+- `examples/rtl-nested-header.js` - Demonstrates complex RTL table with nested headers
+- `examples/test-simple-rtl-table.js` - Basic RTL table functionality test
+- `examples/test-no-spans-rtl-table.js` - RTL table without span elements
+
+### Breaking Changes
+
+- None. All changes are backward compatible.
+
+### Notes
+
+- RTL detection threshold set to 30% RTL content for automatic table reversal
+- Headers with span structures are preserved to maintain layout integrity
+- Cell-level RTL text rendering (`bidi: true`) applied automatically for RTL content
+
+---
+
+## Previous Versions
+
+This is the first tracked version of the changelog. For earlier changes, please refer to the git commit history.

package/LICENSE

@@ -1,22 +1,22 @@
-The MIT License (MIT)
-
-Copyright (c) 2014-2015 bpampuch (original PDFMake)
-              2016-2025 liborm85 (PDFMake maintenance)
-              2025 PDFMake RTL Contributors (RTL extensions)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software is furnished to do so,
-subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
-COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+The MIT License (MIT)
+
+Copyright (c) 2014-2015 bpampuch (original PDFMake)
+              2016-2025 liborm85 (PDFMake maintenance)
+              2025 PDFMake RTL Contributors (RTL extensions)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.