@youtyan/code-viewer 0.1.25 → 0.1.26

package/README.md

@@ -108,6 +108,9 @@ Repository scope settings control recursive repository browsing and search scope
 for the left tree, Ctrl+K file palette, and Ctrl+G grep palette. The in-app Scope
 Settings popover stores only a browser-local override in localStorage; edit
 `.code-viewer.json` directly for project defaults shared with the repository.
+Use `scope.omitDirs` for directories that should stay visible as skipped, and
+`scope.excludeNames` for file or directory names that should be hidden entirely.
+`.DS_Store` is hidden by default.
 
 ## Development
 

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
@@ -568,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;
@@ -580,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 [];
   }
@@ -624,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()) {
@@ -699,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: ""
     };
   }
@@ -1099,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) {
@@ -1142,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",
@@ -1150,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",
@@ -1164,6 +1181,7 @@ function buildRgArgs(query, max, paths, regex = false, omitDirNames = []) {
     "--max-filesize",
     "2M",
     ...omitGlobs,
+    ...excludeGlobs,
     "-e",
     query,
     "--",
@@ -1173,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(`
 `)) {
@@ -1186,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,
@@ -1197,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
@@ -1255,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;
@@ -1329,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), {
@@ -1606,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)
@@ -1617,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))
@@ -1650,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");
 }
@@ -1684,6 +1741,9 @@ function safeWorktreePath(path) {
     return null;
   return realFull;
 }
+function worktreePath(path) {
+  return join4(cwd, path);
+}
 function safeOpenWorktreePath(path) {
   if (path === "") {
     try {
@@ -1798,10 +1858,14 @@ 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,
@@ -1818,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
     }
   });
@@ -1828,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)
@@ -1852,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)
@@ -1883,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",
@@ -1904,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",
@@ -1912,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",
@@ -1932,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) {
@@ -1941,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({
@@ -1952,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") || "";
@@ -2468,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);
@@ -2508,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}
@@ -2556,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")
@@ -2564,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 });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youtyan/code-viewer",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Local browser-based code and git diff viewer",
   "type": "module",
   "bin": {

package/web/app.js

@@ -6947,6 +6947,8 @@ ${frontmatter.yaml}
       direction: "asc"
     };
     let SERVER_SCOPE_OMIT_DIRS_DEFAULT = [];
+    let SERVER_SCOPE_EXCLUDE_NAMES_DEFAULT = [];
+    const UNDO_STACK = [];
     let PENDING_G_SCOPE = null;
     let PENDING_G_UNTIL = 0;
     let SOURCE_CURSOR = null;
@@ -6954,6 +6956,7 @@ ${frontmatter.yaml}
     const HELP_LANGUAGES = ["en", "ja"];
     const HELP_SECTIONS = ["keybindings"];
     const SCOPE_OMIT_DIRS_STORAGE_KEY_PREFIX = "gdp:scope-omit-dirs:";
+    const SCOPE_EXCLUDE_NAMES_STORAGE_KEY_PREFIX = "gdp:scope-exclude-names:";
     const SIDEBAR_FONT_SIZE_STORAGE_KEY = "gdp:sidebar-font-size";
     const CODE_FONT_SIZE_STORAGE_KEY = "gdp:code-font-size";
     const CLIENT_SCOPE_OMIT_DIRS_DEFAULT = [
@@ -6984,6 +6987,7 @@ ${frontmatter.yaml}
       "bin",
       "obj"
     ];
+    const CLIENT_SCOPE_EXCLUDE_NAMES_DEFAULT = [".DS_Store"];
     const HELP_CONTENT = {
       en: {
         languageLabel: "Language",
@@ -7255,9 +7259,18 @@ ${frontmatter.yaml}
         ...new Set(raw.map((item) => item.trim()).filter((item) => item && item.length <= 64 && !item.includes("/") && !item.includes("\\") && item !== "." && item !== ".." && item !== ".git"))
       ].slice(0, 100).sort((a2, b2) => a2.localeCompare(b2));
     }
