@lova/mem-vfs 0.1.0

package/README.md

@@ -0,0 +1,222 @@
+# mem-vfs
+
+High-performance in-memory virtual file system for Node.js with symlink support, file watching, and snapshot/rollback capabilities.
+
+## Features
+
+- **Complete File System API**: readFile, writeFile, appendFile, deleteFile, copyFile, moveFile
+- **Directory Operations**: createDirectory, readDirectory, deleteDirectory (with recursive option)
+- **Symbolic Links**: createSymlink, readSymlink, isSymlink with loop detection
+- **Glob Pattern Matching**: Full glob support with maxDepth, followSymlinks, ignore patterns
+- **Snapshots & Rollback**: Create snapshots, restore state, compute diffs
+- **JSON Import/Export**: Load from and export to JSON structure
+- **Path Utilities**: normalize, resolve, relative, join, dirname, basename
+
+## Installation
+
+```bash
+npm install mem-vfs
+# or
+pnpm add mem-vfs
+```
+
+## Quick Start
+
+```typescript
+import { createVFS } from 'mem-vfs';
+
+const vfs = createVFS();
+
+// Write and read files
+await vfs.writeFile('/src/index.ts', 'export const hello = "world";');
+const content = await vfs.readFile('/src/index.ts', 'utf-8');
+
+// Create directories
+await vfs.createDirectory('/src/utils', true);
+
+// Glob search
+const tsFiles = await vfs.glob('**/*.ts');
+
+// Symbolic links
+await vfs.createSymlink('/src', '/link-to-src');
+
+// Snapshots
+const snapshotId = vfs.createSnapshot('before-refactor');
+// ... make changes ...
+vfs.restoreSnapshot(snapshotId);
+```
+
+## API Reference
+
+### File Operations
+
+```typescript
+// Read file (returns string with encoding, Buffer without)
+await vfs.readFile(path: string, encoding?: BufferEncoding): Promise<string | Buffer>
+
+// Write file (auto-creates parent directories)
+await vfs.writeFile(path: string, content: string | Buffer): Promise<void>
+
+// Append to file
+await vfs.appendFile(path: string, content: string | Buffer): Promise<void>
+
+// Delete file
+await vfs.deleteFile(path: string): Promise<void>
+
+// Copy file
+await vfs.copyFile(src: string, dest: string): Promise<void>
+
+// Move file
+await vfs.moveFile(src: string, dest: string): Promise<void>
+```
+
+### Directory Operations
+
+```typescript
+// Create directory (recursive option creates parent directories)
+await vfs.createDirectory(path: string, recursive?: boolean): Promise<void>
+
+// Read directory contents
+await vfs.readDirectory(path: string): Promise<DirectoryEntry[]>
+
+// Delete directory (recursive option deletes contents)
+await vfs.deleteDirectory(path: string, recursive?: boolean): Promise<void>
+```
+
+### Status Queries
+
+```typescript
+await vfs.exists(path: string): Promise<boolean>
+await vfs.isFile(path: string): Promise<boolean>
+await vfs.isDirectory(path: string): Promise<boolean>
+await vfs.isSymlink(path: string): Promise<boolean>
+await vfs.getStats(path: string): Promise<FileStats>
+```
+
+### Symbolic Links
+
+```typescript
+// Create symlink
+await vfs.createSymlink(target: string, linkPath: string): Promise<void>
+
+// Read symlink target
+await vfs.readSymlink(linkPath: string): Promise<string>
+```
+
+### Glob
+
+```typescript
+const files = await vfs.glob(pattern: string, options?: GlobOptions): Promise<string[]>
+
+// Options:
+interface GlobOptions {
+  cwd?: string;           // Working directory
+  ignore?: string[];      // Ignore patterns
+  dot?: boolean;          // Include dotfiles
+  absolute?: boolean;     // Return absolute paths
+  onlyFiles?: boolean;    // Only return files
+  onlyDirectories?: boolean; // Only return directories
+  followSymlinks?: boolean;  // Follow symbolic links
+  maxDepth?: number;      // Maximum traversal depth
+}
+```
+
+### Snapshots
+
+```typescript
+// Create snapshot
+const id = vfs.createSnapshot(name?: string): SnapshotId
+
+// Restore snapshot
+vfs.restoreSnapshot(id: SnapshotId): void
+
+// Get snapshot info
+vfs.getSnapshotInfo(id: SnapshotId): SnapshotInfo | undefined
+
+// List all snapshots
+vfs.listSnapshots(): SnapshotInfo[]
+
+// Delete snapshot
+vfs.deleteSnapshot(id: SnapshotId): boolean
+
+// Compute diff between snapshots
+vfs.diff(fromId?: SnapshotId, toId?: SnapshotId): FileDiff[]
+```
+
+### JSON Import/Export
+
+```typescript
+// Load from JSON structure
+await vfs.fromJSON({
+  'src': {
+    'index.ts': 'export {}',
+    'utils': {
+      'helper.ts': 'export function help() {}'
+    }
+  },
+  'README.md': '# Project'
+});
+
+// Export to JSON
+const json = vfs.toJSON(): DirectoryJSON
+
+// Reset file system
+vfs.reset(): void
+```
+
+## Configuration
+
+```typescript
+const vfs = createVFS({
+  caseSensitive: true,      // Case-sensitive paths (default: true)
+  defaultFileMode: 0o644,   // Default file permissions
+  defaultDirectoryMode: 0o755, // Default directory permissions
+  maxSymlinkDepth: 40,      // Maximum symlink resolution depth
+});
+```
+
+## Error Handling
+
+```typescript
+import {
+  FileNotFoundError,
+  DirectoryNotFoundError,
+  DirectoryNotEmptyError,
+  NotAFileError,
+  NotADirectoryError,
+  SymlinkLoopError,
+  InvalidPathError
+} from 'mem-vfs';
+
+try {
+  await vfs.readFile('/nonexistent');
+} catch (error) {
+  if (error instanceof FileNotFoundError) {
+    console.log('File not found:', error.path);
+  }
+}
+```
+
+## Path Utilities
+
+```typescript
+import {
+  normalizePath,
+  dirname,
+  basename,
+  extname,
+  join,
+  resolve,
+  relative,
+  isAbsolute
+} from 'mem-vfs';
+
+normalizePath('/a/b/../c/./d') // '/a/c/d'
+dirname('/path/to/file.txt')   // '/path/to'
+basename('/path/to/file.txt')  // 'file.txt'
+join('/a', 'b', 'c')           // '/a/b/c'
+```
+
+## License
+
+MIT

