@fgv/ts-json-base 5.1.0-2 → 5.1.0-20

package/lib/packlets/file-tree/fsTree.d.ts

@@ -26,55 +26,86 @@ export declare class FsFileTreeAccessors<TCT extends string = string> implements
      */
     constructor(params?: IFileTreeInitParams<TCT>);
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
+     * Resolves paths to an absolute path.
+     * @param paths - Paths to resolve.
+     * @returns The resolved absolute path.
      */
     resolveAbsolutePath(...paths: string[]): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
+     * Gets the extension of a path.
+     * @param itemPath - Path to get the extension of.
+     * @returns The extension of the path.
      */
     getExtension(itemPath: string): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
+     * Gets the base name of a path.
+     * @param itemPath - Path to get the base name of.
+     * @param suffix - Optional suffix to remove from the base name.
+     * @returns The base name of the path.
      */
     getBaseName(itemPath: string, suffix?: string): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
+     * Joins paths together.
+     * @param paths - Paths to join.
+     * @returns The joined paths.
      */
     joinPaths(...paths: string[]): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getItem}
+     * Gets an item from the file tree.
+     * @param itemPath - Path of the item to get.
+     * @returns The item if it exists.
      */
     getItem(itemPath: string): Result<FileTreeItem<TCT>>;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
+     * Gets the contents of a file in the file tree.
+     * @param filePath - Absolute path of the file.
+     * @returns The contents of the file.
      */
     getFileContents(filePath: string): Result<string>;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContentType}
+     * Gets the content type of a file in the file tree.
+     * @param filePath - Absolute path of the file.
+     * @param provided - Optional supplied content type.
+     * @returns The content type of the file.
      */
     getFileContentType(filePath: string, provided?: string): Result<TCT | undefined>;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
+     * Gets the children of a directory in the file tree.
+     * @param dirPath - Path of the directory.
+     * @returns The children of the directory.
      */
     getChildren(dirPath: string): Result<ReadonlyArray<FileTreeItem<TCT>>>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.fileIsMutable}
+     * Checks if a file at the given path can be saved.
+     * @param path - The path to check.
+     * @returns `DetailedSuccess` with {@link FileTree.SaveCapability} if the file can be saved,
+     * or `DetailedFailure` with {@link FileTree.SaveFailureReason} if it cannot.
      */
     fileIsMutable(path: string): DetailedResult<boolean, SaveDetail>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.saveFileContents}
+     * Saves the contents to a file at the given path.
+     * @param path - The path of the file to save.
+     * @param contents - The string contents to save.
+     * @returns `Success` if the file was saved, or `Failure` with an error message.
      */
     saveFileContents(path: string, contents: string): Result<string>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteFile}
+     * Deletes a file at the given path.
+     * @param path - The path of the file to delete.
+     * @returns `Success` with `true` if the file was deleted, or `Failure` with an error message.
      */
     deleteFile(path: string): Result<boolean>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.createDirectory}
+     * Creates a directory at the given path, including any missing parent directories.
+     * @param dirPath - The path of the directory to create.
+     * @returns `Success` with the absolute path if created, or `Failure` with an error message.
      */
     createDirectory(dirPath: string): Result<string>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteDirectory}
+     * Deletes a directory at the given path.
+     * The directory must be empty or the operation will fail.
+     * @param dirPath - The path of the directory to delete.
+     * @returns `Success` with `true` if the directory was deleted, or `Failure` with an error message.
      */
     deleteDirectory(dirPath: string): Result<boolean>;
 }

package/lib/packlets/file-tree/fsTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsTree.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fsTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,YAAY,EACZ,mBAAmB,EAEnB,yBAAyB,EACzB,UAAU,EACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAEL,cAAc,EAGd,MAAM,EAGP,MAAM,eAAe,CAAC;AAKvB;;;;GAIG;AACH,qBAAa,mBAAmB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAE,YAAW,yBAAyB,CAAC,GAAG,CAAC;IACrG;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3C;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAEpF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAEjD;;;;OAIG;gBACgB,MAAM,CAAC,EAAE,mBAAmB,CAAC,GAAG,CAAC;IAOpD;;;;OAIG;IACI,mBAAmB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAOtD;;;;OAIG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7C;;;;;OAKG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAI7D;;;;OAIG;IACI,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAI5C;;;;OAIG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAa3D;;;;OAIG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAIxD;;;;;OAKG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC;IAQvF;;;;OAIG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAgB7E;;;;;OAKG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC;IAgCvE;;;;;OAKG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAUvE;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;IAchD;;;;OAIG;IACI,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAcvD;;;;;OAKG;IACI,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;CAczD"}

package/lib/packlets/file-tree/fsTree.js

