@helping-ai-workflow/md2doc 3.6.1 → 3.8.0

package/README.md

@@ -74,6 +74,7 @@ also pass `--open`.
 | `--no-open` | Skip the viewer launch. |
 | `--quiet` | Suppress per-file progress messages. |
 | `--bake-svg` | Pre-render Mermaid / WaveDrom to inert SVG at generation time (HTML output only; needs Chromium). The output then contains no diagram JavaScript. |
+| `--lang <tag>` | Set `<html lang>` (for example `en`, `zh-Hant`). Default: detected — `zh-Hant` when Chinese characters are at least 10% of the prose (code excluded), `ja` / `ko` when kana / Hangul make up at least 20% of the CJK characters, otherwise `en`. |
 | `--version`, `-v` | Print version. |
 | `--help`, `-h` | Print help. |
 

package/THIRD-PARTY-NOTICES.md

@@ -42,3 +42,24 @@ turndown, `@hpcc-js/wasm-graphviz`) are ordinary npm packages: they are
 resolved into your `node_modules` by your own installer, carry their own
 licence files there, and are not redistributed inside md2doc's tarball.
 They are out of scope for this file.
+
+## Lucide (icon path data)
+
+The sidebar icons in `lib/md2doc.js` (`READER_ICONS`) use path data from
+Lucide, https://lucide.dev — ISC License.
+
+Copyright (c) for portions of Lucide are held by Cole Bemis 2013-2022 as part
+of Feather (MIT). All other copyright (c) for Lucide are held by Lucide
+Contributors 2022.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
+OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
+CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/bin/md2doc.js

