@statewalker/webrun-files-browser 0.7.0 → 0.7.1

package/README.md

@@ -107,7 +107,7 @@ class BrowserFilesApi implements FilesApi {
   stats(path: string): Promise<FileStats | undefined>;
   exists(path: string): Promise<boolean>;
   remove(path: string): Promise<boolean>;
-  move(source: string, target: string): Promise<boolean>;
+  move(source: string, target: string): Promise<boolean>;  // uses native move when available
   copy(source: string, target: string): Promise<boolean>;
 }
 ```
@@ -141,11 +141,15 @@ function verifyPermission(
 ): Promise<boolean>;
 ```
 
+## Native Move Support
+
+The `move()` method attempts to use the browser's native [`FileSystemHandle.move()`](https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/move) when available (Chrome 110+, Edge 110+). This provides an atomic, in-place rename/move without copying file data. On older browsers or polyfills that lack native `move()`, the method falls back to copy-then-delete.
+
 ## Browser Support
 
 The File System Access API is supported in:
 
-- Chrome/Edge 86+
+- Chrome/Edge 86+ (native `move()` from 110+)
 - Opera 72+
 - Chrome for Android 86+
 

package/dist/browser-files-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-files-api.d.ts","sourceRoot":"","sources":["../src/browser-files-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,EAAE,yBAAyB,CAAC;CACvC;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,UAAU,CAA4B;gBAElC,OAAO,EAAE,sBAAsB;YAI7B,kBAAkB;YAkBlB,aAAa;IAkBpB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC;IA6BrE,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC;IAsBV,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC;IAqCnE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAqCnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBtC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA4E7D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAGhE"}
+{"version":3,"file":"browser-files-api.d.ts","sourceRoot":"","sources":["../src/browser-files-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAQnC,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,EAAE,yBAAyB,CAAC;CACvC;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,UAAU,CAA4B;gBAElC,OAAO,EAAE,sBAAsB;YAI7B,kBAAkB;YAkBlB,aAAa;IAkBpB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC;IA6BrE,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC;IAsBV,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC;IAqCnE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAqCnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBtC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCtD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA4E7D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAGhE"}

package/dist/cjs/index.cjs

@@ -1,5 +1,5 @@
-let __statewalker_webrun_files = require("@statewalker/webrun-files");
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _statewalker_webrun_files = require("@statewalker/webrun-files");
 //#region src/browser-files-api.ts
 /**
 * Browser filesystem implementation using the File System Access API.
@@ -24,9 +24,9 @@ var BrowserFilesApi = class {
 		return current;
 	}
 	async getFileHandle(path, options = {}) {
-		const normalized = (0, __statewalker_webrun_files.normalizePath)(path);
-		const parentPath = (0, __statewalker_webrun_files.dirname)(normalized);
-		const fileName = (0, __statewalker_webrun_files.basename)(normalized);
+		const normalized = (0, _statewalker_webrun_files.normalizePath)(path);
+		const parentPath = (0, _statewalker_webrun_files.dirname)(normalized);
+		const fileName = (0, _statewalker_webrun_files.basename)(normalized);
 		const parent = await this.getDirectoryHandle(parentPath, options);
 		if (!parent) return null;
 		try {
@@ -59,9 +59,9 @@ var BrowserFilesApi = class {
 		}
 	}
 	async write(path, content) {
-		const normalized = (0, __statewalker_webrun_files.normalizePath)(path);
-		const parentPath = (0, __statewalker_webrun_files.dirname)(normalized);
-		const fileName = (0, __statewalker_webrun_files.basename)(normalized);
+		const normalized = (0, _statewalker_webrun_files.normalizePath)(path);
+		const parentPath = (0, _statewalker_webrun_files.dirname)(normalized);
+		const fileName = (0, _statewalker_webrun_files.basename)(normalized);
 		const parent = await this.getDirectoryHandle(parentPath, { create: true });
 		if (!parent) throw new Error(`Cannot create directory: ${parentPath}`);
 		const writable = await (await parent.getFileHandle(fileName, { create: true })).createWritable();
@@ -72,16 +72,16 @@ var BrowserFilesApi = class {
 		}
 	}
 	async mkdir(path) {
-		const normalized = (0, __statewalker_webrun_files.normalizePath)(path);
+		const normalized = (0, _statewalker_webrun_files.normalizePath)(path);
 		await this.getDirectoryHandle(normalized, { create: true });
 	}
 	async *list(path, options) {
-		const normalized = (0, __statewalker_webrun_files.normalizePath)(path);
+		const normalized = (0, _statewalker_webrun_files.normalizePath)(path);
 		const dirHandle = await this.getDirectoryHandle(normalized);
 		if (!dirHandle) return;
 		const recursive = options?.recursive ?? false;
 		for await (const [name, handle] of dirHandle.entries()) {
-			const entryPath = (0, __statewalker_webrun_files.joinPath)(normalized, name);
+			const entryPath = (0, _statewalker_webrun_files.joinPath)(normalized, name);
 			const isDirectory = handle.kind === "directory";
 			const info = {
 				kind: isDirectory ? "directory" : "file",
@@ -99,7 +99,7 @@ var BrowserFilesApi = class {
 		}
 	}
 	async stats(path) {
-		const normalized = (0, __statewalker_webrun_files.normalizePath)(path);
+		const normalized = (0, _statewalker_webrun_files.normalizePath)(path);
 		if (normalized === "/") return {
 			kind: "directory",
 			lastModified: 0
@@ -124,9 +124,9 @@ var BrowserFilesApi = class {
 		return await this.stats(path) !== void 0;
 	}
 	async remove(path) {
-		const normalized = (0, __statewalker_webrun_files.normalizePath)(path);
-		const parentPath = (0, __statewalker_webrun_files.dirname)(normalized);
-		const name = (0, __statewalker_webrun_files.basename)(normalized);
+		const normalized = (0, _statewalker_webrun_files.normalizePath)(path);
+		const parentPath = (0, _statewalker_webrun_files.dirname)(normalized);
+		const name = (0, _statewalker_webrun_files.basename)(normalized);
 		const parent = await this.getDirectoryHandle(parentPath);
 		if (!parent) return false;
 		try {
@@ -137,20 +137,34 @@ var BrowserFilesApi = class {
 		}
 	}
 	async move(source, target) {
+		const sourcePath = (0, _statewalker_webrun_files.normalizePath)(source);
+		const targetPath = (0, _statewalker_webrun_files.normalizePath)(target);
+		const targetParentPath = (0, _statewalker_webrun_files.dirname)(targetPath);
+		const targetName = (0, _statewalker_webrun_files.basename)(targetPath);
+		const sourceStats = await this.stats(sourcePath);
+		if (!sourceStats) return false;
+		const sourceHandle = sourceStats.kind === "file" ? await this.getFileHandle(sourcePath) : await this.getDirectoryHandle(sourcePath);
+		if (!sourceHandle) return false;
+		if (typeof sourceHandle.move === "function") try {
+			const targetParent = await this.getDirectoryHandle(targetParentPath, { create: true });
+			if (!targetParent) return false;
+			await sourceHandle.move(targetParent, targetName);
+			return true;
+		} catch {}
 		if (!await this.copy(source, target)) return false;
 		return this.remove(source);
 	}
 	async copy(source, target) {
-		const sourcePath = (0, __statewalker_webrun_files.normalizePath)(source);
-		const targetPath = (0, __statewalker_webrun_files.normalizePath)(target);
+		const sourcePath = (0, _statewalker_webrun_files.normalizePath)(source);
+		const targetPath = (0, _statewalker_webrun_files.normalizePath)(target);
 		const sourceStats = await this.stats(source);
 		if (!sourceStats) return false;
 		if (sourceStats.kind === "file") {
 			const sourceHandle = await this.getFileHandle(sourcePath);
 			if (!sourceHandle) return false;
 			const sourceFile = await sourceHandle.getFile();
-			const targetParentPath = (0, __statewalker_webrun_files.dirname)(targetPath);
-			const targetFileName = (0, __statewalker_webrun_files.basename)(targetPath);
+			const targetParentPath = (0, _statewalker_webrun_files.dirname)(targetPath);
+			const targetFileName = (0, _statewalker_webrun_files.basename)(targetPath);
 			const targetParent = await this.getDirectoryHandle(targetParentPath, { create: true });
 			if (!targetParent) return false;
 			const writable = await (await targetParent.getFileHandle(targetFileName, { create: true })).createWritable();
@@ -173,8 +187,8 @@ var BrowserFilesApi = class {
 			const entryHandle = await this.getFileHandle(entry.path);
 			if (!entryHandle) continue;
 			const entryFile = await entryHandle.getFile();
-			const newTargetParentPath = (0, __statewalker_webrun_files.dirname)(newTargetPath);
-			const newTargetFileName = (0, __statewalker_webrun_files.basename)(newTargetPath);
+			const newTargetParentPath = (0, _statewalker_webrun_files.dirname)(newTargetPath);
+			const newTargetFileName = (0, _statewalker_webrun_files.basename)(newTargetPath);
 			const newTargetParent = await this.getDirectoryHandle(newTargetParentPath, { create: true });
 			if (!newTargetParent) continue;
 			const writable = await (await newTargetParent.getFileHandle(newTargetFileName, { create: true })).createWritable();
@@ -198,7 +212,6 @@ var BrowserFilesApi = class {
 async function getOPFSFilesApi() {
 	return new BrowserFilesApi({ rootHandle: await navigator.storage.getDirectory() });
 }
-
 //#endregion
 //#region src/open-browser-files-api.ts
 /**
@@ -264,10 +277,9 @@ async function openBrowserFilesApi(options = {}) {
 	}
 	return new BrowserFilesApi({ rootHandle });
 }
-
 //#endregion
 exports.BrowserFilesApi = BrowserFilesApi;
 exports.getOPFSFilesApi = getOPFSFilesApi;
 exports.isHandlerAccessible = isHandlerAccessible;
 exports.openBrowserFilesApi = openBrowserFilesApi;
-exports.verifyPermission = verifyPermission;
+exports.verifyPermission = verifyPermission;

package/dist/esm/index.js

@@ -1,5 +1,4 @@
 import { basename, dirname, joinPath, normalizePath } from "@statewalker/webrun-files";
-
 //#region src/browser-files-api.ts
 /**
 * Browser filesystem implementation using the File System Access API.
@@ -137,6 +136,20 @@ var BrowserFilesApi = class {
 		}
 	}
 	async move(source, target) {
+		const sourcePath = normalizePath(source);
+		const targetPath = normalizePath(target);
+		const targetParentPath = dirname(targetPath);
+		const targetName = basename(targetPath);
+		const sourceStats = await this.stats(sourcePath);
+		if (!sourceStats) return false;
+		const sourceHandle = sourceStats.kind === "file" ? await this.getFileHandle(sourcePath) : await this.getDirectoryHandle(sourcePath);
+		if (!sourceHandle) return false;
+		if (typeof sourceHandle.move === "function") try {
+			const targetParent = await this.getDirectoryHandle(targetParentPath, { create: true });
+			if (!targetParent) return false;
+			await sourceHandle.move(targetParent, targetName);
+			return true;
+		} catch {}
 		if (!await this.copy(source, target)) return false;
 		return this.remove(source);
 	}
@@ -198,7 +211,6 @@ var BrowserFilesApi = class {
 async function getOPFSFilesApi() {
 	return new BrowserFilesApi({ rootHandle: await navigator.storage.getDirectory() });
 }
-
 //#endregion
 //#region src/open-browser-files-api.ts
 /**
@@ -264,6 +276,5 @@ async function openBrowserFilesApi(options = {}) {
 	}
 	return new BrowserFilesApi({ rootHandle });
 }
-
 //#endregion
-export { BrowserFilesApi, getOPFSFilesApi, isHandlerAccessible, openBrowserFilesApi, verifyPermission };
+export { BrowserFilesApi, getOPFSFilesApi, isHandlerAccessible, openBrowserFilesApi, verifyPermission };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statewalker/webrun-files-browser",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "private": false,
   "type": "module",
   "description": "Browser File System Access API implementation for webrun-files",
@@ -28,25 +28,26 @@
     "dist",
     "src"
   ],
+  "scripts": {
+    "build": "rimraf dist && rolldown -c && tsc --emitDeclarationOnly --declaration",
+    "test": "vitest run",
+    "lint": "biome lint src tests",
+    "prepublishOnly": "pnpm run build"
+  },
   "dependencies": {
-    "@statewalker/webrun-files": "0.7.0"
+    "@statewalker/webrun-files": "workspace:*"
   },
   "devDependencies": {
-    "@types/node": "^24.10.1",
+    "@statewalker/webrun-files-tests": "workspace:*",
+    "@types/node": "catalog:",
     "native-file-system-adapter": "^3.0.1",
-    "rimraf": "^6.1.2",
-    "rolldown": "^1.0.0-beta.53",
-    "typescript": "^5.6.0",
-    "vitest": "^4.0.12",
-    "@statewalker/webrun-files-tests": "1.0.0"
+    "rimraf": "catalog:",
+    "rolldown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
   },
   "sideEffects": false,
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "rimraf dist && rolldown -c && tsc --emitDeclarationOnly --declaration",
-    "test": "vitest run",
-    "lint": "biome lint src tests"
   }
-}
+}

package/src/browser-files-api.ts

@@ -14,6 +14,11 @@ import type {
 } from "@statewalker/webrun-files";
 import { basename, dirname, joinPath, normalizePath } from "@statewalker/webrun-files";
 
+/** Chrome 110+ exposes move() on FileSystemHandle; not yet in TS DOM types. */
+interface MovableHandle extends FileSystemHandle {
+  move(destination: FileSystemDirectoryHandle, name: string): Promise<void>;
+}
+
 export interface BrowserFilesApiOptions {
   /**
    * Root FileSystemDirectoryHandle to use as the filesystem root.
@@ -227,6 +232,32 @@ export class BrowserFilesApi implements FilesApi {
   }
 
   async move(source: string, target: string): Promise<boolean> {
+    const sourcePath = normalizePath(source);
+    const targetPath = normalizePath(target);
+    const targetParentPath = dirname(targetPath);
+    const targetName = basename(targetPath);
+
+    // Try native move() (available in Chrome 110+, Edge 110+)
+    const sourceStats = await this.stats(sourcePath);
+    if (!sourceStats) return false;
+
+    const sourceHandle: FileSystemHandle | null =
+      sourceStats.kind === "file"
+        ? await this.getFileHandle(sourcePath)
+        : await this.getDirectoryHandle(sourcePath);
+    if (!sourceHandle) return false;
+
+    if (typeof (sourceHandle as MovableHandle).move === "function") {
+      try {
+        const targetParent = await this.getDirectoryHandle(targetParentPath, { create: true });
+        if (!targetParent) return false;
+        await (sourceHandle as MovableHandle).move(targetParent, targetName);
+        return true;
+      } catch {
+        // Fall through to copy-then-delete
+      }
+    }
+
     const copied = await this.copy(source, target);
     if (!copied) return false;
     return this.remove(source);

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2022-2026 statewalker
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.