tiptap-python-utils 0.3.0__tar.gz → 0.4.0__tar.gz

{tiptap_python_utils-0.3.0/src/tiptap_python_utils.egg-info → tiptap_python_utils-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tiptap_python_utils
-Version: 0.3.0
+Version: 0.4.0
 Summary: Python utilities for parsing, traversing, editing, and serializing TipTap JSON content.
 Author: tiptap_python_utils contributors
 License: MIT License

{tiptap_python_utils-0.3.0 → tiptap_python_utils-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tiptap_python_utils"
-version = "0.3.0"
+version = "0.4.0"
 description = "Python utilities for parsing, traversing, editing, and serializing TipTap JSON content."
 readme = "README.md"
 requires-python = ">=3.9"

{tiptap_python_utils-0.3.0 → tiptap_python_utils-0.4.0}/src/tiptap_python_utils/contract/key.py

@@ -8,6 +8,8 @@ MARKS = "marks"
 ID = "id"
 TIPTAP_ID = "tiptapId"
 SHARED_ID = "sharedId"
+SHARED = "shared"
+PLACE = "place"
 LEVEL = "level"
 CHECKED = "checked"
 STATUS = "status"

{tiptap_python_utils-0.3.0 → tiptap_python_utils-0.4.0}/src/tiptap_python_utils/shared/families.py

@@ -52,13 +52,22 @@ class SharedFamilies:
         return len(self._bodies)
 
     def merge(self, target: Node) -> Node:
-        """Return target rewritten from the canonical body, preserving local id and sharedId."""
+        """Return target rewritten from the canonical body.
+
+        Preserves the target's per-copy identity (local id, sharedId) and its
+        per-copy ``place`` discriminator. The family-identical ``shared`` core
+        rides along from the canonical body unchanged.
+        """
         canonical = self[target.shared_id]
         raw = canonical.raw()
         attrs = dict(raw.get(key.ATTRS, {}))
+        attrs.pop(key.PLACE, None)
         if target.id:
             attrs[key.ID] = target.id
         if target.shared_id:
             attrs[key.SHARED_ID] = target.shared_id
+        target_attrs = target.raw().get(key.ATTRS, {})
+        if key.PLACE in target_attrs:
+            attrs[key.PLACE] = target_attrs[key.PLACE]
         raw[key.ATTRS] = attrs
         return codec.read_node(raw)

{tiptap_python_utils-0.3.0 → tiptap_python_utils-0.4.0}/src/tiptap_python_utils/shared/fingerprint.py

@@ -13,6 +13,9 @@ def fingerprint(node: Node) -> str:
     attrs = dict(raw.get(key.ATTRS, {}))
     attrs.pop(key.ID, None)
     attrs.pop(key.SHARED_ID, None)
+    attrs.pop(key.SHARED, None)
+    attrs.pop(key.PLACE, None)
+    attrs.pop(key.TASK_CANONICAL_ID, None)
     if attrs:
         raw[key.ATTRS] = attrs
     else:

{tiptap_python_utils-0.3.0 → tiptap_python_utils-0.4.0/src/tiptap_python_utils.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tiptap_python_utils
-Version: 0.3.0
+Version: 0.4.0
 Summary: Python utilities for parsing, traversing, editing, and serializing TipTap JSON content.
 Author: tiptap_python_utils contributors
 License: MIT License

{tiptap_python_utils-0.3.0 → tiptap_python_utils-0.4.0}/tests/test_mutations.py

@@ -140,6 +140,136 @@ def test_sync_shared_no_op_when_no_matching_shared_id():
     assert rewritten.dump() == target.dump()
 
 
+# ---------------------------------------------------------------------------
+# Self-describing shared core: `shared` (family-identical) + `place` (per-copy)
+# ---------------------------------------------------------------------------
+
+
+def test_shared_families_ignores_shared_and_place_when_fingerprinting():
+    # Two members of one family, identical body text, but differing per-copy
+    # `place` and differing `shared` core. These keys are provenance, not body,
+    # so the fingerprint must ignore them and NOT flag a conflict.
+    content = Content.require(
+        json.dumps(
+            {
+                "type": "doc",
+                "content": [
+                    {
+                        "type": "paragraph",
+                        "attrs": {
+                            "id": "n1",
+                            "sharedId": "shared-1",
+                            "shared": {"id": "shared-1", "topics": ["a"]},
+                            "place": {"context": "dated_note", "topicId": None},
+                        },
+                        "content": [{"type": "text", "text": "same body"}],
+                    },
+                    {
+                        "type": "paragraph",
+                        "attrs": {
+                            "id": "n2",
+                            "sharedId": "shared-1",
+                            "shared": {"id": "shared-1", "topics": ["b"]},
+                            "place": {"context": "undated_note", "topicId": "t-1"},
+                        },
+                        "content": [{"type": "text", "text": "same body"}],
+                    },
+                ],
+            }
+        )
+    )
+
+    families = content.shared_families()
+
+    assert "shared-1" in families
+
+
+def test_shared_families_still_rejects_real_body_divergence_despite_place():
+    # Differing `place` must not mask a genuine body difference: the text still
+    # differs, so this remains a conflict (guards against over-stripping).
+    content = Content.require(
+        json.dumps(
+            {
+                "type": "doc",
+                "content": [
+                    {
+                        "type": "paragraph",
+                        "attrs": {
+                            "id": "n1",
+                            "sharedId": "shared-1",
+                            "place": {"context": "dated_note", "topicId": None},
+                        },
+                        "content": [{"type": "text", "text": "one"}],
+                    },
+                    {
+                        "type": "paragraph",
+                        "attrs": {
+                            "id": "n2",
+                            "sharedId": "shared-1",
+                            "place": {"context": "undated_note", "topicId": "t-1"},
+                        },
+                        "content": [{"type": "text", "text": "two"}],
+                    },
+                ],
+            }
+        )
+    )
+
+    with pytest.raises(TiptapValidationError, match="Conflicting node bodies detected"):
+        content.shared_families()
+
+
+def test_sync_shared_preserves_per_copy_place_and_carries_shared_core():
+    source = Content.require(
+        json.dumps(
+            {
+                "type": "doc",
+                "content": [
+                    {
+                        "type": "paragraph",
+                        "attrs": {
+                            "id": "source-id",
+                            "sharedId": "shared-1",
+                            "shared": {"id": "shared-1", "primaryTopic": "t-react"},
+                            "place": {"context": "dated_note", "topicId": None},
+                        },
+                        "content": [{"type": "text", "text": "new"}],
+                    }
+                ],
+            }
+        )
+    )
+    target = Content.require(
+        json.dumps(
+            {
+                "type": "doc",
+                "content": [
+                    {
+                        "type": "paragraph",
+                        "attrs": {
+                            "id": "target-id",
+                            "sharedId": "shared-1",
+                            "shared": {"id": "shared-1", "primaryTopic": "STALE"},
+                            "place": {"context": "undated_note", "topicId": "t-react"},
+                        },
+                        "content": [{"type": "text", "text": "old"}],
+                    }
+                ],
+            }
+        )
+    )
+
+    rewritten = target.sync_shared(source.shared_families())
+    node = json.loads(rewritten.dump())["content"][0]
+
+    # Body + family-identical `shared` core come from the canonical (source).
+    assert node["content"][0]["text"] == "new"
+    assert node["attrs"]["shared"]["primaryTopic"] == "t-react"
+    # Per-copy identity and `place` stay the target's own.
+    assert node["attrs"]["id"] == "target-id"
+    assert node["attrs"]["place"] == {"context": "undated_note", "topicId": "t-react"}
+
+
 # ---------------------------------------------------------------------------
 # Node.with_shared_id
 # ---------------------------------------------------------------------------