@vrowser/fs 0.0.0

package/dist/browser/watcher/index.d.ts

@@ -0,0 +1,289 @@
+//#region src/watcher/protocol.d.ts
+/**
+ * File System Sync Protocol
+ *
+ * Message types for synchronizing file operations between
+ * Main Thread (Publisher) and Workers (Subscribers).
+ *
+ * @module watcher/protocol
+ */
+/**
+ * @author kazuya kawaguchi (a.k.a. kazupon)
+ * @license MIT
+ */
+/**
+ * File content encoding type.
+ * - 'text': UTF-8 string content (JS, TS, JSON, CSS, HTML, etc.)
+ * - 'binary': ArrayBuffer content (images, WASM, fonts, etc.)
+ *
+ * When encoding is 'binary', the content is an ArrayBuffer
+ * and MUST be transferred via postMessage's transfer list
+ * for zero-copy performance.
+ */
+type FSContentEncoding = 'text' | 'binary';
+/**
+ * Main Thread -> Worker: Write (create or update) a file.
+ *
+ * For text files:
+ *   { type: 'V_FS_WRITE', path: '/main.js', encoding: 'text', content: '...' }
+ *   -> postMessage(message)
+ *
+ * For binary files:
+ *   { type: 'V_FS_WRITE', path: '/image.png', encoding: 'binary', content: ArrayBuffer }
+ *   -> postMessage(message, [message.content])  // transfer list
+ */
+interface FSWriteMessage {
+  type: 'V_FS_WRITE';
+  /**
+   * Path of the file to write. Must not end with '/' (directories use FS_MKDIR with path ending in '/').
+   */
+  path: string;
+  /**
+   * Encoding of the content. Determines how the Worker should interpret the content.
+   */
+  encoding: FSContentEncoding;
+  /**
+   * Content of the file. Type depends on encoding:
+   * - 'text': UTF-8 string content
+   * - 'binary': ArrayBuffer content (transferred via postMessage's transfer list)
+   */
+  content: string | ArrayBuffer;
+}
+/**
+ * Main Thread -> Worker: Delete a file.
+ */
+interface FSUnlinkMessage {
+  type: 'V_FS_UNLINK';
+  /**
+   * Path of the file to delete. Must not end with '/' (directories use FS_MKDIR with path ending in '/').
+   */
+  path: string;
+}
+/**
+ * Main Thread -> Worker: Create a directory.
+ */
+interface FSMkdirMessage {
+  type: 'V_FS_MKDIR';
+  /**
+   * Path of the directory to create. Must end with '/' to distinguish from files.
+   */
+  path: string;
+}
+/**
+ * Main Thread -> Worker: Initialize files in bulk.
+ * Used during setup to populate the virtual filesystem.
+ *
+ * Text files are in `files`, binary files are in `binaryFiles`.
+ * Binary ArrayBuffers are transferred via postMessage's transfer list.
+ */
+interface FSInitMessage {
+  type: 'V_FS_INIT';
+  /**
+   * Text files: path -> UTF-8 string content
+   */
+  files?: Record<string, string>;
+  /**
+   * Binary files: path -> ArrayBuffer content (transferred)
+   */
+  binaryFiles?: Record<string, ArrayBuffer>;
+}
+type FileSystemSyncMessage = FSWriteMessage | FSUnlinkMessage | FSMkdirMessage | FSInitMessage;
+declare const V_FS_WRITE: "V_FS_WRITE";
+declare const V_FS_UNLINK: "V_FS_UNLINK";
+declare const V_FS_MKDIR: "V_FS_MKDIR";
+declare const V_FS_INIT: "V_FS_INIT";
+//#endregion
+//#region src/watcher/publisher.d.ts
+/**
+ * FileSystemPublisher - Main Thread side of the Pub-Sub filesystem sync.
+ *
+ * Sends V_FS_* protocol messages to Worker targets (Service Worker, Web Worker).
+ * Provides a `node:fs`-like API for reduced cognitive load.
+ *
+ * @module watcher/publisher
+ */
+/**
+ * A postMessage target compatible like Service Worker and Web Worker APIs.
+ */
+interface FileSystemPublisherTarget {
+  postMessage(message: any, transfer: Transferable[]): void;
+  postMessage(message: any, options?: StructuredSerializeOptions): void;
+}
+/**
+ * Publisher for broadcasting filesystem operations to Workers.
+ *
+ * API is modeled after `node:fs` for familiarity:
+ * - `writeFile` accepts both `string` (text) and `ArrayBuffer` (binary)
+ * - `unlink` deletes a file
+ * - `mkdir` creates a directory
+ */
+interface FileSystemPublisher {
+  /**
+   * Write a file. Encoding is inferred: string → text, ArrayBuffer → binary.
+   *
+   * @param path - Path of the file to write. Must not end with '/' (directories use mkdir with path ending in '/').
+   * @param content - Content of the file. Type determines encoding:
+   *   - string: UTF-8 text content
+   *   - ArrayBuffer: binary content (transferred via postMessage's transfer list for zero-copy performance)
+   */
+  writeFile(path: string, content: string | ArrayBuffer): void;
+  /**
+   * Delete a file.
+   *
+   * @param path - Path of the file to delete. Must not end with '/' (directories use mkdir with path ending in '/').
+   */
+  unlink(path: string): void;
+  /**
+   * Create a directory.
+   *
+   * @param path - Path of the directory to create. Must end with '/' to distinguish from files.
+   */
+  mkdir(path: string): void;
+  /**
+   * Initialize files in bulk.
+   *
+   * @param files - Text files: path -> UTF-8 string content
+   * @param binaryFiles - Binary files: path -> ArrayBuffer content (transferred)
+   */
+  initFiles(files?: Record<string, string>, binaryFiles?: Record<string, ArrayBuffer>): void;
+  /**
+   * Add a postMessage target.
+   *
+   * @param target - The target to add (e.g. Worker, ServiceWorker)
+   */
+  addTarget(target: FileSystemPublisherTarget): void;
+  /**
+   * Remove a postMessage target.
+   *
+   * @param target - The target to remove (e.g. Worker, ServiceWorker)
+   */
+  removeTarget(target: FileSystemPublisherTarget): void;
+}
+/**
+ * Create a {@link FileSystemPublisher} instance.
+ *
+ * @param targets - Initial postMessage targets (e.g. Worker, ServiceWorker)
+ * @returns FileSystemPublisher instance
+ */
+declare function createFileSystemPublisher(targets?: FileSystemPublisherTarget[]): Readonly<FileSystemPublisher>;
+//#endregion
+//#region src/watcher/virtual.d.ts
+/**
+ * VirtualFSWatcher - chokidar compatible FSWatcher for virtual filesystems.
+ *
+ * Unlike real chokidar, this watcher does not monitor the filesystem.
+ * File events are triggered externally via `notify()` by the FileSystemSubscriber.
+ *
+ * @module watcher/virtual
+ */
+/**
+ * @author kazuya kawaguchi (a.k.a. kazupon)
+ * @license MIT
+ */
+type WatchEventName = 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir';
+/**
+ * Watch options for VirtualFSWatcher.
+ * Uses an index signature for structural compatibility with chokidar's WatchOptions.
+ */
+interface VirtualWatchOptions {
+  [key: string]: any;
+}
+/**
+ * chokidar compatible FSWatcher interface for virtual filesystems.
+ *
+ * This interface is the base type that vite-dev-server's `FSWatcher` extends.
+ * The `notify()` method is specific to VirtualFSWatcher.
+ */
+interface VirtualFSWatcher {
+  options: VirtualWatchOptions;
+  /**
+   * Notify the watcher of a file event.
+   * Called by FileSystemSubscriber when a V_FS_* message is received.
+   */
+  notify(event: WatchEventName, path: string): void;
+  add(paths: string | ReadonlyArray<string>): VirtualFSWatcher;
+  unwatch(paths: string | ReadonlyArray<string>): VirtualFSWatcher;
+  getWatched(): {
+    [directory: string]: string[];
+  };
+  close(): Promise<void>;
+  ref(): VirtualFSWatcher;
+  unref(): VirtualFSWatcher;
+  on(event: 'add' | 'addDir' | 'change', listener: (path: string, stats?: any) => void): VirtualFSWatcher;
+  on(event: 'all', listener: (eventName: WatchEventName, path: string, stats?: any) => void): VirtualFSWatcher;
+  on(event: 'error', listener: (error: Error) => void): VirtualFSWatcher;
+  on(event: 'raw', listener: (eventName: string, path: string, details: any) => void): VirtualFSWatcher;
+  on(event: 'ready', listener: () => void): VirtualFSWatcher;
+  on(event: 'unlink' | 'unlinkDir', listener: (path: string) => void): VirtualFSWatcher;
+  on(event: string, listener: (...args: any[]) => void): VirtualFSWatcher;
+  off(event: string, listener: (...args: any[]) => void): VirtualFSWatcher;
+  once(event: string, listener: (...args: any[]) => void): VirtualFSWatcher;
+  emit(event: string, ...args: any[]): boolean;
+  removeListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher;
+  removeAllListeners(event?: string): VirtualFSWatcher;
+  addListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher;
+  listeners(event: string): Function[];
+  listenerCount(event: string): number;
+  eventNames(): string[];
+  getMaxListeners(): number;
+  setMaxListeners(n: number): VirtualFSWatcher;
+  prependListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher;
+  prependOnceListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher;
+  rawListeners(event: string): Function[];
+}
+/**
+ * Create a VirtualFSWatcher instance.
+ *
+ * @param options - Watch options (structural compatibility with chokidar WatchOptions)
+ * @returns VirtualFSWatcher instance
+ */
+declare function createVirtualFSWatcher(options?: VirtualWatchOptions): Readonly<VirtualFSWatcher>;
+//#endregion
+//#region src/watcher/subscriber.d.ts
+/**
+ * Minimal fs interface required by FileSystemSubscriber.
+ */
+interface FileSystemInterfaces {
+  existsSync(path: string): boolean;
+  writeFileSync(path: string, data: any, options?: any): void;
+  unlinkSync(path: string): void;
+  mkdirSync(path: string, options?: any): void;
+}
+/**
+ * Subscriber for processing filesystem sync messages in Workers.
+ */
+interface FileSystemSubscriber {
+  /**
+   * chokidar compatible {@link VirtualFSWatcher | FSWatcher}.
+   */
+  readonly watcher: VirtualFSWatcher;
+  /**
+   * Process a V_FS_* protocol message. Updates vol and notifies watcher.
+   */
+  handleMessage(message: FileSystemSyncMessage): void;
+}
+/**
+ * Options for {@link createFileSystemSubscriber}.
+ */
+interface CreateFileSystemSubscriberOptions {
+  /**
+   * External VirtualFSWatcher instance to use.
+   * If provided, the subscriber will use this watcher instead of creating a new one.
+   * This allows creating the watcher early (e.g. for DevEnvironment.init)
+   * and the subscriber later (e.g. after transformer loads).
+   */
+  watcher?: VirtualFSWatcher;
+}
+/**
+ * Create a {@link FileSystemSubscriber} instance.
+ *
+ * @param fs - fs instance to use for vol operations.
+ *   Must be explicitly passed to avoid module instance mismatch when bundlers
+ *   create separate copies of @vrowser/fs.
+ * @param options - Options including optional external watcher
+ * @returns FileSystemSubscriber instance with a VirtualFSWatcher
+ */
+declare function createFileSystemSubscriber(fs: FileSystemInterfaces, options?: CreateFileSystemSubscriberOptions): Readonly<FileSystemSubscriber>;
+//#endregion
+export { CreateFileSystemSubscriberOptions, FSContentEncoding, FSInitMessage, FSMkdirMessage, FSUnlinkMessage, FSWriteMessage, FileSystemInterfaces, FileSystemPublisher, FileSystemPublisherTarget, FileSystemSubscriber, FileSystemSyncMessage, V_FS_INIT, V_FS_MKDIR, V_FS_UNLINK, V_FS_WRITE, VirtualFSWatcher, VirtualWatchOptions, WatchEventName, createFileSystemPublisher, createFileSystemSubscriber, createVirtualFSWatcher };
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/watcher/protocol.ts","../../../src/watcher/publisher.ts","../../../src/watcher/virtual.ts","../../../src/watcher/subscriber.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/browser/watcher/index.js

