@helping-ai-workflow/md2doc 3.9.1 → 3.10.0

package/lib/editor/icons.js

@@ -0,0 +1,48 @@
+'use strict';
+/* Lucide icons v0.469.0 (ISC License, https://lucide.dev/license), only the ones
+   the editor draws. UMD like toolbar-model.js: require()-able in node for the
+   tests, injected into the edit page as window.md2docIcons (lib/editor/server.js). */
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) module.exports = factory();
+  else root.md2docIcons = factory();
+})(typeof self !== 'undefined' ? self : this, function () {
+const BODY = {
+  "arrow-down-to-line": "<path d=\"M12 17V3\" /><path d=\"m6 11 6 6 6-6\" /><path d=\"M19 21H5\" />",
+  "arrow-up-to-line": "<path d=\"M5 3h14\" /><path d=\"m18 13-6-6-6 6\" /><path d=\"M12 7v14\" />",
+  "bold": "<path d=\"M6 12h9a4 4 0 0 1 0 8H7a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1h7a4 4 0 0 1 0 8\" />",
+  "check": "<path d=\"M20 6 9 17l-5-5\" />",
+  "circle-alert": "<circle cx=\"12\" cy=\"12\" r=\"10\" /><line x1=\"12\" x2=\"12\" y1=\"8\" y2=\"12\" /><line x1=\"12\" x2=\"12.01\" y1=\"16\" y2=\"16\" />",
+  "code": "<polyline points=\"16 18 22 12 16 6\" /><polyline points=\"8 6 2 12 8 18\" />",
+  "grip-vertical": "<circle cx=\"9\" cy=\"12\" r=\"1\" /><circle cx=\"9\" cy=\"5\" r=\"1\" /><circle cx=\"9\" cy=\"19\" r=\"1\" /><circle cx=\"15\" cy=\"12\" r=\"1\" /><circle cx=\"15\" cy=\"5\" r=\"1\" /><circle cx=\"15\" cy=\"19\" r=\"1\" />",
+  "heading": "<path d=\"M6 12h12\" /><path d=\"M6 20V4\" /><path d=\"M18 20V4\" />",
+  "image": "<rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\" ry=\"2\" /><circle cx=\"9\" cy=\"9\" r=\"2\" /><path d=\"m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21\" />",
+  "indent-decrease": "<path d=\"M21 12H11\" /><path d=\"M21 18H11\" /><path d=\"M21 6H11\" /><path d=\"m7 8-4 4 4 4\" />",
+  "indent-increase": "<path d=\"M21 12H11\" /><path d=\"M21 18H11\" /><path d=\"M21 6H11\" /><path d=\"m3 8 4 4-4 4\" />",
+  "info": "<circle cx=\"12\" cy=\"12\" r=\"10\" /><path d=\"M12 16v-4\" /><path d=\"M12 8h.01\" />",
+  "italic": "<line x1=\"19\" x2=\"10\" y1=\"4\" y2=\"4\" /><line x1=\"14\" x2=\"5\" y1=\"20\" y2=\"20\" /><line x1=\"15\" x2=\"9\" y1=\"4\" y2=\"20\" />",
+  "link": "<path d=\"M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71\" /><path d=\"M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71\" />",
+  "list": "<path d=\"M3 12h.01\" /><path d=\"M3 18h.01\" /><path d=\"M3 6h.01\" /><path d=\"M8 12h13\" /><path d=\"M8 18h13\" /><path d=\"M8 6h13\" />",
+  "list-checks": "<path d=\"m3 17 2 2 4-4\" /><path d=\"m3 7 2 2 4-4\" /><path d=\"M13 6h8\" /><path d=\"M13 12h8\" /><path d=\"M13 18h8\" />",
+  "list-ordered": "<path d=\"M10 12h11\" /><path d=\"M10 18h11\" /><path d=\"M10 6h11\" /><path d=\"M4 10h2\" /><path d=\"M4 6h1v4\" /><path d=\"M6 18H4c0-1 2-2 2-3s-1-1.5-2-1\" />",
+  "minus": "<path d=\"M5 12h14\" />",
+  "panel-left": "<rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\" /><path d=\"M9 3v18\" />",
+  "plus": "<path d=\"M5 12h14\" /><path d=\"M12 5v14\" />",
+  "quote": "<path d=\"M16 3a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2 1 1 0 0 1 1 1v1a2 2 0 0 1-2 2 1 1 0 0 0-1 1v2a1 1 0 0 0 1 1 6 6 0 0 0 6-6V5a2 2 0 0 0-2-2z\" /><path d=\"M5 3a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2 1 1 0 0 1 1 1v1a2 2 0 0 1-2 2 1 1 0 0 0-1 1v2a1 1 0 0 0 1 1 6 6 0 0 0 6-6V5a2 2 0 0 0-2-2z\" />",
+  "redo-2": "<path d=\"m15 14 5-5-5-5\" /><path d=\"M20 9H9.5A5.5 5.5 0 0 0 4 14.5A5.5 5.5 0 0 0 9.5 20H13\" />",
+  "save": "<path d=\"M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z\" /><path d=\"M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7\" /><path d=\"M7 3v4a1 1 0 0 0 1 1h7\" />",
+  "square-code": "<path d=\"M10 9.5 8 12l2 2.5\" /><path d=\"m14 9.5 2 2.5-2 2.5\" /><rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\" />",
+  "strikethrough": "<path d=\"M16 4H9a3 3 0 0 0-2.83 4\" /><path d=\"M14 12a4 4 0 0 1 0 8H6\" /><line x1=\"4\" x2=\"20\" y1=\"12\" y2=\"12\" />",
+  "table": "<path d=\"M12 3v18\" /><rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\" /><path d=\"M3 9h18\" /><path d=\"M3 15h18\" />",
+  "underline": "<path d=\"M6 4v6a6 6 0 0 0 12 0V4\" /><line x1=\"4\" x2=\"20\" y1=\"20\" y2=\"20\" />",
+  "undo-2": "<path d=\"M9 14 4 9l5-5\" /><path d=\"M4 9h10.5a5.5 5.5 0 0 1 5.5 5.5a5.5 5.5 0 0 1-5.5 5.5H11\" />",
+  "x": "<path d=\"M18 6 6 18\" /><path d=\"m6 6 12 12\" />"
+};
+const NAMES = Object.freeze(Object.keys(BODY));
+function svg(name, size) {
+  const s = size || 16;
+  return '<svg class="ed-ico" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="' + s + '" height="' + s + '" ' +
+    'fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" ' +
+    'aria-hidden="true" focusable="false">' + BODY[name] + '</svg>';
+}
+return { NAMES, svg };
+});

