merge: feat/directory-picker — browsable server directory picker (#49/#57) (reviewed: APPROVE after fixes)

src/lib/path-utils.test.ts

@@ -0,0 +1,88 @@
+import { test } from "node:test"
+import assert from "node:assert/strict"
+import { stripTrailingSlash, parentOf, nameOf } from "./path-utils.ts"
+
+// stripTrailingSlash -------------------------------------------------------
+
+test("stripTrailingSlash: removes single and repeated trailing separators", () => {
+  assert.equal(stripTrailingSlash("/a/b/"), "/a/b")
+  assert.equal(stripTrailingSlash("/a/b///"), "/a/b")
+  assert.equal(stripTrailingSlash("C:\\proj\\"), "C:\\proj")
+})
+
+test("stripTrailingSlash: keeps input when stripping would empty it", () => {
+  assert.equal(stripTrailingSlash("/"), "/")
+  assert.equal(stripTrailingSlash("\\"), "\\")
+  assert.equal(stripTrailingSlash("///"), "///")
+})
+
+test("stripTrailingSlash: leaves paths without trailing separator unchanged", () => {
+  assert.equal(stripTrailingSlash("/a/b"), "/a/b")
+  assert.equal(stripTrailingSlash("D:/work"), "D:/work")
+})
+
+// parentOf -----------------------------------------------------------------
+
+test("parentOf: POSIX root has no parent", () => {
+  assert.equal(parentOf("/"), null)
+  assert.equal(parentOf("//"), null)
+})
+
+test("parentOf: bare backslash has no parent", () => {
+  assert.equal(parentOf("\\"), null)
+})
+
+test("parentOf: Windows drive roots have no parent", () => {
+  assert.equal(parentOf("C:\\"), null)
+  assert.equal(parentOf("D:/"), null)
+  assert.equal(parentOf("c:"), null)
+})
+
+test("parentOf: first-level POSIX dir returns the root", () => {
+  assert.equal(parentOf("/home"), "/")
+  assert.equal(parentOf("/home/"), "/")
+})
+
+test("parentOf: nested POSIX paths walk up one level", () => {
+  assert.equal(parentOf("/home/user/project"), "/home/user")
+  assert.equal(parentOf("/home/user/project/"), "/home/user")
+})
+
+test("parentOf: first-level Windows dir returns the drive root", () => {
+  assert.equal(parentOf("C:\\projects"), "C:\\")
+  assert.equal(parentOf("D:/work"), "D:\\")
+})
+
+test("parentOf: nested Windows backslash paths walk up one level", () => {
+  assert.equal(parentOf("C:\\projects\\app"), "C:\\projects")
+  assert.equal(parentOf("C:\\projects\\app\\"), "C:\\projects")
+})
+
+test("parentOf: mixed-separator Windows paths walk up one level", () => {
+  assert.equal(parentOf("D:/work/repo"), "D:/work")
+})
+
+test("parentOf: relative segment without separators has no parent", () => {
+  assert.equal(parentOf("project"), null)
+})
+
+// nameOf ---------------------------------------------------------------------
+
+test("nameOf: returns the last POSIX segment", () => {
+  assert.equal(nameOf("/home/user/project"), "project")
+  assert.equal(nameOf("/home/user/project/"), "project")
+})
+
+test("nameOf: returns the last Windows segment", () => {
+  assert.equal(nameOf("C:\\projects\\app"), "app")
+  assert.equal(nameOf("D:/work/repo"), "repo")
+})
+
+test("nameOf: root paths fall back to the trimmed input", () => {
+  assert.equal(nameOf("/"), "/")
+  assert.equal(nameOf("C:\\"), "C:")
+})
+
+test("nameOf: bare segment is returned as-is", () => {
+  assert.equal(nameOf("project"), "project")
+})

src/lib/path-utils.ts

@@ -0,0 +1,38 @@
+// Pure absolute-path helpers for the server-filesystem browser.
+// No React Native imports — unit-testable with node --test.
+//
+// Server working directories can be POSIX (/a/b) or Windows (C:\a\b, D:/a/b)
+// since the mobile app can point at either kind of opencode server, so both
+// separators are handled.
+
+/** Remove trailing slashes/backslashes, keeping the input if that would empty it. */
+export function stripTrailingSlash(dir: string): string {
+  return dir.replace(/[\\/]+$/, "") || dir
+}
+
+function isRoot(trimmed: string): boolean {
+  // POSIX root ("/", "//"), a bare backslash, or a Windows drive root ("C:").
+  return /^[\\/]+$/.test(trimmed) || /^[a-zA-Z]:$/.test(trimmed)
+}
+
+/**
+ * Parent directory of an absolute path, or null when already at a
+ * filesystem root (POSIX "/" or a Windows drive root like "C:\").
+ */
+export function parentOf(dir: string): string | null {
+  const trimmed = stripTrailingSlash(dir)
+  if (isRoot(trimmed)) return null
+  const lastSlash = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"))
+  if (lastSlash < 0) return null
+  const head = trimmed.slice(0, lastSlash)
+  if (!head) return trimmed[0] === "\\" ? "\\" : "/" // reached posix root
+  if (/^[a-zA-Z]:$/.test(head)) return `${head}\\` // reached a windows drive root
+  return head
+}
+
+/** Last path segment, e.g. "/a/b/" -> "b", "C:\\proj" -> "proj". */
+export function nameOf(dir: string): string {
+  const trimmed = stripTrailingSlash(dir)
+  const lastSlash = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"))
+  return lastSlash >= 0 ? trimmed.slice(lastSlash + 1) || trimmed : trimmed
+}

src/lib/sdk.ts

@@ -143,6 +143,14 @@ export interface Project {
   }
 }
 
+export interface FileEntry {
+  name: string
+  path: string
+  absolute: string
+  type: "file" | "directory"
+  ignored: boolean
+}
+
 export interface Event {
   type: string
   properties: Record<string, unknown>
@@ -250,6 +258,17 @@ export function createClient(config: ClientConfig) {
       current: () => request<Project>(config, "/project/current"),
     },
 
+    // Server-side filesystem browsing, scoped to this client's directory
+    // (see ClientConfig.directory / x-opencode-directory header). Use
+    // clientForDirectory(dir) to get a client rooted at a specific folder,
+    // then list("." ) to enumerate its immediate children.
+    file: {
+      list: (params: { path?: string } = {}) => {
+        const query = new URLSearchParams({ path: params.path ?? "." })
+        return request<FileEntry[]>(config, `/file?${query.toString()}`)
+      },
+    },
+
     path: {
       get: () =>
         request<{ home: string; state: string; config: string; worktree: string; directory: string }>(config, "/path"),