+    function normalizeScopeExcludeNames(value) {
+      const raw = Array.isArray(value) ? value : value.split(/[\n,]+/);
+      return [
+        ...new Set(raw.map((item) => item.trim()).filter((item) => item && item.length <= 128 && !item.includes("/") && !item.includes("\\") && item !== "." && item !== ".." && item !== ".git"))
+      ].slice(0, 200).sort((a2, b2) => a2.localeCompare(b2));
+    }
     function scopeOmitDirsStorageKey() {
       return SCOPE_OMIT_DIRS_STORAGE_KEY_PREFIX + (PROJECT_NAME || "default");
     }
+    function scopeExcludeNamesStorageKey() {
+      return SCOPE_EXCLUDE_NAMES_STORAGE_KEY_PREFIX + (PROJECT_NAME || "default");
+    }
     function setProjectName(project) {
       if (!project)
         return;
@@ -7275,16 +7288,36 @@ ${frontmatter.yaml}
         return normalizeScopeOmitDirs(raw);
       }
     }
+    function savedScopeExcludeNames() {
+      const raw = localStorage.getItem(scopeExcludeNamesStorageKey());
+      if (raw == null)
+        return null;
+      try {
+        const parsed = JSON.parse(raw);
+        return normalizeScopeExcludeNames(Array.isArray(parsed) ? parsed : []);
+      } catch {
+        return normalizeScopeExcludeNames(raw);
+      }
+    }
     function serverScopeOmitDirsDefault() {
       return SERVER_SCOPE_OMIT_DIRS_DEFAULT.length ? SERVER_SCOPE_OMIT_DIRS_DEFAULT : CLIENT_SCOPE_OMIT_DIRS_DEFAULT;
     }
+    function serverScopeExcludeNamesDefault() {
+      return SERVER_SCOPE_EXCLUDE_NAMES_DEFAULT.length ? SERVER_SCOPE_EXCLUDE_NAMES_DEFAULT : CLIENT_SCOPE_EXCLUDE_NAMES_DEFAULT;
+    }
     function effectiveScopeOmitDirs() {
       return savedScopeOmitDirs() ?? serverScopeOmitDirsDefault();
     }
