seemore 1.12.20 → 1.12.22

package/README.md

@@ -64,7 +64,7 @@ npx seemore   # renders this folder at http://localhost:4040
 
 The [seemore website](https://arifszn.github.io/seemore) is a folder of Markdown, rendered by seemore. Your own folder will look the same way.
 
-<details open>
+<details>
 <summary><strong>Or ask an AI agent to set it up</strong></summary>
 <br/>
 
@@ -114,7 +114,7 @@ Point seemore at any Markdown you already have: AI-written notes, project docs,
 - **Zero config**: no config file, no code, no files to move
 - **Live preview**: files appear, disappear and reorder as you edit them
 - **Edit in place**: double-click any block in the preview to fix its Markdown
-- **Desktop app**: for macOS, Windows and Linux
+- **Desktop app**: for macOS, Windows and Linux, with an integrated terminal
 - **Editor integration**: one extension covers VS Code, Cursor, Antigravity and other VS Code-compatible editors, including remote workspaces
 - **Documentation framework**: `seemore build` renders the whole site to HTML, ready to deploy on any host
 - **Password protection**: protect the built site with one shared password, with no server required
@@ -136,11 +136,15 @@ Inline editing works only for local previews.
 
 ## Open with the desktop app
 
-Download the app from the [download page](https://arifszn.github.io/seemore/download). It opens a folder or a `.md` file as a site in its own window. You do not need a terminal or Node.js.
+Download the app from the [download page](https://arifszn.github.io/seemore/download). It opens a folder or a `.md` file as a site in its own window, with an integrated terminal.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/arifszn/seemore/main/packages/site/assets/desktop-app.png" alt="The seemore desktop app in the black theme, showing a folder of research notes as a site: a paragraph's Markdown source open in the inline editor above a flowchart, and the integrated terminal listing the folder's Markdown files" width="640"/>
+</p>
 
 - **Open a folder**: use **File > Open Folder**, or drag the folder onto the app.
 - **Open a file**: double-click a `.md` file, or use **File > Open File**.
-- **Export and build**: use the **File** menu.
+- **Use the integrated terminal**: it opens in the site's folder, so you can run an AI agent, git or a script next to the pages it changes.
 
 ## View in your code editor
 

package/dist/cli/index.js

@@ -1159,11 +1159,11 @@ function humanise(slug) {
 // src/node/content/source.ts
 function createSource(options) {
   let cached;
-  const read = () => cached ??= scan(options);
+  const read2 = () => cached ??= scan(options);
   const loader = dynamicLoader(
     {
       cache: "custom",
-      files: () => read().files,
+      files: () => read2().files,
       invalidate: () => {
         cached = void 0;
       }
@@ -1172,11 +1172,11 @@ function createSource(options) {
   );
   return {
     loader,
-    current: read,
-    pages: () => read().pages,
+    current: read2,
+    pages: () => read2().pages,
     refresh() {
       loader.invalidate();
-      return read();
+      return read2();
     },
     async getPageTree() {
       const output = await loader.get();
@@ -1822,6 +1822,14 @@ function spliceSource(content, request) {
   }
   return { ok: true, content: content.slice(0, start) + withEol(text, dominantEol(content)) + content.slice(end) };
 }
+function appendSource(content, text) {
+  const body = text.replace(/\r\n/g, "\n").replace(/\s+$/, "");
+  if (body.trim() === "") return void 0;
+  const lf = content.replace(/\r\n/g, "\n");
+  const separator = lf === "" || lf.endsWith("\n\n") ? "" : lf.endsWith("\n") ? "\n" : "\n\n";
+  return content + withEol(`${separator}${body}
+`, dominantEol(content));
+}
 function dominantEol(content) {
   const crlf = content.match(/\r\n/g)?.length ?? 0;
   const lf = (content.match(/\n/g)?.length ?? 0) - crlf;
@@ -2018,7 +2026,8 @@ function handleSourceRead(ctx, req, res) {
   if (page === void 0) return send(res, 404, { error: "That file is not part of this site." });
   const start = Number(query.get("start"));
   const end = Number(query.get("end"));
-  const content = readFileSync6(page.absPath, "utf8");
+  const content = read(res, page.absPath);
+  if (content === void 0) return;
   if (!Number.isInteger(start) || !Number.isInteger(end) || start < 0 || end < start || end > content.length) {
     return send(res, 400, { error: "The requested range is not inside this file." });
   }
@@ -2033,10 +2042,19 @@ async function handleSourceWrite(ctx, req, res) {
   }
   const page = resolvePage(ctx, body.file);
   if (page === void 0) return send(res, 404, { error: "That file is not part of this site." });
+  if (body.append === true) {
+    if (typeof body.text !== "string") return send(res, 400, { error: "`text` is required." });
+    const content2 = read(res, page.absPath);
+    if (content2 === void 0) return;
+    const appended = appendSource(content2, body.text);
+    if (appended === void 0) return send(res, 200, { ok: true });
+    return write(res, page.absPath, appended);
+  }
   if (typeof body.expected !== "string" || typeof body.text !== "string") {
     return send(res, 400, { error: "Both `expected` and `text` are required." });
   }
-  const content = readFileSync6(page.absPath, "utf8");
+  const content = read(res, page.absPath);
+  if (content === void 0) return;
   const result = spliceSource(content, {
     start: body.start,
     end: body.end,
@@ -2044,7 +2062,24 @@ async function handleSourceWrite(ctx, req, res) {
     text: body.text
   });
   if (!result.ok) return send(res, result.status, { error: result.error });
-  writeFileSync5(page.absPath, result.content, "utf8");
+  return write(res, page.absPath, result.content);
+}
+function read(res, file) {
+  try {
+    return readFileSync6(file, "utf8");
+  } catch (error) {
+    const code = error.code;
+    send(res, 500, { error: `The file could not be read${code === void 0 ? "" : ` (${code})`}. Is another program holding it open?` });
+    return void 0;
+  }
+}
+function write(res, file, content) {
+  try {
+    writeFileSync5(file, content, "utf8");
+  } catch (error) {
+    const code = error.code;
+    return send(res, 500, { error: `The file could not be written${code === void 0 ? "" : ` (${code})`}. Is another program holding it open?` });
+  }
   return send(res, 200, { ok: true });
 }
 function resolvePage(ctx, file) {