@youtyan/code-viewer 0.1.24 → 0.1.26

package/dist/code-viewer.js

@@ -6,14 +6,17 @@ import {
   constants,
   existsSync as existsSync3,
   lstatSync as lstatSync3,
+  mkdirSync,
   openSync,
   readFileSync as readFileSync2,
   realpathSync,
+  renameSync,
   statSync,
   unlinkSync,
   watch,
   writeFileSync
 } from "node:fs";
+import { homedir } from "node:os";
 import { basename as basename2, dirname as dirname2, extname, join as join4, relative } from "node:path";
 
 // web-src/routes.ts
@@ -313,6 +316,13 @@ function objectByteSize(oid, cwd) {
     stderr: res.stderr
   };
 }
+function lastCommitDateForPath(ref, path, cwd) {
+  const args = ["git", "log", "-1", "--format=%cI", ref, "--", path];
+  const res = run(args, cwd);
+  if (res.code !== 0)
+    return null;
+  return res.stdout.trim() || null;
+}
 function objectId(ref, path, cwd) {
   const res = run(["git", "rev-parse", "--verify", `${ref}:${path}`], cwd);
   const oid = res.stdout.trim();
@@ -561,7 +571,13 @@ function omittedWorktreeDirectoryReason(name, omitDirNames) {
     return "internal";
   return omitDirNames.has(name) ? "heavy" : undefined;
 }
-function worktreeEntryFromDirent(base, dir, name, isDirectory, omitDirNames) {
+function worktreeEntryFromDirent(base, dir, name, isDirectory, omitDirNames, excludeNames) {
+  if (excludeNames.has(name.toLowerCase()))
+    return {
+      name,
+      path: "",
+      type: isDirectory ? "tree" : "blob"
+    };
   const entryPath = base ? `${base}/${name}` : name;
   const type = isDirectory ? hasDotGitEntry(join2(dir, name)) ? "commit" : "tree" : "blob";
   const omittedReason = type === "tree" ? omittedWorktreeDirectoryReason(name, omitDirNames) : undefined;
@@ -573,14 +589,15 @@ function worktreeEntryFromDirent(base, dir, name, isDirectory, omitDirNames) {
     children_omitted_reason: omittedReason
   } : { name, path: entryPath, type };
 }
-function worktreeFilesystemEntries(cwd, path, recursive, omitDirNames = DEFAULT_WORKTREE_OMIT_DIR_NAMES) {
+function worktreeFilesystemEntries(cwd, path, recursive, omitDirNames = DEFAULT_WORKTREE_OMIT_DIR_NAMES, excludeNames = []) {
   const base = normalizeTreePath(path);
   const root = join2(cwd, base);
   const omitDirNameSet = new Set(omitDirNames);
+  const excludeNameSet = new Set(excludeNames.map((name) => name.toLowerCase()));
   let directEntries;
   try {
     const dirents = readdirSync(root, { withFileTypes: true });
-    directEntries = sortTreeEntries(dirents.map((entry) => worktreeEntryFromDirent(base, root, entry.name, entry.isDirectory(), omitDirNameSet)));
+    directEntries = sortTreeEntries(dirents.map((entry) => worktreeEntryFromDirent(base, root, entry.name, entry.isDirectory(), omitDirNameSet, excludeNameSet)).filter((entry) => entry.path));
   } catch {
     return [];
   }
@@ -617,6 +634,8 @@ function worktreeFilesystemEntries(cwd, path, recursive, omitDirNames = DEFAULT_
       return;
     }
     for (const entry of entries) {
+      if (excludeNameSet.has(entry.name.toLowerCase()))
+        continue;
       const entryPath = prefix ? `${prefix}/${entry.name}` : entry.name;
       const full = join2(dir, entry.name);
       if (entry.isDirectory()) {
@@ -692,15 +711,12 @@ function combineDirectAndRecursiveFiles(directEntries, fileEntries) {
     ...fileEntries.filter((entry) => !seen.has(entry.path))
   ];
 }
-function worktreeFiles(cwd) {
-  return listTree("worktree", "", cwd, { recursive: true }).entries;
-}
 function listTree(ref, path, cwd, options = {}) {
   const base = normalizeTreePath(path);
   if (ref === "worktree") {
     return {
       code: 0,
-      entries: worktreeFilesystemEntries(cwd, base, !!options.recursive, options.omitDirNames),
+      entries: worktreeFilesystemEntries(cwd, base, !!options.recursive, options.omitDirNames, options.excludeNames),
       stderr: ""
     };
   }
@@ -1092,17 +1108,19 @@ var GREP_DEFAULT_MAX = 200;
 var GREP_ABSOLUTE_MAX = 500;
 var GREP_MAX_FILE_BYTES = 2 * 1024 * 1024;
 var FILE_SEARCH_ABSOLUTE_MAX = 50000;
+var DEFAULT_EXCLUDE_NAMES = [".DS_Store"];
 function normalizeGrepMax(value) {
   const parsed = Number(value || "");
   if (!Number.isInteger(parsed) || parsed <= 0)
     return GREP_DEFAULT_MAX;
   return Math.min(parsed, GREP_ABSOLUTE_MAX);
 }
-function isSkippableSearchPath(path, omitDirNames = []) {
+function isSkippableSearchPath(path, omitDirNames = [], excludeNames = []) {
   const omitDirs = new Set(omitDirNames.map((name) => name.toLowerCase()));
+  const excluded = new Set(excludeNames.map((name) => name.toLowerCase()));
   return path.split(/[\\/]+/).some((part) => {
     const lower = part.toLowerCase();
-    return lower === ".git" || omitDirs.has(lower);
+    return lower === ".git" || omitDirs.has(lower) || excluded.has(lower);
   });
 }
 function fixedStringLineMatches(path, text, query, max) {
@@ -1135,7 +1153,7 @@ function buildFileSearchList(ref, generation, entries) {
     truncated: entries.length > FILE_SEARCH_ABSOLUTE_MAX
   };
 }
-function buildRgArgs(query, max, paths, regex = false, omitDirNames = []) {
+function buildRgArgs(query, max, paths, regex = false, omitDirNames = [], excludeNames = []) {
   const safePaths = paths.length ? paths : ["."];
   const omitGlobs = omitDirNames.flatMap((name) => [
     "--glob",
@@ -1143,6 +1161,12 @@ function buildRgArgs(query, max, paths, regex = false, omitDirNames = []) {
     "--glob",
     `!**/${name}/**`
   ]);
+  const excludeGlobs = excludeNames.flatMap((name) => [
+    "--glob",
+    `!${name}`,
+    "--glob",
+    `!**/${name}`
+  ]);
   const args = [
     "rg",
     "--no-config",
@@ -1157,6 +1181,7 @@ function buildRgArgs(query, max, paths, regex = false, omitDirNames = []) {
     "--max-filesize",
     "2M",
     ...omitGlobs,
+    ...excludeGlobs,
     "-e",
     query,
     "--",
@@ -1166,7 +1191,7 @@ function buildRgArgs(query, max, paths, regex = false, omitDirNames = []) {
     args.splice(8, 0, "--fixed-strings");
   return args;
 }
-function parseRgOutput(stdout, max, omitDirNames = []) {
+function parseRgOutput(stdout, max, omitDirNames = [], excludeNames = []) {
   const matches = [];
   for (const line of stdout.split(`
 `)) {
@@ -1179,7 +1204,7 @@ function parseRgOutput(stdout, max, omitDirNames = []) {
     const lineNo = Number(parsed[2]);
     const column = Number(parsed[3]);
     const preview = parsed[4];
-    if (!path || !lineNo || !column || isSkippableSearchPath(path, omitDirNames))
+    if (!path || !lineNo || !column || isSkippableSearchPath(path, omitDirNames, excludeNames))
       continue;
     matches.push({
       path,
@@ -1190,12 +1215,12 @@ function parseRgOutput(stdout, max, omitDirNames = []) {
   }
   return matches;
 }
-function parseGitGrepOutput(stdout, ref, max, omitDirNames = []) {
+function parseGitGrepOutput(stdout, ref, max, omitDirNames = [], excludeNames = []) {
   const prefix = `${ref}:`;
   const normalized = stdout.split(`
 `).map((line) => line.startsWith(prefix) ? line.slice(prefix.length) : line).join(`
 `);
-  return parseRgOutput(normalized, max, omitDirNames);
+  return parseRgOutput(normalized, max, omitDirNames, excludeNames);
 }
 
 // web-src/server/preview.ts
@@ -1248,6 +1273,7 @@ var uploadAllowedByCli = false;
 var openAfterStart = false;
 var scopeOmitDirNames = DEFAULT_WORKTREE_OMIT_DIR_NAMES;
 var scopeOmitDirCliOverride = null;
+var scopeExcludeNames = DEFAULT_EXCLUDE_NAMES;
 var rgAvailableCache = null;
 var enc = new TextEncoder;
 var sseClients = new Set;
@@ -1322,11 +1348,14 @@ Examples:
   if (!uploadAllowedByCli)
     allowUpload = loadProjectConfigUploadEnabled();
   const configScopeOmitDirs = loadProjectConfigScopeOmitDirs();
+  const configScopeExcludeNames = loadProjectConfigScopeExcludeNames();
   if (scopeOmitDirCliOverride) {
     scopeOmitDirNames = scopeOmitDirCliOverride;
   } else if (configScopeOmitDirs) {
     scopeOmitDirNames = configScopeOmitDirs;
   }
+  if (configScopeExcludeNames)
+    scopeExcludeNames = configScopeExcludeNames;
 }
 function json(data, init = {}) {
   return new Response(JSON.stringify(data), {
@@ -1599,6 +1628,13 @@ function normalizeScopeOmitDirNames(names) {
     ...new Set(names.filter((name) => typeof name === "string").map((name) => name.trim()).filter((name) => name && name.length <= 64 && !name.includes("/") && !name.includes("\\") && !name.includes("\x00") && name !== "." && name !== ".." && name !== ".git"))
   ].sort((a, b) => a.localeCompare(b));
 }
+function normalizeScopeExcludeNames(names) {
+  if (!Array.isArray(names))
+    return [];
+  return [
+    ...new Set(names.filter((name) => typeof name === "string").map((name) => name.trim()).filter((name) => name && name.length <= 128 && !name.includes("/") && !name.includes("\\") && !name.includes("\x00") && name !== "." && name !== ".." && name !== ".git"))
+  ].sort((a, b) => a.localeCompare(b));
+}
 function parseScopeOmitDirNamesQuery(value) {
   const names = value ? value.split(",") : [];
   if (names.length > 100)
@@ -1610,6 +1646,17 @@ function parseScopeOmitDirNamesQuery(value) {
   }
   return normalizeScopeOmitDirNames(names);
 }
+function parseScopeExcludeNamesQuery(value) {
+  const names = value ? value.split(",") : [];
+  if (names.length > 200)
+    return null;
+  for (const raw of names) {
+    const name = raw.trim();
+    if (!name || name.length > 128 || name.includes("/") || name.includes("\\") || name.includes("\x00") || name === "." || name === ".." || name === ".git")
+      return null;
+  }
+  return normalizeScopeExcludeNames(names);
+}
 function loadProjectConfig() {
   const full = join4(cwd, ".code-viewer.json");
   if (!existsSync3(full))
@@ -1643,14 +1690,31 @@ function loadProjectConfigScopeOmitDirs() {
     return null;
   return normalizeScopeOmitDirNames(config.scope.omitDirs);
 }
+function loadProjectConfigScopeExcludeNames() {
+  const config = loadProjectConfig();
+  if (!config?.scope || !Array.isArray(config.scope.excludeNames))
+    return null;
+  return normalizeScopeExcludeNames(config.scope.excludeNames);
+}
 function scopeOmitDirNamesFromQuery(url) {
   if (!url.searchParams.has("omit_dirs"))
     return scopeOmitDirNames;
   return parseScopeOmitDirNamesQuery(url.searchParams.get("omit_dirs") || "") || scopeOmitDirNames;
 }
+function scopeExcludeNamesFromQuery(url) {
+  if (!url.searchParams.has("exclude_names"))
+    return scopeExcludeNames;
+  return parseScopeExcludeNamesQuery(url.searchParams.get("exclude_names") || "") || scopeExcludeNames;
+}
 function invalidScopeOmitDirNamesQuery(url) {
   return url.searchParams.has("omit_dirs") && !parseScopeOmitDirNamesQuery(url.searchParams.get("omit_dirs") || "");
 }
+function invalidScopeExcludeNamesQuery(url) {
+  return url.searchParams.has("exclude_names") && !parseScopeExcludeNamesQuery(url.searchParams.get("exclude_names") || "");
+}
+function isExcludedScopePath(path, excludeNames) {
+  return path.split(/[\\/]+/).some((part) => excludeNames.some((name) => part.toLowerCase() === name.toLowerCase()));
+}
 function isGitInternalPath(path) {
   return path.split(/[\\/]+/).some((part) => part.toLowerCase() === ".git");
 }
@@ -1677,6 +1741,9 @@ function safeWorktreePath(path) {
     return null;
   return realFull;
 }
+function worktreePath(path) {
+  return join4(cwd, path);
+}
 function safeOpenWorktreePath(path) {
   if (path === "") {
     try {
@@ -1694,6 +1761,71 @@ function parentRepoPath(path) {
   const parent = dirname2(path);
   return parent === "." ? "" : parent;
 }
+function isoDate(ms) {
+  return ms && Number.isFinite(ms) ? new Date(ms).toISOString() : undefined;
+}
+function worktreeFileMetadata(path, knownSize) {
+  const full = safeWorktreePath(path);
+  if (!full)
+    return {};
+  try {
+    const stat = statSync(full);
+    return {
+      size: knownSize ?? stat.size,
+      created_at: isoDate(stat.birthtimeMs),
+      updated_at: isoDate(stat.mtimeMs)
+    };
+  } catch {
+    return {};
+  }
+}
+function gitFileMetadata(ref, path, knownSize) {
+  const size = knownSize ?? rawFileSize(path, ref);
+  const commitUpdatedAt = lastCommitDateForPath(ref, path, cwd) || undefined;
+  return {
+    size: size == null ? undefined : size,
+    updated_at: commitUpdatedAt,
+    commit_updated_at: commitUpdatedAt
+  };
+}
+function directoryMetadata(target, path) {
+  if (target === "worktree" || target === "") {
+    const full = path === "" ? safeOpenWorktreePath("") : safeWorktreePath(path);
+    if (!full)
+      return {};
+    try {
+      const stat = statSync(full);
+      return {
+        created_at: isoDate(stat.birthtimeMs),
+        updated_at: isoDate(stat.mtimeMs)
+      };
+    } catch {
+      return {};
+    }
+  }
+  const commitUpdatedAt = lastCommitDateForPath(target, path || ".", cwd) || undefined;
+  return { updated_at: commitUpdatedAt, commit_updated_at: commitUpdatedAt };
+}
+function fileMetadataForTarget(target, path) {
+  return target === "worktree" || target === "" ? worktreeFileMetadata(path) : gitFileMetadata(target, path);
+}
+function attachTreeEntryMetadata(target, entry) {
+  if (entry.type === "tree")
+    return { ...entry, ...directoryMetadata(target, entry.path) };
+  if (entry.type !== "blob")
+    return entry;
+  return { ...entry, ...fileMetadataForTarget(target, entry.path) };
+}
+function fileMetadataHeaders(metadata) {
+  const headers = {};
+  if (metadata.created_at)
+    headers["X-Code-Viewer-Created-At"] = metadata.created_at;
+  if (metadata.updated_at)
+    headers["X-Code-Viewer-Updated-At"] = metadata.updated_at;
+  if (metadata.commit_updated_at)
+    headers["X-Code-Viewer-Commit-Updated-At"] = metadata.commit_updated_at;
+  return headers;
+}
 function readReadme(target, dirPath) {
   const candidates = ["README.md", "readme.md", "README.markdown", "README"];
   for (const name of candidates) {
@@ -1726,16 +1858,20 @@ function handleTree(url) {
   const recursive = url.searchParams.get("recursive") === "1";
   if (invalidScopeOmitDirNamesQuery(url))
     return text("invalid omit dirs", 400);
+  if (invalidScopeExcludeNamesQuery(url))
+    return text("invalid exclude names", 400);
+  const excludeNames = scopeExcludeNamesFromQuery(url);
   const entries = listTree(target, path, cwd, {
     recursive,
-    omitDirNames: scopeOmitDirNamesFromQuery(url)
-  }).entries;
+    omitDirNames: scopeOmitDirNamesFromQuery(url),
+    excludeNames
+  }).entries.filter((entry) => !isExcludedScopePath(entry.path, excludeNames));
   return json({
     ref: target,
     path,
     project: basename2(cwd),
     branch: currentBranch(cwd) || undefined,
-    entries,
+    entries: recursive ? entries : entries.map((entry) => attachTreeEntryMetadata(target, entry)),
     readme: readReadme(target, path),
     upload_enabled: allowUpload && (target === "worktree" || target === "")
   });
@@ -1746,6 +1882,8 @@ function handleSettings() {
     scope: {
       omit_dirs_effective: scopeOmitDirNames,
       omit_dirs_built_in: DEFAULT_WORKTREE_OMIT_DIR_NAMES,
+      exclude_names_effective: scopeExcludeNames,
+      exclude_names_built_in: DEFAULT_EXCLUDE_NAMES,
       max_entries: WORKTREE_RECURSIVE_ENTRY_LIMIT
     }
   });
@@ -1756,22 +1894,26 @@ function handleFiles(url) {
     return text("invalid target", 400);
   if (invalidScopeOmitDirNamesQuery(url))
     return text("invalid omit dirs", 400);
+  if (invalidScopeExcludeNamesQuery(url))
+    return text("invalid exclude names", 400);
   const omitDirNames = scopeOmitDirNamesFromQuery(url);
-  const key = `${target || "worktree"}\x00${omitDirNames.join("\x00")}`;
+  const excludeNames = scopeExcludeNamesFromQuery(url);
+  const key = `${target || "worktree"}\x00${omitDirNames.join("\x00")}\x00${excludeNames.join("\x00")}`;
   const cached = fileListCache.get(key);
   if (cached && cached.generation === generation)
     return json(cached.body);
   const ref = target || "worktree";
   const entries = listTree(ref, "", cwd, {
     recursive: true,
-    omitDirNames
-  }).entries;
+    omitDirNames,
+    excludeNames
+  }).entries.filter((entry) => !isExcludedScopePath(entry.path, excludeNames));
   const body = buildFileSearchList(ref, generation, entries);
   fileListCache.set(key, { generation, body });
   return json(body);
 }
-function parseGrepPaths(url, omitDirNames) {
-  return url.searchParams.getAll("path").filter((path) => safePath(path) && !isGitInternalPath(path) && !isSkippableSearchPath(path, omitDirNames));
+function parseGrepPaths(url, omitDirNames, excludeNames) {
+  return url.searchParams.getAll("path").filter((path) => safePath(path) && !isGitInternalPath(path) && !isSkippableSearchPath(path, omitDirNames, excludeNames));
 }
 function rgAvailable() {
   if (rgAvailableCache !== null)
@@ -1780,13 +1922,17 @@ function rgAvailable() {
   rgAvailableCache = proc.code === 0;
   return rgAvailableCache;
 }
-function grepWorktreeFallback(query, max, paths, omitDirNames) {
-  const candidates = paths.length ? paths : worktreeFiles(cwd).map((entry) => entry.path);
+function grepWorktreeFallback(query, max, paths, omitDirNames, excludeNames) {
+  const candidates = paths.length ? paths : listTree("worktree", "", cwd, {
+    recursive: true,
+    omitDirNames,
+    excludeNames
+  }).entries.map((entry) => entry.path);
   const matches = [];
   for (const path of candidates) {
     if (matches.length >= max)
       break;
-    if (!safePath(path) || isGitInternalPath(path) || isSkippableSearchPath(path, omitDirNames))
+    if (!safePath(path) || isGitInternalPath(path) || isSkippableSearchPath(path, omitDirNames, excludeNames))
       continue;
     const full = safeWorktreePath(path);
     if (!full)
@@ -1811,13 +1957,13 @@ function grepWorktreeFallback(query, max, paths, omitDirNames) {
   }
   return matches;
 }
-function grepWorktree(query, max, paths, regex, omitDirNames) {
+function grepWorktree(query, max, paths, regex, omitDirNames, excludeNames) {
   if (rgAvailable()) {
-    const safePaths = paths.filter((path) => safePath(path) && !isGitInternalPath(path) && !isSkippableSearchPath(path, omitDirNames) && safeWorktreePath(path));
-    const args = buildRgArgs(query, max, safePaths, regex, omitDirNames);
+    const safePaths = paths.filter((path) => safePath(path) && !isGitInternalPath(path) && !isSkippableSearchPath(path, omitDirNames, excludeNames) && safeWorktreePath(path));
+    const args = buildRgArgs(query, max, safePaths, regex, omitDirNames, excludeNames);
     const proc = runSync(args, cwd, { timeout: 5000 });
     const stdout = proc.stdout;
-    const matches2 = parseRgOutput(stdout, max, omitDirNames).filter((match) => safePath(match.path) && !isGitInternalPath(match.path) && !isSkippableSearchPath(match.path, omitDirNames) && !!safeWorktreePath(match.path));
+    const matches2 = parseRgOutput(stdout, max, omitDirNames, excludeNames).filter((match) => safePath(match.path) && !isGitInternalPath(match.path) && !isSkippableSearchPath(match.path, omitDirNames, excludeNames) && !!safeWorktreePath(match.path));
     return {
       ref: "worktree",
       engine: "rg",
@@ -1832,7 +1978,7 @@ function grepWorktree(query, max, paths, regex, omitDirNames) {
       truncated: false,
       matches: []
     };
-  const matches = grepWorktreeFallback(query, max, paths, omitDirNames);
+  const matches = grepWorktreeFallback(query, max, paths, omitDirNames, excludeNames);
   return {
     ref: "worktree",
     engine: "fallback",
@@ -1840,8 +1986,8 @@ function grepWorktree(query, max, paths, regex, omitDirNames) {
     matches
   };
 }
-function grepTreeRef(ref, query, max, paths, regex, omitDirNames) {
-  const safePaths = paths.filter((path) => safePath(path) && !isGitInternalPath(path) && !isSkippableSearchPath(path, omitDirNames));
+function grepTreeRef(ref, query, max, paths, regex, omitDirNames, excludeNames) {
+  const safePaths = paths.filter((path) => safePath(path) && !isGitInternalPath(path) && !isSkippableSearchPath(path, omitDirNames, excludeNames));
   const args = [
     "git",
     "-c",
@@ -1860,7 +2006,7 @@ function grepTreeRef(ref, query, max, paths, regex, omitDirNames) {
   ];
   const proc = runSync(args, cwd, { timeout: 5000 });
   const stdout = proc.stdout;
-  const matches = parseGitGrepOutput(stdout, ref, max, omitDirNames).slice(0, max);
+  const matches = parseGitGrepOutput(stdout, ref, max, omitDirNames, excludeNames).slice(0, max);
   return { ref, engine: "git", truncated: matches.length >= max, matches };
 }
 function handleGrep(url) {
@@ -1869,8 +2015,11 @@ function handleGrep(url) {
   const max = normalizeGrepMax(url.searchParams.get("max"));
   if (invalidScopeOmitDirNamesQuery(url))
     return text("invalid omit dirs", 400);
+  if (invalidScopeExcludeNamesQuery(url))
+    return text("invalid exclude names", 400);
   const omitDirNames = scopeOmitDirNamesFromQuery(url);
-  const paths = parseGrepPaths(url, omitDirNames);
+  const excludeNames = scopeExcludeNamesFromQuery(url);
+  const paths = parseGrepPaths(url, omitDirNames, excludeNames);
   const regex = url.searchParams.get("regex") === "1";
   if (!query.trim())
     return json({
@@ -1880,10 +2029,10 @@ function handleGrep(url) {
       matches: []
     });
   if (ref === "worktree" || ref === "")
-    return json(grepWorktree(query, max, paths, regex, omitDirNames));
+    return json(grepWorktree(query, max, paths, regex, omitDirNames, excludeNames));
   if (!verifyTreeRef(ref, cwd))
     return text("invalid target", 400);
-  return json(grepTreeRef(ref, query, max, paths, regex, omitDirNames));
+  return json(grepTreeRef(ref, query, max, paths, regex, omitDirNames, excludeNames));
 }
 function handleRefCommits(url) {
   const query = url.searchParams.get("q") || "";
@@ -2169,13 +2318,18 @@ function handleRawFile(req, url) {
     const size = rawFileSize(path, ref);
     if (size == null)
       return text("not in ref", 404);
+    const metadata = gitFileMetadata(ref, path, size);
     if (req.method === "HEAD")
-      return new Response(null, { headers: rawFileHeaders(path, size) });
+      return new Response(null, {
+        headers: rawFileHeaders(path, size, undefined, metadata)
+      });
     const res = showBytes(ref, path, cwd);
     if (res.code !== 0)
       return text("not in ref", 404);
     body = res.stdout.buffer.slice(res.stdout.byteOffset, res.stdout.byteOffset + res.stdout.byteLength);
-    return new Response(body, { headers: rawFileHeaders(path, size) });
+    return new Response(body, {
+      headers: rawFileHeaders(path, size, undefined, metadata)
+    });
   } else {
     const full = safeWorktreePath(path);
     if (!full)
@@ -2183,12 +2337,13 @@ function handleRawFile(req, url) {
     const size = rawFileSize(path, ref);
     if (size == null)
       return text("not found", 404);
+    const metadata = worktreeFileMetadata(path, size);
     const rangeResult = req.headers.get("range") ? parseHttpByteRange(req.headers.get("range"), size) : null;
     if (rangeResult?.kind === "unsatisfiable") {
       return new Response(null, {
         status: 416,
         headers: {
-          ...rawFileHeaders(path, size),
+          ...rawFileHeaders(path, size, undefined, metadata),
           "Content-Range": `bytes */${size}`,
           "Content-Length": "0"
         }
@@ -2199,18 +2354,20 @@ function handleRawFile(req, url) {
       if (req.method === "HEAD") {
         return new Response(null, {
           status: 206,
-          headers: rawFileHeaders(path, size, range)
+          headers: rawFileHeaders(path, size, range, metadata)
         });
       }
       return new Response(fileByteRangeResponseBody(full, range.start, range.end), {
         status: 206,
-        headers: rawFileHeaders(path, size, range)
+        headers: rawFileHeaders(path, size, range, metadata)
       });
     }
     if (req.method === "HEAD")
-      return new Response(null, { headers: rawFileHeaders(path, size) });
+      return new Response(null, {
+        headers: rawFileHeaders(path, size, undefined, metadata)
+      });
     return new Response(fileReadableStream(full), {
-      headers: rawFileHeaders(path, size)
+      headers: rawFileHeaders(path, size, undefined, metadata)
     });
   }
 }
@@ -2230,7 +2387,7 @@ function rawFileSize(path, ref) {
     return null;
   }
 }
-function rawFileHeaders(path, size = null, range) {
+function rawFileHeaders(path, size = null, range, metadata = {}) {
   const mime = {
     ".png": "image/png",
     ".jpg": "image/jpeg",
@@ -2263,6 +2420,9 @@ function rawFileHeaders(path, size = null, range) {
   } else if (size != null) {
     headers["Content-Length"] = String(size);
   }
+  for (const [key, value] of Object.entries(fileMetadataHeaders(metadata))) {
+    headers[key] = value;
+  }
   return headers;
 }
 function isForbiddenUploadName(name) {
@@ -2385,6 +2545,152 @@ function openOsPath(path) {
   const cmd = process.platform === "darwin" ? ["open", "--", path] : process.platform === "win32" ? ["explorer.exe", path] : ["xdg-open", path];
   spawnDetached(cmd);
 }
+function windowsTrashScript(path) {
+  const quotedPath = path.replace(/'/g, "''");
+  return [
+    "$ErrorActionPreference = 'Stop';",
+    `$path = '${quotedPath}';`,
+    "Add-Type -TypeDefinition @'",
+    "using System;",
+    "using System.Runtime.InteropServices;",
+    "public static class CodeViewerRecycleBin {",
+    "  [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]",
+    "  public struct SHFILEOPSTRUCT {",
+    "    public IntPtr hwnd;",
+    "    public uint wFunc;",
+    "    public string pFrom;",
+    "    public string pTo;",
+    "    public ushort fFlags;",
+    "    [MarshalAs(UnmanagedType.Bool)] public bool fAnyOperationsAborted;",
+    "    public IntPtr hNameMappings;",
+    "    public string lpszProgressTitle;",
+    "  }",
+    '  [DllImport("shell32.dll", CharSet = CharSet.Unicode)]',
+    "  private static extern int SHFileOperationW(ref SHFILEOPSTRUCT lpFileOp);",
+    "  public static void MoveToRecycleBin(string path) {",
+    "    const uint FO_DELETE = 0x0003;",
+    "    const ushort FOF_SILENT = 0x0004;",
+    "    const ushort FOF_NOCONFIRMATION = 0x0010;",
+    "    const ushort FOF_ALLOWUNDO = 0x0040;",
+    "    const ushort FOF_NOERRORUI = 0x0400;",
+    "    var op = new SHFILEOPSTRUCT {",
+    "      hwnd = IntPtr.Zero,",
+    "      wFunc = FO_DELETE,",
+    '      pFrom = path + "\\0\\0",',
+    "      pTo = null,",
+    "      fFlags = (ushort)(FOF_ALLOWUNDO | FOF_NOCONFIRMATION | FOF_NOERRORUI | FOF_SILENT),",
+    "      fAnyOperationsAborted = false,",
+    "      hNameMappings = IntPtr.Zero,",
+    "      lpszProgressTitle = null",
+    "    };",
+    "    int result = SHFileOperationW(ref op);",
+    '    if (result != 0) throw new InvalidOperationException("SHFileOperationW failed: " + result);',
+    '    if (op.fAnyOperationsAborted) throw new OperationCanceledException("SHFileOperationW aborted");',
+    "  }",
+    "}",
+    "'@;",
+    "[CodeViewerRecycleBin]::MoveToRecycleBin($path);"
+  ].join(" ");
+}
+function windowsRestoreTrashScript(originalPath) {
+  const quotedPath = originalPath.replace(/'/g, "''");
+  return [
+    "$ErrorActionPreference = 'Stop';",
+    `$original = '${quotedPath}';`,
+    "$parent = [System.IO.Path]::GetDirectoryName($original);",
+    "$name = [System.IO.Path]::GetFileName($original);",
+    "$shell = New-Object -ComObject Shell.Application;",
+    "$bin = $shell.Namespace(10);",
+    "$restored = $false;",
+    "foreach ($item in $bin.Items()) {",
+    "  $deletedFrom = $item.ExtendedProperty('System.Recycle.DeletedFrom');",
+    "  if ($item.Name -eq $name -and $deletedFrom -eq $parent) {",
+    "    $item.InvokeVerb('ESTORE');",
+    "    $restored = $true;",
+    "    break;",
+    "  }",
+    "}",
+    "if (-not $restored) { throw 'recycle bin item not found'; }"
+  ].join(" ");
+}
+function makeUndoId() {
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function clearMutableCaches() {
+  fileCache.clear();
+  metaCache.clear();
+  fileListCache.clear();
+}
+function moveMacPathIntoTrash(path) {
+  const trashDir = join4(homedir(), ".Trash");
+  const base = basename2(path) || "code-viewer-trash-item";
+  const target = join4(trashDir, `${base}-${Date.now()}-${process.pid}-${Math.random().toString(36).slice(2, 8)}`);
+  try {
+    mkdirSync(trashDir, { recursive: true });
+    renameSync(path, target);
+    return { ok: true, trashPath: target };
+  } catch (error) {
+    return { ok: false, error: String(error) };
+  }
+}
+function movePathToTrash(path) {
+  lstatSync3(path);
+  if (process.platform === "darwin") {
+    return moveMacPathIntoTrash(path);
+  }
+  if (process.platform === "win32") {
+    const res = runSync([
+      "powershell.exe",
+      "-NoProfile",
+      "-NonInteractive",
+      "-ExecutionPolicy",
+      "Bypass",
+      "-Command",
+      windowsTrashScript(path)
+    ], cwd, { timeout: 60000 });
+    return res.code === 0 ? { ok: true } : { ok: false, error: res.stderr || res.stdout };
+  }
+  return { ok: false, error: "trash unsupported" };
+}
+function restoreTrashPath(originalPath, trashPath) {
+  const parent = parentRepoPath(originalPath);
+  const parentFullPath = safeOpenWorktreePath(parent);
+  if (!parentFullPath)
+    return { ok: false, error: "invalid restore target" };
+  const original = worktreePath(originalPath);
+  if (existsSync3(original))
+    return { ok: false, error: "restore target exists" };
+  if (trashPath) {
+    if (process.platform !== "darwin")
+      return { ok: false, error: "invalid trash handle" };
+    if (!existsSync3(trashPath))
+      return { ok: false, error: "trash item not found" };
+    try {
+      const trashRoot = join4(homedir(), ".Trash");
+      const trashRelative = relative(trashRoot, trashPath);
+      if (trashRelative === "" || trashRelative.startsWith("..") || trashRelative.startsWith("/") || trashRelative.startsWith("\\"))
+        return { ok: false, error: "invalid trash handle" };
+      mkdirSync(dirname2(original), { recursive: true });
+      renameSync(trashPath, original);
+      return { ok: true };
+    } catch (error) {
+      return { ok: false, error: String(error) };
+    }
+  }
+  if (process.platform === "win32") {
+    const res = runSync([
+      "powershell.exe",
+      "-NoProfile",
+      "-NonInteractive",
+      "-ExecutionPolicy",
+      "Bypass",
+      "-Command",
+      windowsRestoreTrashScript(original)
+    ], cwd, { timeout: 60000 });
+    return res.code === 0 ? { ok: true } : { ok: false, error: res.stderr || res.stdout };
+  }
+  return { ok: false, error: "undo unavailable for this trash operation" };
+}
 async function handleOpenPath(req) {
   if (req.method !== "POST")
     return text("method not allowed", 405);
@@ -2425,6 +2731,87 @@ async function handleOpenPath(req) {
   openOsPath(target);
   return json({ ok: true });
 }
+async function handleTrashPath(req) {
+  if (req.method !== "POST")
+    return text("method not allowed", 405);
+  if (!sideEffectRequestAllowed(req))
+    return text("forbidden", 403);
+  const contentType = req.headers.get("content-type") || "";
+  if (!/^application\/json(?:;|$)/i.test(contentType))
+    return text("unsupported media type", 415);
+  const length = Number(req.headers.get("content-length") || "0");
+  if (length > 1024)
+    return text("payload too large", 413);
+  let body = {};
+  try {
+    const raw = await req.text();
+    if (raw.length > 1024)
+      return text("payload too large", 413);
+    body = JSON.parse(raw);
+  } catch {
+    return text("invalid json", 400);
+  }
+  const path = typeof body.path === "string" ? body.path.replace(/^\/+|\/+$/g, "") : "";
+  if (!path)
+    return text("invalid path", 400);
+  if (!safeRepoPath(path))
+    return text("invalid path", 400);
+  if (isGitInternalPath(path))
+    return text("forbidden", 403);
+  const originalFullPath = safeWorktreePath(path);
+  if (!originalFullPath)
+    return text("not found", 404);
+  const moved = movePathToTrash(worktreePath(path));
+  if (!moved.ok)
+    return text(moved.error || "trash failed", 500);
+  const undo = {
+    id: makeUndoId(),
+    type: "trash",
+    label: `Restore ${path}`,
+    payload: {
+      original_path: path,
+      trashPath: moved.trashPath
+    }
+  };
+  generation++;
+  clearMutableCaches();
+  sendSse("update");
+  return json({ ok: true, generation, undo });
+}
+async function handleRestoreTrash(req) {
+  if (req.method !== "POST")
+    return text("method not allowed", 405);
+  if (!sideEffectRequestAllowed(req))
+    return text("forbidden", 403);
+  const contentType = req.headers.get("content-type") || "";
+  if (!/^application\/json(?:;|$)/i.test(contentType))
+    return text("unsupported media type", 415);
+  const length = Number(req.headers.get("content-length") || "0");
+  if (length > 1024)
+    return text("payload too large", 413);
+  let body = {};
+  try {
+    const raw = await req.text();
+    if (raw.length > 1024)
+      return text("payload too large", 413);
+    body = JSON.parse(raw);
+  } catch {
+    return text("invalid json", 400);
+  }
+  const originalPath = typeof body.original_path === "string" ? body.original_path.replace(/^\/+|\/+$/g, "") : "";
+  const trashPath = typeof body.trashPath === "string" ? body.trashPath : "";
+  if (!originalPath || !safeRepoPath(originalPath))
+    return text("invalid restore target", 400);
+  if (isGitInternalPath(originalPath))
+    return text("forbidden", 403);
+  const restored = restoreTrashPath(originalPath, trashPath || undefined);
+  if (!restored.ok)
+    return text(restored.error || "undo failed", 409);
+  generation++;
+  clearMutableCaches();
+  sendSse("update");
+  return json({ ok: true, generation });
+}
 function sendSse(event, data = "tick") {
   const payload = enc.encode(`event: ${event}
 data: ${data}
@@ -2473,6 +2860,10 @@ var server = await startServer({
       return handleRawFile(req, url);
     if (url.pathname === "/_open_path")
       return handleOpenPath(req);
+    if (url.pathname === "/_trash_path")
+      return handleTrashPath(req);
+    if (url.pathname === "/_restore_trash")
+      return handleRestoreTrash(req);
     if (url.pathname === "/_upload_files")
       return handleUploadFiles(req);
     if (url.pathname === "/_refs")
@@ -2481,9 +2872,7 @@ var server = await startServer({
       if (!sideEffectRequestAllowed(req))
         return text("forbidden", 403);
       generation++;
-      fileCache.clear();
-      metaCache.clear();
-      fileListCache.clear();
+      clearMutableCaches();
       sendSse("update");
       return json({ ok: true, generation });
     }