package/lib/editor/server.js

@@ -43,12 +43,12 @@ const SELECTION_SRC = fs.readFileSync(path.join(__dirname, 'selection.js'), 'utf
 // client.js reads window.md2docCellRange.
 const CELL_RANGE_SRC = fs.readFileSync(path.join(__dirname, 'cell-range.js'), 'utf8');
 // v3.1.0 Task E: the four Phase-1 modules behind the visible toolbar, the
-// paste pipeline, the image-drop asset endpoint and the whole-document
-// source escape hatch. Same "pure module, no dependency on any other editor
+// paste pipeline and the image-drop asset endpoint (the whole-document
+// source escape hatch went with v3.10.0). Same "pure module, no dependency on any other editor
 // module" property as indent-clamp.js / convert-md.js / selection.js above —
 // each only has to land before client.js reads its window global.
 const TOOLBAR_MODEL_SRC = fs.readFileSync(path.join(__dirname, 'toolbar-model.js'), 'utf8');
-const DOCSOURCE_SRC = fs.readFileSync(path.join(__dirname, 'docsource.js'), 'utf8');
+const ICONS_SRC = fs.readFileSync(path.join(__dirname, 'icons.js'), 'utf8');
 const ASSET_SRC = fs.readFileSync(path.join(__dirname, 'asset.js'), 'utf8');
 // turndown's BROWSER build. node's `require('turndown')` resolves to
 // lib/turndown.cjs.js, which is not loadable as a plain <script> tag — the
@@ -736,8 +736,8 @@ async function createEditorServer({
           `<script>${PATCHMAP_SRC}</script>\n` +
           `<script>${SELECTION_SRC}</script>\n` +
           `<script>${CELL_RANGE_SRC}</script>\n` +
+          `<script>${ICONS_SRC}</script>\n` +
           `<script>${TOOLBAR_MODEL_SRC}</script>\n` +
-          `<script>${DOCSOURCE_SRC}</script>\n` +
           `<script>${ASSET_SRC}</script>\n` +
           `<script>${TURNDOWN_SRC}</script>\n` +
           `<script>${PASTE_MD_SRC}</script>\n` +
@@ -982,6 +982,16 @@ async function createEditorServer({
         } catch (e) {
           fileId = undefined; drawioClientId = undefined; drawioAck = undefined;
         }
+        // v3.10.0: the client compares this with its own baseline to notice an
+        // edit made outside the browser. A header, not a body: the bare 204
+        // ("nothing stale") is part of the drawio contract and stays bodiless.
+        const pingFile = (typeof fileId === 'number') ? absFiles[fileId] : undefined;
+        // Async on purpose: this route fires every 10s from every open tab, and
+        // the drawio fast path below is pinned to ZERO fs.statSync calls for a
+        // document with no drawio references (test/editor-server.test.js (a)).
+        if (pingFile) {
+          try { res.setHeader('X-Md2doc-Mtime', String((await fs.promises.stat(pingFile)).mtimeMs)); } catch (e) { /* file gone: no header */ }
+        }
         // Ack FIRST, then re-check: a client that has just confirmed it
         // applied version N must get a 204 on this same beat unless the file
         // has moved on past N since.

package/lib/editor/toolbar-model.js

@@ -11,53 +11,47 @@
   else root.md2docToolbarModel = factory();
 })(typeof self !== 'undefined' ? self : this, function () {
 
-// The 23-button roster, spec §4 table (`export▾` moved out of scope — no
-// browser-reachable export path) plus the v3.4.0 §3 `save` button. Seven
+// The 22-button roster, spec §4 table (`export▾` moved out of scope — no
+// browser-reachable export path) plus the v3.4.0 §3 `save` button.
+// v3.10.0 removed the edit/source mode button with source mode itself. Seven
 // groups, in render order; group order here doubles as separator placement
 // for the caller (a separator sits between consecutive groups).
 const BUTTON_DEFS = [
   // file
-  { id: 'save', group: 'file', label: '💾', icon: '💾', title: '儲存 (Ctrl+S)', toggle: false },
+  { id: 'save', group: 'file', label: '💾', icon: 'save', title: '儲存 (Ctrl+S)', toggle: false },
 
   // history
-  { id: 'undo', group: 'history', label: 'Undo', icon: '↶', title: '復原 (Ctrl+Z)', toggle: false },
-  { id: 'redo', group: 'history', label: 'Redo', icon: '↷', title: '重做 (Ctrl+Y)', toggle: false },
+  { id: 'undo', group: 'history', label: 'Undo', icon: 'undo-2', title: '復原 (Ctrl+Z)', toggle: false },
+  { id: 'redo', group: 'history', label: 'Redo', icon: 'redo-2', title: '重做 (Ctrl+Y)', toggle: false },
 
   // block
-  { id: 'headings', group: 'block', label: 'H', icon: 'H', title: '標題', toggle: true },
-  { id: 'quote', group: 'block', label: '❝', icon: '❝', title: '引用', toggle: true },
-  { id: 'code', group: 'block', label: '</>', icon: '</>', title: '程式碼區塊', toggle: true },
-  { id: 'list', group: 'block', label: '•', icon: '•', title: '項目符號列表', toggle: true },
-  { id: 'ordered-list', group: 'block', label: '1.', icon: '1.', title: '編號列表', toggle: true },
-  { id: 'check', group: 'block', label: '☑', icon: '☑', title: '待辦清單', toggle: false },
+  { id: 'headings', group: 'block', label: 'H', icon: 'heading', title: '標題', toggle: true },
+  { id: 'quote', group: 'block', label: '❝', icon: 'quote', title: '引用', toggle: true },
+  { id: 'code', group: 'block', label: '</>', icon: 'square-code', title: '程式碼區塊', toggle: true },
+  { id: 'list', group: 'block', label: '•', icon: 'list', title: '項目符號列表', toggle: true },
+  { id: 'ordered-list', group: 'block', label: '1.', icon: 'list-ordered', title: '編號列表', toggle: true },
+  { id: 'check', group: 'block', label: '☑', icon: 'list-checks', title: '待辦清單', toggle: false },
 
   // inline
-  { id: 'bold', group: 'inline', label: 'B', icon: 'B', title: '粗體', toggle: true },
-  { id: 'italic', group: 'inline', label: 'I', icon: 'I', title: '斜體', toggle: true },
-  { id: 'strike', group: 'inline', label: 'S', icon: 'S', title: '刪除線', toggle: true },
-  { id: 'inline-code', group: 'inline', label: '`', icon: '`', title: '行內程式碼', toggle: true },
-  { id: 'link', group: 'inline', label: '🔗', icon: '🔗', title: '連結', toggle: true },
+  { id: 'bold', group: 'inline', label: 'B', icon: 'bold', title: '粗體', toggle: true },
+  { 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 },
 
   // indent
-  { id: 'outdent', group: 'indent', label: '⇤', icon: '⇤', title: '減少縮排', toggle: false },
-  { id: 'indent', group: 'indent', label: '⇥', icon: '⇥', title: '增加縮排', toggle: false },
+  { id: 'outdent', group: 'indent', label: '⇤', icon: 'indent-decrease', title: '減少縮排', toggle: false },
+  { id: 'indent', group: 'indent', label: '⇥', icon: 'indent-increase', title: '增加縮排', toggle: false },
 
   // insert
-  { id: 'table', group: 'insert', label: '⊞', icon: '⊞', title: '插入表格', toggle: false },
-  { id: 'insert-before', group: 'insert', label: '⬆', icon: '⬆', title: '在上方插入區塊', toggle: false },
-  { id: 'insert-after', group: 'insert', label: '⬇', icon: '⬇', title: '在下方插入區塊', toggle: false },
-  { id: 'line', group: 'insert', label: '―', icon: '―', title: '插入分隔線', toggle: false },
-  { id: 'image', group: 'insert', label: '🖼', icon: '🖼', title: '插入圖片', toggle: false },
+  { id: 'table', group: 'insert', label: '⊞', icon: 'table', title: '插入表格', toggle: false },
+  { id: 'insert-before', group: 'insert', label: '⬆', icon: 'arrow-up-to-line', title: '在上方插入區塊', toggle: false },
+  { id: 'insert-after', group: 'insert', label: '⬇', icon: 'arrow-down-to-line', title: '在下方插入區塊', toggle: false },
+  { id: 'line', group: 'insert', label: '―', icon: 'minus', title: '插入分隔線', toggle: false },
+  { id: 'image', group: 'insert', label: '🖼', icon: 'image', title: '插入圖片', toggle: false },
 
   // view
-  { id: 'outline', group: 'view', label: '☰', icon: '☰', title: '大綱', toggle: false },
-  // v3.2.1: 這顆是 edit <-> source 的兩態切換（preview 模式已移除）。id 保留
-  // 為 'preview' 是刻意的 —— 每一支選擇器、journey 案例與 runtime 測試都指名
-  // 它，改名只換得一個更好聽的字串。label / title 不是烘死值：deriveState()
-  // 每次都依當前 mode 覆寫成【下一個】狀態的名字，這裡的值只是 edit 模式的
-  // 起始值。toggle: false —— 兩態下 aria-pressed 講不出真話（按鈕講的是去處，
-  // 不是目前所在），真話由會變的 label / title 承擔。
-  { id: 'preview', group: 'view', label: 'M↓', icon: 'M↓', title: '切換到原始碼模式', toggle: false },
+  { id: 'outline', group: 'view', label: '☰', icon: 'panel-left', title: '大綱', toggle: false },
 ];
 
 const BUTTONS = Object.freeze(BUTTON_DEFS.map((b) => Object.freeze(Object.assign({}, b))));
@@ -77,7 +71,7 @@ const GROUPS = Object.freeze(['file', 'history', 'block', 'inline', 'indent', 'i
 // `!dirty` line happens to sit; if that line is ever moved above the
 // no-block loop, this set becomes the only thing still enforcing it. Do not
 // delete it as "dead code" without re-checking that ordering.
-const NO_BLOCK_ALLOWED = new Set(['undo', 'redo', 'outline', 'preview', 'save']);
+const NO_BLOCK_ALLOWED = new Set(['undo', 'redo', 'outline', 'save']);
 
 // The mark element each inline button toggles. This module cannot ask the
 // DOM which marks a selection sits in, so the client measures that and hands
@@ -107,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,
-//       mode, marks}
+//       marks, dirty}
 // -> { [id]: {active: bool, mixed: bool, disabled: bool, label?: string} }
 function deriveState(ctx) {
   const c = ctx || {};
@@ -116,7 +110,6 @@ function deriveState(ctx) {
   const headingDepth = c.headingDepth;
   const inList = !!c.inList;
   const listOrdered = !!c.listOrdered;
-  const mode = c.mode;
   const dirty = !!c.dirty;
   const hasBlock = blockType !== null && blockType !== undefined;
 
@@ -125,19 +118,6 @@ function deriveState(ctx) {
     state[b.id] = { active: false, mixed: false, disabled: false };
   }
 
-  // v3.2.1: the mode button names the NEXT state, never the current one.
-  // Under the old tri-state cycle it was permanently labelled 「預覽」 and
-  // reported aria-pressed=true in BOTH non-edit modes, so pressing it twice
-  // landed in source with no grips and an interface that said nothing about
-  // where you were — the reported "stuck" defect. It carries no `active`
-  // now: with two states the honest signal is the label, and the current
-  // mode is spelled out in .ed-toolbar-status by the client.
-  // It stays enabled in source mode via the mode==='source' override below
-  // (do not gate this on inList/hasBlock — it is the escape hatch OUT of
-  // those states).
-  state.preview.label = mode === 'source' ? '✎' : 'M↓';
-  state.preview.title = mode === 'source' ? '切換到編輯模式' : '切換到原始碼模式';
-
   // headings: dropdown whose label tracks the current heading depth.
   state.headings.label = blockType === 'heading' ? 'H' + headingDepth : 'H';
   state.headings.active = blockType === 'heading';
@@ -231,41 +211,8 @@ function deriveState(ctx) {
   // single-sourced: client.js's `documentIsDirty()` — since v3.4.0 batch3
   // Task 7 that is `stack.isDirty() || burstHasUncommittedEdit() ||
   // waveUnwrittenEdit` — arrives as ctx.dirty and is not recomputed here.
-  // This runs before the source-mode override below so that override can
-  // still give save its own exemption.
   state.save.disabled = !dirty;
 
-  // mode 'source' is the full-document raw-source escape hatch: everything
-  // is disabled except the mode button that got you there (id 'preview',
-  // which in v3.2.1 is the edit <-> source toggle), since T11-2 'outline'
-  // (☰), and since v3.4.0 §3 'save'. The mode button is still the ONLY way
-  // back to 'edit' — that has not changed. 'outline' stays reachable because
-  // it is what opens the sidebar drawer (toggleOutlineSidebar() in
-  // lib/editor/client.js), and the fixed `.sidebar-toggle` button that used
-  // to reach the drawer another way is hidden in edit mode entirely (see the
-  // T11-2 comment in lib/md2doc.js) — a disabled ☰ here would leave source
-  // mode with no way to open that drawer at all. 'save' stays reachable
-  // because source mode can still hold unsaved changes (the user can type
-  // into the source textarea) — see the per-button comment below for the
-  // exact shape of the exemption. This override still runs last and still
-  // overrides every disabled flag computed above for every other button; do
-  // not narrow it for anything but these three ids.
-  if (mode === 'source') {
-    for (const b of BUTTONS) {
-      if (b.id === 'preview' || b.id === 'outline') { state[b.id].disabled = false; continue; }
-      // v3.4.0 §3: save is a third exemption, for the same shape of reason
-      // outline already had one — source mode can still hold unsaved
-      // changes (the user can type into the source textarea), so forcing
-      // the only save button grey here would make a mode that holds
-      // unsaved work with no way out of it. The exemption is from the MODE
-      // forcing it grey, not from being grey — a clean document still shows
-      // it disabled in source mode (see the `state.save.disabled = !dirty`
-      // line above, which already ran and is left untouched here).
-      if (b.id === 'save') continue;
-      state[b.id].disabled = true;
-    }
-  }
-
   return state;
 }
 

package/lib/highlight.js

@@ -0,0 +1,35 @@
+'use strict';
+// v3.10.0: syntax colour for fenced code, done once when the HTML is written —
+// the reading page needs no script for it, and PDF gets it for free. Only the
+// languages below are registered; anything else (or no language) stays plain
+// text rather than guessing.
+const hljs = require('highlight.js/lib/core');
+
+const LANGS = {
+  verilog: require('highlight.js/lib/languages/verilog'),
+  python: require('highlight.js/lib/languages/python'),
+  bash: require('highlight.js/lib/languages/bash'),
+  c: require('highlight.js/lib/languages/c'),
+  cpp: require('highlight.js/lib/languages/cpp'),
+  json: require('highlight.js/lib/languages/json'),
+  yaml: require('highlight.js/lib/languages/yaml'),
+  tcl: require('highlight.js/lib/languages/tcl'),
+  makefile: require('highlight.js/lib/languages/makefile'),
+  javascript: require('highlight.js/lib/languages/javascript'),
+  diff: require('highlight.js/lib/languages/diff'),
+  plaintext: require('highlight.js/lib/languages/plaintext'),
+};
+for (const [name, def] of Object.entries(LANGS)) hljs.registerLanguage(name, def);
+hljs.registerAliases(['systemverilog', 'sv', 'v'], { languageName: 'verilog' });
+hljs.registerAliases(['sh', 'shell', 'zsh'], { languageName: 'bash' });
+
+// `lang` is the fence's info string; only its first word names the language,
+// case-insensitively. Returns escaped, coloured HTML, or null when the
+// language is missing or not registered.
+function highlightCode(code, lang) {
+  const name = String(lang || '').trim().split(/\s+/)[0].toLowerCase();
+  if (!name || !hljs.getLanguage(name)) return null;
+  return hljs.highlight(code, { language: name, ignoreIllegals: true }).value;
+}
+
+module.exports = { highlightCode };