package/dist/core/vfs-directory.d.ts

@@ -0,0 +1,35 @@
+/**
+ * VFS 目錄節點
+ */
+import { VFSNode } from './vfs-node.js';
+import { VFSNodeType } from '../types/index.js';
+/** VFS 目錄節點 */
+export declare class VFSDirectory extends VFSNode {
+    readonly type = VFSNodeType.Directory;
+    /** 子節點 */
+    private readonly children;
+    constructor(name: string, mode?: number);
+    /** 取得大小（子節點數量 * 4096，模擬目錄大小） */
+    get size(): number;
+    /** 取得子節點數量 */
+    get childCount(): number;
+    /** 是否為空目錄 */
+    get isEmpty(): boolean;
+    /** 取得子節點 */
+    getChild(name: string): VFSNode | undefined;
+    /** 檢查子節點是否存在 */
+    hasChild(name: string): boolean;
+    /** 新增子節點 */
+    addChild(node: VFSNode): void;
+    /** 移除子節點 */
+    removeChild(name: string): boolean;
+    /** 取得所有子節點名稱 */
+    getChildNames(): string[];
+    /** 取得所有子節點 */
+    getChildren(): VFSNode[];
+    /** 迭代子節點 */
+    entries(): IterableIterator<[string, VFSNode]>;
+    /** 深拷貝 */
+    clone(): VFSDirectory;
+}
+//# sourceMappingURL=vfs-directory.d.ts.map

