pi-studio 0.9.34 → 0.9.35

package/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.9.35] — 2026-07-13
+
+### Added
+- Added Files-view sort options for name, newest/oldest modified time, and largest/smallest file size.
+
 ## [0.9.34] — 2026-07-02
 
 ### Added

package/README.md

@@ -34,7 +34,7 @@ _The video shows an earlier version of the Studio interface. The basic workflow
 - Runs editor text directly, asks for structured critique (auto/writing/code focus), offers a manual **Suggest completion** action for short cursor-aware continuations (`Option/Alt+Tab` where available or `Cmd/Ctrl+Shift+Space` from the editor, `Tab` to insert a visible suggestion) with an optional editor-plus-latest-response context mode, or opens **Quiz me** for a Studio-native active-recall loop over the current editor text, selection, current file, folder, or repo, with optional focus guidance for shaping question selection
 - Includes a live **Working** view for following current model/tool activity, with `All` / `Thinking` / `Tools` filters, image previews for image-producing tool outputs, plus **Load visible into editor** and **Copy visible** actions; when cycling response history, Working follows saved working details for the selected response when available, and `Cmd/Ctrl+Alt+1–7` switches directly between right-pane views while `Cmd/Ctrl+Alt+P` / `Cmd/Ctrl+Alt+E` / `Cmd/Ctrl+Alt+W` keep quick mnemonic shortcuts for Response Preview, Editor Preview, and Working
 - Includes a right-pane **Changes** view for browsing the current git diff by file, previewing per-file diffs, opening changed files, loading the full diff into the editor, and copying the diff
-- Includes a right-pane **Files** view for browsing the current Pi session/resource directory, opening folders, opening the Files root in Finder/the system file manager, loading text/code/CSV/TSV documents into the editor, previewing PDFs/images, opening PDF/image previews in a new Studio tab, converting DOCX/ODT documents to editable Markdown when Pandoc is available after confirmation, copying paths, setting the current folder as the Studio working directory, and revealing files in the file manager
+- Includes a right-pane **Files** view for browsing the current Pi session/resource directory, sorting by name/modified time/size, opening folders, opening the Files root in Finder/the system file manager, loading text/code/CSV/TSV documents into the editor, previewing PDFs/images, opening PDF/image previews in a new Studio tab, converting DOCX/ODT documents to editable Markdown when Pandoc is available after confirmation, copying paths, setting the current folder as the Studio working directory, and revealing files in the file manager
 - Includes an optional tmux-backed **REPL** view for Shell, Python, IPython, Julia, R, GHCi, and Clojure sessions, with Raw/Literate send modes, `Cmd/Ctrl+Shift+Enter` **Send to REPL**, session start/stop/interrupt controls, a compact refresh-persistent **Studio REPL Record** of user and Pi-sent code, a secondary raw tmux mirror, agent-facing `studio_repl_status` / `studio_repl_send` tools, and Markdown/PDF/HTML export
 - Includes a local persistent scratchpad for quick notes you want to keep out of the main editor until you're ready to copy or insert them, with a **Recent…** picker for recovering scratchpads saved under earlier file/draft identities
 - Includes a docked **Outline** rail for navigating document structure in the current editor text, with clickable entries that jump in the raw editor and reveal matching preview locations when available

package/client/studio-client.js

@@ -2104,6 +2104,35 @@
       const DEFAULT_RESPONSE_FONT_SIZE = studioUiRefreshEnabled ? 13.5 : 15;
       let editorFontSize = DEFAULT_EDITOR_FONT_SIZE;
       let responseFontSize = DEFAULT_RESPONSE_FONT_SIZE;
