@lova/mem-vfs 0.1.0

package/dist/path/path-validator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 路徑驗證工具
+ */
+/** 驗證路徑 */
+export declare function validatePath(inputPath: string): void;
+/** 驗證檔案名稱 */
+export declare function validateFileName(name: string): void;
+/** 是否為有效路徑（不拋出錯誤） */
+export declare function isValidPath(inputPath: string): boolean;
+/** 是否為有效檔案名稱（不拋出錯誤） */
+export declare function isValidFileName(name: string): boolean;
+//# sourceMappingURL=path-validator.d.ts.map

package/dist/path/path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validator.d.ts","sourceRoot":"","sources":["../../src/path/path-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,WAAW;AACX,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CA6BpD;AAuBD,aAAa;AACb,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAWnD;AAED,qBAAqB;AACrB,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED,uBAAuB;AACvB,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD"}

package/dist/path/path-validator.js

@@ -0,0 +1,87 @@
+/**
+ * 路徑驗證工具
+ */
+import { InvalidPathError } from '../errors/file-system-errors.js';
+/** 無效的路徑字元 */
+const INVALID_CHARS = /[\x00-\x1f]/;
+/** 保留的檔案名稱（Windows 相容） */
+const RESERVED_NAMES = new Set([
+    'CON', 'PRN', 'AUX', 'NUL',
+    'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9',
+    'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9',
+]);
+/** 驗證路徑 */
+export function validatePath(inputPath) {
+    if (!inputPath) {
+        throw new InvalidPathError('', 'Path cannot be empty');
+    }
+    if (typeof inputPath !== 'string') {
+        throw new InvalidPathError(String(inputPath), 'Path must be a string');
+    }
+    // 檢查無效字元
+    if (INVALID_CHARS.test(inputPath)) {
+        throw new InvalidPathError(inputPath, 'Path contains invalid characters');
+    }
+    // 檢查路徑長度
+    if (inputPath.length > 4096) {
+        throw new InvalidPathError(inputPath, 'Path is too long (max 4096 characters)');
+    }
+    // 檢查各個部分（跳過 . 和 .. 因為這些是合法的路徑導航元素）
+    const parts = inputPath.split('/').filter(Boolean);
+    for (const part of parts) {
+        // 跳過 . 和 .. 路徑導航元素
+        if (part === '.' || part === '..') {
+            continue;
+        }
+        validatePathSegment(part, inputPath);
+    }
+}
+/** 驗證路徑段落 */
+function validatePathSegment(segment, fullPath) {
+    // 檢查段落長度
+    if (segment.length > 255) {
+        throw new InvalidPathError(fullPath, `Path segment "${segment}" is too long (max 255 characters)`);
+    }
+    // 檢查保留名稱（不區分大小寫）
+    const upperSegment = segment.toUpperCase();
+    const baseSegment = upperSegment.split('.')[0];
+    if (RESERVED_NAMES.has(baseSegment)) {
+        throw new InvalidPathError(fullPath, `"${segment}" is a reserved name`);
+    }
+    // 檢查結尾空格或句點
+    if (segment.endsWith(' ') || segment.endsWith('.')) {
+        throw new InvalidPathError(fullPath, `Path segment cannot end with space or period: "${segment}"`);
+    }
+}
+/** 驗證檔案名稱 */
+export function validateFileName(name) {
+    if (!name) {
+        throw new InvalidPathError('', 'File name cannot be empty');
+    }
+    // 不能包含斜線
+    if (name.includes('/') || name.includes('\\')) {
+        throw new InvalidPathError(name, 'File name cannot contain path separators');
+    }
+    validatePathSegment(name, name);
+}
+/** 是否為有效路徑（不拋出錯誤） */
+export function isValidPath(inputPath) {
+    try {
+        validatePath(inputPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 是否為有效檔案名稱（不拋出錯誤） */
+export function isValidFileName(name) {
+    try {
+        validateFileName(name);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=path-validator.js.map

package/dist/path/path-validator.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,171 @@
+/**
+ * mem-vfs 型別定義
+ */
+/** 目錄項目 */
+export interface DirectoryEntry {
+    /** 檔案/目錄名稱 */
+    name: string;
+    /** 完整路徑 */
+    path: string;
+    /** 是否為檔案 */
+    isFile: boolean;
+    /** 是否為目錄 */
+    isDirectory: boolean;
+    /** 是否為符號連結 */
+    isSymlink: boolean;
+    /** 檔案大小（位元組） */
+    size?: number;
+    /** 修改時間 */
+    modifiedTime?: Date;
+}
+/** 檔案統計資訊 */
+export interface FileStats {
+    /** 是否為檔案 */
+    isFile: boolean;
+    /** 是否為目錄 */
+    isDirectory: boolean;
+    /** 是否為符號連結 */
+    isSymlink: boolean;
+    /** 檔案大小（位元組） */
+    size: number;
+    /** 建立時間 */
+    createdTime: Date;
+    /** 修改時間 */
+    modifiedTime: Date;
+    /** 存取時間 */
+    accessedTime: Date;
+    /** 檔案模式 */
+    mode: number;
+    /** 使用者 ID */
+    uid?: number;
+    /** 群組 ID */
+    gid?: number;
+}
+/** Glob 選項 */
+export interface GlobOptions {
+    /** 工作目錄 */
+    cwd?: string;
+    /** 忽略的 pattern */
+    ignore?: string[];
+    /** 是否包含 dot 檔案 */
+    dot?: boolean;
+    /** 是否回傳絕對路徑 */
+    absolute?: boolean;
+    /** 僅回傳檔案 */
+    onlyFiles?: boolean;
+    /** 僅回傳目錄 */
+    onlyDirectories?: boolean;
+    /** 是否追蹤符號連結 */
+    followSymlinks?: boolean;
+    /** 最大深度限制 */
+    maxDepth?: number;
+}
+/** 監聽選項 */
+export interface WatchOptions {
+    /** 是否持續監聽 */
+    persistent?: boolean;
+    /** 是否遞迴監聽 */
+    recursive?: boolean;
+    /** 是否忽略初始事件 */
+    ignoreInitial?: boolean;
+    /** 是否追蹤符號連結 */
+    followSymlinks?: boolean;
+    /** 忽略的 pattern */
+    ignored?: string | string[] | ((path: string) => boolean);
+    /** debounce 延遲（毫秒） */
+    debounce?: number;
+    /** 最大深度 */
+    depth?: number;
+}
+/** 檔案變更事件類型 */
+export declare enum FileChangeType {
+    Add = "add",
+    Change = "change",
+    Unlink = "unlink",
+    AddDir = "addDir",
+    UnlinkDir = "unlinkDir",
+    Ready = "ready",
+    Error = "error"
+}
+/** 檔案變更事件 */
+export interface FileChangeEvent {
+    /** 事件類型 */
+    type: FileChangeType;
+    /** 檔案路徑 */
+    path: string;
+    /** 檔案統計（如果可用） */
+    stats?: FileStats;
+    /** 錯誤（如果是錯誤事件） */
+    error?: Error;
+}
+/** 監聽事件處理器 */
+export type FileWatcherEventListener = (event: FileChangeEvent) => void;
+/** 快照 ID */
+export type SnapshotId = string;
+/** 快照資訊 */
+export interface SnapshotInfo {
+    /** 快照 ID */
+    id: SnapshotId;
+    /** 快照名稱 */
+    name?: string;
+    /** 建立時間 */
+    createdAt: Date;
+    /** 檔案數量 */
+    fileCount: number;
+    /** 目錄數量 */
+    directoryCount: number;
+    /** 總大小（位元組） */
+    totalSize: number;
+}
+/** 檔案差異類型 */
+export declare enum DiffType {
+    Added = "added",
+    Modified = "modified",
+    Deleted = "deleted"
+}
+/** 檔案差異 */
+export interface FileDiff {
+    /** 差異類型 */
+    type: DiffType;
+    /** 檔案路徑 */
+    path: string;
+    /** 舊內容（如果是修改或刪除） */
+    oldContent?: Buffer;
+    /** 新內容（如果是新增或修改） */
+    newContent?: Buffer;
+    /** 舊統計資訊 */
+    oldStats?: FileStats;
+    /** 新統計資訊 */
+    newStats?: FileStats;
+}
+/** VFS 選項 */
+export interface VFSOptions {
+    /** 是否區分大小寫（預設 true） */
+    caseSensitive?: boolean;
+    /** 預設檔案模式 */
+    defaultFileMode?: number;
+    /** 預設目錄模式 */
+    defaultDirectoryMode?: number;
+    /** 符號連結最大解析深度（預設 40） */
+    maxSymlinkDepth?: number;
+}
+/** 原子寫入選項 */
+export interface AtomicWriteOptions {
+    /** 臨時檔案後綴 */
+    tempSuffix?: string;
+    /** 是否 fsync */
+    fsync?: boolean;
+    /** 編碼 */
+    encoding?: BufferEncoding;
+}
+/** 目錄 JSON 結構 */
+export interface DirectoryJSON {
+    [path: string]: string | Buffer | null | DirectoryJSON;
+}
+/** VFS 節點類型 */
+export declare enum VFSNodeType {
+    File = "file",
+    Directory = "directory",
+    Symlink = "symlink"
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,WAAW;AACX,MAAM,WAAW,cAAc;IAC7B,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,EAAE,IAAI,CAAC;IAClB,WAAW;IACX,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW;IACX,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,cAAc;AACd,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC1D,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAe;AACf,oBAAY,cAAc;IACxB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,cAAc;AACd,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAExE,YAAY;AACZ,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,EAAE,EAAE,UAAU,CAAC;IACf,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,aAAa;AACb,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,WAAW;AACX,MAAM,WAAW,QAAQ;IACvB,WAAW;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,YAAY;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,aAAa;AACb,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS;IACT,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,iBAAiB;AACjB,MAAM,WAAW,aAAa;IAC5B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,aAAa,CAAC;CACxD;AAED,eAAe;AACf,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB"}

package/dist/types/index.js

@@ -0,0 +1,29 @@
+/**
+ * mem-vfs 型別定義
+ */
+/** 檔案變更事件類型 */
+export var FileChangeType;
+(function (FileChangeType) {
+    FileChangeType["Add"] = "add";
+    FileChangeType["Change"] = "change";
+    FileChangeType["Unlink"] = "unlink";
+    FileChangeType["AddDir"] = "addDir";
+    FileChangeType["UnlinkDir"] = "unlinkDir";
+    FileChangeType["Ready"] = "ready";
+    FileChangeType["Error"] = "error";
+})(FileChangeType || (FileChangeType = {}));
+/** 檔案差異類型 */
+export var DiffType;
+(function (DiffType) {
+    DiffType["Added"] = "added";
+    DiffType["Modified"] = "modified";
+    DiffType["Deleted"] = "deleted";
+})(DiffType || (DiffType = {}));
+/** VFS 節點類型 */
+export var VFSNodeType;
+(function (VFSNodeType) {
+    VFSNodeType["File"] = "file";
+    VFSNodeType["Directory"] = "directory";
+    VFSNodeType["Symlink"] = "symlink";
+})(VFSNodeType || (VFSNodeType = {}));
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkFH,eAAe;AACf,MAAM,CAAN,IAAY,cAQX;AARD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,yCAAuB,CAAA;IACvB,iCAAe,CAAA;IACf,iCAAe,CAAA;AACjB,CAAC,EARW,cAAc,KAAd,cAAc,QAQzB;AAoCD,aAAa;AACb,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;AACrB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AA6CD,eAAe;AACf,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,kCAAmB,CAAA;AACrB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB"}

package/dist/watcher/debouncer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Debouncer
+ * 事件防抖動處理
+ */
+/** Debouncer 類別 */
+export declare class Debouncer<T> {
+    /** 待處理項目 */
+    private pending;
+    /** 計時器 */
+    private timer;
+    /** 回呼函數 */
+    private readonly callback;
+    /** 延遲時間（毫秒） */
+    private readonly delay;
+    constructor(callback: (items: Map<string, T>) => void, delay?: number);
+    /** 加入項目 */
+    add(key: string, item: T): void;
+    /** 移除項目 */
+    remove(key: string): void;
+    /** 取消所有待處理項目 */
+    cancel(): void;
+    /** 立即執行 */
+    flush(): void;
+    /** 排程執行 */
+    private scheduleFlush;
+    /** 是否有待處理項目 */
+    get hasPending(): boolean;
+    /** 待處理項目數量 */
+    get pendingCount(): number;
+}
+//# sourceMappingURL=debouncer.d.ts.map

package/dist/watcher/debouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debouncer.d.ts","sourceRoot":"","sources":["../../src/watcher/debouncer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB;AACnB,qBAAa,SAAS,CAAC,CAAC;IACtB,YAAY;IACZ,OAAO,CAAC,OAAO,CAA6B;IAE5C,UAAU;IACV,OAAO,CAAC,KAAK,CAA8C;IAE3D,WAAW;IACX,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,eAAe;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,KAAK,GAAE,MAAY;IAK1E,WAAW;IACX,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAK/B,WAAW;IACX,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,gBAAgB;IAChB,MAAM,IAAI,IAAI;IAQd,WAAW;IACX,KAAK,IAAI,IAAI;IAab,WAAW;IACX,OAAO,CAAC,aAAa;IAUrB,eAAe;IACf,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,cAAc;IACd,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF"}

package/dist/watcher/debouncer.js

@@ -0,0 +1,66 @@
+/**
+ * Debouncer
+ * 事件防抖動處理
+ */
+/** Debouncer 類別 */
+export class Debouncer {
+    /** 待處理項目 */
+    pending = new Map();
+    /** 計時器 */
+    timer = null;
+    /** 回呼函數 */
+    callback;
+    /** 延遲時間（毫秒） */
+    delay;
+    constructor(callback, delay = 100) {
+        this.callback = callback;
+        this.delay = delay;
+    }
+    /** 加入項目 */
+    add(key, item) {
+        this.pending.set(key, item);
+        this.scheduleFlush();
+    }
+    /** 移除項目 */
+    remove(key) {
+        this.pending.delete(key);
+    }
+    /** 取消所有待處理項目 */
+    cancel() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.pending.clear();
+    }
+    /** 立即執行 */
+    flush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.pending.size > 0) {
+            const items = new Map(this.pending);
+            this.pending.clear();
+            this.callback(items);
+        }
+    }
+    /** 排程執行 */
+    scheduleFlush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+        }
+        this.timer = setTimeout(() => {
+            this.flush();
+        }, this.delay);
+    }
+    /** 是否有待處理項目 */
+    get hasPending() {
+        return this.pending.size > 0;
+    }
+    /** 待處理項目數量 */
+    get pendingCount() {
+        return this.pending.size;
+    }
+}
+//# sourceMappingURL=debouncer.js.map

package/dist/watcher/debouncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debouncer.js","sourceRoot":"","sources":["../../src/watcher/debouncer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB;AACnB,MAAM,OAAO,SAAS;IACpB,YAAY;IACJ,OAAO,GAAmB,IAAI,GAAG,EAAE,CAAC;IAE5C,UAAU;IACF,KAAK,GAAyC,IAAI,CAAC;IAE3D,WAAW;IACM,QAAQ,CAAkC;IAE3D,eAAe;IACE,KAAK,CAAS;IAE/B,YAAY,QAAyC,EAAE,QAAgB,GAAG;QACxE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,WAAW;IACX,GAAG,CAAC,GAAW,EAAE,IAAO;QACtB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,WAAW;IACX,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,gBAAgB;IAChB,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,WAAW;IACX,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,WAAW;IACH,aAAa;QACnB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,eAAe;IACf,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,cAAc;IACd,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/watcher/watcher-events.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Watcher Events
+ * 監聽事件定義
+ */
+import type { FileStats, FileChangeType } from '../types/index.js';
+/** 監聽事件 */
+export interface WatcherEvent {
+    /** 事件類型 */
+    type: FileChangeType;
+    /** 檔案路徑 */
+    path: string;
+    /** 檔案統計（如果可用） */
+    stats?: FileStats;
+}
+/** 事件處理器 */
+export type WatcherEventHandler = (event: WatcherEvent) => void;
+/** 錯誤處理器 */
+export type WatcherErrorHandler = (error: Error) => void;
+/** 簡單事件發射器實作 */
+export declare class SimpleEventEmitter {
+    private handlers;
+    on(event: string, handler: (...args: unknown[]) => void): this;
+    off(event: string, handler: (...args: unknown[]) => void): this;
+    emit(event: string, ...args: unknown[]): boolean;
+    /** 移除所有處理器 */
+    removeAllListeners(event?: string): this;
+    /** 取得處理器數量 */
+    listenerCount(event: string): number;
+}
+//# sourceMappingURL=watcher-events.d.ts.map

package/dist/watcher/watcher-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-events.d.ts","sourceRoot":"","sources":["../../src/watcher/watcher-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnE,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAEhE,YAAY;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEzD,gBAAgB;AAChB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA6D;IAE7E,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAQ9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAQ/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO;IAiBhD,cAAc;IACd,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASxC,cAAc;IACd,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGrC"}

package/dist/watcher/watcher-events.js

@@ -0,0 +1,52 @@
+/**
+ * Watcher Events
+ * 監聽事件定義
+ */
+/** 簡單事件發射器實作 */
+export class SimpleEventEmitter {
+    handlers = new Map();
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return this;
+    }
+    off(event, handler) {
+        const handlers = this.handlers.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+        }
+        return this;
+    }
+    emit(event, ...args) {
+        const handlers = this.handlers.get(event);
+        if (!handlers || handlers.size === 0) {
+            return false;
+        }
+        for (const handler of handlers) {
+            try {
+                handler(...args);
+            }
+            catch (error) {
+                console.error(`Error in event handler for "${event}":`, error);
+            }
+        }
+        return true;
+    }
+    /** 移除所有處理器 */
+    removeAllListeners(event) {
+        if (event) {
+            this.handlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+        }
+        return this;
+    }
+    /** 取得處理器數量 */
+    listenerCount(event) {
+        return this.handlers.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=watcher-events.js.map

package/dist/watcher/watcher-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-events.js","sourceRoot":"","sources":["../../src/watcher/watcher-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,gBAAgB;AAChB,MAAM,OAAO,kBAAkB;IACrB,QAAQ,GAAmD,IAAI,GAAG,EAAE,CAAC;IAE7E,EAAE,CAAC,KAAa,EAAE,OAAqC;QACrD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,KAAa,EAAE,OAAqC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,GAAG,IAAe;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,IAAI,EAAE,KAAK,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc;IACd,kBAAkB,CAAC,KAAc;QAC/B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc;IACd,aAAa,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/watcher/watcher.d.ts

@@ -0,0 +1,57 @@
+/**
+ * VFSWatcher
+ * 虛擬檔案系統監聽器
+ */
+import type { WatchOptions, FileStats } from '../types/index.js';
+import { SimpleEventEmitter } from './watcher-events.js';
+/** VFS Watcher 類別 */
+export declare class VFSWatcher extends SimpleEventEmitter {
+    /** 監聽路徑 */
+    private readonly watchPath;
+    /** 選項 */
+    private readonly options;
+    /** 是否已關閉 */
+    private closed;
+    /** 事件防抖器 */
+    private readonly debouncer;
+    /** 已知路徑快取（用於判斷新增或修改） */
+    private knownPaths;
+    /** 預設選項 */
+    private static readonly DEFAULT_OPTIONS;
+    constructor(watchPath: string, options?: WatchOptions);
+    /** 通知檔案變更 */
+    notifyChange(path: string, stats?: FileStats): void;
+    /** 通知檔案刪除 */
+    notifyUnlink(path: string, isDirectory?: boolean): void;
+    /** 通知目錄新增 */
+    notifyAddDir(path: string, stats?: FileStats): void;
+    /** 發送 ready 事件 */
+    emitReady(): void;
+    /** 發送錯誤事件 */
+    emitError(error: Error): void;
+    /** 註冊已知路徑 */
+    registerPath(path: string): void;
+    /** 取消註冊路徑 */
+    unregisterPath(path: string): void;
+    /** 關閉監聽器 */
+    close(): void;
+    /** 是否已關閉 */
+    get isClosed(): boolean;
+    /** 監聽的路徑 */
+    get path(): string;
+    /** 覆寫 on 方法 */
+    on(event: string, handler: (...args: unknown[]) => void): this;
+    /** 檢查路徑是否應該被監聽 */
+    private shouldWatch;
+    /** 計算相對於監聽路徑的深度 */
+    private getPathDepth;
+    /** 檢查是否被忽略 */
+    private isIgnored;
+    /** 簡單的 pattern 匹配 */
+    private matchPattern;
+    /** 批量發送事件 */
+    private flushEvents;
+}
+/** 建立 VFSWatcher 實例 */
+export declare function createWatcher(path: string, options?: WatchOptions): VFSWatcher;
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAI5E,qBAAqB;AACrB,qBAAa,UAAW,SAAQ,kBAAkB;IAChD,WAAW;IACX,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,SAAS;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,YAAY;IACZ,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD,wBAAwB;IACxB,OAAO,CAAC,UAAU,CAA0B;IAE5C,WAAW;IACX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAQrC;gBAEU,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAWrD,aAAa;IACb,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI;IAkBnD,aAAa;IACb,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,IAAI;IAgBrD,aAAa;IACb,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI;IAiBnD,kBAAkB;IAClB,SAAS,IAAI,IAAI;IAKjB,aAAa;IACb,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK7B,aAAa;IACb,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,aAAa;IACb,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,YAAY;IACZ,KAAK,IAAI,IAAI;IASb,YAAY;IACZ,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,YAAY;IACZ,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,eAAe;IACN,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAIvE,kBAAkB;IAClB,OAAO,CAAC,WAAW;IAoBnB,mBAAmB;IACnB,OAAO,CAAC,YAAY;IASpB,cAAc;IACd,OAAO,CAAC,SAAS;IAsBjB,qBAAqB;IACrB,OAAO,CAAC,YAAY;IAQpB,aAAa;IACb,OAAO,CAAC,WAAW;CAQpB;AAED,uBAAuB;AACvB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CAE9E"}