package/dist/core/vfs-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-directory.d.ts","sourceRoot":"","sources":["../../src/core/vfs-directory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,eAAe;AACf,qBAAa,YAAa,SAAQ,OAAO;IACvC,QAAQ,CAAC,IAAI,yBAAyB;IAEtC,UAAU;IACV,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAEhD,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAA+B;IAI/D,gCAAgC;IAChC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,cAAc;IACd,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,aAAa;IACb,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAK3C,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK7B,YAAY;IACZ,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUlC,gBAAgB;IAChB,aAAa,IAAI,MAAM,EAAE;IAIzB,cAAc;IACd,WAAW,IAAI,OAAO,EAAE;IAKxB,YAAY;IACX,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/C,UAAU;IACV,KAAK,IAAI,YAAY;CAetB"}

package/dist/core/vfs-directory.js

@@ -0,0 +1,78 @@
+/**
+ * VFS 目錄節點
+ */
+import { VFSNode } from './vfs-node.js';
+import { VFSNodeType } from '../types/index.js';
+/** 預設目錄模式 */
+const DEFAULT_DIRECTORY_MODE = 0o755;
+/** VFS 目錄節點 */
+export class VFSDirectory extends VFSNode {
+    type = VFSNodeType.Directory;
+    /** 子節點 */
+    children = new Map();
+    constructor(name, mode = DEFAULT_DIRECTORY_MODE) {
+        super(name, mode);
+    }
+    /** 取得大小（子節點數量 * 4096，模擬目錄大小） */
+    get size() {
+        return 4096;
+    }
+    /** 取得子節點數量 */
+    get childCount() {
+        return this.children.size;
+    }
+    /** 是否為空目錄 */
+    get isEmpty() {
+        return this.children.size === 0;
+    }
+    /** 取得子節點 */
+    getChild(name) {
+        this.touch();
+        return this.children.get(name);
+    }
+    /** 檢查子節點是否存在 */
+    hasChild(name) {
+        return this.children.has(name);
+    }
+    /** 新增子節點 */
+    addChild(node) {
+        this.children.set(node.name, node);
+        this.markModified();
+    }
+    /** 移除子節點 */
+    removeChild(name) {
+        const result = this.children.delete(name);
+        if (result) {
+            this.markModified();
+        }
+        return result;
+    }
+    /** 取得所有子節點名稱 */
+    getChildNames() {
+        return Array.from(this.children.keys());
+    }
+    /** 取得所有子節點 */
+    getChildren() {
+        this.touch();
+        return Array.from(this.children.values());
+    }
+    /** 迭代子節點 */
+    *entries() {
+        yield* this.children.entries();
+    }
+    /** 深拷貝 */
+    clone() {
+        const cloned = new VFSDirectory(this.name, this.mode);
+        cloned.uid = this.uid;
+        cloned.gid = this.gid;
+        cloned.createdTime = new Date(this.createdTime);
+        cloned.modifiedTime = new Date(this.modifiedTime);
+        cloned.accessedTime = new Date(this.accessedTime);
+        // 深拷貝子節點
+        for (const [name, node] of this.children) {
+            cloned.children.set(name, node.clone());
+        }
+        return cloned;
+    }
+}
+//# sourceMappingURL=vfs-directory.js.map

package/dist/core/vfs-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-directory.js","sourceRoot":"","sources":["../../src/core/vfs-directory.ts"],"names":[],"mappings":"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"}

package/dist/core/vfs-file.d.ts

@@ -0,0 +1,25 @@
+/**
+ * VFS 檔案節點
+ */
+import { VFSNode } from './vfs-node.js';
+import { VFSNodeType } from '../types/index.js';
+/** VFS 檔案節點 */
+export declare class VFSFile extends VFSNode {
+    readonly type = VFSNodeType.File;
+    /** 檔案內容 */
+    private content;
+    constructor(name: string, content?: string | Buffer, mode?: number);
+    /** 取得大小 */
+    get size(): number;
+    /** 讀取內容 */
+    read(encoding?: BufferEncoding): string | Buffer;
+    /** 寫入內容 */
+    write(data: string | Buffer): void;
+    /** 追加內容 */
+    append(data: string | Buffer): void;
+    /** 截斷內容 */
+    truncate(length?: number): void;
+    /** 深拷貝 */
+    clone(): VFSFile;
+}
+//# sourceMappingURL=vfs-file.d.ts.map

