@helping-ai-workflow/md2doc 3.14.1 → 3.16.0

package/lib/editor/inline-md.js

@@ -423,5 +423,24 @@
     return serializeInline(rootEl).unsupported.length === 0;
   }
 
-  return { serializeInline, canWysiwyg, escapeText, escapeBlockStarts };
+  // v3.15.0 T5 (D15): what the URL field writes into an href. serializeAnchor
+  // puts the href into `[text](href)` unescaped, so a space or a parenthesis
+  // would end the destination early; those and angle brackets are
+  // percent-encoded. A bare host gets https://; anything that already names a
+  // scheme, an anchor or a path is kept.
+  function normalizeHref(raw) {
+    let h = String(raw == null ? '' : raw).trim();
+    if (h === '') return '';
+    if (!/^([a-z][a-z0-9+.-]*:|#|\/|\.\/|\.\.\/)/i.test(h)) h = 'https://' + h;
+    return h.replace(/ /g, '%20').replace(/\(/g, '%28').replace(/\)/g, '%29')
+      .replace(/</g, '%3C').replace(/>/g, '%3E');
+  }
+
+  // A clipboard text that is exactly one http(s) URL (the address bar adds a
+  // trailing newline, some pages surrounding spaces).
+  function isPastedUrl(text) {
+    return /^https?:\/\/\S+$/.test(String(text == null ? '' : text).trim());
+  }
+
+  return { serializeInline, canWysiwyg, escapeText, escapeBlockStarts, normalizeHref, isPastedUrl };
 });

package/lib/editor/lineops.js

@@ -96,6 +96,12 @@
     const span = { startLine: op.startLine, endLine: op.startLine + op.after.length - 1 };
     return { lines: replaceLines(lines, span.startLine, span.endLine, op.before).lines, op };
   };
+  // v3.15.0 T9 (D21): the op undo() would pop next, or null. Read, never
+  // popped: rollbackFailedRender() (lib/editor/client.js) undoes a failed
+  // commit only while that commit is still the newest op.
+  UndoStack.prototype.top = function () {
+    return this._done.length ? this._done[this._done.length - 1] : null;
+  };
   // v3.4.0 batch3 Task 7 fix 1 (F3) — read and write the REDO tail.
   //
   // `push()` clears `_undone`, and that is correct for an ordinary edit: once

package/lib/editor/list-md.js

@@ -494,15 +494,21 @@
     // gives the item a source line of its own (blockmap can then hand it a
     // well-formed range). Only the checkbox forces the same-line form.
     //
-    // The prefix is FLUSHED as its own line — degrading to literal '[ ]', which
-    // is what the source said anyway — whenever the next block is not deeper,
-    // i.e. when the item has no child to attach to. Merging it onto a SIBLING
-    // would invent nesting that the document never had.
+    // The prefix is FLUSHED as its own line — `- [ ] `, its checkbox kept by
+    // the one space after it (v3.15.0 T3, R44; see flushPending()) — whenever
+    // the next block is not deeper, i.e. when the item has no child to attach
+    // to. Merging it onto a SIBLING would invent nesting that the document
+    // never had.
     let pending = null; // { text, cols, indent, blockId, indentPrefix, marker }
 
