@helping-ai-workflow/md2doc 3.13.1 → 3.14.1

package/lib/editor/inline-md.js

@@ -267,6 +267,10 @@
   // STRONG, DEL/S, U, the citation label) only ever needs `.md`, because
   // its own outer delimiter is a fixed, known tag regardless of what's
   // nested inside.
+  function markIsSearchHit(node) {
+    if (typeof node.getAttribute !== 'function') return false;
+    return (' ' + (node.getAttribute('class') || '') + ' ').indexOf(' search-hit ') !== -1;
+  }
   function walkChildren(nodes, unsupported) {
     let out = '';
     let firstSegment = true;
@@ -292,6 +296,15 @@
         firstSegment = false;
         continue;
       }
+      if (name === 'MARK' && markIsSearchHit(node)) {
+        // v3.14.0 T9: the reader's search paints its hits as this element and
+        // it is transient, so it serializes as what it wraps.
+        const inner = walkChildren(node.childNodes, unsupported);
+        out += inner.md;
+        if (inner.md.length) lastMarkTag = inner.lastMarkTag;
+        firstSegment = false;
+        continue;
+      }
       if (name === 'SPAN') {
         if (spanHasAttributes(node)) {
           unsupported.push(name);
@@ -356,6 +369,14 @@
         firstSegment = false;
         continue;
       }
+      if (name === 'BR' && typeof node.getAttribute === 'function' &&
+          node.getAttribute('data-ed-tail') === '1') {
+        // v3.14.0 T8: the editor's tail <br> (insertBrAtCaret() in client.js)
+        // only gives a line break at the end of a surface a line to stand on.
+        // It is not content: nothing written, and like an empty text node it
+        // leaves lastMarkTag / firstSegment as they were.
+        continue;
+      }
       if (name === 'BR') {
         // Spec §3.12. Two different things arrive here as the same element:
         //   * a <br> the EDIT-MODE renderer marked (lib/md2doc.js's

package/lib/editor/toolbar-model.js

@@ -101,7 +101,7 @@ const MARK_IDS = Object.freeze(Object.keys(MARK_TAG_BY_ID));
 //   'inert'   pressing the button would do nothing at all
 
 // ctx: {blockType, indent, headingDepth, inList, listOrdered, hasSelection,
-//       marks, dirty}
+//       marks, dirty, transient}
 // -> { [id]: {active: bool, mixed: bool, disabled: bool, label?: string} }
 function deriveState(ctx) {
   const c = ctx || {};
@@ -151,6 +151,16 @@ function deriveState(ctx) {
   // primary case (spec review ruling: gating it on inList made it dead for
   // that case).
 
+  // v3.14.0 T4 (D15): an EMPTY transient paragraph has no text to convert, so
+  // the conversions that wrap existing text (quote, numbered list, check) and
+  // the list-depth buttons stay off until it has some. ctx.transient is
+  // 'empty' | 'text' | null; the client derives it from the DOM.
+  if (c.transient === 'empty') {
+    for (const id of ['quote', 'ordered-list', 'check', 'indent', 'outdent']) {
+      state[id].disabled = true;
+    }
+  }
+
   // No block at all (rerenderAll's zeroed state): everything disabled except
   // the handful of buttons that don't depend on having a focused block.
   if (!hasBlock) {

package/lib/md2doc.js

@@ -1395,8 +1395,12 @@ ${itemsHtml}
           resetLiRunState(biRef); // §3.8 rule (c): a non-li block ends every run
           const b = blocks[biRef.v++];
           const inner = marked.parser([t]);
+          // v3.14.0 T10: the reader wraps an svg-only block in .inline-svg for the
+          // dark white plate; edit mode keeps its DOM, so it marks the wrapper.
+          const svgPlate = ((t.type === 'html' && t.block && wrapsSvg(t.text)) ||
+            (t.type === 'paragraph' && wrapsSvgParagraph(t.raw))) ? ' data-svg-plate="1"' : '';
           parts.push(
-            `<div class="ed-block" data-block-id="${b.id}" data-block-type="${b.type}">` +
+            `<div class="ed-block" data-block-id="${b.id}" data-block-type="${b.type}"${svgPlate}>` +
             inner + '</div>'
           );
         }
@@ -3446,6 +3450,16 @@ ${usesDrawio ? `  /* v3.4.0 §4: a document with no drawio reference must not pa
     outline: 2px solid var(--md-accent); outline-offset: 2px;
     caret-color: var(--md-accent);
   }
+  /* v3.14.0 T4: the empty-paragraph hint. syncEmptyMark() in the client sets
+     data-ed-empty on a paragraph surface with no text; a real paragraph shows
+     the hint while focused, the transient (an empty document's, or one Enter
+     left behind) shows it even unfocused so a blank line is never a blank
+     page. An empty transient also gets a line of height of its own. */
+  .ed-block[data-block-type="paragraph"] > .ed-wys-armed[data-ed-empty]:focus::before,
+  .ed-block[data-ed-transient] > .ed-wys-armed[data-ed-empty]::before {
+    content: attr(data-placeholder); color: var(--md-muted-2); pointer-events: none;
+  }
+  .ed-block[data-ed-transient] > .ed-wys-armed { min-height: 1.6em; }
   /* Task 5: table cells armed PERMANENTLY (one edit surface per CELL, not
      per table root — see armEditables()'s 'table' branch in the client
      runtime) — same "no persistent outline, blue on :focus" language as
@@ -4584,23 +4598,31 @@ ${mermaidInitTag}`)
     )).join('');
   }
 
+  // On the edit page every block sits in a .ed-block wrapper, so the heading's
+  // siblings are wrappers: the section ends at the next wrapper that is, or
+  // directly holds, a heading of the same or a shallower depth. In the reader
+  // the unit is the heading itself and the walk is the one it always was.
   function sectionBoundary(sectionId) {
     const start = document.getElementById(sectionId);
     if (!start) return null;
     const startDepth = Number(start.getAttribute('data-reader-depth') || '1');
+    const unit = start.closest('.ed-block') || start;
     let end = null;
-    let node = start.nextElementSibling;
+    let node = unit.nextElementSibling;
     while (node) {
-      if (node.matches && node.matches('[data-reader-heading]')) {
-        const depth = Number(node.getAttribute('data-reader-depth') || '1');
+      let heading = null;
+      if (node.matches && node.matches('[data-reader-heading]')) heading = node;
+      else if (unit !== start && node.querySelector) heading = node.querySelector(':scope > [data-reader-heading]');
+      if (heading) {
+        const depth = Number(heading.getAttribute('data-reader-depth') || '1');
         if (depth <= startDepth) {
-          end = node;
+          end = heading;
           break;
         }
       }
       node = node.nextElementSibling;
     }
-    return { start, end };
+    return { start, end, container: unit.parentNode };
   }
 
   // A whitespace-only text node is the real space between words when it sits in
@@ -4634,13 +4656,12 @@ ${mermaidInitTag}`)
   function highlightFirstOccurrence(sectionId, query) {
     const bounds = sectionBoundary(sectionId);
     if (!bounds) return null;
-    const { start, end } = bounds;
-    const container = start.parentNode;
+    const { start, end, container } = bounds;
     if (!container) return null;
     const walker = document.createTreeWalker(container, NodeFilter.SHOW_TEXT | NodeFilter.SHOW_ELEMENT, {
       acceptNode(node) {
         if (node.nodeType === Node.ELEMENT_NODE) {
-          if (node.matches(SKIP_SELECTOR) || node.matches('.reader-sidebar, .heading-anchor')) return NodeFilter.FILTER_REJECT;
+          if (node.matches(SKIP_SELECTOR) || node.matches('.reader-sidebar, .heading-anchor, button')) return NodeFilter.FILTER_REJECT;
           return node.matches('br, .katex') ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP;
         }
         if (!node.nodeValue) return NodeFilter.FILTER_REJECT;
@@ -4650,7 +4671,7 @@ ${mermaidInitTag}`)
     });
     // Nothing before the heading is in range, so the walk starts at it.
     walker.currentNode = start;
