@uniweb/content-writer 0.3.1 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/content-writer",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "ProseMirror document structure to Markdown converter",
   "type": "module",
   "main": "src/index.js",
@@ -20,7 +20,7 @@
   },
   "devDependencies": {
     "vitest": "^4.1.7",
-    "@uniweb/content-reader": "1.2.0"
+    "@uniweb/content-reader": "1.2.1"
   },
   "directories": {
     "test": "tests"

package/src/nodes.js

@@ -148,7 +148,7 @@ export function serializeInsetBlock(node) {
  * @returns {string} Fenced concept block
  */
 export function serializeConceptBlock(node) {
-  const { tag } = node.attrs || {}
+  const { tag, syntax } = node.attrs || {}
   if (!tag) return ''
 
   const { serializeNode } = await_serializer()
@@ -157,6 +157,22 @@ export function serializeConceptBlock(node) {
     .filter(Boolean)
     .join('\n\n')
 
+  // Write back the spelling the author wrote. One node, two surfaces — a
+  // ```md:<tag> fence and GitHub's `> [!WARNING]` — and `syntax` is how the
+  // reader records which. Normalizing instead would rewrite someone's file on
+  // the next editor sync, which is exactly what `dataBlock.language` was added
+  // to stop when a ```yaml block came back as ```json.
+  if (syntax === 'gfm') {
+    // Every line of a blockquote carries its own marker, including the blank
+    // ones between blocks — a bare `>` rather than `> ` so no trailing space
+    // is written into the author's file.
+    const quoted = body
+      .split('\n')
+      .map(line => (line ? `> ${line}` : '>'))
+      .join('\n')
+    return `> [!${tag.toUpperCase()}]\n${quoted}`
+  }
+
   const fence = '`'.repeat(fenceWidthFor(body))
 
   return `${fence}md:${tag}\n${body}\n${fence}`

package/tests/roundtrip.test.js

@@ -457,3 +457,38 @@ describe('Round-trip: Concept blocks', () => {
     expect(proseMirrorToMarkdown(doc).trim()).not.toBe('')
   })
 })
+
+describe('Round-trip: GitHub alerts', () => {
+  testRoundTrip('> [!WARNING]\n> Back up your database first.', 'a GitHub alert')
+  testRoundTrip('> [!NOTE]\n> Something **worth** knowing, with a [link](/x).', 'marks inside one')
+  testRoundTrip('> [!TIP]\n> One thing.\n>\n> And another.', 'multiple blocks inside one')
+  testRoundTrip('> A plain quotation, **unchanged**.', 'an ordinary blockquote still round-trips')
+
+  test('the spelling is PRESERVED, not normalized', () => {
+    // The whole reason `syntax` exists. Normalizing would rewrite an author's
+    // file on the next editor sync — the defect dataBlock.language was added
+    // to stop, where a ```yaml block came back as ```json.
+    const gfm = '> [!WARNING]\n> Back up first.'
+    const fence = '```md:warning\nBack up first.\n```'
+
+    expect(proseMirrorToMarkdown(markdownToProseMirror(gfm)).trim()).toBe(gfm)
+    expect(proseMirrorToMarkdown(markdownToProseMirror(fence)).trim()).toBe(fence)
+  })
+
+  test('both spellings carry the same content', () => {
+    const gfm = markdownToProseMirror('> [!WARNING]\n> Back up **first**.')
+    const fence = markdownToProseMirror('```md:warning\nBack up **first**.\n```')
+    expect(gfm.content[0].content).toEqual(fence.content[0].content)
+    expect(gfm.content[0].attrs.tag).toBe(fence.content[0].attrs.tag)
+  })
+
+  test('is a FIXED POINT, asserted on the body', () => {
+    const original = '> [!CAUTION]\n> Mind the gap.'
+    const pass1 = proseMirrorToMarkdown(markdownToProseMirror(original))
+    const pass2 = proseMirrorToMarkdown(markdownToProseMirror(pass1))
+    // A dropped node is trivially a fixed point — pin the content first.
+    expect(pass1).toContain('Mind the gap.')
+    expect(pass1).toContain('[!CAUTION]')
+    expect(pass2).toBe(pass1)
+  })
+})