@uniweb/semantic-parser 1.1.7 → 1.1.8

package/AGENTS.md

@@ -167,7 +167,7 @@ Key patterns:
 - **Pretitle Pattern**: Any heading followed by a more important heading (e.g., H3→H1, H2→H1, H6→H5, etc.)
 - **Banner Pattern**: Image (with banner role or followed by heading) at start of first group
 - **Divider Mode**: Presence of any `horizontalRule` switches entire document to divider-based grouping
-- **Heading Groups**: Consecutive headings with increasing levels are consumed together
+- **Heading Groups**: Consecutive headings are consumed together only when each is exactly one level deeper (H1→H2 yes, H1→H3 no — skipped levels start a new group)
 - **Main Content**: First group is main if it's the only group OR has lower heading level than second group
 - **Body Headings**: Headings after the title and subtitle slots are collected in `body.headings` in document order
 

package/README.md

@@ -153,6 +153,8 @@ Groups are created based on heading patterns. A new group starts when:
 - Multiple H1s appear (no main content created)
 - The heading level indicates a new section
 
+**Heading group formation:** Consecutive headings are consumed as a single semantic unit only when each subsequent heading is _exactly one level deeper_ than the previous (e.g., H1→H2→H3). Skipping levels (H1→H3) breaks the group — the deeper heading starts a new group instead of becoming a subtitle. This reflects natural document structure: a large level gap signals items, not a title-subtitle pair.
+
 **Pretitle Detection:** Any heading followed by a more important heading is automatically detected as a pretitle:
 - H3 before H1 → pretitle ✅
 - H2 before H1 → pretitle ✅

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/semantic-parser",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Semantic parser for ProseMirror/TipTap content structures",
   "type": "module",
   "main": "./src/index.js",

package/src/processors/groups.js

@@ -183,9 +183,11 @@ function readHeadingGroup(sequence, startIdx) {
             break;
         }
 
-        // Case 1: Strictly Deeper (Standard Subtitle/Deep Header)
-        // e.g. H1 -> H2
-        if (element.level > previousElement.level) {
+        // Case 1: Adjacent Deeper (Standard Subtitle/Deep Header)
+        // Only group headings that are exactly one level apart.
+        // e.g. H1 -> H2 groups, but H1 -> H3 does not (skipped level
+        // signals a structural tier change, not a title-subtitle pair).
+        if (element.level - previousElement.level === 1) {
             hasGoneDeeper = true;
             elements.push(element);
             continue;