Bug: Large TOC overflows into footer / header

[thseiler]

Describe the bug

I found a pagination issue with HTML2PDF4Doc when used with StrictDoc: Large table of contents are overflowing into the header / footer area. I attached a minimal example:

minimal-toc-example.zip

The exported PDF looks like this:

The PDF preview is also affected, but differently. Some entries are missing:

To Reproduce

• unzip attached example
• run strictdoc server .
• open browser to http://localhost:5111
• switch to PDF preview and

Expected behavior

The attached example rendered with strictdoc 0.11.0 and a manually downgraded html2pdf4doc==0.0.18 looks as expected:

Environment

OS: Windows 11

Browsers tested:

• Chrome 139.0.7258.139 : affected
• Microsoft Edge 139.0.3405.102 : affected
• Firefox 142.0 (64-bit): affected

Strictdoc / html2pdf4doc versions:

• 0.11.0 / 0.0.20: affected
• 0.10.1 / 0.0.20: affected
• 0.9.4 / 0.0.20: affected
• 0.11.0 / 0.0.19: affected
• 0.11.0 / 0.0.18: works as expected, so it seems to be related to a change introduced in html2pdf4doc 0.0.19

[stanislaw]

@thseiler thanks a lot for reporting this. It is a pretty painful bug that was introduced during the ongoing refactoring that @mettta and I are doing on the HTML2PDF.js side, mainly targeted towards deterministic splitting of content across pages as highlighted by this report: strictdoc-project/strictdoc#2170.

Not only a wrong commit was used as a submodule of the Python library but we also had a regression of the test suite itself where a previous TOC test was disabled and it didn't catch regressions like this TOC overflow.

I have released a new Python library and a corresponding StrictDoc library, and they should now be free of this issue.

We will be working on finishing the migration and adding more tests to catch issues like this one.