package/dist/core/vfs-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-file.d.ts","sourceRoot":"","sources":["../../src/core/vfs-file.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,eAAe;AACf,qBAAa,OAAQ,SAAQ,OAAO;IAClC,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,WAAW;IACX,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,GAAG,MAAwB,EAAE,IAAI,GAAE,MAA0B;IAKtG,WAAW;IACX,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,WAAW;IACX,IAAI,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM;IAUhD,WAAW;IACX,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKlC,WAAW;IACX,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMnC,WAAW;IACX,QAAQ,CAAC,MAAM,GAAE,MAAU,GAAG,IAAI;IASlC,UAAU;IACV,KAAK,IAAI,OAAO;CAUjB"}

package/dist/core/vfs-file.js

@@ -0,0 +1,60 @@
+/**
+ * VFS 檔案節點
+ */
+import { VFSNode } from './vfs-node.js';
+import { VFSNodeType } from '../types/index.js';
+/** 預設檔案模式 */
+const DEFAULT_FILE_MODE = 0o644;
+/** VFS 檔案節點 */
+export class VFSFile extends VFSNode {
+    type = VFSNodeType.File;
+    /** 檔案內容 */
+    content;
+    constructor(name, content = Buffer.alloc(0), mode = DEFAULT_FILE_MODE) {
+        super(name, mode);
+        this.content = typeof content === 'string' ? Buffer.from(content, 'utf-8') : content;
+    }
+    /** 取得大小 */
+    get size() {
+        return this.content.length;
+    }
+    /** 讀取內容 */
+    read(encoding) {
+        this.touch();
+        if (encoding) {
+            return this.content.toString(encoding);
+        }
+        return Buffer.from(this.content);
+    }
+    /** 寫入內容 */
+    write(data) {
+        this.content = typeof data === 'string' ? Buffer.from(data, 'utf-8') : Buffer.from(data);
+        this.markModified();
+    }
+    /** 追加內容 */
+    append(data) {
+        const appendBuffer = typeof data === 'string' ? Buffer.from(data, 'utf-8') : data;
+        this.content = Buffer.concat([this.content, appendBuffer]);
+        this.markModified();
+    }
+    /** 截斷內容 */
+    truncate(length = 0) {
+        if (length >= this.content.length) {
+            return;
+        }
+        this.content = this.content.subarray(0, length);
+        this.markModified();
+    }
+    /** 深拷貝 */
+    clone() {
+        const cloned = new VFSFile(this.name, Buffer.from(this.content), this.mode);
+        cloned.uid = this.uid;
+        cloned.gid = this.gid;
+        // 時間屬性需要重新賦值（因為 readonly 是在 constructor 設定的）
+        cloned.createdTime = new Date(this.createdTime);
+        cloned.modifiedTime = new Date(this.modifiedTime);
+        cloned.accessedTime = new Date(this.accessedTime);
+        return cloned;
+    }
+}
+//# sourceMappingURL=vfs-file.js.map

package/dist/core/vfs-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-file.js","sourceRoot":"","sources":["../../src/core/vfs-file.ts"],"names":[],"mappings":"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"}

package/dist/core/vfs-node.d.ts

@@ -0,0 +1,42 @@
+/**
+ * VFS 節點基礎類別
+ */
+import type { FileStats } from '../types/index.js';
+import { VFSNodeType } from '../types/index.js';
+/** VFS 節點基礎類別 */
+export declare abstract class VFSNode {
+    /** 節點名稱 */
+    readonly name: string;
+    /** 節點類型 */
+    abstract readonly type: VFSNodeType;
+    /** 建立時間 */
+    readonly createdTime: Date;
+    /** 修改時間 */
+    modifiedTime: Date;
+    /** 存取時間 */
+    accessedTime: Date;
+    /** 檔案模式 */
+    mode: number;
+    /** 使用者 ID */
+    uid: number;
+    /** 群組 ID */
+    gid: number;
+    constructor(name: string, mode?: number);
+    /** 是否為檔案 */
+    get isFile(): boolean;
+    /** 是否為目錄 */
+    get isDirectory(): boolean;
+    /** 是否為符號連結 */
+    get isSymlink(): boolean;
+    /** 取得大小（由子類別實作） */
+    abstract get size(): number;
+    /** 取得統計資訊 */
+    getStats(): FileStats;
+    /** 更新存取時間 */
+    touch(): void;
+    /** 更新修改時間 */
+    markModified(): void;
+    /** 深拷貝（由子類別實作） */
+    abstract clone(): VFSNode;
+}
+//# sourceMappingURL=vfs-node.d.ts.map