+      function normalizeFileBrowserSortMode(sort) {
+        const value = String(sort || "").trim().toLowerCase();
+        if (value === "mtime-desc" || value === "modified-desc" || value === "newest") return "mtime-desc";
+        if (value === "mtime-asc" || value === "modified-asc" || value === "oldest") return "mtime-asc";
+        if (value === "size-desc" || value === "largest") return "size-desc";
+        if (value === "size-asc" || value === "smallest") return "size-asc";
+        return "name";
+      }
+
+      function readFileBrowserSortMode() {
+        try {
+          const stored = window.localStorage ? window.localStorage.getItem("piStudio.fileBrowserSort") : "";
+          return normalizeFileBrowserSortMode(stored);
+        } catch {
+          return "name";
+        }
+      }
+
+      function writeFileBrowserSortMode(sort) {
+        const normalized = normalizeFileBrowserSortMode(sort);
+        try {
+          if (window.localStorage) window.localStorage.setItem("piStudio.fileBrowserSort", normalized);
+        } catch {
+          // Ignore storage failures.
+        }
+        return normalized;
+      }
+
+      let fileBrowserSortMode = readFileBrowserSortMode();
       let fileBrowserState = {
         rootDir: "",
         currentDir: "",
@@ -2112,6 +2141,7 @@
         entries: [],
         omitted: 0,
         omittedIgnored: 0,
+        sort: fileBrowserSortMode,
         loading: false,
         error: "",
         loaded: false,
@@ -8145,6 +8175,9 @@
         critiqueViewEl.addEventListener("click", handleFilesPaneClick);
         critiqueViewEl.addEventListener("click", handleGitChangesPaneClick);
         critiqueViewEl.addEventListener("change", handleReplPaneChange);
+        critiqueViewEl.addEventListener("change", (event) => {
+          void handleFilesPaneChange(event);
+        });
       }
 
       function replaceResponsePaneWithClone() {
@@ -9965,6 +9998,24 @@
         return entry.extension ? entry.extension.replace(/^\./, "") : "file";
       }
 