-    const BLOCK = 'p, li, td, th, h1, h2, h3, h4, h5, h6, pre, blockquote, dt, dd, figcaption, .katex-display';
+    const BLOCK = 'p, li, .ed-li-text, td, th, h1, h2, h3, h4, h5, h6, pre, blockquote, dt, dd, figcaption, .katex-display';
     const nodes = [];
     let flat = '';
     const at = [];

package/lib/theme/tokens.js

@@ -165,7 +165,7 @@ function themeCss() {
     '    ' + D + ' .content .drawio { background: #ffffff; border-radius: 6px; box-shadow: 0 0 0 10px #ffffff; }',
     // R7 甲: a Markdown-native inline svg (wrapped in .inline-svg by the renderer) gets the
     // same white plate; its ink stays the light text colour because the plate is always white.
-    '    ' + D + ' .content .inline-svg > svg { background: #ffffff; color: #1f2328; border-radius: 4px; box-shadow: 0 0 0 10px #ffffff; }',
+    '    ' + D + ' .content .inline-svg > svg, ' + D + ' .content .ed-block[data-svg-plate="1"] > svg, ' + D + ' .content .ed-block[data-svg-plate="1"] > p > svg { background: #ffffff; color: #1f2328; border-radius: 4px; box-shadow: 0 0 0 10px #ffffff; }',
     '    ' + D + ' .lightbox-canvas > svg[data-md2doc-recoloured] { background: var(--md-bg); }',
     '  }',
     '  .md2doc-theme-toggle { position: fixed; right: 20px; bottom: 20px; z-index: 60; width: 40px; height: 40px;',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helping-ai-workflow/md2doc",
-  "version": "3.13.1",
+  "version": "3.14.1",
   "description": "Markdown → HTML / PDF renderer with WaveDrom, Mermaid, Graphviz, and draw.io support",
   "keywords": [
     "markdown",