-    function appendScopeOmitDirsParam(params) {
-      const saved = savedScopeOmitDirs();
-      if (saved != null)
-        params.set("omit_dirs", saved.join(","));
+    function effectiveScopeExcludeNames() {
+      return savedScopeExcludeNames() ?? serverScopeExcludeNamesDefault();
+    }
+    function appendScopeParams(params) {
+      const omit = savedScopeOmitDirs();
+      if (omit != null)
+        params.set("omit_dirs", omit.join(","));
+      const exclude = savedScopeExcludeNames();
+      if (exclude != null)
+        params.set("exclude_names", exclude.join(","));
     }
     function normalizeViewerFontSize(value) {
       return value === "compact" || value === "large" || value === "xlarge" ? value : "regular";
@@ -7319,8 +7352,9 @@ ${frontmatter.yaml}
       syncSidebarHeaderHeight();
     }
     function repoFileCacheKey(ref) {
-      const saved = savedScopeOmitDirs();
-      return `${ref}\x00${saved ? saved.join("\x00") : "server"}`;
+      const omit = savedScopeOmitDirs();
+      const exclude = savedScopeExcludeNames();
+      return `${ref}\x00${omit ? omit.join("\x00") : "server"}\x00${exclude ? exclude.join("\x00") : "server"}`;
     }
     async function loadSettings() {
       try {
@@ -7330,6 +7364,7 @@ ${frontmatter.yaml}
         const settings = await res.json();
         setProjectName(settings.project || "");
         SERVER_SCOPE_OMIT_DIRS_DEFAULT = normalizeScopeOmitDirs(settings.scope.omit_dirs_effective);
+        SERVER_SCOPE_EXCLUDE_NAMES_DEFAULT = normalizeScopeExcludeNames(settings.scope.exclude_names_effective);
         return settings;
       } catch {
         return null;
@@ -7671,7 +7706,7 @@ ${frontmatter.yaml}
       applySidebarHidden(!STATE.sidebarHidden);
     }
     function scopeOmitSourceLabel() {
-      return savedScopeOmitDirs() != null ? "Browser override" : "Server default";
+      return savedScopeOmitDirs() != null || savedScopeExcludeNames() != null ? "Browser override" : "Server default";
     }
     function refreshRepositoryTreeAfterSettings() {
       REPO_FILE_CACHE.clear();
@@ -7687,15 +7722,18 @@ ${frontmatter.yaml}
     async function openScopeSettings() {
       const pop = document.querySelector("#scope-settings-popover");
       const input = document.querySelector("#scope-omit-dirs");
+      const excludeInput = document.querySelector("#scope-exclude-names");
       const sidebarFontSize = document.querySelector("#sidebar-font-size");
       const codeFontSize = document.querySelector("#code-font-size");
       const source = document.querySelector("#scope-omit-source");
-      if (!pop || !input || !sidebarFontSize || !codeFontSize || !source)
+      if (!pop || !input || !excludeInput || !sidebarFontSize || !codeFontSize || !source)
         return;
       await loadSettings();
       sidebarFontSize.value = savedSidebarFontSize();
       codeFontSize.value = savedCodeFontSize();
       input.value = effectiveScopeOmitDirs().join(`
+`);
+      excludeInput.value = effectiveScopeExcludeNames().join(`
 `);
       source.textContent = 'Saved for project "' + (PROJECT_NAME || "default") + '" in this browser. Source: ' + scopeOmitSourceLabel() + ". Used by tree, Ctrl+K, and Ctrl+G. Reset removes the browser override.";
       pop.hidden = false;
@@ -7708,15 +7746,17 @@ ${frontmatter.yaml}
     }
     function saveScopeSettings() {
       const input = document.querySelector("#scope-omit-dirs");
+      const excludeInput = document.querySelector("#scope-exclude-names");
       const sidebarFontSize = document.querySelector("#sidebar-font-size");
       const codeFontSize = document.querySelector("#code-font-size");
-      if (!input || !sidebarFontSize || !codeFontSize)
+      if (!input || !excludeInput || !sidebarFontSize || !codeFontSize)
         return;
       localStorage.setItem(SIDEBAR_FONT_SIZE_STORAGE_KEY, normalizeViewerFontSize(sidebarFontSize.value));
       localStorage.setItem(CODE_FONT_SIZE_STORAGE_KEY, normalizeViewerFontSize(codeFontSize.value));
       applySidebarFontSize();
       applyCodeFontSize();
       localStorage.setItem(scopeOmitDirsStorageKey(), JSON.stringify(normalizeScopeOmitDirs(input.value)));
+      localStorage.setItem(scopeExcludeNamesStorageKey(), JSON.stringify(normalizeScopeExcludeNames(excludeInput.value)));
       closeScopeSettings();
       refreshRepositoryTreeAfterSettings();
     }
@@ -7726,6 +7766,7 @@ ${frontmatter.yaml}
       applySidebarFontSize("regular");
       applyCodeFontSize("regular");
       localStorage.removeItem(scopeOmitDirsStorageKey());
+      localStorage.removeItem(scopeExcludeNamesStorageKey());
       closeScopeSettings();
       refreshRepositoryTreeAfterSettings();
     }
@@ -7809,6 +7850,8 @@ ${frontmatter.yaml}
           li.className = "tree-dir";
           li.tabIndex = -1;
           li.dataset.dirpath = dir.path;
+          if (dir.children_omitted_reason)
+            li.dataset.childrenOmittedReason = dir.children_omitted_reason;
           if (dir.explicit)
             li.dataset.explicit = "true";
           if (dir.children_omitted) {
@@ -7952,6 +7995,8 @@ ${frontmatter.yaml}
       li.className = "tree-dir";
       li.tabIndex = -1;
       li.dataset.dirpath = dir.path;
+      if (dir.children_omitted_reason)
+        li.dataset.childrenOmittedReason = dir.children_omitted_reason;
       if (dir.explicit)
         li.dataset.explicit = "true";
       if (dir.children_omitted) {
@@ -8944,6 +8989,224 @@ ${frontmatter.yaml}
           button.disabled = false;
       }
     }
+    function closeRepoContextMenu() {
+      document.querySelector(".gdp-context-menu")?.remove();
+    }
+    function closeTrashDialog() {
+      document.querySelector(".gdp-trash-dialog-backdrop")?.remove();
+    }
+    function createTrashDialog(title, body, actions) {
+      closeTrashDialog();
+      const backdrop = document.createElement("div");
+      backdrop.className = "gdp-trash-dialog-backdrop";
+      const dialog = document.createElement("div");
+      dialog.className = "gdp-trash-dialog";
+      const titleId = "gdp-trash-dialog-title";
+      const bodyId = "gdp-trash-dialog-body";
+      dialog.setAttribute("role", "dialog");
+      dialog.setAttribute("aria-modal", "true");
+      dialog.setAttribute("aria-labelledby", titleId);
+      dialog.setAttribute("aria-describedby", bodyId);
+      const heading2 = document.createElement("div");
+      heading2.id = titleId;
+      heading2.className = "gdp-trash-dialog-title";
+      heading2.textContent = title;
+      const message = document.createElement("div");
+      message.id = bodyId;
+      message.className = "gdp-trash-dialog-body";
+      message.textContent = body;
+      const actionRow = document.createElement("div");
+      actionRow.className = "gdp-trash-dialog-actions";
+      actionRow.append(...actions);
+      dialog.append(heading2, message, actionRow);
+      backdrop.appendChild(dialog);
+      document.body.appendChild(backdrop);
+      return backdrop;
+    }
+    function confirmMoveToTrash(path, focusReturnTarget) {
+      return new Promise((resolve) => {
+        const previousFocus = focusReturnTarget || document.activeElement;
+        const cancel = document.createElement("button");
+        cancel.type = "button";
+        cancel.className = "gdp-btn gdp-btn-sm";
+        cancel.textContent = "Cancel";
+        const move = document.createElement("button");
+        move.type = "button";
+        move.className = "gdp-btn gdp-btn-sm gdp-trash-dialog-danger";
+        move.textContent = "Move to Trash";
+        const done = (ok) => {
+          document.removeEventListener("keydown", onKeydown);
+          closeTrashDialog();
+          previousFocus?.focus?.();
+          resolve(ok);
+        };
+        const onKeydown = (event) => {
+          if (event.key === "Escape") {
+            event.preventDefault();
+            event.stopPropagation();
+            done(false);
+            return;
+          }
+          if (event.key !== "Tab")
+            return;
+          const focusables = [cancel, move];
+          const index = focusables.indexOf(document.activeElement);
+          if (index < 0) {
+            event.preventDefault();
+            focusables[0].focus();
+            return;
+          }
+          if (event.shiftKey && index <= 0) {
+            event.preventDefault();
+            focusables[focusables.length - 1].focus();
+          } else if (!event.shiftKey && index === focusables.length - 1) {
+            event.preventDefault();
+            focusables[0].focus();
+          }
+        };
+        cancel.addEventListener("click", () => done(false));
+        move.addEventListener("click", () => done(true));
+        const backdrop = createTrashDialog("Move to Trash?", `Move "${path}" to Trash?`, [cancel, move]);
+        backdrop.addEventListener("pointerdown", (event) => {
+          if (event.target === backdrop)
+            done(false);
+        });
+        document.addEventListener("keydown", onKeydown);
+        cancel.focus();
+      });
+    }
+    function showTrashError(message) {
+      const ok = document.createElement("button");
+      ok.type = "button";
+      ok.className = "gdp-btn gdp-btn-sm";
+      ok.textContent = "OK";
+      ok.addEventListener("click", closeTrashDialog);
+      createTrashDialog("Trash failed", message, [ok]);
+      ok.focus();
+    }
+    async function moveRepoPathToTrash(path) {
+      const res = await fetch("/_trash_path", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Code-Viewer-Action": "1"
+        },
+        body: JSON.stringify({ path })
+      });
+      if (!res.ok) {
+        showTrashError(`Failed to move "${path}" to Trash: ${await res.text()}`);
+        return false;
+      }
+      const body = await res.json();
+      if (body.undo)
+        UNDO_STACK.unshift(body.undo);
+      return true;
+    }
+    async function runUndoAction(action) {
+      if (action.type !== "trash")
+        return false;
+      const res = await fetch("/_restore_trash", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Code-Viewer-Action": "1"
+        },
+        body: JSON.stringify(action.payload)
+      });
+      if (!res.ok) {
+        showTrashError(`Failed to undo "${action.label}": ${await res.text()}`);
+        return false;
+      }
+      return true;
+    }
+    async function undoLastAction() {
+      const action = UNDO_STACK.shift();
+      if (!action)
+        return false;
+      if (!await runUndoAction(action)) {
+        UNDO_STACK.unshift(action);
+        return true;
+      }
+      invalidateRepoSidebar();
+      await load();
+      return true;
+    }
+    async function requestMoveToTrash(path, onMoved, options = {}) {
+      if (!await confirmMoveToTrash(path, options.focusReturnTarget))
+        return;
+      if (await moveRepoPathToTrash(path))
+        onMoved();
+    }
+    function canTrashWorktreeRef(ref) {
+      return ref === "worktree" || ref === "";
+    }
+    function showRepoContextMenu(event, entry, ref, onDeleted) {
+      if (document.querySelector(".gdp-trash-dialog-backdrop"))
+        return false;
+      if (!canTrashWorktreeRef(ref))
+        return false;
+      if (entry.children_omitted_reason === "internal")
+        return false;
+      event.preventDefault();
+      closeRepoContextMenu();
+      const menu = document.createElement("div");
+      menu.className = "gdp-context-menu";
+      const anchor = event.target;
+      const focusReturnTarget = anchor?.closest("li, .gdp-repo-row");
+      const anchorRect = anchor?.closest("li, .gdp-repo-row")?.getBoundingClientRect();
+      const anchorX = event.clientX > 0 ? event.clientX : anchorRect?.left || window.innerWidth / 2;
+      const anchorY = event.clientY > 0 ? event.clientY : anchorRect?.bottom || window.innerHeight / 2;
+      menu.style.left = `${anchorX}px`;
+      menu.style.top = `${anchorY}px`;
+      const trash = document.createElement("button");
+      trash.type = "button";
+      trash.className = "danger";
+      trash.textContent = "Move to Trash...";
+      trash.addEventListener("click", async () => {
+        closeRepoContextMenu();
+        await requestMoveToTrash(entry.path, onDeleted, { focusReturnTarget });
+      });
+      menu.appendChild(trash);
+      document.body.appendChild(menu);
+      const rect = menu.getBoundingClientRect();
+      const left = Math.min(anchorX, window.innerWidth - rect.width - 8);
+      const top = Math.min(anchorY, window.innerHeight - rect.height - 8);
+      menu.style.left = `${Math.max(8, left)}px`;
+      menu.style.top = `${Math.max(8, top)}px`;
+      return true;
+    }
+    function sidebarTrashEntryFromEvent(event) {
+      if (!isRepositorySidebarMode())
+        return null;
+      const row = event.target?.closest("#filelist li");
+      if (!row)
+        return null;
+      const path = row.dataset.path || row.dataset.dirpath || "";
+      if (!path)
+        return null;
+      return {
+        path,
+        children_omitted_reason: row.dataset.childrenOmittedReason
+      };
+    }
+    function handleSidebarContextMenu(event) {
+      const entry = sidebarTrashEntryFromEvent(event);
+      if (!entry)
+        return;
+      if (showRepoContextMenu(event, entry, REPO_SIDEBAR_REF || "worktree", () => loadRepo()))
+        markActive(entry.path);
+    }
+    function createMoveToTrashButton(path, onDeleted) {
+      const button = document.createElement("button");
+      button.type = "button";
+      button.className = "gdp-btn gdp-btn-sm gdp-trash-path";
+      button.textContent = "Move to Trash";
+      button.addEventListener("click", async (event) => {
+        event.stopPropagation();
+        await requestMoveToTrash(path, onDeleted, { focusReturnTarget: button });
+      });
+      return button;
+    }
     function createOpenPathButton(path, kind, title = "open folder in OS") {
       const button = document.createElement("button");
       button.type = "button";
@@ -9198,6 +9461,7 @@ ${frontmatter.yaml}
               renderStandaloneSource({ path: entry.path, ref: meta.ref });
             }
           });
