fix: render empty list entries (#2893)

* fix: render empty list entries

* update example

* update changelog

---------

Co-authored-by: Nadeem Shadan <nadeem.s@iinerds.com>
Co-authored-by: Libor M. <liborm85@gmail.com>

Author: 3 people

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 - Used fetch API for downloading fonts and images
 - Update Roboto font (version 3.014)
+- Fixed render empty list entries
 
 ## 0.3.0-beta.18 - 2025-05-09
 

examples/lists.js

@@ -388,6 +388,23 @@ var docDefinition = {
 				{ text: 'item 3', listType: 'circle' }
 			]
 		},
+		{ text: '\n\nOrdered list with an empty item:', style: 'header' },
+		{
+			ol: [
+				'First item',
+				'Second item',
+				'',
+				'Fourth item'
+			]
+		},
+		{ text: '\n\nUnordered list with an empty item:', style: 'header' },
+		{
+			ul: [
+				'First bullet',
+				'',
+				'Third bullet'
+			]
+		},
 	],
 	styles: {
 		header: {

src/LayoutBuilder.js

@@ -72,7 +72,17 @@ class LayoutBuilder {
 				return false;
 			}
 
-			linearNodeList = linearNodeList.filter(node => node.positions.length > 0);
+			const hasRenderableContent = node => {
+				if (!node || node.positions.length === 0) {
+					return false;
+				}
+				if (node.text === '' && !node.listMarker) {
+					return false;
+				}
+				return true;
+			};
+
+			linearNodeList = linearNodeList.filter(hasRenderableContent);
 
 			linearNodeList.forEach(node => {
 				let nodeInfo = {};

src/TextBreaker.js

@@ -9,12 +9,22 @@ import StyleContextStack from './StyleContextStack';
  */
 const splitWords = (text, noWrap) => {
 	let words = [];
+	if (text === undefined || text === null) {
+		text = '';
+	} else {
+		text = String(text);
+	}
 
 	if (noWrap) {
 		words.push({ text: text });
 		return words;
 	}
 
+	if (text.length === 0) {
+		words.push({ text: '' });
+		return words;
+	}
+
 	let breaker = new LineBreaker(text);
 	let last = 0;
 	let bk;