jmd-format 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jmd-format",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "JMD (JSON Markdown) — structured data format for LLM-driven infrastructure. JavaScript reference implementation.",
   "type": "module",
   "main": "./src/index.js",

package/src/parser.js

@@ -127,10 +127,12 @@ export function createParser() {
       return drain()
     }
 
-    // Thematic break: `---` (or more) at column 0, only meaningful inside
-    // an array scope, where it terminates the current item.
+    // Thematic break `---` is pure decoration (§8.6): the level-pop (an
+    // anonymous heading) is the structural mechanism, so a `---` line is
+    // skipped. It consumes any pending blank, so a following `- ` item
+    // still joins the current array instead of triggering a root reset.
     if (/^-{3,}$/.test(line)) {
-      onThematicBreak()
+      blankPending = false
       return drain()
     }
 
@@ -153,30 +155,6 @@ export function createParser() {
     if (stack[0] && stack[0].kind === 'array') closeItem(stack[0])
   }
 
-  function onThematicBreak() {
-    blankPending = false
-    // A thematic break is consumed by the innermost enclosing array whose
-    // most-recent item is a dict containing nested structures — this is
-    // the only context where jmd-format emits the break, and the parser
-    // mirrors that rule (spec §8.6). Inner scopes are closed; if no array
-    // on the stack qualifies, the line is tolerated as decoration.
-    let targetIdx = -1
-    for (let i = stack.length - 1; i >= 0; i--) {
-      const s = stack[i]
-      if (s.kind !== 'array') continue
-      const last = s.container[s.container.length - 1]
-      if (last && typeof last === 'object' && !Array.isArray(last)
-          && Object.values(last).some(
-            v => v !== null && typeof v === 'object')) {
-        targetIdx = i
-        break
-      }
-    }
-    if (targetIdx === -1) return
-    while (stack.length - 1 > targetIdx) popScope()
-    closeItem(stack[targetIdx])
-  }
-
   // --- Blockquote ----------------------------------------------------------
 
   function startBlockquote(container, key) {
@@ -370,13 +348,25 @@ export function createParser() {
       return
     }
 
-    popToDepth(depth)
-
+    // Anonymous heading at depth D. If an array scope is open at exactly
+    // this depth, the heading is a level-pop (§8.6): return to that array
+    // — drop any deeper sub-scopes and close the record that opened them,
+    // so the next `- ` item joins THIS array. One marker pops arbitrary
+    // nesting in a single step. Otherwise it is a §3.2a anonymous object.
     if (text === '' || text === undefined) {
+      const arr = arrayScopeAtDepth(depth)
+      if (arr) {
+        popToDepth(depth + 1)
+        closeItem(arr)
+        return
+      }
+      popToDepth(depth)
       openObjectScope(depth, '')
       return
     }
 
+    popToDepth(depth)
+
     // Anonymous sub-array: `### []` — handled below with the other array forms.
     if (text === '[]') {
       openSubArray(depth)
@@ -570,6 +560,20 @@ export function createParser() {
     )
   }
 
+  // Find an open array scope at exactly this depth, scanning from the top.
+  // Used to disambiguate an anonymous heading: an array at the heading's
+  // own depth means the heading is a level-pop (§8.6), not a §3.2a
+  // anonymous object. Returns null if the first scope at depth ≤ D is not
+  // such an array.
+  function arrayScopeAtDepth(depth) {
+    for (let i = stack.length - 1; i >= 0; i--) {
+      const s = stack[i]
+      if (s.depth > depth) continue
+      return (s.depth === depth && s.kind === 'array') ? s : null
+    }
+    return null
+  }
+
   function parentContainerAndSeen(scope) {
     if (scope.kind === 'object') {
       return { container: scope.container, seen: scope.seen }

package/src/serializer.js

@@ -152,10 +152,8 @@ function writeArrayItems(lst, lines, depth) {
   }
 
   if (allDicts) {
-    const hasNested = lst.some(item =>
-      Object.values(item).some(isNested))
     for (let i = 0; i < lst.length; i++) {
-      writeDictItem(lst[i], lines, depth, i > 0 && hasNested)
+      writeDictItem(lst[i], lines, depth, i < lst.length - 1)
     }
     return
   }
@@ -196,7 +194,7 @@ function writeArrayItems(lst, lines, depth) {
   }
 }
 
-function writeDictItem(item, lines, depth, separatorNeeded, qualifierPrefix = '') {
+function writeDictItem(item, lines, depth, moreFollow, qualifierPrefix = '') {
   const scalarFields = []
   const nestedFields = []
   for (const [k, v] of Object.entries(item)) {
@@ -204,14 +202,6 @@ function writeDictItem(item, lines, depth, separatorNeeded, qualifierPrefix = ''
     else scalarFields.push([k, v])
   }
 
-  if (separatorNeeded) {
-    // Match the C-accelerated Python serializer (the default in jmd-format):
-    // blank line before the `---`, but the next `- ` follows immediately on
-    // the next line — no blank after the thematic break.
-    lines.push('')
-    lines.push('---')
-  }
-
   if (scalarFields.length === 0) {
     lines.push(qualifierPrefix + '-')
   } else {
@@ -230,6 +220,13 @@ function writeDictItem(item, lines, depth, separatorNeeded, qualifierPrefix = ''
 
   if (nestedFields.length > 0) {
     writeObjectFields(Object.fromEntries(nestedFields), lines, depth)
+    // Level-pop (§8.6): this record opened a sub-structure (heading at
+    // depth+1). If more records follow, emit an anonymous heading at the
+    // array's own depth to pop back, so the next bare `-` item is read into
+    // THIS array. The last record needs no pop — end-of-scope closes it.
+    if (moreFollow) {
+      lines.push('#'.repeat(depth))
+    }
   }
 }