From 115435a835829b1914df5323df88905d07d62466 Mon Sep 17 00:00:00 2001
From: Maxim Lysak <mly@zurich.ibm.com>
Date: Tue, 15 Oct 2024 14:32:37 +0200
Subject: [PATCH 1/2] Fixes for lists handling in docx

Signed-off-by: Maxim Lysak <mly@zurich.ibm.com>
---
 docling/backend/mspowerpoint_backend.py |   4 +-
 docling/backend/msword_backend.py       |  91 ++++++++++++++++++++----
 tests/data/word_sample.docx             | Bin 103139 -> 103966 bytes
 3 files changed, 80 insertions(+), 15 deletions(-)

diff --git a/docling/backend/mspowerpoint_backend.py b/docling/backend/mspowerpoint_backend.py
index bdf73c99..0849328d 100644
--- a/docling/backend/mspowerpoint_backend.py
+++ b/docling/backend/mspowerpoint_backend.py
@@ -88,7 +88,7 @@ class MsPowerpointDocumentBackend(DeclarativeDocumentBackend, PaginatedDocumentB
         )
         doc = DoclingDocument(
             description=DescriptionItem(), name="name_without_extension", origin=origin
-        )  # TODO must add origin information
+        )  # must add origin information
         doc = self.walk_linear(self.pptx_obj, doc)
 
         return doc
