Allow previews to open readable files (#1214)

* Allow previews to open readable files * Fix Windows file preview path test * Address file preview review comments
2026-05-29 11:35:38 +08:00
parent 2e1b907c63
commit 3585c80266
11 changed files with 361 additions and 132 deletions
@@ -0,0 +1,107 @@
+import { isAbsolutePath } from "@/utils/path";
+
+export interface FilePreviewReadTarget {
+  cwd: string;
+  path: string;
+}
+
+function trimTrailingSeparators(value: string): string {
+  if (value === "/" || /^[A-Za-z]:[\\/]?$/.test(value)) {
+    return value.replace(/\\/g, "/");
+  }
+  return value.replace(/[\\/]+$/, "");
+}
+
+function normalizeForPathComparison(value: string): string {
+  const normalized = trimTrailingSeparators(value.replace(/\\/g, "/"));
+  if (/^[A-Za-z]:\//.test(normalized)) {
+    return `${normalized.slice(0, 1).toUpperCase()}${normalized.slice(1)}`;
+  }
+  return normalized;
+}
+
+function isPathWithinRoot(candidatePath: string, rootPath: string): boolean {
+  const candidate = normalizeForPathComparison(candidatePath);
+  const root = normalizeForPathComparison(rootPath);
+  if (!candidate || !root) {
+    return false;
+  }
+  if (root === "/") {
+    return candidate.startsWith("/");
+  }
+  if (candidate === root) {
+    return true;
+  }
+  return candidate.startsWith(`${root}/`);
+}
+
+function deriveFilesystemRootFromAbsolutePath(value: string): string | null {
+  if (value.startsWith("/")) {
+    return "/";
+  }
+
+  const driveMatch = /^([A-Za-z]:)[\\/]/.exec(value);
+  if (driveMatch?.[1]) {
+    return `${driveMatch[1]}/`;
+  }
+
+  const uncMatch = /^(\\\\[^\\]+\\[^\\]+)/.exec(value);
+  if (uncMatch?.[1]) {
+    return uncMatch[1];
+  }
+
+  return null;
+}
+
+function isHomeRelativePath(value: string): boolean {
+  return value === "~" || value.startsWith("~/") || value.startsWith("~\\");
+}
+
+export function resolveFilePreviewReadTarget(input: {
+  path: string;
+  workspaceRoot?: string;
+}): FilePreviewReadTarget | null {
+  const previewPath = input.path.trim();
+  if (!previewPath) {
+    return null;
+  }
+
+  if (isHomeRelativePath(previewPath)) {
+    return {
+      cwd: "~",
+      path: previewPath,
+    };
+  }
+
+  const workspaceRoot = input.workspaceRoot?.trim();
+  if (!isAbsolutePath(previewPath)) {
+    if (!workspaceRoot || !isAbsolutePath(workspaceRoot)) {
+      return null;
+    }
+    return {
+      cwd: workspaceRoot,
+      path: previewPath,
+    };
+  }
+
+  if (
+    workspaceRoot &&
+    isAbsolutePath(workspaceRoot) &&
+    isPathWithinRoot(previewPath, workspaceRoot)
+  ) {
+    return {
+      cwd: workspaceRoot,
+      path: previewPath,
+    };
+  }
+
+  const filesystemRoot = deriveFilesystemRootFromAbsolutePath(previewPath);
+  if (!filesystemRoot) {
+    return null;
+  }
+
+  return {
+    cwd: filesystemRoot,
+    path: previewPath,
+  };
+}