Support linenames for grid-template-columns/rows

DEVSIX-8368

Author: vitali-pr

src/main/java/com/itextpdf/html2pdf/css/apply/util/GridApplierUtil.java

@@ -175,6 +175,10 @@ public final class Html2PdfLogMessageConstant {
     public static final String IMMEDIATE_FLUSH_DISABLED = "Setting createAcroForm disables immediateFlush property";
     public static final String GRID_TEMPLATE_AREAS_IS_INVALID = "grid-template-areas property is invalid. "
             + "The result is nondeterministic";
+    public static final String LINENAMES_ARE_NOT_SUPPORTED_WITHIN_AUTO_REPEAT = "Line names are not supported "
+            + "with auto-repeat as a track-size";
+    public static final String ADDING_GRID_LINES_TO_THE_LEFT_OR_TOP_IS_NOT_SUPPORTED = "Adding grid lines to the left "
+            + "or to the top is not supported";
 
     private Html2PdfLogMessageConstant() {
         //Private constructor will prevent the instantiation of this class directly

src/main/java/com/itextpdf/html2pdf/logs/Html2PdfLogMessageConstant.java

@@ -25,8 +25,6 @@ This file is part of the iText (R) project.
 import com.itextpdf.html2pdf.ConverterProperties;
 import com.itextpdf.html2pdf.ExtendedHtmlConversionITextTest;
 import com.itextpdf.html2pdf.logs.Html2PdfLogMessageConstant;
-import com.itextpdf.styledxmlparser.logs.StyledXmlParserLogMessageConstant;
-import com.itextpdf.test.LogLevelConstants;
 import com.itextpdf.test.annotations.LogMessage;
 import com.itextpdf.test.annotations.LogMessages;
 
@@ -119,6 +117,23 @@ public void invalidTemplateAreasTest() throws IOException, InterruptedException
         runTest("invalidTemplateAreas");
     }
 
+    @Test
+    public void templateAreasStartAutoTest() throws IOException, InterruptedException {
+        runTest("templateAreasStartAuto");
+    }
+
+    @Test
+    public void templateAreasStartTest() throws IOException, InterruptedException {
+        // Here browser result seems strange. We specified only row starts but it somehow applies to column starts also.
+        // I'd expect the same result as for templateAreasStartAutoTest
+        runTest("templateAreasStart");
+    }
+
+    @Test
+    public void templateAreasStartEndTest() throws IOException, InterruptedException {
+        runTest("templateAreasStartEnd");
+    }
+
     private void runTest(String testName) throws IOException, InterruptedException {
         convertToPdfAndCompare(testName,
                 SOURCE_FOLDER, DESTINATION_FOLDER, false,

src/test/java/com/itextpdf/html2pdf/css/apply/util/GridApplierUtilTest.java

@@ -0,0 +1,104 @@
+/*
+    This file is part of the iText (R) project.
+    Copyright (c) 1998-2024 Apryse Group NV
+    Authors: Apryse Software.
+
+    This program is offered under a commercial and under the AGPL license.
+    For commercial licensing, contact us at https://itextpdf.com/sales.  For AGPL licensing, see below.
+
+    AGPL licensing:
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU Affero General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU Affero General Public License for more details.
+
+    You should have received a copy of the GNU Affero General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.itextpdf.html2pdf.css.grid;
+
+import com.itextpdf.html2pdf.ConverterProperties;
+import com.itextpdf.html2pdf.ExtendedHtmlConversionITextTest;
+import com.itextpdf.html2pdf.logs.Html2PdfLogMessageConstant;
+import com.itextpdf.test.annotations.LogMessage;
+import com.itextpdf.test.annotations.LogMessages;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Tag;
+
+import java.io.IOException;
+
+@Tag("IntegrationTest")
+public class GridLinenameTest extends ExtendedHtmlConversionITextTest {
+    public static final String SOURCE_FOLDER = "./src/test/resources/com/itextpdf/html2pdf/css/grid/GridLinenameTest/";
+    public static final String DESTINATION_FOLDER = "./target/test/com/itextpdf/html2pdf/css/grid/GridLinenameTest/";
+
+
+    @BeforeAll
+    public static void beforeClass() {
+        createOrClearDestinationFolder(DESTINATION_FOLDER);
+    }
+
+    @Test
+    public void linenamesCombinedTest() throws IOException, InterruptedException {
+        runTest("linenamesCombined");
+    }
+
+    @Test
+    public void linenameSpanTest() throws IOException, InterruptedException {
+        runTest("linenameSpan");
+    }
+
+    @Test
+    public void linenameNthTest() throws IOException, InterruptedException {
+        runTest("linenameNth");
+    }
+
+    @Test
+    public void duplicateLineNamesTest() throws IOException, InterruptedException {
+        runTest("duplicateLineNames");
+    }
+
+    @Test
+    public void linenameGridAreaTest() throws IOException, InterruptedException {
+        runTest("linenameGridArea");
+    }
+
+    @Test
+    public void customIndentSpanTest() throws IOException, InterruptedException {
+        runTest("customIndentSpan");
+    }
+
+    @Test
+    public void customIndentTrickySpanTest() throws IOException, InterruptedException {
+        runTest("customIndentTrickySpan");
+    }
+
+    @Test
+    public void templateAreasNamesTest() throws IOException, InterruptedException {
+        runTest("templateAreasNames");
+    }
+
+    @Test
+    public void linenameRepeatTest() throws IOException, InterruptedException {
+        runTest("linenameRepeat");
+    }
+
+    @Test
+    @LogMessages(messages = @LogMessage(
+            messageTemplate = Html2PdfLogMessageConstant.LINENAMES_ARE_NOT_SUPPORTED_WITHIN_AUTO_REPEAT))
+    public void linenameAutoRepeatTest() throws IOException, InterruptedException {
+        runTest("linenameAutoRepeat");
+    }
+
+    private void runTest(String testName) throws IOException, InterruptedException {
+        convertToPdfAndCompare(testName,
+                SOURCE_FOLDER, DESTINATION_FOLDER, false,
+                new ConverterProperties().setBaseUri(SOURCE_FOLDER).setCssGridEnabled(true));
+    }
+}

src/test/java/com/itextpdf/html2pdf/css/grid/GridAreaTest.java

@@ -11,7 +11,7 @@
   height: 250px;
   grid-template-areas:
     "head head"
-    "nav  1"
+    "nav  3"
     "nav  foot";
   grid-template-rows: 50px 100px 30px;
   grid-template-columns: 150px 200px;
@@ -28,7 +28,7 @@
 }
 
 #page > main {
-  grid-area: 1;
+  grid-area: 3;
   background-color: #ffff64;
 }