@helping-ai-workflow/md2doc 3.7.0 → 3.9.0

package/README.md

@@ -74,9 +74,14 @@ 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. |
 
+### Reading view
+
+- **Dark mode** — a ☀/☾ toggle (bottom-right on desktop, top bar on phone). Light by default; the choice is remembered in the browser. PDF and print stay light.
+
 ### Images
 
 Local images referenced from the markdown are resolved against the **markdown file's own

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/client.js

@@ -12823,7 +12823,8 @@
       // S4 Task 2b (user request, 2026-09-01): the ONLY feedback the source
       // block gets. `.ed-handle` is `opacity: 0` off-hover, so from the moment
       // the pointer leaves the block there is nothing under the cursor but the
-      // indicator line. The ruling is a `cursor: grabbing` class on
+      // indicator line. The ruling is a drag-cursor class (`cursor: move`; v3.8.1
+      // dropped `grabbing`, a browser bitmap on Windows) on
       // `document.documentElement` — OUTSIDE `contentEl`, so the "mutate
       // nothing in the content DOM during a drag" invariant this whole gesture
       // rests on still holds, and every cancellation path stays unconditional.
@@ -13578,7 +13579,7 @@
       if (tePointer.hit.kind === 'row') {
         // The column grip hides like the insert bubbles above (it isn't
         // meaningful mid row-drag); the ROW grip stays visible and switches
-        // to its "dragging" visual (grabbing cursor) — it IS the drag
+        // to its "dragging" visual (move cursor) — it IS the drag
         // handle the user is holding, per the brief ("the active grip may
         // stay as the drag handle visual").
         colGrip.hidden = true;