@@ -177,7 +177,7 @@ class MsPowerpointDocumentBackend(DeclarativeDocumentBackend, PaginatedDocumentB
                         e_is_a_list_item = False
 
                     if e_is_a_list_item:
-                        # TODO: Set marker and enumerated arguments if this is an enumeration element.
+                        # Set marker and enumerated arguments if this is an enumeration element.
                         enum_marker = str(enum_list_item_value) + "."
                         doc.add_list_item(
                             marker=enum_marker,
diff --git a/docling/backend/msword_backend.py b/docling/backend/msword_backend.py
index a098db51..2974d1ff 100644
--- a/docling/backend/msword_backend.py
+++ b/docling/backend/msword_backend.py
@@ -44,6 +44,7 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
             self.parents[i] = None
 
         self.level = 0
+        self.listIter = 0
 
         self.history = {
             "names": [None],
@@ -115,6 +116,7 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
         for element in body:
             tag_name = etree.QName(element).localname
 
+            # Check for Inline Images (drawings or blip elements)
             found_drawing = etree.ElementBase.xpath(
                 element, ".//w:drawing", namespaces=self.xml_namespaces
             )
@@ -128,8 +130,7 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
                     self.handle_tables(element, docx_obj, doc)
                 except Exception:
                     _log.error("could not parse a table, broken docx table")
-            # Check for Inline Images (drawings or blip elements)
-            # elif element.xpath(".//w:drawing", namespaces = self.xml_namespaces) or element.xpath(".//w:pict", namespaces = self.xml_namespaces):
+
             elif found_drawing or found_pict:
                 self.handle_pictures(element, docx_obj, doc)
             # Check for Text
@@ -157,7 +158,6 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
             # Get the numId element and extract the value
             numId_elem = numPr.find("w:numId", namespaces=paragraph._element.nsmap)
             ilvl_elem = numPr.find("w:ilvl", namespaces=paragraph._element.nsmap)
-
             numId = numId_elem.get(self.XML_KEY) if numId_elem is not None else None
             ilvl = ilvl_elem.get(self.XML_KEY) if ilvl_elem is not None else None
 
@@ -206,15 +206,31 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
         text = paragraph.text.strip()
         # if len(text)==0 # keep empty paragraphs, they seperate adjacent lists!
 
+        # Common styles for bullet and numbered lists.
+        # "List Bullet", "List Number", "List Paragraph"
+        # TODO: reliably identify wether list is a numbered list or not
+        # is_numbered = "List Bullet" not in paragraph.style.name
+        is_numbered = False
+
         p_style_name, p_level = self.get_label_and_level(paragraph)
         numid, ilevel = self.get_numId_and_ilvl(paragraph)
+        # print("numid: {}, ilevel: {}, text: {}".format(numid, ilevel, text))
 
-        # print("paragraph.text: {} | numid: {} | ilevel: {}".format(paragraph.text, numid, ilevel))
+        if numid == 0:
+            numid = None
 
         # Handle lists
         if numid is not None and ilevel is not None:
             self.add_listitem(
-                element, docx_obj, doc, p_style_name, p_level, numid, ilevel, text
+                element,
+                docx_obj,
+                doc,
+                p_style_name,
+                p_level,
+                numid,
+                ilevel,
+                text,
+                is_numbered,
             )
             self.update_history(p_style_name, p_level, numid, ilevel)
             return
@@ -224,14 +240,12 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
                     self.parents[key] = None
             self.level = self.level_at_new_list - 1
             self.level_at_new_list = None
-
         if p_style_name in ["Title"]:
             for key, val in self.parents.items():
                 self.parents[key] = None
             self.parents[0] = doc.add_text(
                 parent=None, label=DocItemLabel.TITLE, text=text
             )
-
         elif "Heading" in p_style_name:
             self.add_header(element, docx_obj, doc, p_style_name, p_level, text)
 
@@ -303,8 +317,20 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
         return
 
     def add_listitem(
-        self, element, docx_obj, doc, p_style_name, p_level, numid, ilevel, text: str
+        self,
+        element,
+        docx_obj,
+        doc,
+        p_style_name,
+        p_level,
+        numid,
+        ilevel,
+        text: str,
+        is_numbered=False,
     ):
+        # is_numbered = is_numbered
+        enum_marker = ""
+
         level = self.get_level()
         if self.prev_numid() is None:  # Open new list
             self.level_at_new_list = level
@@ -314,7 +340,16 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
             )
 
             # TODO: Set marker and enumerated arguments if this is an enumeration element.
-            doc.add_list_item(parent=self.parents[level], text=text)
+            self.listIter += 1
+            if is_numbered:
+                enum_marker = str(self.listIter) + "."
+                is_numbered = True
+            doc.add_list_item(
+                marker=enum_marker,
+                enumerated=is_numbered,
+                parent=self.parents[level],
+                text=text,
+            )
 
         elif (
             self.prev_numid() == numid and self.prev_indent() < ilevel
@@ -325,12 +360,26 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
             ):
                 # TODO: determine if this is an unordered list or an ordered list.
                 #  Set GroupLabel.ORDERED_LIST when it fits.
-                self.parents[i] = doc.add_group(
-                    label=GroupLabel.LIST, name="list", parent=self.parents[i - 1]
-                )
+                self.listIter = 0
+                if is_numbered:
+                    self.parents[i] = doc.add_group(
+                        label=GroupLabel.ORDERED_LIST,
+                        name="list",
+                        parent=self.parents[i - 1],
+                    )
+                else:
+                    self.parents[i] = doc.add_group(
+                        label=GroupLabel.LIST, name="list", parent=self.parents[i - 1]
+                    )
 
             # TODO: Set marker and enumerated arguments if this is an enumeration element.
+            self.listIter += 1
+            if is_numbered:
+                enum_marker = str(self.listIter) + "."
+                is_numbered = True
             doc.add_list_item(
+                marker=enum_marker,
+                enumerated=is_numbered,
                 parent=self.parents[self.level_at_new_list + ilevel],
                 text=text,
             )
@@ -341,14 +390,30 @@ class MsWordDocumentBackend(DeclarativeDocumentBackend):
                     self.parents[k] = None
 
             # TODO: Set marker and enumerated arguments if this is an enumeration element.
+            self.listIter += 1
+            if is_numbered:
+                enum_marker = str(self.listIter) + "."
+                is_numbered = True
             doc.add_list_item(
+                marker=enum_marker,
+                enumerated=is_numbered,
                 parent=self.parents[self.level_at_new_list + ilevel],
                 text=text,
             )
+            self.listIter = 0
 
         elif self.prev_numid() == numid or self.prev_indent() == ilevel:
             # TODO: Set marker and enumerated arguments if this is an enumeration element.
-            doc.add_list_item(parent=self.parents[level - 1], text=text)
+            self.listIter += 1
+            if is_numbered:
+                enum_marker = str(self.listIter) + "."
+                is_numbered = True
+            doc.add_list_item(
+                marker=enum_marker,
+                enumerated=is_numbered,
+                parent=self.parents[level - 1],
+                text=text,
+            )
         return
 
     def handle_tables(self, element, docx_obj, doc):
diff --git a/tests/data/word_sample.docx b/tests/data/word_sample.docx
index b1889405865c5bfcc594a04de63ae20168e4a84c..69b09f5a3a72c6a7bbfe016ff71465f3ca66109c 100644
GIT binary patch
delta 15668
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

delta 14819
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


From f49d7881d00bd0e385456cdac5fb9c98f8cc93c5 Mon Sep 17 00:00:00 2001
From: Michele Dolfi <dol@zurich.ibm.com>
Date: Tue, 15 Oct 2024 14:35:02 +0200
Subject: [PATCH 2/2] pin docling-core and glm

Signed-off-by: Michele Dolfi <dol@zurich.ibm.com>
---
 poetry.lock    | 17 +++++++++--------
 pyproject.toml |  4 ++--
 2 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index cefef5e6..4a868911 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -885,7 +885,7 @@ files = []
 develop = false
 
 [package.dependencies]
-docling-core = {git = "https://github.com/DS4SD/docling-core.git", rev = "6fee533a101ca08f62e88826218c33e0aab2f417"}
+docling-core = {git = "https://github.com/DS4SD/docling-core.git", rev = "7c104d61aa5d003dd8d9711c37e23ce04799f4c9"}
 docutils = "!=0.21"
 matplotlib = "^3.7.1"
 networkx = "^3.1"
@@ -909,8 +909,8 @@ toolkit = ["deepsearch-toolkit (>=0.31.0)"]
 [package.source]
 type = "git"
 url = "https://github.com/DS4SD/deepsearch-glm.git"
-reference = "c13a6cdda25206911d63a5a28e990217ad823068"
-resolved_reference = "c13a6cdda25206911d63a5a28e990217ad823068"
+reference = "c185c4f985ccd29a470a1cddd3bec43880b739ee"
+resolved_reference = "c185c4f985ccd29a470a1cddd3bec43880b739ee"
 
 [[package]]
 name = "dill"
@@ -952,14 +952,15 @@ json-schema-for-humans = "^1.0.0"
 jsonref = "^1.1.0"
 jsonschema = "^4.16.0"
 pandas = "^2.1.4"
+pillow = "^10.3.0"
 pydantic = "^2.6.0"
 tabulate = "^0.9.0"
 
 [package.source]
 type = "git"
 url = "https://github.com/DS4SD/docling-core.git"
-reference = "6fee533a101ca08f62e88826218c33e0aab2f417"
-resolved_reference = "6fee533a101ca08f62e88826218c33e0aab2f417"
+reference = "7c104d61aa5d003dd8d9711c37e23ce04799f4c9"
+resolved_reference = "7c104d61aa5d003dd8d9711c37e23ce04799f4c9"
 
 [[package]]
 name = "docling-ibm-models"
@@ -3441,9 +3442,9 @@ files = [
 [package.dependencies]
 numpy = [
     {version = ">=1.26.0", markers = "python_version >= \"3.12\""},
-    {version = ">=1.23.5", markers = "python_version >= \"3.11\" and python_version < \"3.12\""},
     {version = ">=1.21.4", markers = "python_version >= \"3.10\" and platform_system == \"Darwin\" and python_version < \"3.11\""},
     {version = ">=1.21.2", markers = "platform_system != \"Darwin\" and python_version >= \"3.10\" and python_version < \"3.11\""},
+    {version = ">=1.23.5", markers = "python_version >= \"3.11\" and python_version < \"3.12\""},
 ]
 
 [[package]]
@@ -3577,8 +3578,8 @@ files = [
 [package.dependencies]
 numpy = [
     {version = ">=1.26.0", markers = "python_version >= \"3.12\""},
-    {version = ">=1.23.2", markers = "python_version == \"3.11\""},
     {version = ">=1.22.4", markers = "python_version < \"3.11\""},
+    {version = ">=1.23.2", markers = "python_version == \"3.11\""},
 ]
 python-dateutil = ">=2.8.2"
 pytz = ">=2020.1"
@@ -7114,4 +7115,4 @@ tesserocr = ["tesserocr"]
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "46f6c1eb76034223f7d65760f6ebe0989ba9e8aff46fcdbce82c147030fcb8be"
+content-hash = "14143d6cc79f4c2c8a4d021711198697e91ca01ecf290dd270b483984461c3d1"
diff --git a/pyproject.toml b/pyproject.toml
index 92225813..4914b903 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -37,9 +37,9 @@ torchvision = [
 ######################
 python = "^3.10"
 pydantic = "^2.0.0"
-docling-core = {git = "https://github.com/DS4SD/docling-core.git", rev = "6fee533a101ca08f62e88826218c33e0aab2f417"}
+docling-core = {git = "https://github.com/DS4SD/docling-core.git", rev = "7c104d61aa5d003dd8d9711c37e23ce04799f4c9"}
 docling-ibm-models = {git = "https://github.com/DS4SD/docling-ibm-models.git", rev = "1d2e2a2e6eb152c237f1383cdba20cf85db80b97"}
-deepsearch-glm = {git = "https://github.com/DS4SD/deepsearch-glm.git", rev = "c13a6cdda25206911d63a5a28e990217ad823068"}
+deepsearch-glm = {git = "https://github.com/DS4SD/deepsearch-glm.git", rev = "c185c4f985ccd29a470a1cddd3bec43880b739ee"}
 docling-parse = "^1.5.1"
 
 filetype = "^1.2.0"