@uniweb/content-writer 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/content-writer",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "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.1"
+    "@uniweb/content-reader": "1.2.4"
   },
   "directories": {
     "test": "tests"

package/src/nodes.js

@@ -21,6 +21,12 @@ export { serializeInsetRef }
 export function serializeHeading(node) {
   const prefix = '#'.repeat(node.attrs?.level || 1)
   const text = serializeInlineContent(node.content)
+  // A `#>` label line (pretitle). The hash count carries the authored
+  // spelling only — `#>` and `##>` mean the same thing — so emitting the
+  // stored level keeps the file byte-identical through a round-trip.
+  if (node.attrs?.role === 'pretitle') {
+    return `${prefix}> ${text}`
+  }
   return `${prefix} ${text}`
 }
 

package/src/normalize.js

@@ -9,7 +9,7 @@
  *     link/button/code/span`), and
  *   - the **editor (TipTap) dialect** (`ImageBlock`, `Video`,
  *     `UniwebIcon`/`Icon`, `DividerBlock`, `card-group`, `FormBlock`,
- *     `WarningBlock`, `details`, colour/highlight marks …).
+ *     colour/highlight marks …).
  *
  * A ProseMirror document handed to content-writer may be in either dialect,
  * or a mix (file-origin content is framework-dialect; editor-authored
@@ -46,8 +46,15 @@
  *   - `FormBlock` — the editor node carries `activeSchemaId` + filled
  *     `data`; the framework `yaml:form` block carries a form *definition*.
  *     Different shapes; mapping needs a decision, not a guess.
- *   - `card-group`/`document-group`, `details`, `WarningBlock` — open
- *     mapping decisions (items vs insets; 🟥 gaps).
+ *   - `card-group`/`document-group` — open mapping decisions (🟥 gaps).
+ *
+ *   The editor's pre-concept containers — `WarningBlock`, `details`,
+ *   `detailsSummary`, `detailsContent` — used to be mapped here. The editor
+ *   now registers `concept_block` and its rows directly, so it never emits
+ *   them and the conversion was dead code; it was deleted when the
+ *   regenerated fixture in `_contracts/editor-vocabulary-diff.test.js`
+ *   stopped listing them. That fixture is the signal, and it is the only one
+ *   there is — no message announces it.
  *   - colour/highlight/strike/underline marks — need the named-inline-
  *     style convention decision.
  *
@@ -192,9 +199,6 @@ function mapEditorNode(node) {
     case 'UniwebIcon':
     case 'Icon':
       return mapUniwebIcon(node)
-    case 'WarningBlock':
-    case 'details':
-      return EDITOR_CONTAINERS[node.type](node)
     case 'emoji':
       // The node carries the character alongside a name; the character is the
       // whole markdown form. Guarded rather than assumed to be populated.
@@ -240,95 +244,6 @@ function mapEditorNode(node) {
  */
 const NAMED_INLINE_STYLES = new Set(['accent', 'highlight', 'callout', 'muted'])
 
-/**
- * Editor container nodes → the framework's `inset_block`, as an explicit table.
- *
- * Deliberately not derived from the node name. The editor's node is
- * `WarningBlock` while the component is `Alert`, and its `type` defaults to
- * `info` rather than `warning` — a name-derived mapping drops exactly that row,
- * which is how `mapUniwebIcon` came to lose every icon the editor produces. A
- * missing entry here is a visible gap rather than a silent assumption.
- */
-const EDITOR_CONTAINERS = {
-  // A callout's SEVERITY is the concept, not a parameter on one — a warning and
-  // a note are different kinds of thing, so they are different tags. This is
-  // where the editor's `type` attribute goes.
-  WarningBlock: node => ({
-    type: 'concept_block',
-    attrs: { tag: node.attrs?.type || 'info' },
-    content: asBlocks(node.content),
-  }),
-  // The summary becomes the leading HEADING rather than a paragraph, which is
-  // what makes the mapping lossless in both directions: a concept block's items
-  // come from its headings, so the summary recovers as that item's title and
-  // the body as its paragraphs. Flattening it to a paragraph — what this did
-  // while the target was an inset — made the two indistinguishable on the way
-  // back.
-  details: node => ({
-    type: 'concept_block',
-    attrs: { tag: 'details' },
-    content: detailsBody(node),
-  }),
-}
-
-/** Inline node types, for deciding whether a container's body needs wrapping. */
-const INLINE_TYPES = new Set([
-  'text',
-  'hardBreak',
-  'image',
-  'math_inline',
-  'inset_ref',
-  'emoji',
-  'UniwebIcon',
-])
-
-/**
- * A container body as block content.
- *
- * `WarningBlock` holds `text*` today and `block+` after the editor's widening,
- * so both shapes arrive here. Inline content is wrapped in one paragraph;
- * block content passes through.
- *
- * @param {Array} content
- * @returns {Array}
- */
-function asBlocks(content) {
-  if (!content?.length) return []
-  return content.every(node => INLINE_TYPES.has(node.type))
-    ? [{ type: 'paragraph', content }]
-    : content
-}
-
-/**
- * Flatten the editor's `details` › `detailsSummary` + `detailsContent` into a
- * concept block's body, summary first — as a HEADING.
- *
- * The heading is what makes the mapping lossless. A concept block's items come
- * from its headings, so a summary written as `# …` recovers as that item's
- * title and the body as its paragraphs; written as a paragraph (which is what
- * this did while the target was an inset) the two become indistinguishable on
- * the way back, and a disclosure loses which half was its label.
- *
- * The summary stays inline content rather than moving to an attribute for the
- * original reason: `detailsSummary` can carry marks, and `summary="…"` would
- * flatten emphasis and links.
- *
- * @param {Object} node
- * @returns {Array}
- */
-function detailsBody(node) {
-  const body = []
-  for (const child of node.content || []) {
-    if (child.type === 'detailsSummary') {
-      if (child.content?.length) {
-        body.push({ type: 'heading', attrs: { level: 1 }, content: child.content })
-      }
-    } else if (child.type === 'detailsContent') body.push(...(child.content || []))
-    else body.push(child)
-  }
-  return body
-}
-
 /** A mark that carries nothing and should be removed rather than reported. */
 const DROP_MARK = Symbol('drop-mark')
 

package/tests/pretitle.test.js

@@ -0,0 +1,36 @@
+/**
+ * `#>` label lines (pretitles) round-trip through read → write.
+ *
+ * The hash count means nothing but is preserved — an authored `##>` comes
+ * back as `##>`, so a sync never rewrites a file over a spelling choice.
+ */
+import { describe, test, expect } from 'vitest'
+import { proseMirrorToMarkdown } from '../src/index.js'
+import { markdownToProseMirror } from '@uniweb/content-reader'
+
+const md = s => proseMirrorToMarkdown(markdownToProseMirror(s)).trim()
+
+describe('pretitle round-trip', () => {
+  test('#> comes back as #>', () => {
+    expect(md('#> New in v2')).toBe('#> New in v2')
+  })
+
+  test('the authored hash count is preserved', () => {
+    expect(md('##> Most popular')).toBe('##> Most popular')
+    expect(md('###> Deep label')).toBe('###> Deep label')
+  })
+
+  test('a label above a headline survives in place', () => {
+    const source = '#> New in v2\n\n# Build the system\n\n## Not every page'
+    expect(md(source)).toBe(source)
+  })
+
+  test('inline marks inside a label survive', () => {
+    expect(md('#> New in *v2*')).toBe('#> New in *v2*')
+  })
+
+  test('serialization is a fixed point', () => {
+    const once = md('##> Label')
+    expect(md(once)).toBe(once)
+  })
+})

package/tests/roundtrip-source.test.js

@@ -262,35 +262,4 @@ describe('containers — the block form of an inset', () => {
     const source = '````@Alert{type=info}\nDo not:\n\n```js\nconst x = 1\n```\n````'
     expect(rt(source)).toBe(source)
   })
-
-  test('the editor containers normalize onto CONCEPT blocks, not insets', () => {
-    // Changed 2026-07-31. These used to become `@Alert` and `@Details` — an
-    // inset naming the component that renders it, which is a rendering
-    // decision living in content. A concept block names what the content IS
-    // and leaves rendering to the foundation.
-    const text = t => ({ type: 'text', text: t })
-    const doc = node => proseMirrorToMarkdown({ type: 'doc', content: [node] }).trim()
-
-    // The editor's `type` becomes the TAG: a warning and a note are different
-    // kinds of thing, not one kind with a parameter. `info` is still the
-    // default, and still not `warning` — a name-derived mapping drops that.
-    expect(doc({ type: 'WarningBlock', attrs: {}, content: [text('Careful.')] }))
-      .toBe('```md:info\nCareful.\n```')
-    expect(doc({ type: 'WarningBlock', attrs: { type: 'warning' }, content: [text('Careful.')] }))
-      .toBe('```md:warning\nCareful.\n```')
-
-    // The summary becomes the leading HEADING, which is what makes this
-    // lossless: a concept block's items come from its headings, so the summary
-    // recovers as the item's title and the body as its paragraphs. As a
-    // paragraph — what this produced while the target was an inset — the two
-    // were indistinguishable coming back.
-    expect(doc({
-      type: 'details',
-      content: [
-        { type: 'detailsSummary', content: [text('Breaking '), { type: 'text', text: 'changes', marks: [{ type: 'bold' }] }] },
-        { type: 'detailsContent', content: [{ type: 'paragraph', content: [text('Body.')] }] },
-      ],
-    })).toBe('```md:details\n# Breaking **changes**\n\nBody.\n```')
-  })
-
 })