+    // v3.15.0 T3 (R44): the flushed line keeps ONE space after its checkbox.
+    // `- [ ]` with nothing after it is a plain item whose text is "[ ]"
+    // (measured, marked) — the next commit of that item wrote `- \[ \]`, and
+    // typing into the empty to-do an Enter had made saved `- x\[ \]`. `- [ ] `
+    // is an empty to-do (the D5 skeleton), so that is what is written.
     function flushPending() {
       if (!pending) return;
-      lines.push(pending.text.replace(/[ \t]+$/, ''));
+      lines.push(pending.text.replace(/[ \t]+$/, '') + ' ');
       lineMeta.push({ blockId: pending.blockId, indentPrefix: pending.indentPrefix,
         marker: pending.marker });
       pending = null;

package/lib/editor/server.js

@@ -4,7 +4,7 @@ const path = require('path');
 const http = require('http');
 const crypto = require('crypto');
 const drawioLib = require('../drawio.js');
-const { renderMarkdown } = require('../md2doc.js');
+const { renderMarkdown, buildKatexStyleTag, diagramEnginePaths } = require('../md2doc.js');
 
 const LINEOPS_SRC = fs.readFileSync(path.join(__dirname, 'lineops.js'), 'utf8');
 const INLINE_MD_SRC = fs.readFileSync(path.join(__dirname, 'inline-md.js'), 'utf8');
@@ -25,6 +25,10 @@ const INDENT_CLAMP_SRC = fs.readFileSync(path.join(__dirname, 'indent-clamp.js')
 // indent-clamp.js above — it only has to land before client.js reads
 // window.md2docConvertMd.
 const CONVERT_MD_SRC = fs.readFileSync(path.join(__dirname, 'convert-md.js'), 'utf8');
+// v3.15.0 T1: the "/" block menu's catalogue (its items, filter and
+// skeletons). Pure, no dependency on any other editor module; it only has to
+// land before client.js reads window.md2docBlockCatalog.
+const BLOCK_CATALOG_SRC = fs.readFileSync(path.join(__dirname, 'block-catalog.js'), 'utf8');
 // v3.2.0: the pure string-diff module behind incremental DOM patching —
 // stripBlockId()/patchmap() compare oldParts[i] against newParts[j] with only
 // data-block-id normalized (see the global constraint on that). Same "no
@@ -190,6 +194,33 @@ function hostIsLoopback(hostHeader, port) {
   return false;
 }
 
+// v3.15.0 T4 (D12, R9): the diagram engines an edit page loads on demand
+// (client.js ensureDiagramEngines()) — the page inlines them only when the
+// document used them at load. The paths are lib/md2doc.js's own resolved ones
+// (B2 fix round 1, R61: one resolver, not two). Read per request (a few MB, a
+// handful of requests per session at most).
+function diagramLibBody(name) {
+  if (name === 'mermaid.js') {
+    const p = diagramEnginePaths.mermaid;
+    return p ? { type: 'application/javascript; charset=utf-8', body: fs.readFileSync(p, 'utf8') } : null;
+  }
+  if (name === 'wavedrom.js') {
+    // The skin first: the library reads the WaveSkin global it defines.
+    const skin = diagramEnginePaths.wavedromSkin;
+    const lib = diagramEnginePaths.wavedrom;
+    if (!skin || !lib) return null;
+    return { type: 'application/javascript; charset=utf-8',
+      body: fs.readFileSync(skin, 'utf8') + '\n' + fs.readFileSync(lib, 'utf8') };
+  }
+  if (name === 'katex.css') {
+    const tag = buildKatexStyleTag();
+    const open = tag.indexOf('>') + 1;
+    const close = tag.lastIndexOf('</style>');
+    return { type: 'text/css; charset=utf-8', body: tag.slice(open, close) };
+  }
+  return null;
+}
+
 function send(res, status, obj) {
   const body = JSON.stringify(obj);
   res.writeHead(status, { 'content-type': 'application/json' });
@@ -736,6 +767,7 @@ async function createEditorServer({
           `<script>${HISTORY_SRC}</script>\n` +
           `<script>${INDENT_CLAMP_SRC}</script>\n` +
           `<script>${CONVERT_MD_SRC}</script>\n` +
+          `<script>${BLOCK_CATALOG_SRC}</script>\n` +
           `<script>${PATCHMAP_SRC}</script>\n` +
           `<script>${SELECTION_SRC}</script>\n` +
           `<script>${CELL_RANGE_SRC}</script>\n` +
@@ -776,6 +808,13 @@ async function createEditorServer({
         return res.end(out);
       }
 
+      if (req.method === 'GET' && url.pathname.indexOf('/api/lib/') === 0) {
+        const lib = diagramLibBody(url.pathname.slice('/api/lib/'.length));
+        if (!lib) return send(res, 404, { error: 'unknown library' });
+        res.writeHead(200, { 'content-type': lib.type, 'cache-control': 'no-store' });
+        return res.end(lib.body);
+      }
+
       if (req.method === 'POST' && url.pathname === '/api/render') {
         const { fileId, content } = await readJson(req);
         const file = absFiles[fileId];

package/lib/editor/toolbar-model.js

@@ -37,7 +37,7 @@ const BUTTON_DEFS = [
   { id: 'italic', group: 'inline', label: 'I', icon: 'italic', title: '斜體', toggle: true },
   { id: 'strike', group: 'inline', label: 'S', icon: 'strikethrough', title: '刪除線', toggle: true },
   { id: 'inline-code', group: 'inline', label: '`', icon: 'code', title: '行內程式碼', toggle: true },
-  { id: 'link', group: 'inline', label: '🔗', icon: 'link', title: '連結', toggle: true },
+  { id: 'link', group: 'inline', label: '🔗', icon: 'link', title: '連結 (Ctrl+K)', toggle: true },
 
   // indent
   { id: 'outdent', group: 'indent', label: '⇤', icon: 'indent-decrease', title: '減少縮排', toggle: false },
@@ -152,11 +152,13 @@ function deriveState(ctx) {
   // 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.
+  // v3.15.0 T2 (D11): quote, numbered list and check are on again — on an
+  // empty transient they insert their empty block there (the "/" menu's
+  // skeletons), so only indent / outdent have nothing to act on.
   if (c.transient === 'empty') {
-    for (const id of ['quote', 'ordered-list', 'check', 'indent', 'outdent']) {
+    for (const id of ['indent', 'outdent']) {
       state[id].disabled = true;
     }
   }

package/lib/md2doc.js

@@ -190,6 +190,9 @@ let marked, Renderer;
 let blockMathText = null;
 try {
   ({ marked, Renderer } = require('marked'));
+  // v3.15.0 B2 fix round 1 (R56): the empty to-do token rule, shared with the
+  // editor's block map — see lib/task-items.js.
+  require('./task-items.js');
 
   // Code-aware subscript / superscript as marked inline extensions.
   // The old raw-text pre-pass (mdPre.replace(/~([^~]+)~/...)) ran BEFORE marked
@@ -464,6 +467,7 @@ const READER_ICONS = {
   x: ICON_SVG_OPEN + '<path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>',
   copy: ICON_SVG_OPEN + '<rect width="14" height="14" x="8" y="8" rx="2" ry="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg>',
   check: ICON_SVG_OPEN + '<path d="M20 6 9 17l-5-5"/></svg>',
+  camera: ICON_SVG_OPEN + '<path d="M14.5 4h-5L7 7H4a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-3l-2.5-3z"/><circle cx="12" cy="13" r="3"/></svg>',
 };
 
 async function renderMarkdown(mdText, srcPath, opts = {}) {
@@ -1489,7 +1493,8 @@ ${itemsHtml}
       <div class="toc-header-actions">
         <button id="toc-expand-all" type="button" aria-label="Expand all" title="Expand all">${READER_ICONS.unfold}</button>
         <button id="toc-collapse-all" type="button" aria-label="Collapse all" title="Collapse all">${READER_ICONS.fold}</button>
-        <button id="toc-collapse-toggle" type="button" aria-label="Collapse table of contents" title="Collapse / expand sidebar">${READER_ICONS.panel}</button>
+${opts.editMode ? '' : `        <button id="capture-mode-toggle" type="button" aria-label="Screenshot mode" title="Screenshot mode (Esc to exit)">${READER_ICONS.camera}</button>
+`}        <button id="toc-collapse-toggle" type="button" aria-label="Collapse table of contents" title="Collapse / expand sidebar">${READER_ICONS.panel}</button>
       </div>
       <div class="toc-breadcrumb" data-toc-breadcrumb aria-label="Current location"></div>
     </div>
@@ -2408,7 +2413,8 @@ const html = `<!DOCTYPE html>
      TOC-list buttons (no list to act on) and shrink padding so the toggle
      fits inside the rail instead of being clipped by overflow:hidden. */
   body[data-toc-collapsed] #toc-expand-all,
-  body[data-toc-collapsed] #toc-collapse-all {
+  body[data-toc-collapsed] #toc-collapse-all,
+  body[data-toc-collapsed] #capture-mode-toggle {
     display: none;
   }
   body[data-toc-collapsed] .toc {
@@ -2878,6 +2884,42 @@ const html = `<!DOCTYPE html>
     min-width: 0;
     flex: 1 1 auto;
   }
+  /* Screenshot mode (v3.16.0). A scroll-and-stitch full-page capture
+     (FireShot and the like) glues one slice per screen, so whatever stays put
+     while the page scrolls lands on every slice: hide all of it, and keep the
+     column at the width it was read at (--md2doc-capture-w, measured on
+     entry), centred, so its lines break as they did. */
+  body[data-capture-mode] .reader-sidebar,
+  body[data-capture-mode] .sidebar-splitter,
+  body[data-capture-mode] .sidebar-scrim,
+  body[data-capture-mode] .mobile-bar,
+  body[data-capture-mode] .md2doc-theme-toggle {
+    display: none;
+  }
+  body[data-capture-mode] .page-layout {
+    display: block;
+  }
+  body[data-capture-mode] main.content {
+    box-sizing: border-box;
+    width: var(--md2doc-capture-w, auto);
+    max-width: 100%;
+    margin: 0 auto;
+  }
+  .capture-toast {
+    position: fixed;
+    top: 16px;
+    left: 50%;
+    transform: translateX(-50%);
+    z-index: 300;
+    padding: 8px 16px;
+    border-radius: 999px;
+    background: #24292e;
+    color: #ffffff;
+    font-size: 14px;
+    line-height: 1.4;
+    box-shadow: 0 4px 14px rgba(0,0,0,0.18);
+    pointer-events: none;
+  }
   .content p,
   .content li,
   .content blockquote,
@@ -3582,6 +3624,41 @@ ${usesDrawio ? `  /* v3.4.0 §4: a document with no drawio reference must not pa
   .ed-handle-submenu { left: 100%; margin-left: 4px; max-height: calc(100vh - 8px); overflow-y: auto; }
   .ed-handle-menu-btn:hover { background: var(--md-ed-hover); }
   .ed-handle-menu-btn[hidden] { display: none; }
+  /* v3.15.0 T1: the "/" block menu (decision D9, layout M1). Fixed, placed
+     4px under the caret by the client runtime (above it when there is no
+     room below) and closed on scroll. 280px wide, its list scrolls on its
+     own under a 360px cap; group titles, 32px rows of a 16px icon, the label
+     and a muted monospace hint on the right; a key-help footer. The row the
+     keyboard cursor is on carries data-ed-slash-cursor. Same surface, ring
+     and shadow roles as the other editor menus, so it follows the theme.
+     (No backticks in this comment: it lives inside a JS template literal.) */
+  .ed-slash-menu {
+    position: fixed; z-index: 100; width: 280px; max-height: 360px;
+    display: flex; flex-direction: column; box-sizing: border-box; overflow: hidden;
+    border-radius: 8px; background: var(--md-ed-surface); color: var(--md-strong);
+    box-shadow: 0 0 0 1px var(--md-ed-ring), 0 8px 24px var(--md-ed-shadow);
+    font-size: 13px; line-height: 1.3;
+  }
+  .ed-slash-list { flex: 1 1 auto; min-height: 0; overflow-y: auto; padding: 4px; }
+  .ed-slash-group { padding: 8px 8px 4px; font-size: 11px; font-weight: 600; color: var(--md-muted); }
+  .ed-slash-item {
+    display: flex; align-items: center; gap: 8px; width: 100%; height: 32px;
+    padding: 0 8px; box-sizing: border-box; margin: 0;
+    border: 0; border-radius: 6px; background: transparent; color: inherit;
+    font: inherit; text-align: left; cursor: pointer;
+  }
+  .ed-slash-item:hover, .ed-slash-item[data-ed-slash-cursor] { background: var(--md-ed-hover); }
+  .ed-slash-item svg { flex: 0 0 auto; width: 16px; height: 16px; margin: 0; }
+  .ed-slash-label { flex: 1 1 auto; min-width: 0; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+  .ed-slash-hint {
+    flex: 0 0 auto; color: var(--md-muted); font-size: 12px;
+    font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  }
+  .ed-slash-empty { padding: 8px; color: var(--md-muted); }
+  .ed-slash-foot {
+    flex: 0 0 auto; padding: 6px 10px; font-size: 11px; color: var(--md-muted);
+    border-top: 1px solid var(--md-ed-ring);
+  }
   /* §10-gap fix: block-level INSERT — the ＋ button sits NEXT TO the ⠿
      handle in the left gutter, same node/visibility-toggle shape as
      .ed-handle above (real per-block node, opacity-only reveal on hover).
@@ -3613,23 +3690,8 @@ ${usesDrawio ? `  /* v3.4.0 §4: a document with no drawio reference must not pa
   .ed-block:hover .ed-insert,
   .ed-insert:focus { opacity: 1; }
   .ed-insert:hover { background: var(--md-ed-hover); color: var(--md-strong); }
-  /* The ＋ button's small menu: 段落/標題/清單/表格/程式碼 — same dark
-     translucent pill language as .ed-handle-menu above. */
-  .ed-insert-menu {
-    position: absolute; top: -4px; left: -4px; z-index: 6;
-    display: flex; align-items: center; gap: 4px;
-    padding: 4px 6px; border-radius: 8px;
-    background: var(--md-ed-surface); color: var(--md-strong);
-    box-shadow: 0 0 0 1px var(--md-ed-ring), 0 8px 24px var(--md-ed-shadow);
-  }
-  .ed-insert-menu-btn {
-    min-width: 28px; height: 26px; padding: 0 8px;
-    border: 1px solid transparent; border-radius: 6px;
-    background: transparent; color: inherit;
-    font: inherit; font-size: 12px; line-height: 1;
-    white-space: nowrap; cursor: pointer;
-  }
-  .ed-insert-menu-btn:hover { background: var(--md-ed-hover); }
+  /* v3.15.0 T2: the ＋ button opens the "/" block menu (.ed-slash-menu
+     above) on a new empty paragraph; its own small pill menu is gone. */
   /* Task 5: hover-edge column/row insert bubbles — a SINGLETON pair of "＋"
      buttons (client runtime repositions them via getBoundingClientRect(),
      never creates more than these two). Visual language deliberately
@@ -3648,6 +3710,32 @@ ${usesDrawio ? `  /* v3.4.0 §4: a document with no drawio reference must not pa
   }
   .ed-tb-insert:hover { background: var(--md-accent); color: var(--md-ed-surface); }
   .ed-tb-insert[hidden] { display: none; }
+  /* v3.15.0 T8 (D20): the trailing add bars, a SINGLETON pair placed by the
+     client runtime along the grid of the hovered table: .ed-tb-addrow under
+     the last row (the grid's width; 22px tall, which the client lowers to
+     the gap above the block under the table, R97), .ed-tb-addcol right of the
+     last column (22px wide, the grid's height), each a centred plus on the
+     hover tint. z-index 6 sits under the grips (7) and the bubbles (8), so a
+     press where they overlap goes to those. Two rules, one per bar, because
+     each is its own fixed overlay. */
+  .ed-tb-addrow {
+    position: fixed; z-index: 6;
+    height: 22px; padding: 0; margin: 0; box-sizing: border-box;
+    display: flex; align-items: center; justify-content: center;
+    border: 0; border-radius: 4px;
+    background: var(--md-ed-hover); color: var(--md-muted);
+    font: inherit; font-size: 14px; line-height: 1; cursor: pointer;
+  }
+  .ed-tb-addcol {
+    position: fixed; z-index: 6;
+    width: 22px; padding: 0; margin: 0; box-sizing: border-box;
+    display: flex; align-items: center; justify-content: center;
+    border: 0; border-radius: 4px;
+    background: var(--md-ed-hover); color: var(--md-muted);
+    font: inherit; font-size: 14px; line-height: 1; cursor: pointer;
+  }
+  .ed-tb-addrow:hover, .ed-tb-addcol:hover { color: var(--md-accent); }
+  .ed-tb-addrow[hidden], .ed-tb-addcol[hidden] { display: none; }
   /* Task 6: table edge-click menus (delete/align) + row drag-reorder.
      '.ed-te-hl' marks the currently-selected column's or row's CELLS
      (th+td) — never the <tr>, which paints nothing the user can see once a
@@ -3667,23 +3755,39 @@ ${usesDrawio ? `  /* v3.4.0 §4: a document with no drawio reference must not pa
   .ed-cell-range { background: var(--md-ed-range) !important; }
   .ed-cell-range-active { caret-color: transparent; }
   .ed-cell-range-active ::selection { background: transparent; }
+  /* v3.15.0 T7 (D18/D19): the edge menu is a vertical list in the look of
+     the block menu above (.ed-handle-menu): 30px rows of a 16px icon and a
+     label, an alignment row of three icon buttons (aria-pressed marks the
+     current one), a separator, and the delete row in the error colour. The
+     row the keyboard cursor is on carries data-ed-te-cursor. Placed by the
+     client runtime under the column grip or beside the row grip, clamped to
+     the table and the viewport. */
   .ed-te-menu {
     position: fixed; z-index: 12;
-    display: flex; align-items: center; gap: 4px;
-    padding: 4px 6px; border-radius: 8px;
+    display: flex; flex-direction: column; align-items: stretch; gap: 2px;
+    padding: 4px; border-radius: 8px;
     background: var(--md-ed-surface); color: var(--md-strong);
     box-shadow: 0 0 0 1px var(--md-ed-ring), 0 8px 24px var(--md-ed-shadow);
   }
   .ed-te-menu[hidden] { display: none; }
   .ed-te-menu-btn {
-    min-width: 28px; height: 26px; padding: 0 8px;
+    min-width: 132px; height: 30px; padding: 0 10px 0 8px;
+    display: flex; align-items: center; gap: 8px;
     border: 1px solid transparent; border-radius: 6px;
     background: transparent; color: inherit;
-    font: inherit; font-size: 12px; line-height: 1;
-    white-space: nowrap; cursor: pointer;
+    font: inherit; font-size: 13px; line-height: 1;
+    text-align: left; white-space: nowrap; cursor: pointer;
   }
+  .ed-te-menu-btn .ed-menu-icon { flex: 0 0 auto; width: 16px; height: 16px; margin: 0; }
   .ed-te-menu-btn:hover { background: var(--md-ed-hover); }
   .ed-te-menu-btn[hidden] { display: none; }
+  .ed-te-menu-btn[data-ed-te-cursor] { background: var(--md-ed-hover); box-shadow: inset 0 0 0 1px var(--md-ed-ring); }
+  .ed-te-menu-align { display: flex; gap: 2px; }
+  .ed-te-menu-align[hidden] { display: none; }
+  .ed-te-menu-align .ed-te-menu-btn { flex: 1 1 0; min-width: 0; padding: 0; justify-content: center; }
+  .ed-te-menu-align .ed-te-menu-btn[aria-pressed="true"] { color: var(--md-accent); background: var(--md-ed-hover); }
+  .ed-te-menu-sep { height: 1px; margin: 2px 4px; background: var(--md-border); }
+  .ed-te-menu-delete { color: var(--md-ed-err); }
   .ed-te-drop-indicator {
     position: fixed; z-index: 8; height: 3px; border-radius: 2px;
     background: var(--md-accent); pointer-events: none;
@@ -3817,6 +3921,48 @@ ${usesDrawio ? `  /* v3.4.0 §4: a document with no drawio reference must not pa
   .ed-seltb-btn:hover:not([aria-disabled="true"]) { color: var(--md-strong); }
   .ed-seltb-sep { width: 1px; height: 18px; margin: 0 3px; background: var(--md-rule); align-self: center; }
   .ed-ico { display: block; flex: none; }
+  /* v3.15.0 T5: the URL field. A separate fixed element laid over the
+     selection toolbar (which is hidden while it is up), never a child of it.
+     Same surface, ring and shadow roles as the toolbar so it follows the
+     theme; the input uses the field role. z-index 16 keeps it over the
+     toolbar (15) and under the banner (999). */
+  .ed-linkbar {
+    position: fixed; z-index: 16;
+    display: flex; align-items: center; gap: 6px; box-sizing: border-box;
+    width: 300px; max-width: calc(100vw - 8px); padding: 4px 4px 4px 8px; border-radius: 8px;
+    background: var(--md-ed-surface); color: var(--md-strong);
+    box-shadow: 0 0 0 1px var(--md-ed-ring), 0 8px 24px var(--md-ed-shadow);
+  }
+  .ed-linkbar-icon { flex: none; display: inline-grid; place-items: center; color: var(--md-muted); }
+  .ed-linkbar-input {
+    flex: 1 1 auto; min-width: 0; height: 28px; box-sizing: border-box; padding: 0 8px;
+    border: 1px solid var(--md-ed-ring); border-radius: 6px;
+    background: var(--md-ed-field); color: inherit; font: inherit; font-size: 13px;
+  }
+  .ed-linkbar-input:focus { outline: none; border-color: var(--md-muted); }
+  .ed-linkbar-apply {
+    flex: none; height: 28px; padding: 0 10px; border: 0; border-radius: 6px;
+    background: transparent; color: inherit; font: inherit; font-size: 13px; cursor: pointer;
+  }
+  .ed-linkbar-apply:hover { background: var(--md-ed-hover); }
+  /* v3.15.0 T6: the link card, 6px under a link that holds the caret. Same
+     surface, ring and shadow roles; the href is cut by an ellipsis. */
+  .ed-linkcard {
+    position: fixed; z-index: 15;
+    display: flex; align-items: center; gap: 2px; box-sizing: border-box;
+    max-width: calc(100vw - 8px); padding: 4px 4px 4px 10px; border-radius: 8px;
+    background: var(--md-ed-surface); color: var(--md-strong); font-size: 13px;
+    box-shadow: 0 0 0 1px var(--md-ed-ring), 0 8px 24px var(--md-ed-shadow);
+  }
+  .ed-linkcard-href {
+    flex: 0 1 auto; min-width: 0; max-width: 320px; margin-right: 6px;
+    overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--md-muted);
+  }
+  .ed-linkcard-btn {
+    flex: none; height: 26px; padding: 0 8px; border: 0; border-radius: 6px;
+    background: transparent; color: inherit; font: inherit; font-size: 13px; cursor: pointer;
+  }
+  .ed-linkcard-btn:hover { background: var(--md-ed-hover); }
   /* v3.1.0 §4: the always-visible editing toolbar. Its numeric language is
      .lightbox-bar's (8px/12px padding, 6px gap, 13px type) over .ed-seltb's
      dark pill, so the two floating surfaces read as one family.
@@ -4011,7 +4157,7 @@ ${usesDrawio ? `  /* v3.4.0 §4: a document with no drawio reference must not pa
   .ed-toolbar-status[data-state="failed"] { color: var(--md-ed-err); }
   .ed-status-dot { width: 8px; height: 8px; border-radius: 50%; background: var(--md-ed-dirty); display: inline-block; }
   .ed-toolbar-btn[data-ed-tb="save"][aria-pressed="true"] { color: var(--md-accent); background: var(--md-active-bg); }
-  /* The H▾ dropdown: same singleton-panel idiom as .ed-insert-menu, but
+  /* The H▾ dropdown: same singleton-panel idiom as the ⠿ menu, but
      anchored to a fixed bar rather than moved into a block, so it is
      positioned in viewport coordinates by the client runtime.
      max-height/overflow-y: same backstop role as .ed-handle-submenu above
@@ -4602,17 +4748,31 @@ ${mermaidInitTag}`)
   // 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.
+  // v3.15.0 R76: except for a heading nested in another block (a blockquote's
+  // heading in the reader): the section index lists the text after that
+  // block under the heading, so the unit is the top-level block that holds
+  // it, and the walk (whose container is that block's parent) reaches the
+  // text after the quote. Headings are still found only as top-level
+  // siblings in the reader, so a quoted heading still ends no section.
+  function topLevelBlockOf(node) {
+    const root = node.closest('.content');
+    if (!root) return node;
+    let n = node;
+    while (n.parentElement && n.parentElement !== root) n = n.parentElement;
+    return n.parentElement === root ? n : node;
+  }
   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;
+    const wrapper = start.closest('.ed-block');
+    const unit = wrapper || topLevelBlockOf(start);
     let end = null;
     let node = unit.nextElementSibling;
     while (node) {
       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]');
+      else if (wrapper && node.querySelector) heading = node.querySelector(':scope > [data-reader-heading]');
       if (heading) {
         const depth = Number(heading.getAttribute('data-reader-depth') || '1');
         if (depth <= startDepth) {
@@ -4936,6 +5096,45 @@ ${mermaidInitTag}`)
       setSidebarOpen(false);
     }
   });
+
+  // ── Screenshot mode (v3.16.0): only the document, for a full-page capture ──
+  // The CSS beside '.capture-toast' hides everything that stays put while the
+  // page scrolls. The column keeps the width measured here, so nothing reflows
+  // and the reading position holds. Esc leaves; a reload never comes back in it.
+  const captureBtn = document.getElementById('capture-mode-toggle');
+  let captureToastTimer = 0;
+  function setCaptureMode(on) {
+    clearTimeout(captureToastTimer);
+    const oldToast = document.querySelector('.capture-toast');
+    if (oldToast) oldToast.remove();
+    if (!on) {
+      document.body.removeAttribute('data-capture-mode');
+      document.body.style.removeProperty('--md2doc-capture-w');
+      return;
+    }
+    setSidebarOpen(false);
+    const w = document.querySelector('main.content').getBoundingClientRect().width;
+    document.body.style.setProperty('--md2doc-capture-w', w + 'px');
+    document.body.setAttribute('data-capture-mode', '');
+    const toast = document.createElement('div');
+    toast.className = 'capture-toast';
+    toast.setAttribute('role', 'status');
+    toast.textContent = 'Screenshot mode — press Esc or reload to exit';
+    document.body.appendChild(toast);
+    // Gone before the capture tool scrolls, or it would be on every slice too.
+    captureToastTimer = setTimeout(() => toast.remove(), 2000);
+  }
+  if (captureBtn) {
+    captureBtn.addEventListener('click', () => setCaptureMode(true));
+  }
+  // Registered ahead of the lightbox's own Esc handler, which closes the
+  // diagram: while one is open, its Esc is the lightbox's and the mode stays.
+  document.addEventListener('keydown', (event) => {
+    if (lightboxIsOpen()) return;
+    if (event.key === 'Escape' && document.body.hasAttribute('data-capture-mode')) {
+      setCaptureMode(false);
+    }
+  });
   document.addEventListener('click', (event) => {
     if (!document.body.hasAttribute('data-sidebar-open')) return;
     if (!event.target || !event.target.closest) return;
@@ -6381,7 +6580,11 @@ ${usesDrawioMultiPage ? `  // v3.4.0 batch2 Task 6: wired through a NAMED, reusa
     drawioRefs: Array.from(drawioRefs, ([p, stamp]) => ({ path: p, stamp })),
   };
 }
-module.exports = { renderMarkdown };
+// v3.15.0 B2 fix round 1 (R61): the resolved engine paths, so the editor
+// server's on-demand GET /api/lib/<name> serves exactly what this file inlines
+// instead of resolving them a second time.
+const diagramEnginePaths = { mermaid: localMermaidJs, wavedrom: localWaveDromJs, wavedromSkin: localWaveDromSkin };
+module.exports = { renderMarkdown, buildKatexStyleTag, diagramEnginePaths };
 
 // Index of the first "{" in dot source that opens the graph body: not inside a
 // double-quoted string, a // or /* */ comment, a line starting with # (dot

package/lib/task-items.js

@@ -0,0 +1,48 @@
+'use strict';
+// v3.15.0 B2 fix round 1 (R56): an EMPTY to-do item at the token level.
+//
+// marked reads `[ ]` / `[x]` as a checkbox only when a space follows it, and
+// it trims an item's trailing whitespace first when the item is the last one
+// of a NESTED list: `- a\n  - [ ] \n` (end of file, or a paragraph next) lexes
+// the child as a plain item whose text is "[ ]" (measured, marked 14.1.4).
+// The editor writes exactly that shape for a new empty to-do (Enter at the end
+// of a nested last to-do), and no byte form of an empty nested task survives
+// marked without visible content. So the READING side decides: a list item
+// whose whole text is `[ ]`, `[x]` or `[X]` and that marked did not already
+// read as a task is an empty to-do, checked accordingly.
+//
+// One place for both readers: this module installs the rule on marked's own
+// `list` tokenizer, so every marked.lexer() / marked.parse() in the process —
+// the reader renderer (lib/md2doc.js) and the editor's block map
+// (lib/editor/blockmap.js), which both require this file — sees the same
+// token. An escaped box (`- \[ \]`, what the editor writes for that text in a
+// plain item) is text and stays text. Other renderers (GitHub) still show a
+// literal "[ ]" for such an item; that is what the file says.
+const { marked } = require('marked');
+
+const EMPTY_BOX = /^\[([ xX])\]$/;
+
+function normalizeListToken(listToken) {
+  if (!listToken || !Array.isArray(listToken.items)) return listToken;
+  listToken.items.forEach((item) => {
+    if (!item || item.task) return;
+    const m = EMPTY_BOX.exec(String(item.text || '').trim());
+    if (!m) return;
+    item.task = true;
+    item.checked = m[1] !== ' ';
+    item.text = '';
+    item.tokens = [];
+  });
+  return listToken;
+}
+
+marked.use({
+  tokenizer: {
+    list(src) {
+      const token = marked.Tokenizer.prototype.list.call(this, src);
+      return token ? normalizeListToken(token) : token;
+    },
+  },
+});
+
+module.exports = { normalizeListToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helping-ai-workflow/md2doc",
-  "version": "3.14.1",
+  "version": "3.16.0",
   "description": "Markdown → HTML / PDF renderer with WaveDrom, Mermaid, Graphviz, and draw.io support",
   "keywords": [
     "markdown",
@@ -46,7 +46,7 @@
   },
   "scripts": {
     "preinstall": "node scripts/preinstall.js",
-    "test": "node test/md2doc.test.js && node test/highlight.test.js && node test/blockmap.test.js && node test/drawio.test.js && node test/images.test.js && node test/scroll-anchor.test.js && node test/lightbox.test.js && node test/lightbox-anno.test.js && node test/lightbox-anno-style.test.js && node test/reader-panels.test.js && node test/cli.test.js && node test/code-operator.test.js && node test/convert-md.test.js && node test/render-api.test.js && node test/lineops.test.js && node test/indent-clamp.test.js && node test/selection.test.js && node test/cell-range.test.js && node test/editmode-render.test.js && node test/editmode-wavedrom-reinit.test.js && node test/editor-server.test.js && node test/cli-edit.test.js && node test/open-viewer.test.js && node test/editor-client.test.js && node test/editor-client-runtime.test.js && node test/roundtrip.test.js && node test/byte-stability.test.js && node test/editor-server-throw.test.js && node test/editor-reader-rebind.test.js && node test/inline-md.test.js && node test/table-md.test.js && node test/table-anchor-recovery.test.js && node test/gate-compat.test.js && node test/history.test.js && node test/list-md.test.js && node test/table-width.test.js && node test/toolbar-model.test.js && node test/asset.test.js && node test/paste-md.test.js && node test/patchmap.test.js && node test/wave-codec.test.js && node test/wave-draw.test.js && node test/wave-geometry.test.js && node test/wave-store.test.js && node test/editor-journey.test.js && node test/detach-census.test.js && node test/editor-arrow-nav.test.js && node test/editor-cell-range.test.js && node test/reader-design.test.js && node test/theme.test.js && node test/release-check.test.js && node test/wave-overflow.test.js",
+    "test": "node test/md2doc.test.js && node test/highlight.test.js && node test/blockmap.test.js && node test/drawio.test.js && node test/images.test.js && node test/scroll-anchor.test.js && node test/lightbox.test.js && node test/lightbox-anno.test.js && node test/lightbox-anno-style.test.js && node test/reader-panels.test.js && node test/cli.test.js && node test/code-operator.test.js && node test/convert-md.test.js && node test/block-catalog.test.js && node test/render-api.test.js && node test/lineops.test.js && node test/indent-clamp.test.js && node test/selection.test.js && node test/cell-range.test.js && node test/editmode-render.test.js && node test/editmode-wavedrom-reinit.test.js && node test/editor-server.test.js && node test/cli-edit.test.js && node test/open-viewer.test.js && node test/editor-client.test.js && node test/editor-client-runtime.test.js && node test/roundtrip.test.js && node test/byte-stability.test.js && node test/editor-server-throw.test.js && node test/editor-reader-rebind.test.js && node test/inline-md.test.js && node test/table-md.test.js && node test/table-anchor-recovery.test.js && node test/gate-compat.test.js && node test/history.test.js && node test/list-md.test.js && node test/table-width.test.js && node test/toolbar-model.test.js && node test/asset.test.js && node test/paste-md.test.js && node test/patchmap.test.js && node test/wave-codec.test.js && node test/wave-draw.test.js && node test/wave-geometry.test.js && node test/wave-store.test.js && node test/editor-journey.test.js && node test/detach-census.test.js && node test/editor-arrow-nav.test.js && node test/editor-cell-range.test.js && node test/reader-design.test.js && node test/theme.test.js && node test/release-check.test.js && node test/wave-overflow.test.js",
     "test:browser": "node test/reader-click.test.js && node test/editor-click.test.js && node test/wave-canvas.test.js"
   },
   "repository": {