+      function getFileBrowserSortOptions() {
+        return [
+          { value: "name", label: "Sort: Name" },
+          { value: "mtime-desc", label: "Sort: Newest" },
+          { value: "mtime-asc", label: "Sort: Oldest" },
+          { value: "size-desc", label: "Sort: Largest" },
+          { value: "size-asc", label: "Sort: Smallest" },
+        ];
+      }
+
+      function buildFileBrowserSortSelectHtml() {
+        const currentSort = normalizeFileBrowserSortMode(fileBrowserSortMode || (fileBrowserState && fileBrowserState.sort));
+        const options = getFileBrowserSortOptions().map((option) => {
+          return "<option value='" + escapeHtml(option.value) + "'" + (option.value === currentSort ? " selected" : "") + ">" + escapeHtml(option.label) + "</option>";
+        }).join("");
+        return "<select class='files-sort-select' data-files-sort aria-label='Files sort order' title='Sort file browser entries. Folders remain grouped first.'>" + options + "</select>";
+      }
+
       function buildFileBrowserPanelHtml() {
         const state = fileBrowserState || {};
         const entries = Array.isArray(state.entries) ? state.entries : [];
@@ -10019,6 +10070,7 @@
           + "<div class='files-toolbar'>"
           + "<div class='files-path-group'><span class='files-label'>Files</span><span class='files-path' title='" + escapeHtml(currentDir) + "'>" + escapeHtml(relativeDir || ".") + "</span></div>"
           + "<div class='files-toolbar-actions'>"
+          + buildFileBrowserSortSelectHtml()
           + "<button type='button' data-files-action='parent'" + parentDisabled + ">Parent</button>"
           + "<button type='button' data-files-action='refresh'>Refresh</button>"
           + (currentDir ? "<button type='button' data-files-action='copy-current' data-files-path='" + escapeHtml(currentDir) + "'>Copy path</button>" : "")
@@ -10045,6 +10097,7 @@
             entries: [],
             omitted: 0,
             omittedIgnored: 0,
+            sort: fileBrowserSortMode,
             loading: false,
             error: "",
             loaded: false,
@@ -10079,8 +10132,10 @@
           if (dir) query.dir = String(dir);
           if (context.sourcePath) query.sourcePath = context.sourcePath;
           if (context.resourceDir) query.resourceDir = context.resourceDir;
+          query.sort = normalizeFileBrowserSortMode(fileBrowserSortMode);
           const payload = await fetchStudioJson("/file-browser", { query });
           if (nonce !== fileBrowserLoadNonce) return;
+          fileBrowserSortMode = normalizeFileBrowserSortMode(payload.sort || fileBrowserSortMode);
           fileBrowserState = {
             rootDir: typeof payload.rootDir === "string" ? payload.rootDir : "",
             currentDir: typeof payload.currentDir === "string" ? payload.currentDir : "",
@@ -10089,6 +10144,7 @@
             entries: Array.isArray(payload.entries) ? payload.entries : [],
             omitted: Number(payload.omitted) || 0,
             omittedIgnored: Number(payload.omittedIgnored) || 0,
+            sort: normalizeFileBrowserSortMode(payload.sort || fileBrowserSortMode),
             loading: false,
             error: "",
             loaded: true,
@@ -10191,6 +10247,17 @@
         setStatus(payload && payload.message ? payload.message : "Opened folder in file manager.", "success");
       }
 
+      async function handleFilesPaneChange(event) {
+        if (rightView !== "files") return;
+        const target = event.target;
+        const sortSelect = target instanceof Element ? target.closest("[data-files-sort]") : null;
+        if (!sortSelect || !("value" in sortSelect)) return;
+        const nextSort = writeFileBrowserSortMode(sortSelect.value);
+        if (nextSort === fileBrowserSortMode && fileBrowserState.loaded && !fileBrowserState.loading) return;
+        fileBrowserSortMode = nextSort;
+        await loadFileBrowserDirectory(fileBrowserState.currentDir || "", { user: true });
+      }
+
       async function handleFilesPaneClick(event) {
         if (rightView !== "files") return;
         const target = event.target;

package/client/studio.css

@@ -3290,11 +3290,21 @@
     }
 
     .files-toolbar-actions button,
-    .files-actions button {
+    .files-actions button,
+    .files-sort-select {
       padding: 4px 7px;
       font-size: 11px;
     }
 
+    .files-sort-select {
+      max-width: 150px;
+      border: 1px solid var(--control-border);
+      border-radius: 7px;
+      background: var(--panel);
+      color: var(--text);
+      font-family: var(--font-ui);
+    }
+
     .files-subtitle,
     .files-notice,
     .files-empty {

package/index.ts

@@ -2752,6 +2752,7 @@ const STUDIO_FILE_BROWSER_IGNORED_DIRS = new Set([
 ]);
 
 type StudioLocalPreviewResourceKind = "pdf" | "text" | "image" | "office" | "other";
+type StudioFileBrowserSortMode = "name" | "mtime-desc" | "mtime-asc" | "size-desc" | "size-asc";
 
 interface StudioLocalPreviewResource {
 	filePath: string;
@@ -2773,6 +2774,29 @@ interface StudioFileBrowserEntry {
 	hidden: boolean;
 }
 
+function normalizeStudioFileBrowserSortMode(sort: string | null | undefined): StudioFileBrowserSortMode {
+	const value = typeof sort === "string" ? sort.trim().toLowerCase() : "";
+	if (value === "mtime-desc" || value === "modified-desc" || value === "newest") return "mtime-desc";
+	if (value === "mtime-asc" || value === "modified-asc" || value === "oldest") return "mtime-asc";
+	if (value === "size-desc" || value === "largest") return "size-desc";
+	if (value === "size-asc" || value === "smallest") return "size-asc";
+	return "name";
+}
+
+function compareStudioFileBrowserEntryNames(a: StudioFileBrowserEntry, b: StudioFileBrowserEntry): number {
+	return a.name.localeCompare(b.name, undefined, { sensitivity: "base", numeric: true });
+}
+
+function compareStudioFileBrowserEntries(a: StudioFileBrowserEntry, b: StudioFileBrowserEntry, sort: StudioFileBrowserSortMode): number {
+	if (a.type !== b.type) return a.type === "directory" ? -1 : 1;
+	if (a.hidden !== b.hidden) return a.hidden ? 1 : -1;
+	if (sort === "mtime-desc") return (b.mtimeMs - a.mtimeMs) || compareStudioFileBrowserEntryNames(a, b);
+	if (sort === "mtime-asc") return (a.mtimeMs - b.mtimeMs) || compareStudioFileBrowserEntryNames(a, b);
+	if (sort === "size-desc" && a.type === "file") return (b.size - a.size) || compareStudioFileBrowserEntryNames(a, b);
+	if (sort === "size-asc" && a.type === "file") return (a.size - b.size) || compareStudioFileBrowserEntryNames(a, b);
+	return compareStudioFileBrowserEntryNames(a, b);
+}
+
 function resolveStudioPdfResourcePath(pdfPath: string | undefined, sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string): string {
 	const rawPath = typeof pdfPath === "string" ? pdfPath.trim() : "";
 	if (!rawPath) throw new Error("Missing PDF path.");
@@ -2922,8 +2946,10 @@ function listStudioFileBrowserDirectory(
 	sourcePath: string | undefined,
 	resourceDir: string | undefined,
 	fallbackCwd: string,
-): { rootDir: string; currentDir: string; relativeDir: string; parentDir: string | null; entries: StudioFileBrowserEntry[]; omitted: number; omittedIgnored: number } {
+	sortMode?: string | null,
+): { rootDir: string; currentDir: string; relativeDir: string; parentDir: string | null; entries: StudioFileBrowserEntry[]; omitted: number; omittedIgnored: number; sort: StudioFileBrowserSortMode } {
 	const context = resolveStudioFileBrowserDirectory(dirPath, sourcePath, resourceDir, fallbackCwd);
+	const sort = normalizeStudioFileBrowserSortMode(sortMode);
 	const entries: StudioFileBrowserEntry[] = [];
 	let omitted = 0;
 	let omittedIgnored = 0;
@@ -2962,14 +2988,10 @@ function listStudioFileBrowserDirectory(
 			omitted += 1;
 		}
 	}
-	entries.sort((a, b) => {
-		if (a.type !== b.type) return a.type === "directory" ? -1 : 1;
-		if (a.hidden !== b.hidden) return a.hidden ? 1 : -1;
-		return a.name.localeCompare(b.name, undefined, { sensitivity: "base", numeric: true });
-	});
+	entries.sort((a, b) => compareStudioFileBrowserEntries(a, b, sort));
 	const limitedEntries = entries.slice(0, STUDIO_FILE_BROWSER_MAX_ENTRIES);
 	omitted += Math.max(0, entries.length - limitedEntries.length);
-	return { ...context, entries: limitedEntries, omitted, omittedIgnored };
+	return { ...context, entries: limitedEntries, omitted, omittedIgnored, sort };
 }
 
 function resolveStudioHtmlPreviewResourcePath(
@@ -14150,6 +14172,7 @@ export default function (pi: ExtensionAPI) {
 					requestUrl.searchParams.get("sourcePath") ?? undefined,
 					requestUrl.searchParams.get("resourceDir") ?? undefined,
 					studioCwd,
+					requestUrl.searchParams.get("sort") ?? undefined,
 				);
 				respondJson(res, 200, { ok: true, ...listing, entries: method === "HEAD" ? [] : listing.entries });
 			} catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.9.34",
+  "version": "0.9.35",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, active quiz, prompt/response history, live previews, and tmux-backed REPL/literate REPL workflows",
   "type": "module",
   "license": "MIT",