@erdemtuna/doc-review 0.9.0 → 0.11.0

package/lib/icons.js

@@ -0,0 +1,325 @@
+// Generated by scripts/generate-icons.js from lucide-static. Do not edit.
+export const ICON_NODES = Object.freeze({
+    "eye": [
+        [
+            "path",
+            {
+                "d": "M2.062 12.348a1 1 0 0 1 0-.696 10.75 10.75 0 0 1 19.876 0 1 1 0 0 1 0 .696 10.75 10.75 0 0 1-19.876 0"
+            }
+        ],
+        [
+            "circle",
+            {
+                "cx": "12",
+                "cy": "12",
+                "r": "3"
+            }
+        ]
+    ],
+    "pencil": [
+        [
+            "path",
+            {
+                "d": "M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "m15 5 4 4"
+            }
+        ]
+    ],
+    "plus": [
+        [
+            "path",
+            {
+                "d": "M5 12h14"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M12 5v14"
+            }
+        ]
+    ],
+    "minus": [
+        [
+            "path",
+            {
+                "d": "M5 12h14"
+            }
+        ]
+    ],
+    "locate": [
+        [
+            "line",
+            {
+                "x1": "2",
+                "x2": "5",
+                "y1": "12",
+                "y2": "12"
+            }
+        ],
+        [
+            "line",
+            {
+                "x1": "19",
+                "x2": "22",
+                "y1": "12",
+                "y2": "12"
+            }
+        ],
+        [
+            "line",
+            {
+                "x1": "12",
+                "x2": "12",
+                "y1": "2",
+                "y2": "5"
+            }
+        ],
+        [
+            "line",
+            {
+                "x1": "12",
+                "x2": "12",
+                "y1": "19",
+                "y2": "22"
+            }
+        ],
+        [
+            "circle",
+            {
+                "cx": "12",
+                "cy": "12",
+                "r": "7"
+            }
+        ]
+    ],
+    "chevronDown": [
+        [
+            "path",
+            {
+                "d": "m6 9 6 6 6-6"
+            }
+        ]
+    ],
+    "chevronRight": [
+        [
+            "path",
+            {
+                "d": "m9 18 6-6-6-6"
+            }
+        ]
+    ],
+    "messageSquarePlus": [
+        [
+            "path",
+            {
+                "d": "M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M12 8v6"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M9 11h6"
+            }
+        ]
+    ],
+    "messages": [
+        [
+            "path",
+            {
+                "d": "M16 10a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 14.286V4a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M20 9a2 2 0 0 1 2 2v10.286a.71.71 0 0 1-1.212.502l-2.202-2.202A2 2 0 0 0 17.172 19H10a2 2 0 0 1-2-2v-1"
+            }
+        ]
+    ],
+    "send": [
+        [
+            "path",
+            {
+                "d": "M14.536 21.686a.5.5 0 0 0 .937-.024l6.5-19a.496.496 0 0 0-.635-.635l-19 6.5a.5.5 0 0 0-.024.937l7.93 3.18a2 2 0 0 1 1.112 1.11z"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "m21.854 2.147-10.94 10.939"
+            }
+        ]
+    ],
+    "trash": [
+        [
+            "path",
+            {
+                "d": "M10 11v6"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M14 11v6"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M3 6h18"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"
+            }
+        ]
+    ],
+    "moreHorizontal": [
+        [
+            "circle",
+            {
+                "cx": "12",
+                "cy": "12",
+                "r": "1"
+            }
+        ],
+        [
+            "circle",
+            {
+                "cx": "19",
+                "cy": "12",
+                "r": "1"
+            }
+        ],
+        [
+            "circle",
+            {
+                "cx": "5",
+                "cy": "12",
+                "r": "1"
+            }
+        ]
+    ],
+    "x": [
+        [
+            "path",
+            {
+                "d": "M18 6 6 18"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "m6 6 12 12"
+            }
+        ]
+    ],
+    "check": [
+        [
+            "path",
+            {
+                "d": "M20 6 9 17l-5-5"
+            }
+        ]
+    ],
+    "sun": [
+        [
+            "circle",
+            {
+                "cx": "12",
+                "cy": "12",
+                "r": "4"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M12 2v2"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M12 20v2"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "m4.93 4.93 1.41 1.41"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "m17.66 17.66 1.41 1.41"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M2 12h2"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "M20 12h2"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "m6.34 17.66-1.41 1.41"
+            }
+        ],
+        [
+            "path",
+            {
+                "d": "m19.07 4.93-1.41 1.41"
+            }
+        ]
+    ],
+    "moon": [
+        [
+            "path",
+            {
+                "d": "M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401"
+            }
+        ]
+    ]
+});
+const escape = (value) => String(value).replace(/[&<>"]/g, (char) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[char]);
+export function iconMarkup(name, { title = "", className = "icon", size = 16 } = {}) {
+    const nodes = ICON_NODES[name];
+    if (!nodes)
+        throw new Error(`Unknown icon: ${name}`);
+    const body = nodes.map(([tag, attrs]) => `<${tag} ${Object.entries(attrs).map(([key, value]) => `${key}="${escape(value)}"`).join(" ")}></${tag}>`).join("");
+    const label = title ? ` role="img" aria-label="${escape(title)}"` : ' aria-hidden="true"';
+    return `<svg class="${escape(className)}" width="${size}" height="${size}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"${label}>${body}</svg>`;
+}
+export function createIcon(name, options = {}) {
+    const template = document.createElement("template");
+    template.innerHTML = iconMarkup(name, options);
+    return template.content.firstElementChild;
+}

package/{src → lib}/markdown.js

@@ -1,8 +1,6 @@
 import path from "node:path";
 import { marked, Renderer } from "marked";
-
 export const isMarkdown = (file) => /\.(md|markdown)$/i.test(file);
-
 /**
  * Readable defaults for rendered Markdown. This HTML is a viewing surface
  * only — it is never written back to disk, so the styling can be opinionated.
@@ -35,45 +33,46 @@ const STYLE = `
   img { max-width: 100%; height: auto; }
   hr { border: none; border-top: 1px solid #eceae3; margin: 2.2em 0; }
 `;
-
-const escapeHtml = (value) =>
-  String(value)
+const escapeHtml = (value) => String(value)
     .replace(/&/g, "&")
     .replace(/</g, "&lt;")
     .replace(/>/g, "&gt;");
-
 function safeUrl(value, { image = false } = {}) {
-  const url = String(value || "").trim();
-  const probe = url.replace(/[\u0000-\u0020\u007f]+/g, "");
-  const match = /^([a-z][a-z0-9+.-]*):/i.exec(probe);
-  if (!match) return url;
-  const scheme = match[1].toLowerCase();
-  if (scheme === "http" || scheme === "https") return url;
-  if (!image && scheme === "mailto") return url;
-  if (image && /^data:image\/(?:avif|gif|jpe?g|png|webp);base64,/i.test(probe)) return url;
-  return null;
+    const url = String(value || "").trim();
+    const probe = url.replace(/[\u0000-\u0020\u007f]+/g, "");
+    const match = /^([a-z][a-z0-9+.-]*):/i.exec(probe);
+    if (!match)
+        return url;
+    const scheme = match[1].toLowerCase();
+    if (scheme === "http" || scheme === "https")
+        return url;
+    if (!image && scheme === "mailto")
+        return url;
+    if (image && /^data:image\/(?:avif|gif|jpe?g|png|webp);base64,/i.test(probe))
+        return url;
+    return null;
 }
-
 // Markdown can contain arbitrary HTML. Show that source as text so event
 // handlers, embeds, SVG, and future browser features can never become active.
 const INERT_RENDERER = new Renderer();
 INERT_RENDERER.html = ({ text }) => escapeHtml(text);
 INERT_RENDERER.link = function (token) {
-  const href = safeUrl(token.href);
-  if (!href) return this.parser.parseInline(token.tokens);
-  return Renderer.prototype.link.call(this, { ...token, href });
+    const href = safeUrl(token.href);
+    if (!href)
+        return this.parser.parseInline(token.tokens);
+    return Renderer.prototype.link.call(this, { ...token, href });
 };
 INERT_RENDERER.image = function (token) {
-  const href = safeUrl(token.href, { image: true });
-  if (!href) return escapeHtml(token.text || "");
-  return Renderer.prototype.image.call(this, { ...token, href });
+    const href = safeUrl(token.href, { image: true });
+    if (!href)
+        return escapeHtml(token.text || "");
+    return Renderer.prototype.image.call(this, { ...token, href });
 };
-
 /** Render a Markdown file into a standalone review page. */
 export function renderMarkdownPage(mdText, file) {
-  const body = marked.parse(mdText, { gfm: true, async: false, renderer: INERT_RENDERER });
-  const title = path.basename(file);
-  return `<!DOCTYPE html>
+    const body = marked.parse(mdText, { gfm: true, async: false, renderer: INERT_RENDERER });
+    const title = path.basename(file);
+    return `<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="utf-8">

package/lib/paths.js

@@ -0,0 +1,83 @@
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import path from "node:path";
+import fs from "node:fs";
+// Bump this when the CLI and detached server no longer share the same request
+// contract. A new CLI must not silently reuse an older background server.
+export const SERVER_PROTOCOL = 17;
+export function serverProtocolMatches(protocol) {
+    return Number(protocol) === SERVER_PROTOCOL;
+}
+export function stateDir() {
+    const override = process.env.DOC_REVIEW_STATE_DIR;
+    return override ? path.resolve(override) : path.join(homedir(), ".doc-review");
+}
+export function statePath() {
+    return path.join(stateDir(), "state.json");
+}
+export function serverPath() {
+    return path.join(stateDir(), "server.json");
+}
+export function serverLockPath() {
+    return path.join(stateDir(), "server.lock");
+}
+export function ensureStateDir() {
+    // Comments and the server token live here; keep it private to the user.
+    fs.mkdirSync(stateDir(), { recursive: true, mode: 0o700 });
+}
+const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "[::1]"]);
+/**
+ * Return a canonical loopback URL, or null when the input is a filesystem path.
+ * HTTP-looking non-loopback targets fail loudly instead of becoming odd paths.
+ */
+export function localUrl(target) {
+    const value = String(target || "");
+    if (!/^https?:\/\//i.test(value))
+        return null;
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new Error(`Invalid localhost URL: ${value}`);
+    }
+    if (!LOOPBACK_HOSTS.has(parsed.hostname)) {
+        throw new Error("doc-review URL support is limited to localhost, 127.0.0.1, and [::1].");
+    }
+    if (parsed.username || parsed.password) {
+        throw new Error("Localhost review URLs cannot contain credentials.");
+    }
+    parsed.hash = "";
+    return parsed.href;
+}
+/** Canonical identity for a page: the real path of the file on disk. */
+export function pageKey(file) {
+    let real = path.resolve(file);
+    try {
+        real = fs.realpathSync(real);
+    }
+    catch {
+        // File may not exist yet; the resolved path is still a stable identity.
+    }
+    return createHash("sha256").update(real).digest("hex").slice(0, 16);
+}
+/** Stable identity for either an existing file target or a localhost URL. */
+export function targetKey(target) {
+    const url = localUrl(target);
+    if (!url)
+        return pageKey(target);
+    return createHash("sha256").update(`url:${url}`).digest("hex").slice(0, 16);
+}
+export function canonicalTarget(target) {
+    const url = localUrl(target);
+    return url ? { kind: "url", value: url } : { kind: "file", value: realFile(target) };
+}
+export function realFile(file) {
+    const resolved = path.resolve(file);
+    try {
+        return fs.realpathSync(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}