@@ -50,7 +50,9 @@ class FsFileTreeAccessors {
         this._mutable = (_b = params === null || params === void 0 ? void 0 : params.mutable) !== null && _b !== void 0 ? _b : false;
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
+     * Resolves paths to an absolute path.
+     * @param paths - Paths to resolve.
+     * @returns The resolved absolute path.
      */
     resolveAbsolutePath(...paths) {
         if (this.prefix && !path_1.default.isAbsolute(paths[0])) {
@@ -59,25 +61,34 @@ class FsFileTreeAccessors {
         return path_1.default.resolve(...paths);
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
+     * Gets the extension of a path.
+     * @param itemPath - Path to get the extension of.
+     * @returns The extension of the path.
      */
     getExtension(itemPath) {
         return path_1.default.extname(itemPath);
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
+     * Gets the base name of a path.
+     * @param itemPath - Path to get the base name of.
+     * @param suffix - Optional suffix to remove from the base name.
+     * @returns The base name of the path.
      */
     getBaseName(itemPath, suffix) {
         return path_1.default.basename(itemPath, suffix);
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
+     * Joins paths together.
+     * @param paths - Paths to join.
+     * @returns The joined paths.
      */
     joinPaths(...paths) {
         return path_1.default.join(...paths);
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getItem}
+     * Gets an item from the file tree.
+     * @param itemPath - Path of the item to get.
+     * @returns The item if it exists.
      */
     getItem(itemPath) {
         return (0, ts_utils_1.captureResult)(() => {
@@ -93,13 +104,18 @@ class FsFileTreeAccessors {
         });
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
+     * Gets the contents of a file in the file tree.
+     * @param filePath - Absolute path of the file.
+     * @returns The contents of the file.
      */
     getFileContents(filePath) {
         return (0, ts_utils_1.captureResult)(() => fs_1.default.readFileSync(this.resolveAbsolutePath(filePath), 'utf8'));
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContentType}
+     * Gets the content type of a file in the file tree.
+     * @param filePath - Absolute path of the file.
+     * @param provided - Optional supplied content type.
+     * @returns The content type of the file.
      */
     getFileContentType(filePath, provided) {
         if (provided !== undefined) {
@@ -109,7 +125,9 @@ class FsFileTreeAccessors {
         return this._inferContentType(filePath);
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
+     * Gets the children of a directory in the file tree.
+     * @param dirPath - Path of the directory.
+     * @returns The children of the directory.
      */
     getChildren(dirPath) {
         return (0, ts_utils_1.captureResult)(() => {
@@ -128,7 +146,10 @@ class FsFileTreeAccessors {
         });
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.fileIsMutable}
+     * Checks if a file at the given path can be saved.
+     * @param path - The path to check.
+     * @returns `DetailedSuccess` with {@link FileTree.SaveCapability} if the file can be saved,
+     * or `DetailedFailure` with {@link FileTree.SaveFailureReason} if it cannot.
      */
     fileIsMutable(path) {
         const absolutePath = this.resolveAbsolutePath(path);
@@ -161,7 +182,10 @@ class FsFileTreeAccessors {
         }
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.saveFileContents}
+     * Saves the contents to a file at the given path.
+     * @param path - The path of the file to save.
+     * @param contents - The string contents to save.
+     * @returns `Success` if the file was saved, or `Failure` with an error message.
      */
     saveFileContents(path, contents) {
         return this.fileIsMutable(path).asResult.onSuccess(() => {
@@ -173,7 +197,9 @@ class FsFileTreeAccessors {
         });
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteFile}
+     * Deletes a file at the given path.
+     * @param path - The path of the file to delete.
+     * @returns `Success` with `true` if the file was deleted, or `Failure` with an error message.
      */
     deleteFile(path) {
         return this.fileIsMutable(path).asResult.onSuccess(() => {
@@ -189,7 +215,9 @@ class FsFileTreeAccessors {
         });
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.createDirectory}
+     * Creates a directory at the given path, including any missing parent directories.
+     * @param dirPath - The path of the directory to create.
+     * @returns `Success` with the absolute path if created, or `Failure` with an error message.
      */
     createDirectory(dirPath) {
         const absolutePath = this.resolveAbsolutePath(dirPath);
@@ -203,7 +231,10 @@ class FsFileTreeAccessors {
         });
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteDirectory}
+     * Deletes a directory at the given path.
+     * The directory must be empty or the operation will fail.
+     * @param dirPath - The path of the directory to delete.
+     * @returns `Success` with `true` if the directory was deleted, or `Failure` with an error message.
      */
     deleteDirectory(dirPath) {
         return this.fileIsMutable(dirPath).asResult.onSuccess(() => {

package/lib/packlets/file-tree/fsTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsTree.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fsTree.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;AASH,gDAAwB;AACxB,4CAAoB;AACpB,4CAQuB;AACvB,mDAAgD;AAChD,yCAAsC;AACtC,6CAA6C;AAE7C;;;;GAIG;AACH,MAAa,mBAAmB;IAiB9B;;;;OAIG;IACH,YAAmB,MAAiC;;QAClD,IAAI,CAAC,MAAM,GAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,gBAAgB,mCAAI,mBAAQ,CAAC,uBAAuB,CAAC;QACtF,mEAAmE;QACnE,IAAI,CAAC,QAAQ,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,OAAO,mCAAI,KAAK,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,mBAAmB,CAAC,GAAG,KAAe;QAC3C,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,cAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,cAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,YAAY,CAAC,QAAgB;QAClC,OAAO,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,QAAgB,EAAE,MAAe;QAClD,OAAO,cAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,GAAG,KAAe;QACjC,OAAO,cAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;YACxB,MAAM,IAAI,GAAG,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7D,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO,6BAAa,CAAC,MAAM,CAAM,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7D,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACzB,OAAO,mBAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACnD,CAAC;YACD,uFAAuF;YACvF,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,2BAA2B,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,QAAgB;QACrC,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,YAAE,CAAC,YAAY,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CAAC,QAAgB,EAAE,QAAiB;QAC3D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,IAAA,kBAAO,EAAC,QAAe,CAAC,CAAC;QAClC,CAAC;QACD,+GAA+G;QAC/G,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,OAAe;QAChC,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;YACxB,MAAM,QAAQ,GAAwB,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9D,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,QAAQ,CAAC,IAAI,CAAC,6BAAa,CAAC,MAAM,CAAM,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrE,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;oBACzB,QAAQ,CAAC,IAAI,CAAC,mBAAQ,CAAC,MAAM,CAAM,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,IAAY;QAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAEpD,kCAAkC;QAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,IAAA,yBAAc,EAAC,GAAG,YAAY,0BAA0B,EAAE,aAAa,CAAC,CAAC;QAClF,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,IAAA,0BAAa,EAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,OAAO,IAAA,yBAAc,EAAC,GAAG,YAAY,8BAA8B,EAAE,eAAe,CAAC,CAAC;QACxF,CAAC;QAED,gCAAgC;QAChC,IAAI,CAAC;YACH,uBAAuB;YACvB,IAAI,YAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,YAAE,CAAC,UAAU,CAAC,YAAY,EAAE,YAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,wCAAwC;gBACxC,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3E,IAAI,SAAS,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC1C,YAAE,CAAC,UAAU,CAAC,SAAS,EAAE,YAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YACD,OAAO,IAAA,4BAAiB,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC7C,+FAA+F;QACjG,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,IAAA,yBAAc,EAAC,GAAG,YAAY,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,IAAY,EAAE,QAAgB;QACpD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YACtD,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;gBACxB,YAAE,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACjD,OAAO,QAAQ,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YACtD,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;gBACxB,MAAM,IAAI,GAAG,YAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,cAAc,CAAC,CAAC;gBACjD,CAAC;gBACD,YAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,OAAe;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAEvD,kCAAkC;QAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,IAAA,eAAI,EAAC,GAAG,YAAY,0BAA0B,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;YACxB,YAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,eAAe,CAAC,OAAe;QACpC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YACzD,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACvD,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE;gBACxB,MAAM,IAAI,GAAG,YAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,mBAAmB,CAAC,CAAC;gBACtD,CAAC;gBACD,kEAAkE;gBAClE,YAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAnPD,kDAmPC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport {\n  FileTreeItem,\n  IFileTreeInitParams,\n  IFilterSpec,\n  IMutableFileTreeAccessors,\n  SaveDetail\n} from './fileTreeAccessors';\nimport path from 'path';\nimport fs from 'fs';\nimport {\n  captureResult,\n  DetailedResult,\n  fail,\n  failWithDetail,\n  Result,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\nimport { DirectoryItem } from './directoryItem';\nimport { FileItem } from './fileItem';\nimport { isPathMutable } from './filterSpec';\n\n/**\n * Implementation of {@link FileTree.IMutableFileTreeAccessors} that uses the\n * file system to access and modify files and directories.\n * @public\n */\nexport class FsFileTreeAccessors<TCT extends string = string> implements IMutableFileTreeAccessors<TCT> {\n  /**\n   * Optional path prefix to prepend to all paths.\n   */\n  public readonly prefix: string | undefined;\n\n  /**\n   * Function to infer the content type of a file.\n   * @public\n   */\n  protected readonly _inferContentType: (filePath: string) => Result<TCT | undefined>;\n\n  /**\n   * The mutability configuration.\n   */\n  private readonly _mutable: boolean | IFilterSpec;\n\n  /**\n   * Construct a new instance of the {@link FileTree.FsFileTreeAccessors | FsFileTreeAccessors} class.\n   * @param params - Optional {@link FileTree.IFileTreeInitParams | initialization parameters}.\n   * @public\n   */\n  public constructor(params?: IFileTreeInitParams<TCT>) {\n    this.prefix = params?.prefix;\n    this._inferContentType = params?.inferContentType ?? FileItem.defaultInferContentType;\n    /* c8 ignore next 1 - defensive default when params is undefined */\n    this._mutable = params?.mutable ?? false;\n  }\n\n  /**\n   * Resolves paths to an absolute path.\n   * @param paths - Paths to resolve.\n   * @returns The resolved absolute path.\n   */\n  public resolveAbsolutePath(...paths: string[]): string {\n    if (this.prefix && !path.isAbsolute(paths[0])) {\n      return path.resolve(this.prefix, ...paths);\n    }\n    return path.resolve(...paths);\n  }\n\n  /**\n   * Gets the extension of a path.\n   * @param itemPath - Path to get the extension of.\n   * @returns The extension of the path.\n   */\n  public getExtension(itemPath: string): string {\n    return path.extname(itemPath);\n  }\n\n  /**\n   * Gets the base name of a path.\n   * @param itemPath - Path to get the base name of.\n   * @param suffix - Optional suffix to remove from the base name.\n   * @returns The base name of the path.\n   */\n  public getBaseName(itemPath: string, suffix?: string): string {\n    return path.basename(itemPath, suffix);\n  }\n\n  /**\n   * Joins paths together.\n   * @param paths - Paths to join.\n   * @returns The joined paths.\n   */\n  public joinPaths(...paths: string[]): string {\n    return path.join(...paths);\n  }\n\n  /**\n   * Gets an item from the file tree.\n   * @param itemPath - Path of the item to get.\n   * @returns The item if it exists.\n   */\n  public getItem(itemPath: string): Result<FileTreeItem<TCT>> {\n    return captureResult(() => {\n      const stat = fs.statSync(this.resolveAbsolutePath(itemPath));\n      if (stat.isDirectory()) {\n        return DirectoryItem.create<TCT>(itemPath, this).orThrow();\n      } else if (stat.isFile()) {\n        return FileItem.create(itemPath, this).orThrow();\n      }\n      /* c8 ignore next 1 - defensive coding: filesystem items should be file or directory */\n      throw new Error(`${itemPath}: not a file or directory`);\n    });\n  }\n\n  /**\n   * Gets the contents of a file in the file tree.\n   * @param filePath - Absolute path of the file.\n   * @returns The contents of the file.\n   */\n  public getFileContents(filePath: string): Result<string> {\n    return captureResult(() => fs.readFileSync(this.resolveAbsolutePath(filePath), 'utf8'));\n  }\n\n  /**\n   * Gets the content type of a file in the file tree.\n   * @param filePath - Absolute path of the file.\n   * @param provided - Optional supplied content type.\n   * @returns The content type of the file.\n   */\n  public getFileContentType(filePath: string, provided?: string): Result<TCT | undefined> {\n    if (provided !== undefined) {\n      return succeed(provided as TCT);\n    }\n    /* c8 ignore next 2 - coverage has intermittent issues in the build - local tests show coverage of this line */\n    return this._inferContentType(filePath);\n  }\n\n  /**\n   * Gets the children of a directory in the file tree.\n   * @param dirPath - Path of the directory.\n   * @returns The children of the directory.\n   */\n  public getChildren(dirPath: string): Result<ReadonlyArray<FileTreeItem<TCT>>> {\n    return captureResult(() => {\n      const children: FileTreeItem<TCT>[] = [];\n      const files = fs.readdirSync(this.resolveAbsolutePath(dirPath), { withFileTypes: true });\n      files.forEach((file) => {\n        const fullPath = this.resolveAbsolutePath(dirPath, file.name);\n        if (file.isDirectory()) {\n          children.push(DirectoryItem.create<TCT>(fullPath, this).orThrow());\n        } else if (file.isFile()) {\n          children.push(FileItem.create<TCT>(fullPath, this).orThrow());\n        }\n      });\n      return children;\n    });\n  }\n\n  /**\n   * Checks if a file at the given path can be saved.\n   * @param path - The path to check.\n   * @returns `DetailedSuccess` with {@link FileTree.SaveCapability} if the file can be saved,\n   * or `DetailedFailure` with {@link FileTree.SaveFailureReason} if it cannot.\n   */\n  public fileIsMutable(path: string): DetailedResult<boolean, SaveDetail> {\n    const absolutePath = this.resolveAbsolutePath(path);\n\n    // Check if mutability is disabled\n    if (this._mutable === false) {\n      return failWithDetail(`${absolutePath}: mutability is disabled`, 'not-mutable');\n    }\n\n    // Check if path is excluded by filter\n    if (!isPathMutable(absolutePath, this._mutable)) {\n      return failWithDetail(`${absolutePath}: path is excluded by filter`, 'path-excluded');\n    }\n\n    // Check file system permissions\n    try {\n      // Check if file exists\n      if (fs.existsSync(absolutePath)) {\n        fs.accessSync(absolutePath, fs.constants.W_OK);\n      } else {\n        // Check if parent directory is writable\n        const parentDir = absolutePath.substring(0, absolutePath.lastIndexOf('/'));\n        if (parentDir && fs.existsSync(parentDir)) {\n          fs.accessSync(parentDir, fs.constants.W_OK);\n        }\n      }\n      return succeedWithDetail(true, 'persistent');\n      /* c8 ignore next 3 - unreachable when running as root (CI), tested in mutableFsTree.test.ts */\n    } catch {\n      return failWithDetail(`${absolutePath}: permission denied`, 'permission-denied');\n    }\n  }\n\n  /**\n   * Saves the contents to a file at the given path.\n   * @param path - The path of the file to save.\n   * @param contents - The string contents to save.\n   * @returns `Success` if the file was saved, or `Failure` with an error message.\n   */\n  public saveFileContents(path: string, contents: string): Result<string> {\n    return this.fileIsMutable(path).asResult.onSuccess(() => {\n      const absolutePath = this.resolveAbsolutePath(path);\n      return captureResult(() => {\n        fs.writeFileSync(absolutePath, contents, 'utf8');\n        return contents;\n      });\n    });\n  }\n\n  /**\n   * Deletes a file at the given path.\n   * @param path - The path of the file to delete.\n   * @returns `Success` with `true` if the file was deleted, or `Failure` with an error message.\n   */\n  public deleteFile(path: string): Result<boolean> {\n    return this.fileIsMutable(path).asResult.onSuccess(() => {\n      const absolutePath = this.resolveAbsolutePath(path);\n      return captureResult(() => {\n        const stat = fs.statSync(absolutePath);\n        if (!stat.isFile()) {\n          throw new Error(`${absolutePath}: not a file`);\n        }\n        fs.unlinkSync(absolutePath);\n        return true;\n      });\n    });\n  }\n\n  /**\n   * Creates a directory at the given path, including any missing parent directories.\n   * @param dirPath - The path of the directory to create.\n   * @returns `Success` with the absolute path if created, or `Failure` with an error message.\n   */\n  public createDirectory(dirPath: string): Result<string> {\n    const absolutePath = this.resolveAbsolutePath(dirPath);\n\n    // Check if mutability is disabled\n    if (this._mutable === false) {\n      return fail(`${absolutePath}: mutability is disabled`);\n    }\n\n    return captureResult(() => {\n      fs.mkdirSync(absolutePath, { recursive: true });\n      return absolutePath;\n    });\n  }\n\n  /**\n   * Deletes a directory at the given path.\n   * The directory must be empty or the operation will fail.\n   * @param dirPath - The path of the directory to delete.\n   * @returns `Success` with `true` if the directory was deleted, or `Failure` with an error message.\n   */\n  public deleteDirectory(dirPath: string): Result<boolean> {\n    return this.fileIsMutable(dirPath).asResult.onSuccess(() => {\n      const absolutePath = this.resolveAbsolutePath(dirPath);\n      return captureResult(() => {\n        const stat = fs.statSync(absolutePath);\n        if (!stat.isDirectory()) {\n          throw new Error(`${absolutePath}: not a directory`);\n        }\n        // fs.rmdirSync fails if directory is non-empty (desired behavior)\n        fs.rmdirSync(absolutePath);\n        return true;\n      });\n    });\n  }\n}\n"]}

package/lib/packlets/file-tree/in-memory/inMemoryTree.d.ts

@@ -51,56 +51,87 @@ export declare class InMemoryTreeAccessors<TCT extends string = string> implemen
      */
     static create<TCT extends string = string>(files: IInMemoryFile<TCT>[], params?: IFileTreeInitParams<TCT>): Result<InMemoryTreeAccessors<TCT>>;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
+     * Resolves paths to an absolute path.
+     * @param paths - Paths to resolve.
+     * @returns The resolved absolute path.
      */
     resolveAbsolutePath(...paths: string[]): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
+     * Gets the extension of a path.
+     * @param path - Path to get the extension of.
+     * @returns The extension of the path.
      */
     getExtension(path: string): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
+     * Gets the base name of a path.
+     * @param path - Path to get the base name of.
+     * @param suffix - Optional suffix to remove from the base name.
+     * @returns The base name of the path.
      */
     getBaseName(path: string, suffix?: string): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
+     * Joins paths together.
+     * @param paths - Paths to join.
+     * @returns The joined paths.
      */
     joinPaths(...paths: string[]): string;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getItem}
+     * Gets an item from the file tree.
+     * @param itemPath - Path of the item to get.
+     * @returns The item if it exists.
      */
     getItem(itemPath: string): Result<FileTreeItem<TCT>>;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
+     * Gets the contents of a file in the file tree.
+     * @param path - Absolute path of the file.
+     * @returns The contents of the file.
      */
     getFileContents(path: string): Result<string>;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContentType}
+     * Gets the content type of a file in the file tree.
+     * @param path - Absolute path of the file.
+     * @param provided - Optional supplied content type.
+     * @returns The content type of the file.
      */
     getFileContentType(path: string, provided?: string): Result<TCT | undefined>;
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
+     * Gets the children of a directory in the file tree.
+     * @param path - Path of the directory.
+     * @returns The children of the directory.
      */
     getChildren(path: string): Result<ReadonlyArray<FileTreeItem<TCT>>>;
     private _addMutableFile;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.createDirectory}
+     * Creates a directory at the given path, including any missing parent directories.
+     * @param dirPath - The path of the directory to create.
+     * @returns `Success` with the absolute path if created, or `Failure` with an error message.
      */
     createDirectory(dirPath: string): Result<string>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.fileIsMutable}
+     * Checks if a file at the given path can be saved.
+     * @param path - The path to check.
+     * @returns `DetailedSuccess` with {@link FileTree.SaveCapability} if the file can be saved,
+     * or `DetailedFailure` with {@link FileTree.SaveFailureReason} if it cannot.
      */
     fileIsMutable(path: string): DetailedResult<boolean, SaveDetail>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteFile}
+     * Deletes a file at the given path.
+     * @param path - The path of the file to delete.
+     * @returns `Success` with `true` if the file was deleted, or `Failure` with an error message.
      */
     deleteFile(path: string): Result<boolean>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteDirectory}
+     * Deletes a directory at the given path.
+     * The directory must be empty or the operation will fail.
+     * @param path - The path of the directory to delete.
+     * @returns `Success` with `true` if the directory was deleted, or `Failure` with an error message.
      */
     deleteDirectory(path: string): Result<boolean>;
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.saveFileContents}
+     * Saves the contents to a file at the given path.
+     * @param path - The path of the file to save.
+     * @param contents - The string contents to save.
+     * @returns `Success` if the file was saved, or `Failure` with an error message.
      */
     saveFileContents(path: string, contents: string): Result<string>;
 }

package/lib/packlets/file-tree/in-memory/inMemoryTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryTree.d.ts","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/inMemoryTree.ts"],"names":[],"mappings":"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"}

package/lib/packlets/file-tree/in-memory/inMemoryTree.js

@@ -138,7 +138,9 @@ class InMemoryTreeAccessors {
         return (0, ts_utils_1.captureResult)(() => new InMemoryTreeAccessors(files, params));
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
+     * Resolves paths to an absolute path.
+     * @param paths - Paths to resolve.
+     * @returns The resolved absolute path.
      */
     resolveAbsolutePath(...paths) {
         const parts = paths[0].startsWith('/') ? paths : [this._tree.prefix, ...paths];
@@ -146,7 +148,9 @@ class InMemoryTreeAccessors {
         return `/${joined}`;
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
+     * Gets the extension of a path.
+     * @param path - Path to get the extension of.
+     * @returns The extension of the path.
      */
     getExtension(path) {
         const parts = path.split('.');
@@ -156,7 +160,10 @@ class InMemoryTreeAccessors {
         return `.${parts.pop()}`;
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
+     * Gets the base name of a path.
+     * @param path - Path to get the base name of.
+     * @param suffix - Optional suffix to remove from the base name.
+     * @returns The base name of the path.
      */
     getBaseName(path, suffix) {
         var _a;
@@ -168,7 +175,9 @@ class InMemoryTreeAccessors {
         return base;
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
+     * Joins paths together.
+     * @param paths - Paths to join.
+     * @returns The joined paths.
      */
     joinPaths(...paths) {
         var _a;
@@ -176,7 +185,9 @@ class InMemoryTreeAccessors {
         return ((_a = paths[0]) === null || _a === void 0 ? void 0 : _a.startsWith('/')) ? `/${joined}` : joined;
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getItem}
+     * Gets an item from the file tree.
+     * @param itemPath - Path of the item to get.
+     * @returns The item if it exists.
      */
     getItem(itemPath) {
         const existing = this._tree.byAbsolutePath.get(itemPath);
@@ -191,7 +202,9 @@ class InMemoryTreeAccessors {
         return (0, ts_utils_1.fail)(`${itemPath}: not found`);
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
+     * Gets the contents of a file in the file tree.
+     * @param path - Absolute path of the file.
+     * @returns The contents of the file.
      */
     getFileContents(path) {
         const absolutePath = this.resolveAbsolutePath(path);
@@ -208,7 +221,10 @@ class InMemoryTreeAccessors {
         return (0, ts_utils_1.captureResult)(() => JSON.stringify(item.contents));
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContentType}
+     * Gets the content type of a file in the file tree.
+     * @param path - Absolute path of the file.
+     * @param provided - Optional supplied content type.
+     * @returns The content type of the file.
      */
     getFileContentType(path, provided) {
         // If provided contentType is given, use it directly (highest priority)
@@ -231,7 +247,9 @@ class InMemoryTreeAccessors {
         return this._inferContentType(path);
     }
     /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
+     * Gets the children of a directory in the file tree.
+     * @param path - Path of the directory.
+     * @returns The children of the directory.
      */
     getChildren(path) {
         const item = this._tree.byAbsolutePath.get(path);
@@ -281,7 +299,9 @@ class InMemoryTreeAccessors {
         });
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.createDirectory}
+     * Creates a directory at the given path, including any missing parent directories.
+     * @param dirPath - The path of the directory to create.
+     * @returns `Success` with the absolute path if created, or `Failure` with an error message.
      */
     createDirectory(dirPath) {
         const absolutePath = this.resolveAbsolutePath(dirPath);
@@ -312,7 +332,10 @@ class InMemoryTreeAccessors {
         return (0, ts_utils_1.succeed)(absolutePath);
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.fileIsMutable}
+     * Checks if a file at the given path can be saved.
+     * @param path - The path to check.
+     * @returns `DetailedSuccess` with {@link FileTree.SaveCapability} if the file can be saved,
+     * or `DetailedFailure` with {@link FileTree.SaveFailureReason} if it cannot.
      */
     fileIsMutable(path) {
         const absolutePath = this.resolveAbsolutePath(path);
@@ -327,7 +350,9 @@ class InMemoryTreeAccessors {
         return (0, ts_utils_1.succeedWithDetail)(true, 'transient');
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteFile}
+     * Deletes a file at the given path.
+     * @param path - The path of the file to delete.
+     * @returns `Success` with `true` if the file was deleted, or `Failure` with an error message.
      */
     deleteFile(path) {
         const absolutePath = this.resolveAbsolutePath(path);
@@ -359,7 +384,10 @@ class InMemoryTreeAccessors {
         return (0, ts_utils_1.succeed)(true);
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.deleteDirectory}
+     * Deletes a directory at the given path.
+     * The directory must be empty or the operation will fail.
+     * @param path - The path of the directory to delete.
+     * @returns `Success` with `true` if the directory was deleted, or `Failure` with an error message.
      */
     deleteDirectory(path) {
         const absolutePath = this.resolveAbsolutePath(path);
@@ -399,7 +427,10 @@ class InMemoryTreeAccessors {
         return (0, ts_utils_1.succeed)(true);
     }
     /**
-     * {@inheritDoc FileTree.IMutableFileTreeAccessors.saveFileContents}
+     * Saves the contents to a file at the given path.
+     * @param path - The path of the file to save.
+     * @param contents - The string contents to save.
+     * @returns `Success` if the file was saved, or `Failure` with an error message.
      */
     saveFileContents(path, contents) {
         const isMutable = this.fileIsMutable(path);

package/lib/packlets/file-tree/in-memory/inMemoryTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryTree.js","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/inMemoryTree.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport {\n  captureResult,\n  DetailedResult,\n  fail,\n  failWithDetail,\n  Result,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\nimport { DirectoryItem } from '../directoryItem';\nimport { FileItem } from '../fileItem';\nimport {\n  FileTreeItem,\n  IFileTreeInitParams,\n  IFilterSpec,\n  IMutableFileTreeAccessors,\n  SaveDetail\n} from '../fileTreeAccessors';\nimport { InMemoryDirectory, InMemoryFile, TreeBuilder } from './treeBuilder';\nimport { isPathMutable } from '../filterSpec';\n\n/**\n * Represents a single file in an in-memory {@link FileTree | file tree}.\n * @public\n */\nexport interface IInMemoryFile<TCT extends string = string> {\n  /**\n   * The absolute path of the file in the tree.\n   */\n  readonly path: string;\n\n  /**\n   * The contents of the file\n   */\n  readonly contents: unknown;\n\n  /**\n   * The content type of the file.\n   */\n  readonly contentType?: TCT;\n}\n\n/**\n * A mutable in-memory file that allows updating contents.\n * @internal\n */\nclass MutableInMemoryFile<TCT extends string = string> {\n  public readonly absolutePath: string;\n  public readonly contentType?: TCT;\n  private _contents: unknown;\n\n  public constructor(absolutePath: string, contents: unknown, contentType?: TCT) {\n    this.absolutePath = absolutePath;\n    this._contents = contents;\n    this.contentType = contentType;\n  }\n\n  public get contents(): unknown {\n    return this._contents;\n  }\n\n  public setContents(contents: unknown): void {\n    this._contents = contents;\n  }\n}\n\n/**\n * A mutable in-memory directory that creates mutable files.\n * @internal\n */\nclass MutableInMemoryDirectory<TCT extends string = string> {\n  public readonly absolutePath: string;\n  protected _children: Map<string, MutableInMemoryDirectory<TCT> | MutableInMemoryFile<TCT>>;\n\n  /* c8 ignore next 3 - internal getter used by tree traversal */\n  public get children(): ReadonlyMap<string, MutableInMemoryDirectory<TCT> | MutableInMemoryFile<TCT>> {\n    return this._children;\n  }\n\n  public constructor(absolutePath: string) {\n    this.absolutePath = absolutePath;\n    this._children = new Map();\n  }\n\n  public getChildPath(name: string): string {\n    if (this.absolutePath === '/') {\n      return `/${name}`;\n    }\n    return [this.absolutePath, name].join('/');\n  }\n\n  public addFile(name: string, contents: unknown, contentType?: TCT): Result<MutableInMemoryFile<TCT>> {\n    /* c8 ignore next 3 - defensive: duplicate detection during construction */\n    if (this._children.has(name)) {\n      return fail(`${name}: already exists`);\n    }\n    const child = new MutableInMemoryFile<TCT>(this.getChildPath(name), contents, contentType);\n    this._children.set(name, child);\n    return succeed(child);\n  }\n\n  public getOrAddDirectory(name: string): Result<MutableInMemoryDirectory<TCT>> {\n    const existing = this._children.get(name);\n    if (existing) {\n      if (existing instanceof MutableInMemoryDirectory) {\n        return succeed(existing);\n      }\n      return fail(`${name}: not a directory`);\n    }\n    const child = new MutableInMemoryDirectory<TCT>(this.getChildPath(name));\n    this._children.set(name, child);\n    return succeed(child);\n  }\n\n  public updateOrAddFile(\n    name: string,\n    contents: unknown,\n    contentType?: TCT\n  ): Result<MutableInMemoryFile<TCT>> {\n    const existing = this._children.get(name);\n    if (existing) {\n      if (existing instanceof MutableInMemoryFile) {\n        existing.setContents(contents);\n        return succeed(existing);\n      }\n      return fail(`${name}: not a file`);\n    }\n    return this.addFile(name, contents, contentType);\n  }\n\n  public removeChild(name: string): boolean {\n    return this._children.delete(name);\n  }\n}\n\n/**\n * Implementation of {@link FileTree.IMutableFileTreeAccessors} that uses an in-memory\n * tree to access and modify files and directories.\n * @public\n */\nexport class InMemoryTreeAccessors<TCT extends string = string> implements IMutableFileTreeAccessors<TCT> {\n  private readonly _tree: TreeBuilder<TCT>;\n  private readonly _inferContentType: (filePath: string) => Result<TCT | undefined>;\n  private readonly _mutable: boolean | IFilterSpec;\n  private readonly _mutableByPath: Map<string, MutableInMemoryDirectory<TCT> | MutableInMemoryFile<TCT>>;\n  private readonly _mutableRoot: MutableInMemoryDirectory<TCT>;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n   * @param params - Optional params for the tree.\n   * @public\n   */\n  protected constructor(files: IInMemoryFile<TCT>[], params?: IFileTreeInitParams<TCT>) {\n    this._tree = TreeBuilder.create<TCT>(params?.prefix).orThrow();\n    this._inferContentType = params?.inferContentType ?? FileItem.defaultInferContentType;\n    this._mutable = params?.mutable ?? false;\n    this._mutableByPath = new Map();\n    const prefix = params?.prefix ?? '/';\n    this._mutableRoot = new MutableInMemoryDirectory<TCT>(\n      prefix.endsWith('/') ? prefix.slice(0, -1) || '/' : prefix\n    );\n    this._mutableByPath.set(this._mutableRoot.absolutePath, this._mutableRoot);\n\n    for (const file of files) {\n      const contentType = file.contentType ?? this._inferContentType(file.path).orDefault();\n      this._tree.addFile(file.path, file.contents, contentType).orThrow();\n      this._addMutableFile(file.path, file.contents, contentType);\n    }\n  }\n\n  /**\n   * Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied\n   * in-memory files.\n   * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n   * @param prefix - Optional prefix for the tree.\n   */\n  public static create<TCT extends string = string>(\n    files: IInMemoryFile<TCT>[],\n    prefix?: string\n  ): Result<InMemoryTreeAccessors<TCT>>;\n\n  /**\n   * Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied\n   * in-memory files.\n   * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n   * @param params - Optional params for the tree.\n   */\n  public static create<TCT extends string = string>(\n    files: IInMemoryFile<TCT>[],\n    params?: IFileTreeInitParams<TCT>\n  ): Result<InMemoryTreeAccessors<TCT>>;\n\n  /**\n   * Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied\n   * in-memory files.\n   * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n   * @param params - Optional params for the tree.\n   */\n  public static create<TCT extends string = string>(\n    files: IInMemoryFile<TCT>[],\n    params?: IFileTreeInitParams<TCT> | string\n  ): Result<InMemoryTreeAccessors<TCT>> {\n    /* c8 ignore next 2 - tested but code coverage has intermittent issues */\n    params = typeof params === 'string' ? { prefix: params } : params;\n    return captureResult(() => new InMemoryTreeAccessors(files, params));\n  }\n\n  /**\n   * Resolves paths to an absolute path.\n   * @param paths - Paths to resolve.\n   * @returns The resolved absolute path.\n   */\n  public resolveAbsolutePath(...paths: string[]): string {\n    const parts = paths[0].startsWith('/') ? paths : [this._tree.prefix, ...paths];\n    const joined = parts.flatMap((p) => p.split('/').filter((s) => s.length > 0)).join('/');\n    return `/${joined}`;\n  }\n\n  /**\n   * Gets the extension of a path.\n   * @param path - Path to get the extension of.\n   * @returns The extension of the path.\n   */\n  public getExtension(path: string): string {\n    const parts = path.split('.');\n    if (parts.length === 1) {\n      return '';\n    }\n    return `.${parts.pop()}`;\n  }\n\n  /**\n   * Gets the base name of a path.\n   * @param path - Path to get the base name of.\n   * @param suffix - Optional suffix to remove from the base name.\n   * @returns The base name of the path.\n   */\n  public getBaseName(path: string, suffix?: string): string {\n    /* c8 ignore next 1 - ?? is defense in depth should never happen */\n    const base = path.split('/').pop() ?? '';\n    if (suffix && base.endsWith(suffix)) {\n      return base.slice(0, base.length - suffix.length);\n    }\n    return base;\n  }\n\n  /**\n   * Joins paths together.\n   * @param paths - Paths to join.\n   * @returns The joined paths.\n   */\n  public joinPaths(...paths: string[]): string {\n    const joined = paths.flatMap((p) => p.split('/').filter((s) => s.length > 0)).join('/');\n    return paths[0]?.startsWith('/') ? `/${joined}` : joined;\n  }\n\n  /**\n   * Gets an item from the file tree.\n   * @param itemPath - Path of the item to get.\n   * @returns The item if it exists.\n   */\n  public getItem(itemPath: string): Result<FileTreeItem<TCT>> {\n    const existing = this._tree.byAbsolutePath.get(itemPath);\n    if (existing) {\n      if (existing instanceof InMemoryFile) {\n        return FileItem.create<TCT>(existing.absolutePath, this);\n      } else if (existing instanceof InMemoryDirectory) {\n        return DirectoryItem.create<TCT>(existing.absolutePath, this);\n      }\n    }\n    return fail(`${itemPath}: not found`);\n  }\n\n  /**\n   * Gets the contents of a file in the file tree.\n   * @param path - Absolute path of the file.\n   * @returns The contents of the file.\n   */\n  public getFileContents(path: string): Result<string> {\n    const absolutePath = this.resolveAbsolutePath(path);\n    const item = this._mutableByPath.get(absolutePath);\n    if (item === undefined) {\n      return fail(`${absolutePath}: not found`);\n    }\n    if (!(item instanceof MutableInMemoryFile)) {\n      return fail(`${absolutePath}: not a file`);\n    }\n    if (typeof item.contents === 'string') {\n      return succeed(item.contents);\n    }\n    return captureResult(() => JSON.stringify(item.contents));\n  }\n\n  /**\n   * Gets the content type of a file in the file tree.\n   * @param path - Absolute path of the file.\n   * @param provided - Optional supplied content type.\n   * @returns The content type of the file.\n   */\n  public getFileContentType(path: string, provided?: string): Result<TCT | undefined> {\n    // If provided contentType is given, use it directly (highest priority)\n    if (provided !== undefined) {\n      return succeed(provided as TCT);\n    }\n\n    const item = this._tree.byAbsolutePath.get(path);\n    if (item === undefined) {\n      // If file doesn't exist, still try to infer content type from path\n      return this._inferContentType(path);\n    }\n    if (!(item instanceof InMemoryFile)) {\n      // For directories, return undefined\n      return succeed(undefined);\n    }\n    // Return stored contentType if it exists, otherwise infer\n    if (item.contentType !== undefined) {\n      return succeed(item.contentType);\n    }\n    return this._inferContentType(path);\n  }\n\n  /**\n   * Gets the children of a directory in the file tree.\n   * @param path - Path of the directory.\n   * @returns The children of the directory.\n   */\n  public getChildren(path: string): Result<ReadonlyArray<FileTreeItem<TCT>>> {\n    const item = this._tree.byAbsolutePath.get(path);\n    if (item === undefined) {\n      return fail(`${path}: not found`);\n    }\n    /* c8 ignore next 3 - local coverage is 100% but build coverage has intermittent issues */\n    if (!(item instanceof InMemoryDirectory)) {\n      return fail(`${path}: not a directory`);\n    }\n    return captureResult(() => {\n      const children: FileTreeItem<TCT>[] = [];\n      for (const child of item.children.values()) {\n        if (child instanceof InMemoryFile) {\n          children.push(FileItem.create<TCT>(child.absolutePath, this).orThrow());\n        } else if (child instanceof InMemoryDirectory) {\n          children.push(DirectoryItem.create<TCT>(child.absolutePath, this).orThrow());\n        }\n      }\n      return children;\n    });\n  }\n\n  private _addMutableFile(\n    path: string,\n    contents: unknown,\n    contentType?: TCT\n  ): Result<MutableInMemoryFile<TCT>> {\n    const absolutePath = this.resolveAbsolutePath(path);\n    const parts = absolutePath.split('/').filter((p) => p.length > 0);\n    /* c8 ignore next 3 - defensive: invalid path detection */\n    if (parts.length === 0) {\n      return fail(`${absolutePath}: invalid file path`);\n    }\n\n    let dir: MutableInMemoryDirectory<TCT> = this._mutableRoot;\n    while (parts.length > 1) {\n      const part = parts.shift()!;\n      const result = dir.getOrAddDirectory(part);\n      /* c8 ignore next 3 - defensive: directory conflict during construction */\n      if (result.isFailure()) {\n        return fail(result.message);\n      }\n      dir = result.value as MutableInMemoryDirectory<TCT>;\n      if (!this._mutableByPath.has(dir.absolutePath)) {\n        this._mutableByPath.set(dir.absolutePath, dir);\n      }\n    }\n\n    return dir.addFile(parts[0], contents, contentType).onSuccess((file) => {\n      this._mutableByPath.set(file.absolutePath, file as MutableInMemoryFile<TCT>);\n      return succeed(file as MutableInMemoryFile<TCT>);\n    });\n  }\n\n  /**\n   * Creates a directory at the given path, including any missing parent directories.\n   * @param dirPath - The path of the directory to create.\n   * @returns `Success` with the absolute path if created, or `Failure` with an error message.\n   */\n  public createDirectory(dirPath: string): Result<string> {\n    const absolutePath = this.resolveAbsolutePath(dirPath);\n\n    // Check if mutability is disabled\n    if (this._mutable === false) {\n      return fail(`${absolutePath}: mutability is disabled`);\n    }\n\n    // Add to the TreeBuilder (read layer)\n    const treeResult = this._tree.addDirectory(absolutePath);\n    /* c8 ignore next 3 - defensive: read layer failure would indicate internal inconsistency */\n    if (treeResult.isFailure()) {\n      return fail(treeResult.message);\n    }\n\n    // Add to the mutable layer\n    const parts = absolutePath.split('/').filter((p) => p.length > 0);\n    let dir: MutableInMemoryDirectory<TCT> = this._mutableRoot;\n    for (const part of parts) {\n      const result = dir.getOrAddDirectory(part);\n      /* c8 ignore next 3 - defensive: mutable layer should match read layer state */\n      if (result.isFailure()) {\n        return fail(result.message);\n      }\n      dir = result.value as MutableInMemoryDirectory<TCT>;\n      if (!this._mutableByPath.has(dir.absolutePath)) {\n        this._mutableByPath.set(dir.absolutePath, dir);\n      }\n    }\n\n    return succeed(absolutePath);\n  }\n\n  /**\n   * Checks if a file at the given path can be saved.\n   * @param path - The path to check.\n   * @returns `DetailedSuccess` with {@link FileTree.SaveCapability} if the file can be saved,\n   * or `DetailedFailure` with {@link FileTree.SaveFailureReason} if it cannot.\n   */\n  public fileIsMutable(path: string): DetailedResult<boolean, SaveDetail> {\n    const absolutePath = this.resolveAbsolutePath(path);\n\n    // Check if mutability is disabled\n    if (this._mutable === false) {\n      return failWithDetail(`${absolutePath}: mutability is disabled`, 'not-mutable');\n    }\n\n    // Check if path is excluded by filter\n    if (!isPathMutable(absolutePath, this._mutable)) {\n      return failWithDetail(`${absolutePath}: path is excluded by filter`, 'path-excluded');\n    }\n\n    return succeedWithDetail(true, 'transient');\n  }\n\n  /**\n   * Deletes a file at the given path.\n   * @param path - The path of the file to delete.\n   * @returns `Success` with `true` if the file was deleted, or `Failure` with an error message.\n   */\n  public deleteFile(path: string): Result<boolean> {\n    const absolutePath = this.resolveAbsolutePath(path);\n    const parts = absolutePath.split('/').filter((p) => p.length > 0);\n    if (parts.length === 0) {\n      return fail(`${absolutePath}: invalid file path`);\n    }\n\n    const fileName = parts.pop()!;\n\n    // Navigate to parent directory\n    let dir: MutableInMemoryDirectory<TCT> = this._mutableRoot;\n    for (const part of parts) {\n      const child = dir.children.get(part);\n      if (!child || !(child instanceof MutableInMemoryDirectory)) {\n        return fail(`${absolutePath}: parent directory not found`);\n      }\n      dir = child;\n    }\n\n    if (!dir.removeChild(fileName)) {\n      return fail(`${absolutePath}: file not found`);\n    }\n\n    // Also remove from the read layer's directory children and path index\n    const parentPath = parts.length === 0 ? '/' : '/' + parts.join('/');\n    const readParent = this._tree.byAbsolutePath.get(parentPath);\n    if (readParent instanceof InMemoryDirectory) {\n      readParent.removeChild(fileName);\n    }\n    this._tree.byAbsolutePath.delete(absolutePath);\n    this._mutableByPath.delete(absolutePath);\n\n    return succeed(true);\n  }\n\n  /**\n   * Deletes a directory at the given path.\n   * The directory must be empty or the operation will fail.\n   * @param path - The path of the directory to delete.\n   * @returns `Success` with `true` if the directory was deleted, or `Failure` with an error message.\n   */\n  public deleteDirectory(path: string): Result<boolean> {\n    const absolutePath = this.resolveAbsolutePath(path);\n    const parts = absolutePath.split('/').filter((p) => p.length > 0);\n    if (parts.length === 0) {\n      return fail(`${absolutePath}: invalid directory path`);\n    }\n\n    const dirName = parts.pop()!;\n\n    // Navigate to parent directory\n    let parentDir: MutableInMemoryDirectory<TCT> = this._mutableRoot;\n    for (const part of parts) {\n      const child = parentDir.children.get(part);\n      if (!child || !(child instanceof MutableInMemoryDirectory)) {\n        return fail(`${absolutePath}: parent directory not found`);\n      }\n      parentDir = child;\n    }\n\n    // Verify target is a directory\n    const target = parentDir.children.get(dirName);\n    if (!target || !(target instanceof MutableInMemoryDirectory)) {\n      return fail(`${absolutePath}: not a directory`);\n    }\n\n    // Check non-empty\n    if (target.children.size > 0) {\n      return fail(`${absolutePath}: directory is not empty`);\n    }\n\n    parentDir.removeChild(dirName);\n\n    // Also remove from the read layer\n    /* c8 ignore next 1 - defensive: branch for top-level directory deletion */\n    const readParentPath = parts.length === 0 ? '/' : '/' + parts.join('/');\n    const readParent = this._tree.byAbsolutePath.get(readParentPath);\n    if (readParent instanceof InMemoryDirectory) {\n      readParent.removeChild(dirName);\n    }\n    this._tree.byAbsolutePath.delete(absolutePath);\n    this._mutableByPath.delete(absolutePath);\n\n    return succeed(true);\n  }\n\n  /**\n   * Saves the contents to a file at the given path.\n   * @param path - The path of the file to save.\n   * @param contents - The string contents to save.\n   * @returns `Success` if the file was saved, or `Failure` with an error message.\n   */\n  public saveFileContents(path: string, contents: string): Result<string> {\n    const isMutable = this.fileIsMutable(path);\n    if (isMutable.isFailure()) {\n      return fail(isMutable.message);\n    }\n\n    const absolutePath = this.resolveAbsolutePath(path);\n    const parts = absolutePath.split('/').filter((p) => p.length > 0);\n    if (parts.length === 0) {\n      return fail(`${absolutePath}: invalid file path`);\n    }\n\n    // Navigate to parent directory, creating directories as needed\n    let dir: MutableInMemoryDirectory<TCT> = this._mutableRoot;\n    while (parts.length > 1) {\n      const part = parts.shift()!;\n      const result = dir.getOrAddDirectory(part);\n      if (result.isFailure()) {\n        return fail(result.message);\n      }\n      dir = result.value as MutableInMemoryDirectory<TCT>;\n      if (!this._mutableByPath.has(dir.absolutePath)) {\n        this._mutableByPath.set(dir.absolutePath, dir);\n      }\n    }\n\n    // Update or add the file in the mutable layer\n    return dir.updateOrAddFile(parts[0], contents).onSuccess((file) => {\n      this._mutableByPath.set(file.absolutePath, file as MutableInMemoryFile<TCT>);\n\n      // Also register in the read layer so getItem/getChildren can find it\n      if (!this._tree.byAbsolutePath.has(file.absolutePath)) {\n        this._tree.addFile(file.absolutePath, contents);\n      }\n\n      return succeed(contents);\n    });\n  }\n}\n"]}

package/lib/packlets/file-tree/in-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/index.ts"],"names":[],"mappings":"AAsBA,cAAc,gBAAgB,CAAC"}

package/lib/packlets/file-tree/in-memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,iDAA+B","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './inMemoryTree';\n"]}

package/lib/packlets/file-tree/in-memory/treeBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeBuilder.d.ts","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/treeBuilder.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAgC,MAAM,eAAe,CAAC;AAErE;;;GAGG;AACH,qBAAa,YAAY,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IACnD;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC;;OAEG;IACH,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,SAAgB,WAAW,CAAC,EAAE,GAAG,CAAC;IAElC;;;;;OAKG;gBACgB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,GAAG;CAK9E;AAED;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IACxD;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7E;;OAEG;IACH,IAAW,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAErF;IAED;;;OAGG;gBACgB,YAAY,EAAE,MAAM;IAKvC;;;;;OAKG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAatE;;;;;;;OAOG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAS7F;;;;OAIG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;OAMG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAM1C;AAED;;;GAGG;AACH,qBAAa,WAAW,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IAClD;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAE7C;;OAEG;IACH,SAAgB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAExF;;;;OAIG;IACH,SAAS,aAAa,MAAM,CAAC,EAAE,MAAM;IAiBrC;;;;;;OAMG;WACW,MAAM,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAI5F;;;;;;;;OAQG;IACI,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAuBrG;;;;;;;OAOG;IACI,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;CAe1E"}