package/dist/core/vfs-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-node.d.ts","sourceRoot":"","sources":["../../src/core/vfs-node.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,iBAAiB;AACjB,8BAAsB,OAAO;IAC3B,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAEpC,WAAW;IACX,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B,WAAW;IACX,YAAY,EAAE,IAAI,CAAC;IAEnB,WAAW;IACX,YAAY,EAAE,IAAI,CAAC;IAEnB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IAEb,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IAEZ,YAAY;IACZ,GAAG,EAAE,MAAM,CAAC;gBAEA,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc;IAY9C,YAAY;IACZ,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,YAAY;IACZ,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,cAAc;IACd,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,mBAAmB;IACnB,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAE5B,aAAa;IACb,QAAQ,IAAI,SAAS;IAerB,aAAa;IACb,KAAK,IAAI,IAAI;IAIb,aAAa;IACb,YAAY,IAAI,IAAI;IAMpB,kBAAkB;IAClB,QAAQ,CAAC,KAAK,IAAI,OAAO;CAC1B"}

package/dist/core/vfs-node.js

@@ -0,0 +1,69 @@
+/**
+ * VFS 節點基礎類別
+ */
+import { VFSNodeType } from '../types/index.js';
+/** VFS 節點基礎類別 */
+export class VFSNode {
+    /** 節點名稱 */
+    name;
+    /** 建立時間 */
+    createdTime;
+    /** 修改時間 */
+    modifiedTime;
+    /** 存取時間 */
+    accessedTime;
+    /** 檔案模式 */
+    mode;
+    /** 使用者 ID */
+    uid;
+    /** 群組 ID */
+    gid;
+    constructor(name, mode = 0o644) {
+        this.name = name;
+        this.mode = mode;
+        this.uid = 0;
+        this.gid = 0;
+        const now = new Date();
+        this.createdTime = now;
+        this.modifiedTime = now;
+        this.accessedTime = now;
+    }
+    /** 是否為檔案 */
+    get isFile() {
+        return this.type === VFSNodeType.File;
+    }
+    /** 是否為目錄 */
+    get isDirectory() {
+        return this.type === VFSNodeType.Directory;
+    }
+    /** 是否為符號連結 */
+    get isSymlink() {
+        return this.type === VFSNodeType.Symlink;
+    }
+    /** 取得統計資訊 */
+    getStats() {
+        return {
+            isFile: this.isFile,
+            isDirectory: this.isDirectory,
+            isSymlink: this.isSymlink,
+            size: this.size,
+            createdTime: this.createdTime,
+            modifiedTime: this.modifiedTime,
+            accessedTime: this.accessedTime,
+            mode: this.mode,
+            uid: this.uid,
+            gid: this.gid,
+        };
+    }
+    /** 更新存取時間 */
+    touch() {
+        this.accessedTime = new Date();
+    }
+    /** 更新修改時間 */
+    markModified() {
+        const now = new Date();
+        this.modifiedTime = now;
+        this.accessedTime = now;
+    }
+}
+//# sourceMappingURL=vfs-node.js.map

package/dist/core/vfs-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-node.js","sourceRoot":"","sources":["../../src/core/vfs-node.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,iBAAiB;AACjB,MAAM,OAAgB,OAAO;IAC3B,WAAW;IACF,IAAI,CAAS;IAKtB,WAAW;IACF,WAAW,CAAO;IAE3B,WAAW;IACX,YAAY,CAAO;IAEnB,WAAW;IACX,YAAY,CAAO;IAEnB,WAAW;IACX,IAAI,CAAS;IAEb,aAAa;IACb,GAAG,CAAS;IAEZ,YAAY;IACZ,GAAG,CAAS;IAEZ,YAAY,IAAY,EAAE,OAAe,KAAK;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QAEb,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED,YAAY;IACZ,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,YAAY;IACZ,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,SAAS,CAAC;IAC7C,CAAC;IAED,cAAc;IACd,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,OAAO,CAAC;IAC3C,CAAC;IAKD,aAAa;IACb,QAAQ;QACN,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;IAED,aAAa;IACb,KAAK;QACH,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,aAAa;IACb,YAAY;QACV,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;IAC1B,CAAC;CAIF"}