@@ -32,6 +32,7 @@ function printHelp() {
         '  --open              Launch the platform viewer after render (default when --out is absent).',
         '  --no-open           Skip the viewer launch.',
         '  --quiet             Suppress per-file progress messages.',
+        '  --lang <tag>        Set <html lang> (default: detected — zh-Hant for Chinese-heavy text, ja / ko for Japanese / Korean, else en).',
         '  --bake-svg          Pre-render mermaid/wavedrom to inert SVG (HTML output only; needs Chromium).',
         '  --edit              Serve listed .md files in the browser editor (localhost).',
         '  --port <n>          Pin the editor server port (only with --edit).',
@@ -51,6 +52,7 @@ function parseArgs(argv) {
     let bakeSvg = false;
     let edit = false;
     let port = null;
+    let lang = null;
 
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
@@ -96,6 +98,19 @@ function parseArgs(argv) {
             out = argv[i];
             continue;
         }
+        if (a === '--lang') {
+            i++;
+            if (i >= argv.length) {
+                process.stderr.write('error: --lang requires a value\n');
+                process.exit(2);
+            }
+            if (!/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(argv[i])) {
+                process.stderr.write('error: --lang must be a language tag such as en or zh-Hant\n');
+                process.exit(2);
+            }
+            lang = argv[i];
+            continue;
+        }
         if (a.startsWith('-')) {
             process.stderr.write('error: unknown flag ' + a + '\n');
             process.exit(2);
@@ -124,7 +139,7 @@ function parseArgs(argv) {
         open = (out === null);
     }
 
-    return { inputs, formats, formatsExplicit, out, open, quiet, bakeSvg, edit, port };
+    return { inputs, formats, formatsExplicit, out, open, quiet, bakeSvg, edit, port, lang };
 }
 
 function shortHash(absPath) {
@@ -232,8 +247,8 @@ function main() {
     }
 
     if (args.edit) {
-        if (args.formatsExplicit || args.out !== null || args.bakeSvg) {
-            process.stderr.write('error: --edit cannot be combined with --html/--pdf/--out/--bake-svg\n');
+        if (args.formatsExplicit || args.out !== null || args.bakeSvg || args.lang !== null) {
+            process.stderr.write('error: --edit cannot be combined with --html/--pdf/--out/--bake-svg/--lang\n');
             process.exit(2);
         }
         for (const input of args.inputs) {
@@ -262,6 +277,7 @@ function main() {
         const stdio = args.quiet ? ['inherit', 'ignore', 'inherit'] : 'inherit';
         const childArgs = [LIB, input, output];
         if (args.bakeSvg) childArgs.push('--bake-svg');
+        if (args.lang) childArgs.push('--lang=' + args.lang);
         const r = spawnSync(process.execPath, childArgs, { stdio });
         if (r.status !== 0) {
             process.stderr.write('error: render failed for ' + input + ' (exit ' + r.status + ')\n');

package/lib/editor/cell-range.js

@@ -0,0 +1,85 @@
+'use strict';
+/* Table cell-range selection — the pure model.
+   Spec: docs/superpowers/specs/2026-09-24-editor-cell-range-design.md.
+   UMD, same shape as selection.js: require-able in node for the unit tests,
+   injected into the editor page as window.md2docCellRange. Points are
+   {r, c}: r indexes the table's rows with the header row as 0, c the cell
+   index within that row. */
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) module.exports = factory();
+  else root.md2docCellRange = factory();
+})(typeof self !== 'undefined' ? self : this, function () {
+  function clamp(n, lo, hi) { return Math.max(lo, Math.min(hi, n)); }
+
+  function normalize(a, f) {
+    return { top: Math.min(a.r, f.r), left: Math.min(a.c, f.c),
+      bottom: Math.max(a.r, f.r), right: Math.max(a.c, f.c) };
+  }
+
+  function cellsIn(rect) {
+    const out = [];
+    for (let r = rect.top; r <= rect.bottom; r++) {
+      for (let c = rect.left; c <= rect.right; c++) out.push({ r: r, c: c });
+    }
+    return out;
+  }
+
+  function isSingle(a, f) { return a.r === f.r && a.c === f.c; }
+
+  const DELTA = { up: [-1, 0], down: [1, 0], left: [0, -1], right: [0, 1] };
+  function step(p, dir, rowCount, colCount) {
+    const d = DELTA[dir];
+    return { r: clamp(p.r + d[0], 0, rowCount - 1), c: clamp(p.c + d[1], 0, colCount - 1) };
+  }
+
+  // Excel's TSV: TAB between fields, newline between records, a field that
+  // STARTS with a quote is quoted ("" inside is one quote, and it may hold
+  // TABs and newlines). A trailing newline does not make an empty record.
+  function parseTsv(text) {
+    const s = String(text).replace(/\r\n?/g, '\n');
+    const rows = [];
+    let row = [];
+    let field = '';
+    let atStart = true;
+    let i = 0;
+    while (i < s.length) {
+      const ch = s[i];
+      if (atStart && ch === '"') {
+        i++;
+        while (i < s.length) {
+          if (s[i] === '"') {
+            if (s[i + 1] === '"') { field += '"'; i += 2; continue; }
+            i++;
+            break;
+          }
+          field += s[i];
+          i++;
+        }
+        atStart = false;
+        continue;
+      }
+      if (ch === '\t') { row.push(field); field = ''; atStart = true; i++; continue; }
+      if (ch === '\n') { row.push(field); rows.push(row); row = []; field = ''; atStart = true; i++; continue; }
+      field += ch;
+      atStart = false;
+      i++;
+    }
+    if (field !== '' || row.length) { row.push(field); rows.push(row); }
+    return rows;
+  }
+
+  function quoteField(f) {
+    return /[\t\n"]/.test(f) ? '"' + f.replace(/"/g, '""') + '"' : f;
+  }
+  function toTsv(grid) {
+    return grid.map((row) => row.map(quoteField).join('\t')).join('\n');
+  }
+
+  function growthNeeded(origin, grid, rowCount, colCount) {
+    const width = grid.reduce((w, row) => Math.max(w, row.length), 0);
+    return { addRows: Math.max(0, origin.r + grid.length - rowCount),
+      addCols: Math.max(0, origin.c + width - colCount) };
+  }
+
+  return { normalize, cellsIn, isSingle, step, parseTsv, toTsv, growthNeeded };
+});