finch-markdown-editor 0.1.0 → 0.1.1

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 import { createHash } from "node:crypto";
-import { mkdir, readFile, realpath, stat, writeFile } from "node:fs/promises";
+import { mkdir, readFile, realpath, rm, stat, writeFile } from "node:fs/promises";
 import { watch } from "node:fs";
 import { spawn } from "node:child_process";
 import path from "node:path";
@@ -101,6 +101,69 @@ async function writeStyleSlot(ctx, slot, value) {
   await writeFile(styleSlotsFile(ctx), JSON.stringify(slots), "utf8");
   return slots;
 }
+function draftPathFor(ctx, sourcePath) {
+  const digest = createHash("sha256").update(sourcePath).digest("hex").slice(0, 32);
+  return path.join(ctx.storagePath, "drafts", `${digest}.json`);
+}
+function hashText(text) {
+  return createHash("sha256").update(text).digest("hex");
+}
+async function readDraft(ctx, sourcePath) {
+  try {
+    const raw = JSON.parse(await readFile(draftPathFor(ctx, sourcePath), "utf8"));
+    return raw && raw.path === sourcePath && typeof raw.markdown === "string" ? raw : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function writeDraft(ctx, sourcePath, markdown, base) {
+  try {
+    const file = draftPathFor(ctx, sourcePath);
+    await mkdir(path.dirname(file), { recursive: true });
+    const entry = { path: sourcePath, markdown, savedAt: Date.now() };
+    if (typeof base === "string") entry.baseHash = hashText(base);
+    await writeFile(file, JSON.stringify(entry), "utf8");
+  } catch (error) {
+    ctx.logger.warn(`Could not persist draft for ${sourcePath}: ${String(error)}`);
+  }
+}
+async function deleteDraft(ctx, sourcePath) {
+  await rm(draftPathFor(ctx, sourcePath), { force: true }).catch(() => {
+  });
+}
+var DRAFT_WRITE_DEBOUNCE_MS = 600;
+var pendingDraftWrites = /* @__PURE__ */ new Map();
+function scheduleDraftWrite(ctx, panelId, sourcePath, markdown, base) {
+  const existing = pendingDraftWrites.get(panelId);
+  if (existing?.timer) clearTimeout(existing.timer);
+  const entry = { path: sourcePath, markdown, base, timer: null };
+  entry.timer = setTimeout(() => {
+    entry.timer = null;
+    pendingDraftWrites.delete(panelId);
+    void writeDraft(ctx, sourcePath, markdown, base);
+  }, DRAFT_WRITE_DEBOUNCE_MS);
+  pendingDraftWrites.set(panelId, entry);
+}
+function flushPendingDraftWrite(ctx, panelId) {
+  const entry = pendingDraftWrites.get(panelId);
+  if (!entry) return;
+  if (entry.timer) clearTimeout(entry.timer);
+  pendingDraftWrites.delete(panelId);
+  void writeDraft(ctx, entry.path, entry.markdown, entry.base);
+}
+function cancelPendingDraftWrite(panelId) {
+  const entry = pendingDraftWrites.get(panelId);
+  if (entry?.timer) clearTimeout(entry.timer);
+  pendingDraftWrites.delete(panelId);
+}
+async function readFileWithDraft(ctx, sourcePath) {
+  const diskMarkdown = await readFile(sourcePath, "utf8");
+  const draft = await readDraft(ctx, sourcePath);
+  if (!draft || draft.markdown === diskMarkdown) return { markdown: diskMarkdown, diskMarkdown, draftRestored: false, draftConflict: false };
+  const diskMatchesBaseline = draft.baseHash === void 0 || draft.baseHash === hashText(diskMarkdown);
+  if (diskMatchesBaseline) return { markdown: draft.markdown, diskMarkdown, draftRestored: true, draftConflict: false };
+  return { markdown: diskMarkdown, diskMarkdown, draftRestored: false, draftConflict: true };
+}
 function sessionBucketKey(panel) {
   return panel.sessionId || "__global__";
 }
@@ -195,6 +258,18 @@ async function sendDocument(panel, state) {
   livePanelDocuments.set(panel.id, state);
   await panel.postMessage({ type: "document", ...state });
 }
+async function sendLiveDocument(ctx, panel, liveDocument) {
+  if (liveDocument.path && path.isAbsolute(liveDocument.path)) {
+    try {
+      const { markdown, diskMarkdown, draftRestored, draftConflict } = await readFileWithDraft(ctx, liveDocument.path);
+      await sendDocument(panel, { ...liveDocument, markdown, title: documentTitle(markdown, liveDocument.path), draftRestored, draftConflict, diskMarkdown });
+      return;
+    } catch (error) {
+      ctx.logger.warn(`Could not re-read ${liveDocument.path} for a reconnecting panel, resending cached copy: ${String(error)}`);
+    }
+  }
+  await sendDocument(panel, liveDocument);
+}
 function payloadPath(panel) {
   const payload = panel.payload;
   if (!payload || typeof payload !== "object" || Array.isArray(payload)) return void 0;
@@ -206,10 +281,10 @@ async function restoreDocument(ctx, panel) {
   const sourcePath = await readLastPath(ctx, panel) ?? payloadPath(panel);
   if (!sourcePath) return false;
   try {
-    const markdown = await readFile(sourcePath, "utf8");
+    const { markdown, diskMarkdown, draftRestored, draftConflict } = await readFileWithDraft(ctx, sourcePath);
     watchSource(ctx, panel, sourcePath);
     await rememberLastPath(ctx, panel, sourcePath);
-    await sendDocument(panel, { path: sourcePath, markdown, title: documentTitle(markdown, sourcePath) });
+    await sendDocument(panel, { path: sourcePath, markdown, title: documentTitle(markdown, sourcePath), draftRestored, draftConflict, diskMarkdown });
     return true;
   } catch (error) {
     ctx.logger.warn(`Could not restore ${sourcePath}: ${String(error)}`);
@@ -318,6 +393,11 @@ function watchSource(ctx, panel, sourcePath) {
           await sendDocument(panel, { path: sourcePath, markdown, title: documentTitle(markdown, sourcePath) });
         } catch (error) {
           ctx.logger.warn(`Source refresh failed: ${String(error)}`);
+          const code = error?.code;
+          if (code === "ENOENT") {
+            await panel.postMessage({ type: "sourceMissing", path: sourcePath }).catch(() => {
+            });
+          }
         }
       }, 150);
     });
@@ -353,13 +433,19 @@ async function sendReady(ctx, panel) {
     homeDir: os.homedir()
   });
 }