+          row.addEventListener("contextmenu", (event) => showRepoContextMenu(event, entry, meta.ref, () => loadRepo()));
           list2.appendChild(row);
         });
         if (!meta.entries.length) {
@@ -9271,7 +9535,7 @@ ${frontmatter.yaml}
       const params = new URLSearchParams;
       params.set("ref", normalizedRef);
       params.set("recursive", "1");
-      appendScopeOmitDirsParam(params);
+      appendScopeParams(params);
       REPO_SIDEBAR_LOAD_REF = normalizedRef;
       const load2 = trackLoad(fetch(`/_tree?${params.toString()}`).then((r2) => {
         if (!r2.ok)
@@ -9289,6 +9553,7 @@ ${frontmatter.yaml}
           children_omitted: entry.children_omitted,
           children_omitted_reason: entry.children_omitted_reason
         }));
+        REPO_SIDEBAR_REF = normalizedRef;
         renderSidebar(files, (file) => {
           if (file.type === "tree") {
             setRoute(repoRoute(normalizedRef, file.path));
@@ -9304,7 +9569,6 @@ ${frontmatter.yaml}
           });
           renderStandaloneSource({ path: file.path, ref: normalizedRef });
         });
-        REPO_SIDEBAR_REF = normalizedRef;
         activateRepoSidebarPath(currentPath);
       }).catch(() => {
         REPO_SIDEBAR_REF = null;
@@ -11579,6 +11843,13 @@ ${frontmatter.yaml}
       name.appendChild(copy);
       name.appendChild(createOpenPathButton(target.path, "file-parent", "open parent folder in OS"));
       header.appendChild(name);
+      if (repoTarget && canTrashWorktreeRef(repoTarget)) {
+        header.appendChild(createMoveToTrashButton(target.path, () => {
+          const parent = target.path.split("/").slice(0, -1).join("/");
+          setRoute(repoRoute(repoTarget, parent));
+          loadRepo();
+        }));
+      }
       loadRawFileInfo(target).then((meta) => {
         if (req !== SOURCE_REQ_SEQ || !sourceTargetsEqual(sourceTargetFromRoute(), target))
           return;
@@ -12781,7 +13052,7 @@ ${frontmatter.yaml}
         return cached;
       const params = new URLSearchParams;
       params.set("ref", ref);
-      appendScopeOmitDirsParam(params);
+      appendScopeParams(params);
       const res = await trackLoad(fetch(`/_files?${params.toString()}`).then((r2) => {
         if (!r2.ok)
           throw new Error("failed to load files");
@@ -12885,7 +13156,7 @@ ${frontmatter.yaml}
         params.set("max", "200");
         if (state.grepRegex)
           params.set("regex", "1");
-        appendScopeOmitDirsParam(params);
+        appendScopeParams(params);
         if (source === "diff") {
           for (const file of state.diffSnapshot)
             params.append("path", file.path);
@@ -13176,10 +13447,19 @@ ${frontmatter.yaml}
     document.addEventListener("keydown", handleVirtualSourcePagingKeydown, {
       capture: true
     });
-    document.addEventListener("keydown", (e2) => {
+    document.addEventListener("click", closeRepoContextMenu);
+    $("#filelist").addEventListener("contextmenu", handleSidebarContextMenu);
+    document.addEventListener("keydown", async (e2) => {
+      if (e2.key === "Escape")
+        closeRepoContextMenu();
       if (e2.__gdpVirtualSourcePagingHandled)
         return;
       const targetEl = e2.target;
+      if ((e2.ctrlKey || e2.metaKey) && !e2.shiftKey && !e2.altKey && e2.key.toLowerCase() === "z" && !isEditableKeyTarget(targetEl)) {
+        if (await undoLastAction())
+          e2.preventDefault();
+        return;
+      }
       if ((e2.ctrlKey || e2.metaKey) && e2.key.toLowerCase() === "f" && !isEditableKeyTarget(targetEl)) {
         if (openVirtualSourceSearchFromKeyboard(targetEl)) {
           e2.preventDefault();
@@ -13214,7 +13494,7 @@ ${frontmatter.yaml}
       params.set("ref", STATE.route.ref || "worktree");
       if (STATE.route.path)
         params.set("path", STATE.route.path);
-      appendScopeOmitDirsParam(params);
+      appendScopeParams(params);
       return trackLoad(fetch(`/_tree?${params.toString()}`).then((r2) => {
         if (!r2.ok)
           throw new Error("failed to load repository tree");

package/web/index.html

@@ -124,7 +124,9 @@
     <div class="scope-settings-section">
       <strong class="scope-settings-section-title">Excluded directories</strong>
       <label for="scope-omit-dirs">Skip these directory names while browsing and searching</label>
-      <textarea id="scope-omit-dirs" rows="9" spellcheck="false"></textarea>
+      <textarea id="scope-omit-dirs" rows="6" spellcheck="false"></textarea>
+      <label for="scope-exclude-names">Hide these file or directory names completely</label>
+      <textarea id="scope-exclude-names" rows="4" spellcheck="false"></textarea>
       <p id="scope-omit-source"></p>
       <div class="scope-settings-actions">
         <button id="scope-omit-reset" type="button">Reset</button>

package/web/style.css

@@ -1171,10 +1171,11 @@ body.gdp-resizing * { user-select: none !important; }
   font: inherit;
   font-size: 12.5px;
 }
-#scope-omit-dirs {
+#scope-omit-dirs,
+#scope-exclude-names {
   box-sizing: border-box;
   width: 100%;
-  min-height: 210px;
+  min-height: 110px;
   resize: vertical;
   border: 1px solid var(--border-muted);
   border-radius: 6px;
@@ -2590,6 +2591,10 @@ table.d2h-diff-table tr.gdp-diff-line-target > td:first-child {
   flex-shrink: 0;
   color: var(--fg-muted);
 }
+.gdp-file-detail-header .gdp-trash-path {
+  flex-shrink: 0;
+  color: var(--danger);
+}
 .gdp-file-detail-meta {
   display: flex;
   align-items: center;
@@ -3257,6 +3262,82 @@ body.gdp-file-detail-page #empty {
   font-size: 12px;
   white-space: nowrap;
 }
+.gdp-context-menu {
+  position: fixed;
+  z-index: 1000;
+  min-width: 180px;
+  padding: 6px;
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  background: var(--bg);
+  box-shadow: 0 8px 24px rgba(31, 35, 40, 0.18);
+}
+.gdp-context-menu button {
+  width: 100%;
+  min-height: 30px;
+  padding: 5px 8px;
+  border: 0;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--fg);
+  font: inherit;
+  font-size: 13px;
+  text-align: left;
+  cursor: pointer;
+}
+.gdp-context-menu button:hover {
+  background: var(--bg-soft);
+}
+.gdp-context-menu .danger {
+  color: var(--danger);
+}
+.gdp-trash-dialog-backdrop {
+  position: fixed;
+  inset: 0;
+  z-index: 1100;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding-top: min(14vh, 120px);
+  background: rgba(31, 35, 40, 0.18);
+}
+[data-theme="dark"] .gdp-trash-dialog-backdrop {
+  background: rgba(1, 4, 9, 0.45);
+}
+.gdp-trash-dialog {
+  width: min(420px, calc(100vw - 32px));
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  background: var(--bg);
+  box-shadow: 0 16px 48px rgba(31, 35, 40, 0.28);
+}
+.gdp-trash-dialog-title {
+  padding: 14px 16px 0;
+  color: var(--fg);
+  font-size: 15px;
+  font-weight: 600;
+}
+.gdp-trash-dialog-body {
+  padding: 8px 16px 14px;
+  color: var(--fg-muted);
+  font-size: 13px;
+  line-height: 1.5;
+  overflow-wrap: anywhere;
+}
+.gdp-trash-dialog-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 12px 16px;
+  border-top: 1px solid var(--border-muted);
+}
+.gdp-trash-dialog-danger {
+  border-color: var(--danger);
+  color: var(--danger);
+}
+.gdp-trash-dialog-danger:hover {
+  background: var(--diff-del-bg);
+}
 .gdp-repo-empty {
   padding: 32px;
   color: var(--fg-muted);