@helping-ai-workflow/md2doc 3.17.0 → 3.17.1

package/lib/editor/wave-codec.js

@@ -2503,9 +2503,11 @@ function sameLane(a, b) {
  * Paint one cycle of one lane, addressed by display index.
  *
  * `ch` is a single character: a level, a value character, `|` for a gap, or `.`
- * to make the cycle continue the one in front of it. Anything else — a longer
- * string, a cycle outside the lane, a `.` or `|` at cycle 0 where there is
- * nothing to continue or to draw over — answers the doc unchanged.
+ * to make the cycle continue the one in front of it. A cycle past the lane's
+ * end grows the lane first, continuing its last level up to that cycle (see
+ * `paint`). Anything else — a longer string, a negative or fractional cycle, a
+ * `.` or `|` at cycle 0 where there is nothing to continue or to draw over —
+ * answers the doc unchanged.
  *
  * A newly painted value cell keeps the label of the value cell it replaced and
  * otherwise starts blank; a cell painted with something that is not a value
@@ -2542,12 +2544,20 @@ function paint(doc, laneIndex, from, to, ch, asRun) {
       lo = hi;
       hi = swap;
     }
-    if (!isIndex(lo, n) || !isIndex(hi, n)) return null;
+    if (lo < 0) return null;
     // A repeater at cycle 0 has nothing to repeat, and the engine answers that
     // by drawing the run and the cycle after it as x. Refusing is the honest
     // reply to a brush that cannot mean anything where it was aimed.
     if (lo === 0 && (ch === HELD_CHAR || ch === GAP_CHAR)) return null;
-    const anchored = anchorAfter(model.cells, hi);
+    // Past the lane's end: continue its last level up to `hi` first, then
+    // paint. A lane shorter than the diagram is ordinary (新增訊號 writes one
+    // cycle, hand-written lanes differ in length) and the editor's grid is as
+    // wide as the whole diagram, so `geometry.cellAt` hands out these cells on
+    // purpose; refusing them here left every click past a short lane's end
+    // silently doing nothing. How far past is bounded by the caller (the
+    // grid), not here.
+    const grown = hi < n ? model.cells : model.cells.concat(fillerCells(model.cells, n, hi + 1 - n));
+    const anchored = anchorAfter(grown, hi);
     const before = resolveCells(anchored);
     const heldLevel = lo > 0 ? before.levels[lo - 1] : '';
     const cells = anchored.slice();

package/lib/editor/wave-ui.js

@@ -1690,6 +1690,14 @@
       if (added) notify('notice', lead + where);
       return added;
     }
+    /** The lane 新增訊號 writes: `x` across the whole diagram, not one cycle
+     *  of it. A one-cycle lane draws a single x and then nothing, which read
+     *  as a broken signal (user report 2026-10-28), and every cycle after it
+     *  had to be grown by painting before it showed anything. */
+    function newSignalLane() {
+      const cycles = layoutNow().cycles;
+      return { name: '', wave: 'x' + '.'.repeat(Math.max(0, cycles - 1)) };
+    }
     function addLaneFromToolbar(name, lane) {
       addLaneAt(signalInsertAt(), name, lane);
     }
@@ -1705,7 +1713,7 @@
       const el = panels.menu('ed-wave-signal-pop', [
         { key: 'ed-wave-signal-add', label: '新增訊號',
           title: '在選取的 lane 後面加一條（沒有選取就加在最前面）—— 會落在' + where,
-          run: function () { closePopover(true); addLaneFromToolbar('add-lane', { name: '', wave: 'x' }); } },
+          run: function () { closePopover(true); addLaneFromToolbar('add-lane', newSignalLane()); } },
         { key: 'ed-wave-signal-blank', label: '新增空白列',
           title: '在選取的 lane 後面插入一個空白列（WaveJSON 的 {}，用來空出間距）—— 會落在' + where,
           run: function () { closePopover(true); addLaneFromToolbar('add-spacer', {}); } },
@@ -1950,7 +1958,7 @@
         const row = layoutNow().lanes[i];
         const actions = {
           copy: picked(function () { duplicateLaneAt(i); }),
-          addBelow: picked(function () { addLaneAt(i + 1, 'add-lane', { name: '', wave: 'x' }); }),
+          addBelow: picked(function () { addLaneAt(i + 1, 'add-lane', newSignalLane()); }),
           blankBelow: picked(function () { addLaneAt(i + 1, 'add-spacer', {}); }),
           up: picked(function () { moveLaneBy(i, -1); }),
           down: picked(function () { moveLaneBy(i, 1); }),
@@ -2473,7 +2481,7 @@
     // signal at the end — the one insert position the ⠿ menus (which add
     // BELOW a row) and 訊號 (after the selection) do not make obvious.
     panels.toolButton('ed-wave-add-lane', '＋ 新增訊號', '在最後面加一條訊號', function () {
-      addLaneAt(layoutNow().lanes.length, 'add-lane', { name: '', wave: 'x' });
+      addLaneAt(layoutNow().lanes.length, 'add-lane', newSignalLane());
     }, stage);
     // One canvas per editor session (spec §3.2); `close()` destroys it.
     engineCanvas = opts.canvas.createCanvas({

package/package.json

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