-function revealInFileManager(ctx, directory) {
+async function revealInFileManager(ctx, targetPath) {
   try {
-    if (process.platform === "darwin") spawn("open", [directory], { stdio: "ignore", detached: true }).unref();
-    else if (process.platform === "win32") spawn("explorer", [directory], { stdio: "ignore", detached: true }).unref();
-    else spawn("xdg-open", [directory], { stdio: "ignore", detached: true }).unref();
+    const info = await stat(targetPath).catch(() => void 0);
+    const isFile = info?.isFile() ?? false;
+    if (process.platform === "darwin") {
+      spawn("open", isFile ? ["-R", targetPath] : [targetPath], { stdio: "ignore", detached: true }).unref();
+    } else if (process.platform === "win32") {
+      spawn("explorer", isFile ? [`/select,${targetPath}`] : [targetPath], { stdio: "ignore", detached: true }).unref();
+    } else {
+      spawn("xdg-open", [isFile ? path.dirname(targetPath) : targetPath], { stdio: "ignore", detached: true }).unref();
+    }
   } catch (error) {
-    ctx.logger.warn(`Could not open file manager for ${directory}: ${String(error)}`);
+    ctx.logger.warn(`Could not open file manager for ${targetPath}: ${String(error)}`);
   }
 }
 async function handleMessage(ctx, panel, raw) {
@@ -373,7 +459,7 @@ async function handleMessage(ctx, panel, raw) {
       await sendReady(ctx, panel);
       const liveDocument = livePanelDocuments.get(panel.id);
       if (liveDocument) {
-        await sendDocument(panel, liveDocument);
+        await sendLiveDocument(ctx, panel, liveDocument);
       } else if (!await restoreDocument(ctx, panel)) {
         await panel.postMessage({ type: "lastFileUnavailable" });
       }
@@ -421,10 +507,10 @@ async function handleMessage(ctx, panel, raw) {
           return;
         }
         const sourcePath = picked.files[0].path;
-        const markdown = await readFile(sourcePath, "utf8");
+        const { markdown, diskMarkdown, draftRestored, draftConflict } = await readFileWithDraft(ctx, sourcePath);
         watchSource(ctx, panel, sourcePath);
         await rememberLastPath(ctx, panel, sourcePath);
-        await sendDocument(panel, { path: sourcePath, markdown, title: documentTitle(markdown, sourcePath) });
+        await sendDocument(panel, { path: sourcePath, markdown, title: documentTitle(markdown, sourcePath), draftRestored, draftConflict, diskMarkdown });
       } catch (error) {
         ctx.logger.error(`pickFile() threw: ${error instanceof Error ? error.stack ?? error.message : String(error)}`);
         await panel.postMessage({
@@ -442,10 +528,10 @@ async function handleMessage(ctx, panel, raw) {
         return;
       }
       try {
-        const markdown = await readFile(sourcePath, "utf8");
+        const { markdown, diskMarkdown, draftRestored, draftConflict } = await readFileWithDraft(ctx, sourcePath);
         watchSource(ctx, panel, sourcePath);
         await rememberLastPath(ctx, panel, sourcePath);
-        await sendDocument(panel, { path: sourcePath, markdown, title: documentTitle(markdown, sourcePath) });
+        await sendDocument(panel, { path: sourcePath, markdown, title: documentTitle(markdown, sourcePath), draftRestored, draftConflict, diskMarkdown });
       } catch (error) {
         await panel.postMessage({ type: "error", message: `Cannot read file: ${error instanceof Error ? error.message : String(error)}` });
       }
@@ -462,7 +548,7 @@ async function handleMessage(ctx, panel, raw) {
     case "requestLastFile": {
       const liveDocument = livePanelDocuments.get(panel.id);
       if (liveDocument) {
-        await sendDocument(panel, liveDocument);
+        await sendLiveDocument(ctx, panel, liveDocument);
       } else if (!await restoreDocument(ctx, panel)) {
         await panel.postMessage({ type: "lastFileUnavailable" });
       }
@@ -470,7 +556,7 @@ async function handleMessage(ctx, panel, raw) {
     }
     case "openPath": {
       const targetPath = String(message.path ?? "").trim();
-      if (targetPath && path.isAbsolute(targetPath)) revealInFileManager(ctx, targetPath);
+      if (targetPath && path.isAbsolute(targetPath)) await revealInFileManager(ctx, targetPath);
       return;
     }
     case "goHome": {
@@ -493,12 +579,28 @@ async function handleMessage(ctx, panel, raw) {
       if (!path.isAbsolute(sourcePath)) return;
       try {
         await writeFile(sourcePath, String(message.markdown ?? ""), "utf8");
+        cancelPendingDraftWrite(panel.id);
+        await deleteDraft(ctx, sourcePath);
         await panel.postMessage({ type: "savedMarkdown", path: sourcePath, requestId: message.requestId });
       } catch (error) {
         await panel.postMessage({ type: "error", message: `Could not save Markdown: ${error instanceof Error ? error.message : String(error)}` });
       }
       return;
     }
+    case "saveDraft": {
+      const sourcePath = String(message.path ?? "").trim();
+      if (!path.isAbsolute(sourcePath)) return;
+      const base = typeof message.base === "string" ? message.base : void 0;
+      scheduleDraftWrite(ctx, panel.id, sourcePath, String(message.markdown ?? ""), base);
+      return;
+    }
+    case "discardDraft": {
+      const sourcePath = String(message.path ?? "").trim();
+      if (!path.isAbsolute(sourcePath)) return;
+      cancelPendingDraftWrite(panel.id);
+      await deleteDraft(ctx, sourcePath);
+      return;
+    }
     case "renderBm": {
       try {
         const html = await renderWithBm(ctx, String(message.markdown ?? ""), String(message.markdownStyle ?? "kami"), message.customCss, () => {
@@ -637,6 +739,9 @@ function activate(ctx) {
     },
     "wechat-copy": {
       svg: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linejoin="round"><path stroke-linecap="round" stroke-width="2" d="M7 7h.009m5.982 0H13m4.991 7.5H18m-4 0h.009"></path><path stroke-width="2" d="M10 16c0 2.761 2.686 5 6 5c.907 0 1.767-.168 2.538-.468c.189-.073.393-.1.592-.063L22 21l-.652-2.03a1.13 1.13 0 0 1 .11-.89A4.3 4.3 0 0 0 22 16c0-2.761-2.686-5-6-5s-6 2.239-6 5Z"></path><path stroke-width="2" d="M17.873 11.249Q18 10.639 18 10c0-3.866-3.582-7-8-7s-8 3.134-8 7c0 1.112.297 2.164.824 3.098c.147.26.196.567.108.853L2 17l3.914-.76c.208-.041.422-.013.617.07a9 9 0 0 0 3.589.69"></path></svg>'
+    },
+    feather: {
+      svg: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14.086 18.412A2 2 0 0 1 12.67 19H5v-7.672a2 2 0 0 1 .586-1.414L11.75 3.75a6 6 0 1 1 8.49 8.49z"/><path d="M16 8 2 22"/><path d="M17.488 15H9"/></svg>'
     }
   }));
   ctx.subscriptions.push(ctx.ui.onDidOpenPanel((panel) => {
@@ -653,13 +758,14 @@ function activate(ctx) {
     ctx.subscriptions.push(panel.onDidDispose(() => {
       stopWatching(panel.id);
       livePanelDocuments.delete(panel.id);
+      flushPendingDraftWrite(ctx, panel.id);
       if (lastPanel === panel) lastPanel = void 0;
     }));
     void sendReady(ctx, panel).catch((error) => ctx.logger.warn(String(error)));
   }));
   ctx.subscriptions.push(ctx.tools.register({
     name: "markdown_editor_document",
-    title: "Markdown \u7F16\u8F91",
+    title: "\u5199\u4F5C",
     description: `Open, create, revise, or restyle a Markdown document in Markdown Editor.
 action:
   open \u2014 read an absolute local Markdown path and open it as an editable WeChat article preview
@@ -686,12 +792,12 @@ action:
         if (!path.isAbsolute(sourcePath)) return result("`path` must be an absolute local path.", true);
         if (action === "open") {
           try {
-            const markdown2 = await readFile(sourcePath, "utf8");
+            const { markdown: markdown2, diskMarkdown, draftRestored, draftConflict } = await readFileWithDraft(ctx, sourcePath);
             const panel = ctx.ui.createPanel({ instanceMode: "single", payload: { path: sourcePath } });
             await panel.reveal();
             watchSource(ctx, panel, sourcePath);
             await rememberLastPath(ctx, panel, sourcePath);
-            await sendDocument(panel, { path: sourcePath, markdown: markdown2, title: documentTitle(markdown2, sourcePath) });
+            await sendDocument(panel, { path: sourcePath, markdown: markdown2, title: documentTitle(markdown2, sourcePath), draftRestored, draftConflict, diskMarkdown });
             return result(`Opened Markdown Editor for ${path.basename(sourcePath)}.`);
           } catch (error) {
             return result(`Could not read ${sourcePath}: ${error instanceof Error ? error.message : String(error)}`, true);