@lova/mem-vfs 0.1.0

package/dist/core/vfs.d.ts

@@ -0,0 +1,107 @@
+/**
+ * VirtualFileSystem 主類別
+ * 記憶體虛擬檔案系統實作
+ */
+import type { DirectoryEntry, FileStats, GlobOptions, VFSOptions, AtomicWriteOptions, DirectoryJSON, SnapshotId, SnapshotInfo, FileDiff, WatchOptions } from '../types/index.js';
+import { VFSWatcher } from '../watcher/watcher.js';
+/** VirtualFileSystem 類別 */
+export declare class VirtualFileSystem {
+    /** 根目錄 */
+    private readonly root;
+    /** 選項 */
+    private readonly options;
+    /** 快照儲存 */
+    private readonly snapshots;
+    /** 快照計數器 */
+    private snapshotCounter;
+    /** 監聽器列表 */
+    private readonly watchers;
+    constructor(options?: VFSOptions);
+    /** 讀取檔案 */
+    readFile(filePath: string, encoding?: BufferEncoding): Promise<string | Buffer>;
+    /** 寫入檔案 */
+    writeFile(filePath: string, content: string | Buffer, _options?: AtomicWriteOptions): Promise<void>;
+    /** 追加檔案內容 */
+    appendFile(filePath: string, content: string | Buffer): Promise<void>;
+    /** 刪除檔案 */
+    deleteFile(filePath: string): Promise<void>;
+    /** 建立目錄 */
+    createDirectory(dirPath: string, recursive?: boolean): Promise<void>;
+    /** 讀取目錄內容 */
+    readDirectory(dirPath: string): Promise<DirectoryEntry[]>;
+    /** 刪除目錄 */
+    deleteDirectory(dirPath: string, recursive?: boolean): Promise<void>;
+    /** 檢查路徑是否存在 */
+    exists(targetPath: string): Promise<boolean>;
+    /** 取得檔案統計 */
+    getStats(targetPath: string): Promise<FileStats>;
+    /** 取得符號連結統計（不跟隨連結） */
+    getLinkStats(targetPath: string): Promise<FileStats>;
+    /** 檢查是否為檔案 */
+    isFile(targetPath: string): Promise<boolean>;
+    /** 檢查是否為目錄 */
+    isDirectory(targetPath: string): Promise<boolean>;
+    /** 檢查是否為符號連結 */
+    isSymlink(targetPath: string): Promise<boolean>;
+    /** 複製檔案 */
+    copyFile(srcPath: string, destPath: string): Promise<void>;
+    /** 移動檔案 */
+    moveFile(srcPath: string, destPath: string): Promise<void>;
+    /** 建立符號連結 */
+    createSymlink(target: string, linkPath: string): Promise<void>;
+    /** 讀取符號連結目標 */
+    readSymlink(linkPath: string): Promise<string>;
+    /** Glob 搜尋 */
+    glob(pattern: string, options?: GlobOptions): Promise<string[]>;
+    /** 建立快照 */
+    createSnapshot(name?: string): SnapshotId;
+    /** 還原快照 */
+    restoreSnapshot(id: SnapshotId): void;
+    /** 取得快照資訊 */
+    getSnapshotInfo(id: SnapshotId): SnapshotInfo | undefined;
+    /** 列出所有快照 */
+    listSnapshots(): SnapshotInfo[];
+    /** 刪除快照 */
+    deleteSnapshot(id: SnapshotId): boolean;
+    /** 計算兩個快照之間的差異 */
+    diff(fromId?: SnapshotId, toId?: SnapshotId): FileDiff[];
+    /** 從 JSON 結構載入 */
+    fromJSON(structure: DirectoryJSON, basePath?: string): Promise<void>;
+    /** 從平面路徑 JSON 結構載入 */
+    private fromFlatJSON;
+    /** 從嵌套結構 JSON 載入 */
+    private fromNestedJSON;
+    /** 輸出為 JSON 結構 */
+    toJSON(basePath?: string, options?: {
+        flatten?: boolean;
+    }): DirectoryJSON;
+    /** 輸出為平面路徑 JSON 結構 */
+    private toFlatJSON;
+    /** 輸出為嵌套結構 JSON */
+    private toNestedJSON;
+    /** 重置檔案系統 */
+    reset(): void;
+    /** 監聽檔案變更 */
+    watch(watchPath: string, options?: WatchOptions): VFSWatcher;
+    /** 初始化 watcher 的已知路徑 */
+    private initializeWatcher;
+    /** 通知所有 watcher 檔案變更 */
+    private notifyWatchers;
+    /** 解析節點 */
+    private resolveNode;
+    /** 取得目錄節點 */
+    private getDirectory;
+    /** 取得目錄節點（可能為 null） */
+    private getDirectoryOrNull;
+    /** 將 glob pattern 轉換為正規表示式 */
+    private patternToRegex;
+    /** 檢查是否符合忽略規則 */
+    private matchesIgnore;
+    /** 計算節點數量 */
+    private countNodes;
+    /** 計算差異 */
+    private computeDiff;
+}
+/** 建立 VirtualFileSystem 實例 */
+export declare function createVFS(options?: VFSOptions): VirtualFileSystem;
+//# sourceMappingURL=vfs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vfs.d.ts","sourceRoot":"","sources":["../../src/core/vfs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,YAAY,EACb,MAAM,mBAAmB,CAAC;AAa3B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAoBnD,2BAA2B;AAC3B,qBAAa,iBAAiB;IAC5B,UAAU;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IAEpC,SAAS;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,WAAW;IACX,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0E;IAEpG,YAAY;IACZ,OAAO,CAAC,eAAe,CAAK;IAE5B,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;gBAE3C,OAAO,CAAC,EAAE,UAAU;IAShC,WAAW;IACL,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAkBrF,WAAW;IACL,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCzG,aAAa;IACP,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3E,WAAW;IACL,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjD,WAAW;IACL,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CxE,aAAa;IACP,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsB/D,WAAW;IACL,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCxE,eAAe;IACT,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD,aAAa;IACP,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAUtD,sBAAsB;IAChB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAU1D,cAAc;IACR,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD,cAAc;IACR,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvD,gBAAgB;IACV,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarD,WAAW;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,WAAW;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAShE,aAAa;IACP,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpE,eAAe;IACT,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBpD,cAAc;IACR,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0ErE,WAAW;IACX,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU;IAoBzC,WAAW;IACX,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAmBrC,aAAa;IACb,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS;IAIzD,aAAa;IACb,aAAa,IAAI,YAAY,EAAE;IAI/B,WAAW;IACX,cAAc,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO;IAIvC,kBAAkB;IAClB,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,EAAE;IAsBxD,kBAAkB;IACZ,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvE,sBAAsB;YACR,YAAY;IAa1B,oBAAoB;YACN,cAAc;IAkB5B,kBAAkB;IAClB,MAAM,CAAC,QAAQ,SAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa;IAOtE,sBAAsB;IACtB,OAAO,CAAC,UAAU;IA0BlB,mBAAmB;IACnB,OAAO,CAAC,YAAY;IAwBpB,aAAa;IACb,KAAK,IAAI,IAAI;IAQb,aAAa;IACb,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU;IAsB5D,wBAAwB;YACV,iBAAiB;IAmB/B,wBAAwB;IACxB,OAAO,CAAC,cAAc;IA4BtB,WAAW;IACX,OAAO,CAAC,WAAW;IAyDnB,aAAa;IACb,OAAO,CAAC,YAAY;IAcpB,uBAAuB;IACvB,OAAO,CAAC,kBAAkB;IAQ1B,8BAA8B;IAC9B,OAAO,CAAC,cAAc;IAYtB,iBAAiB;IACjB,OAAO,CAAC,aAAa;IAUrB,aAAa;IACb,OAAO,CAAC,UAAU;IAqBlB,WAAW;IACX,OAAO,CAAC,WAAW;CA6EpB;AAED,8BAA8B;AAC9B,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAEjE"}