@@ -0,0 +1,231 @@
+//#region src/watcher/protocol.ts
+const V_FS_WRITE = "V_FS_WRITE";
+const V_FS_UNLINK = "V_FS_UNLINK";
+const V_FS_MKDIR = "V_FS_MKDIR";
+const V_FS_INIT = "V_FS_INIT";
+
+//#endregion
+//#region src/watcher/publisher.ts
+/**
+* Create a {@link FileSystemPublisher} instance.
+*
+* @param targets - Initial postMessage targets (e.g. Worker, ServiceWorker)
+* @returns FileSystemPublisher instance
+*/
+function createFileSystemPublisher(targets) {
+	const _targets = new Set(targets);
+	function broadcast(message, transfer = []) {
+		for (const target of _targets) target.postMessage(message, transfer);
+	}
+	return Object.freeze({
+		writeFile(path, content) {
+			if (typeof content === "string") broadcast({
+				type: "V_FS_WRITE",
+				path,
+				encoding: "text",
+				content
+			});
+			else {
+				const targetList = [..._targets];
+				for (let i = 0; i < targetList.length; i++) {
+					const buf = i === 0 ? content : content.slice(0);
+					const msg = {
+						type: "V_FS_WRITE",
+						path,
+						encoding: "binary",
+						content: buf
+					};
+					targetList[i].postMessage(msg, [buf]);
+				}
+			}
+		},
+		unlink(path) {
+			broadcast({
+				type: "V_FS_UNLINK",
+				path
+			});
+		},
+		mkdir(path) {
+			broadcast({
+				type: "V_FS_MKDIR",
+				path
+			});
+		},
+		initFiles(files, binaryFiles) {
+			const transfer = binaryFiles ? Object.values(binaryFiles) : [];
+			const msg = { type: "V_FS_INIT" };
+			if (files) msg.files = files;
+			if (binaryFiles) msg.binaryFiles = binaryFiles;
+			broadcast(msg, transfer);
+		},
+		addTarget(target) {
+			_targets.add(target);
+		},
+		removeTarget(target) {
+			_targets.delete(target);
+		}
+	});
+}
+
+//#endregion
+//#region src/watcher/virtual.ts
+/**
+* Create a VirtualFSWatcher instance.
+*
+* @param options - Watch options (structural compatibility with chokidar WatchOptions)
+* @returns VirtualFSWatcher instance
+*/
+function createVirtualFSWatcher(options = {}) {
+	const handlers = /* @__PURE__ */ new Map();
+	let closed = false;
+	function _emit(event, ...args) {
+		const listeners = handlers.get(event);
+		if (!listeners?.size) return false;
+		for (const handler of [...listeners]) handler(...args);
+		return true;
+	}
+	const watcher = {
+		options,
+		notify(event, path) {
+			if (closed) return;
+			_emit(event, path);
+			_emit("all", event, path);
+		},
+		add() {
+			return watcher;
+		},
+		unwatch() {
+			return watcher;
+		},
+		getWatched() {
+			return {};
+		},
+		async close() {
+			closed = true;
+			handlers.clear();
+		},
+		ref() {
+			return watcher;
+		},
+		unref() {
+			return watcher;
+		},
+		on(event, listener) {
+			if (!handlers.has(event)) handlers.set(event, /* @__PURE__ */ new Set());
+			handlers.get(event).add(listener);
+			return watcher;
+		},
+		off(event, listener) {
+			handlers.get(event)?.delete(listener);
+			return watcher;
+		},
+		once(event, listener) {
+			const wrapper = (...args) => {
+				watcher.off(event, wrapper);
+				listener(...args);
+			};
+			return watcher.on(event, wrapper);
+		},
+		emit(event, ...args) {
+			return _emit(event, ...args);
+		},
+		removeListener(event, listener) {
+			return watcher.off(event, listener);
+		},
+		removeAllListeners(event) {
+			if (event) handlers.delete(event);
+			else handlers.clear();
+			return watcher;
+		},
+		addListener(event, listener) {
+			return watcher.on(event, listener);
+		},
+		listeners(event) {
+			return [...handlers.get(event) ?? []];
+		},
+		listenerCount(event) {
+			return handlers.get(event)?.size ?? 0;
+		},
+		eventNames() {
+			return [...handlers.keys()];
+		},
+		getMaxListeners() {
+			return Infinity;
+		},
+		setMaxListeners() {
+			return watcher;
+		},
+		prependListener(event, listener) {
+			return watcher.on(event, listener);
+		},
+		prependOnceListener(event, listener) {
+			return watcher.once(event, listener);
+		},
+		rawListeners(event) {
+			return watcher.listeners(event);
+		}
+	};
+	return Object.freeze(watcher);
+}
+
+//#endregion
+//#region src/watcher/subscriber.ts
+/**
+* Create a {@link FileSystemSubscriber} instance.
+*
+* @param fs - fs instance to use for vol operations.
+*   Must be explicitly passed to avoid module instance mismatch when bundlers
+*   create separate copies of @vrowser/fs.
+* @param options - Options including optional external watcher
+* @returns FileSystemSubscriber instance with a VirtualFSWatcher
+*/
+function createFileSystemSubscriber(fs, options) {
+	const watcher = options?.watcher ?? createVirtualFSWatcher();
+	function ensureDir(filePath) {
+		const dir = filePath.substring(0, filePath.lastIndexOf("/"));
+		if (dir && !fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+	}
+	function writeToVol(path, encoding, content) {
+		ensureDir(path);
+		if (encoding === "binary") fs.writeFileSync(path, new Uint8Array(content));
+		else fs.writeFileSync(path, content, { encoding: "utf8" });
+	}
+	function handleMessage(message) {
+		switch (message.type) {
+			case "V_FS_WRITE": {
+				const exists = fs.existsSync(message.path);
+				writeToVol(message.path, message.encoding, message.content);
+				watcher.notify(exists ? "change" : "add", message.path);
+				break;
+			}
+			case "V_FS_UNLINK":
+				if (fs.existsSync(message.path)) {
+					fs.unlinkSync(message.path);
+					watcher.notify("unlink", message.path);
+				}
+				break;
+			case "V_FS_MKDIR":
+				fs.mkdirSync(message.path, { recursive: true });
+				watcher.notify("addDir", message.path);
+				break;
+			case "V_FS_INIT":
+				if (message.files) for (const [path, content] of Object.entries(message.files)) {
+					writeToVol(path, "text", content);
+					watcher.notify("add", path);
+				}
+				if (message.binaryFiles) for (const [path, content] of Object.entries(message.binaryFiles)) {
+					writeToVol(path, "binary", content);
+					watcher.notify("add", path);
+				}
+				break;
+		}
+	}
+	return Object.freeze({
+		watcher,
+		handleMessage
+	});
+}
+
+//#endregion
+export { V_FS_INIT, V_FS_MKDIR, V_FS_UNLINK, V_FS_WRITE, createFileSystemPublisher, createFileSystemSubscriber, createVirtualFSWatcher };
+//# sourceMappingURL=index.js.map

package/dist/browser/watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["msg: FSWriteMessage","transfer: Transferable[]","msg: FSInitMessage","watcher: VirtualFSWatcher"],"sources":["../../../src/watcher/protocol.ts","../../../src/watcher/publisher.ts","../../../src/watcher/virtual.ts","../../../src/watcher/subscriber.ts"],"sourcesContent":["/**\n * File System Sync Protocol\n *\n * Message types for synchronizing file operations between\n * Main Thread (Publisher) and Workers (Subscribers).\n *\n * @module watcher/protocol\n */\n\n/**\n * @author kazuya kawaguchi (a.k.a. kazupon)\n * @license MIT\n */\n\n/**\n * File content encoding type.\n * - 'text': UTF-8 string content (JS, TS, JSON, CSS, HTML, etc.)\n * - 'binary': ArrayBuffer content (images, WASM, fonts, etc.)\n *\n * When encoding is 'binary', the content is an ArrayBuffer\n * and MUST be transferred via postMessage's transfer list\n * for zero-copy performance.\n */\nexport type FSContentEncoding = 'text' | 'binary'\n\n/**\n * Main Thread -> Worker: Write (create or update) a file.\n *\n * For text files:\n *   { type: 'V_FS_WRITE', path: '/main.js', encoding: 'text', content: '...' }\n *   -> postMessage(message)\n *\n * For binary files:\n *   { type: 'V_FS_WRITE', path: '/image.png', encoding: 'binary', content: ArrayBuffer }\n *   -> postMessage(message, [message.content])  // transfer list\n */\nexport interface FSWriteMessage {\n  type: 'V_FS_WRITE'\n  /**\n   * Path of the file to write. Must not end with '/' (directories use FS_MKDIR with path ending in '/').\n   */\n  path: string\n  /**\n   * Encoding of the content. Determines how the Worker should interpret the content.\n   */\n  encoding: FSContentEncoding\n  /**\n   * Content of the file. Type depends on encoding:\n   * - 'text': UTF-8 string content\n   * - 'binary': ArrayBuffer content (transferred via postMessage's transfer list)\n   */\n  content: string | ArrayBuffer\n}\n\n/**\n * Main Thread -> Worker: Delete a file.\n */\nexport interface FSUnlinkMessage {\n  type: 'V_FS_UNLINK'\n  /**\n   * Path of the file to delete. Must not end with '/' (directories use FS_MKDIR with path ending in '/').\n   */\n  path: string\n}\n\n/**\n * Main Thread -> Worker: Create a directory.\n */\nexport interface FSMkdirMessage {\n  type: 'V_FS_MKDIR'\n  /**\n   * Path of the directory to create. Must end with '/' to distinguish from files.\n   */\n  path: string\n}\n\n/**\n * Main Thread -> Worker: Initialize files in bulk.\n * Used during setup to populate the virtual filesystem.\n *\n * Text files are in `files`, binary files are in `binaryFiles`.\n * Binary ArrayBuffers are transferred via postMessage's transfer list.\n */\nexport interface FSInitMessage {\n  type: 'V_FS_INIT'\n  /**\n   * Text files: path -> UTF-8 string content\n   */\n  files?: Record<string, string>\n  /**\n   * Binary files: path -> ArrayBuffer content (transferred)\n   */\n  binaryFiles?: Record<string, ArrayBuffer>\n}\n\nexport type FileSystemSyncMessage =\n  | FSWriteMessage\n  | FSUnlinkMessage\n  | FSMkdirMessage\n  | FSInitMessage\n\n// Constants\nexport const V_FS_WRITE = 'V_FS_WRITE' as const\nexport const V_FS_UNLINK = 'V_FS_UNLINK' as const\nexport const V_FS_MKDIR = 'V_FS_MKDIR' as const\nexport const V_FS_INIT = 'V_FS_INIT' as const\n","/**\n * FileSystemPublisher - Main Thread side of the Pub-Sub filesystem sync.\n *\n * Sends V_FS_* protocol messages to Worker targets (Service Worker, Web Worker).\n * Provides a `node:fs`-like API for reduced cognitive load.\n *\n * @module watcher/publisher\n */\n\n/**\n * @author kazuya kawaguchi (a.k.a. kazupon)\n * @license MIT\n */\n\nimport type { FSInitMessage, FSWriteMessage, FileSystemSyncMessage } from './protocol.ts'\n\n/**\n * A postMessage target compatible like Service Worker and Web Worker APIs.\n */\nexport interface FileSystemPublisherTarget {\n  postMessage(message: any, transfer: Transferable[]): void\n  postMessage(message: any, options?: StructuredSerializeOptions): void\n}\n\n/**\n * Publisher for broadcasting filesystem operations to Workers.\n *\n * API is modeled after `node:fs` for familiarity:\n * - `writeFile` accepts both `string` (text) and `ArrayBuffer` (binary)\n * - `unlink` deletes a file\n * - `mkdir` creates a directory\n */\nexport interface FileSystemPublisher {\n  /**\n   * Write a file. Encoding is inferred: string → text, ArrayBuffer → binary.\n   *\n   * @param path - Path of the file to write. Must not end with '/' (directories use mkdir with path ending in '/').\n   * @param content - Content of the file. Type determines encoding:\n   *   - string: UTF-8 text content\n   *   - ArrayBuffer: binary content (transferred via postMessage's transfer list for zero-copy performance)\n   */\n  writeFile(path: string, content: string | ArrayBuffer): void\n  /**\n   * Delete a file.\n   *\n   * @param path - Path of the file to delete. Must not end with '/' (directories use mkdir with path ending in '/').\n   */\n  unlink(path: string): void\n  /**\n   * Create a directory.\n   *\n   * @param path - Path of the directory to create. Must end with '/' to distinguish from files.\n   */\n  mkdir(path: string): void\n  /**\n   * Initialize files in bulk.\n   *\n   * @param files - Text files: path -> UTF-8 string content\n   * @param binaryFiles - Binary files: path -> ArrayBuffer content (transferred)\n   */\n  initFiles(files?: Record<string, string>, binaryFiles?: Record<string, ArrayBuffer>): void\n  /**\n   * Add a postMessage target.\n   *\n   * @param target - The target to add (e.g. Worker, ServiceWorker)\n   */\n  addTarget(target: FileSystemPublisherTarget): void\n  /**\n   * Remove a postMessage target.\n   *\n   * @param target - The target to remove (e.g. Worker, ServiceWorker)\n   */\n  removeTarget(target: FileSystemPublisherTarget): void\n}\n\n/**\n * Create a {@link FileSystemPublisher} instance.\n *\n * @param targets - Initial postMessage targets (e.g. Worker, ServiceWorker)\n * @returns FileSystemPublisher instance\n */\nexport function createFileSystemPublisher(\n  targets?: FileSystemPublisherTarget[]\n): Readonly<FileSystemPublisher> {\n  const _targets = new Set<FileSystemPublisherTarget>(targets)\n\n  function broadcast(message: FileSystemSyncMessage, transfer: Transferable[] = []) {\n    for (const target of _targets) {\n      target.postMessage(message, transfer)\n    }\n  }\n\n  const instance: FileSystemPublisher = {\n    writeFile(path, content) {\n      if (typeof content === 'string') {\n        broadcast({ type: 'V_FS_WRITE', path, encoding: 'text', content })\n      } else {\n        // ArrayBuffer: transfer list for zero-copy.\n        // First target gets the original buffer, subsequent targets get copies.\n        const targetList = [..._targets]\n        for (let i = 0; i < targetList.length; i++) {\n          const buf = i === 0 ? content : content.slice(0)\n          const msg: FSWriteMessage = { type: 'V_FS_WRITE', path, encoding: 'binary', content: buf }\n          // @ts-expect-error - postMessage with transfer list is supported by both Worker and ServiceWorker targets, but TypeScript typings may not reflect this accurately.\n          targetList[i].postMessage(msg, [buf])\n        }\n      }\n    },\n\n    unlink(path) {\n      broadcast({ type: 'V_FS_UNLINK', path })\n    },\n\n    mkdir(path) {\n      broadcast({ type: 'V_FS_MKDIR', path })\n    },\n\n    initFiles(files, binaryFiles) {\n      const transfer: Transferable[] = binaryFiles ? Object.values(binaryFiles) : []\n      const msg: FSInitMessage = { type: 'V_FS_INIT' }\n      if (files) {\n        msg.files = files\n      }\n      if (binaryFiles) {\n        msg.binaryFiles = binaryFiles\n      }\n      broadcast(msg, transfer)\n    },\n\n    addTarget(target) {\n      _targets.add(target)\n    },\n\n    removeTarget(target) {\n      _targets.delete(target)\n    }\n  }\n\n  return Object.freeze(instance)\n}\n","/**\n * VirtualFSWatcher - chokidar compatible FSWatcher for virtual filesystems.\n *\n * Unlike real chokidar, this watcher does not monitor the filesystem.\n * File events are triggered externally via `notify()` by the FileSystemSubscriber.\n *\n * @module watcher/virtual\n */\n\n/**\n * @author kazuya kawaguchi (a.k.a. kazupon)\n * @license MIT\n */\n\nexport type WatchEventName = 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir'\n\n/**\n * Watch options for VirtualFSWatcher.\n * Uses an index signature for structural compatibility with chokidar's WatchOptions.\n */\nexport interface VirtualWatchOptions {\n  [key: string]: any\n}\n\n/**\n * chokidar compatible FSWatcher interface for virtual filesystems.\n *\n * This interface is the base type that vite-dev-server's `FSWatcher` extends.\n * The `notify()` method is specific to VirtualFSWatcher.\n */\nexport interface VirtualFSWatcher {\n  options: VirtualWatchOptions\n\n  // ---- VirtualFSWatcher specific ----\n\n  /**\n   * Notify the watcher of a file event.\n   * Called by FileSystemSubscriber when a V_FS_* message is received.\n   */\n  notify(event: WatchEventName, path: string): void\n\n  // ---- chokidar FSWatcher interface ----\n\n  add(paths: string | ReadonlyArray<string>): VirtualFSWatcher\n  unwatch(paths: string | ReadonlyArray<string>): VirtualFSWatcher\n  getWatched(): { [directory: string]: string[] }\n  close(): Promise<void>\n  ref(): VirtualFSWatcher\n  unref(): VirtualFSWatcher\n\n  // ---- EventEmitter I/F (chokidar compatible) ----\n\n  on(\n    event: 'add' | 'addDir' | 'change',\n    listener: (path: string, stats?: any) => void\n  ): VirtualFSWatcher\n  on(\n    event: 'all',\n    listener: (eventName: WatchEventName, path: string, stats?: any) => void\n  ): VirtualFSWatcher\n  on(event: 'error', listener: (error: Error) => void): VirtualFSWatcher\n  on(\n    event: 'raw',\n    listener: (eventName: string, path: string, details: any) => void\n  ): VirtualFSWatcher\n  on(event: 'ready', listener: () => void): VirtualFSWatcher\n  on(event: 'unlink' | 'unlinkDir', listener: (path: string) => void): VirtualFSWatcher\n  on(event: string, listener: (...args: any[]) => void): VirtualFSWatcher\n  off(event: string, listener: (...args: any[]) => void): VirtualFSWatcher\n  once(event: string, listener: (...args: any[]) => void): VirtualFSWatcher\n  emit(event: string, ...args: any[]): boolean\n  removeListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher\n  removeAllListeners(event?: string): VirtualFSWatcher\n  addListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher\n  listeners(event: string): Function[]\n  listenerCount(event: string): number\n  eventNames(): string[]\n  getMaxListeners(): number\n  setMaxListeners(n: number): VirtualFSWatcher\n  prependListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher\n  prependOnceListener(event: string, listener: (...args: any[]) => void): VirtualFSWatcher\n  rawListeners(event: string): Function[]\n}\n\n/**\n * Create a VirtualFSWatcher instance.\n *\n * @param options - Watch options (structural compatibility with chokidar WatchOptions)\n * @returns VirtualFSWatcher instance\n */\nexport function createVirtualFSWatcher(\n  options: VirtualWatchOptions = {}\n): Readonly<VirtualFSWatcher> {\n  const handlers = new Map<string, Set<(...args: any[]) => void>>()\n  let closed = false\n\n  function _emit(event: string, ...args: any[]): boolean {\n    const listeners = handlers.get(event)\n    if (!listeners?.size) {\n      return false\n    }\n    // Clone the set before iterating to avoid issues if handlers are modified during iteration\n    for (const handler of [...listeners]) {\n      handler(...args)\n    }\n    return true\n  }\n\n  const watcher: VirtualFSWatcher = {\n    options,\n\n    // ---- VirtualFSWatcher specific ----\n\n    notify(event, path) {\n      if (closed) {\n        return\n      }\n      _emit(event, path)\n      _emit('all', event, path)\n    },\n\n    // ---- chokidar FSWatcher interface ----\n\n    add() {\n      return watcher\n    },\n    unwatch() {\n      return watcher\n    },\n    getWatched() {\n      return {}\n    },\n    async close() {\n      closed = true\n      handlers.clear()\n    },\n    ref() {\n      return watcher\n    },\n    unref() {\n      return watcher\n    },\n\n    // ---- EventEmitter I/F ----\n\n    on(event: string, listener: (...args: any[]) => void) {\n      if (!handlers.has(event)) {\n        handlers.set(event, new Set())\n      }\n      handlers.get(event)!.add(listener)\n      return watcher\n    },\n\n    off(event, listener) {\n      handlers.get(event)?.delete(listener)\n      return watcher\n    },\n\n    once(event, listener) {\n      const wrapper = (...args: any[]) => {\n        watcher.off(event, wrapper)\n        listener(...args)\n      }\n      return watcher.on(event, wrapper)\n    },\n\n    emit(event, ...args) {\n      return _emit(event, ...args)\n    },\n\n    removeListener(event, listener) {\n      return watcher.off(event, listener)\n    },\n\n    removeAllListeners(event?) {\n      if (event) {\n        handlers.delete(event)\n      } else {\n        handlers.clear()\n      }\n      return watcher\n    },\n\n    addListener(event, listener) {\n      return watcher.on(event, listener)\n    },\n\n    listeners(event) {\n      return [...(handlers.get(event) ?? [])]\n    },\n\n    listenerCount(event) {\n      return handlers.get(event)?.size ?? 0\n    },\n\n    eventNames() {\n      return [...handlers.keys()]\n    },\n\n    getMaxListeners() {\n      return Infinity\n    },\n    setMaxListeners() {\n      return watcher\n    },\n\n    prependListener(event, listener) {\n      return watcher.on(event, listener)\n    },\n\n    prependOnceListener(event, listener) {\n      return watcher.once(event, listener)\n    },\n\n    rawListeners(event) {\n      return watcher.listeners(event)\n    }\n  }\n\n  return Object.freeze(watcher)\n}\n","/**\n * FileSystemSubscriber - Worker side of the Pub-Sub filesystem sync.\n *\n * Receives V_FS_* protocol messages, updates the @vrowser/fs memfs volume,\n * and notifies the VirtualFSWatcher to trigger chokidar-compatible events.\n *\n * @module watcher/subscriber\n */\n\n/**\n * @author kazuya kawaguchi (a.k.a. kazupon)\n * @license MIT\n */\n\nimport type { FSContentEncoding, FileSystemSyncMessage } from './protocol.ts'\nimport type { VirtualFSWatcher } from './virtual.ts'\nimport { createVirtualFSWatcher } from './virtual.ts'\n\n/**\n * Minimal fs interface required by FileSystemSubscriber.\n */\nexport interface FileSystemInterfaces {\n  existsSync(path: string): boolean\n  writeFileSync(path: string, data: any, options?: any): void\n  unlinkSync(path: string): void\n  mkdirSync(path: string, options?: any): void\n}\n\n/**\n * Subscriber for processing filesystem sync messages in Workers.\n */\nexport interface FileSystemSubscriber {\n  /**\n   * chokidar compatible {@link VirtualFSWatcher | FSWatcher}.\n   */\n  readonly watcher: VirtualFSWatcher\n  /**\n   * Process a V_FS_* protocol message. Updates vol and notifies watcher.\n   */\n  handleMessage(message: FileSystemSyncMessage): void\n}\n\n/**\n * Options for {@link createFileSystemSubscriber}.\n */\nexport interface CreateFileSystemSubscriberOptions {\n  /**\n   * External VirtualFSWatcher instance to use.\n   * If provided, the subscriber will use this watcher instead of creating a new one.\n   * This allows creating the watcher early (e.g. for DevEnvironment.init)\n   * and the subscriber later (e.g. after transformer loads).\n   */\n  watcher?: VirtualFSWatcher\n}\n\n/**\n * Create a {@link FileSystemSubscriber} instance.\n *\n * @param fs - fs instance to use for vol operations.\n *   Must be explicitly passed to avoid module instance mismatch when bundlers\n *   create separate copies of @vrowser/fs.\n * @param options - Options including optional external watcher\n * @returns FileSystemSubscriber instance with a VirtualFSWatcher\n */\nexport function createFileSystemSubscriber(\n  fs: FileSystemInterfaces,\n  options?: CreateFileSystemSubscriberOptions\n): Readonly<FileSystemSubscriber> {\n  const watcher = options?.watcher ?? createVirtualFSWatcher()\n\n  function ensureDir(filePath: string): void {\n    const dir = filePath.substring(0, filePath.lastIndexOf('/'))\n    if (dir && !fs.existsSync(dir)) {\n      fs.mkdirSync(dir, { recursive: true })\n    }\n  }\n\n  function writeToVol(\n    path: string,\n    encoding: FSContentEncoding,\n    content: string | ArrayBuffer\n  ): void {\n    ensureDir(path)\n    if (encoding === 'binary') {\n      fs.writeFileSync(path, new Uint8Array(content as ArrayBuffer))\n    } else {\n      fs.writeFileSync(path, content as string, { encoding: 'utf8' })\n    }\n  }\n\n  function handleMessage(message: FileSystemSyncMessage): void {\n    switch (message.type) {\n      case 'V_FS_WRITE': {\n        const exists = fs.existsSync(message.path)\n        writeToVol(message.path, message.encoding, message.content)\n        watcher.notify(exists ? 'change' : 'add', message.path)\n        break\n      }\n\n      case 'V_FS_UNLINK': {\n        if (fs.existsSync(message.path)) {\n          fs.unlinkSync(message.path)\n          watcher.notify('unlink', message.path)\n        }\n        break\n      }\n\n      case 'V_FS_MKDIR': {\n        fs.mkdirSync(message.path, { recursive: true })\n        watcher.notify('addDir', message.path)\n        break\n      }\n\n      case 'V_FS_INIT': {\n        if (message.files) {\n          for (const [path, content] of Object.entries(message.files)) {\n            writeToVol(path, 'text', content)\n            watcher.notify('add', path)\n          }\n        }\n        if (message.binaryFiles) {\n          for (const [path, content] of Object.entries(message.binaryFiles)) {\n            writeToVol(path, 'binary', content)\n            watcher.notify('add', path)\n          }\n        }\n        break\n      }\n    }\n  }\n\n  return Object.freeze({ watcher, handleMessage })\n}\n"],"mappings":"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"}