package/dist/core/vfs-symlink.d.ts

@@ -0,0 +1,21 @@
+/**
+ * VFS 符號連結節點
+ */
+import { VFSNode } from './vfs-node.js';
+import { VFSNodeType } from '../types/index.js';
+/** VFS 符號連結節點 */
+export declare class VFSSymlink extends VFSNode {
+    readonly type = VFSNodeType.Symlink;
+    /** 目標路徑 */
+    private targetPath;
+    constructor(name: string, target: string, mode?: number);
+    /** 取得大小（目標路徑的長度） */
+    get size(): number;
+    /** 取得目標路徑 */
+    get target(): string;
+    /** 設定目標路徑 */
+    setTarget(target: string): void;
+    /** 深拷貝 */
+    clone(): VFSSymlink;
+}
+//# sourceMappingURL=vfs-symlink.d.ts.map

package/dist/core/vfs-symlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-symlink.d.ts","sourceRoot":"","sources":["../../src/core/vfs-symlink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,iBAAiB;AACjB,qBAAa,UAAW,SAAQ,OAAO;IACrC,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,WAAW;IACX,OAAO,CAAC,UAAU,CAAS;gBAEf,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAA6B;IAK7E,oBAAoB;IACpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,aAAa;IACb,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,aAAa;IACb,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,UAAU;IACV,KAAK,IAAI,UAAU;CASpB"}

package/dist/core/vfs-symlink.js

@@ -0,0 +1,41 @@
+/**
+ * VFS 符號連結節點
+ */
+import { VFSNode } from './vfs-node.js';
+import { VFSNodeType } from '../types/index.js';
+/** 預設符號連結模式 */
+const DEFAULT_SYMLINK_MODE = 0o777;
+/** VFS 符號連結節點 */
+export class VFSSymlink extends VFSNode {
+    type = VFSNodeType.Symlink;
+    /** 目標路徑 */
+    targetPath;
+    constructor(name, target, mode = DEFAULT_SYMLINK_MODE) {
+        super(name, mode);
+        this.targetPath = target;
+    }
+    /** 取得大小（目標路徑的長度） */
+    get size() {
+        return Buffer.byteLength(this.targetPath, 'utf-8');
+    }
+    /** 取得目標路徑 */
+    get target() {
+        return this.targetPath;
+    }
+    /** 設定目標路徑 */
+    setTarget(target) {
+        this.targetPath = target;
+        this.markModified();
+    }
+    /** 深拷貝 */
+    clone() {
+        const cloned = new VFSSymlink(this.name, this.targetPath, this.mode);
+        cloned.uid = this.uid;
+        cloned.gid = this.gid;
+        cloned.createdTime = new Date(this.createdTime);
+        cloned.modifiedTime = new Date(this.modifiedTime);
+        cloned.accessedTime = new Date(this.accessedTime);
+        return cloned;
+    }
+}
+//# sourceMappingURL=vfs-symlink.js.map

package/dist/core/vfs-symlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-symlink.js","sourceRoot":"","sources":["../../src/core/vfs-symlink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,eAAe;AACf,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,iBAAiB;AACjB,MAAM,OAAO,UAAW,SAAQ,OAAO;IAC5B,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC;IAEpC,WAAW;IACH,UAAU,CAAS;IAE3B,YAAY,IAAY,EAAE,MAAc,EAAE,OAAe,oBAAoB;QAC3E,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;IAC3B,CAAC;IAED,oBAAoB;IACpB,IAAI,IAAI;QACN,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,aAAa;IACb,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,aAAa;IACb,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,UAAU;IACV,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACtB,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,MAAgC,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3E,MAAM,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}