@fgv/ts-utils 4.5.0-2 → 4.5.0

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

@@ -1,93 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2025 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileItem = void 0;
-const base_1 = require("../base");
-/**
- * Class representing a file in a file tree.
- * @public
- */
-class FileItem {
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.name}
-     */
-    get name() {
-        return this._hal.getBaseName(this.absolutePath);
-    }
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.baseName}
-     */
-    get baseName() {
-        return this._hal.getBaseName(this.absolutePath, this.extension);
-    }
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.extension}
-     */
-    get extension() {
-        return this._hal.getExtension(this.absolutePath);
-    }
-    /**
-     * Protected constructor for derived classes.
-     * @param path - Relative path of the file.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    constructor(path, hal) {
-        /**
-         * {@inheritdoc FileTree.IFileTreeFileItem."type"}
-         */
-        this.type = 'file';
-        this._hal = hal;
-        this.absolutePath = hal.resolveAbsolutePath(path);
-    }
-    /**
-     * Creates a new {@link FileTree.FileItem | FileItem} instance.
-     * @param path - Relative path of the file.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    static create(path, hal) {
-        return (0, base_1.captureResult)(() => new FileItem(path, hal));
-    }
-    getContents(converter) {
-        return this._hal
-            .getFileContents(this.absolutePath)
-            .onSuccess((body) => (0, base_1.captureResult)(() => JSON.parse(body)).onFailure(() => (0, base_1.succeed)(body)))
-            .onSuccess((parsed) => {
-            if (converter !== undefined) {
-                return converter.convert(parsed);
-            }
-            return (0, base_1.succeed)(parsed);
-        });
-    }
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.getRawContents}
-     */
-    getRawContents() {
-        return this._hal.getFileContents(this.absolutePath);
-    }
-}
-exports.FileItem = FileItem;
-//# sourceMappingURL=fileItem.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileItem.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileItem.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,kCAAyD;AAKzD;;;GAGG;AACH,MAAa,QAAQ;IAWnB;;OAEG;IACH,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAQD;;;;;;OAMG;IACH,YAAsB,IAAY,EAAE,GAAuB;QA5C3D;;WAEG;QACa,SAAI,GAAW,MAAM,CAAC;QA0CpC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,GAAuB;QACxD,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAUM,WAAW,CAAI,SAAuC;QAC3D,OAAO,IAAI,CAAC,IAAI;aACb,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;aAClC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC,CAAC;aACzF,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACpB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,IAAA,cAAO,EAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;CACF;AAvFD,4BAuFC","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 { captureResult, Result, succeed } from '../base';\nimport { Converter } from '../conversion';\nimport { Validator } from '../validation';\nimport { IFileTreeAccessors, IFileTreeFileItem } from './fileTreeAccessors';\n\n/**\n * Class representing a file in a file tree.\n * @public\n */\nexport class FileItem implements IFileTreeFileItem {\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.\"type\"}\n   */\n  public readonly type: 'file' = 'file';\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.absolutePath}\n   */\n  public readonly absolutePath: string;\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.name}\n   */\n  public get name(): string {\n    return this._hal.getBaseName(this.absolutePath);\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.baseName}\n   */\n  public get baseName(): string {\n    return this._hal.getBaseName(this.absolutePath, this.extension);\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.extension}\n   */\n  public get extension(): string {\n    return this._hal.getExtension(this.absolutePath);\n  }\n\n  /**\n   * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.\n   * @public\n   */\n  protected readonly _hal: IFileTreeAccessors;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param path - Relative path of the file.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @public\n   */\n  protected constructor(path: string, hal: IFileTreeAccessors) {\n    this._hal = hal;\n    this.absolutePath = hal.resolveAbsolutePath(path);\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileItem | FileItem} instance.\n   * @param path - Relative path of the file.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @public\n   */\n  public static create(path: string, hal: IFileTreeAccessors): Result<FileItem> {\n    return captureResult(() => new FileItem(path, hal));\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.(getContents:1)}\n   */\n  public getContents(): Result<unknown>;\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.(getContents:2)}\n   */\n  public getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;\n  public getContents<T>(converter?: Validator<T> | Converter<T>): Result<T | unknown> {\n    return this._hal\n      .getFileContents(this.absolutePath)\n      .onSuccess((body) => captureResult(() => JSON.parse(body)).onFailure(() => succeed(body)))\n      .onSuccess((parsed) => {\n        if (converter !== undefined) {\n          return converter.convert(parsed);\n        }\n        return succeed(parsed);\n      });\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.getRawContents}\n   */\n  public getRawContents(): Result<string> {\n    return this._hal.getFileContents(this.absolutePath);\n  }\n}\n"]}

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

@@ -1,84 +0,0 @@
-import { Result } from '../base';
-import { FileTreeItem, IFileTreeAccessors, IFileTreeDirectoryItem, IFileTreeFileItem } from './fileTreeAccessors';
-import { IInMemoryFile } from './in-memory';
-/**
- * Represents a file tree.
- * @public
- */
-export declare class FileTree {
-    /**
-     * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.
-     * @public
-     */
-    hal: IFileTreeAccessors;
-    /**
-     * Protected constructor for derived classes.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    protected constructor(hal: IFileTreeAccessors);
-    /**
-     * Creates a new {@link FileTree.FileTree | FileTree} instance with the supplied
-     * accessors.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     */
-    static create(hal: IFileTreeAccessors): Result<FileTree>;
-    /**
-     * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors
-     * for the filesystem.
-     * @param prefix - An optional prefix to prepended to supplied relative
-     * paths.
-     */
-    static forFilesystem(prefix?: string): Result<FileTree>;
-    /**
-     * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors
-     * for an in-memory file tree.
-     * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to
-     * include in the tree.
-     * @param prefix - An optional prefix to add to the paths of all files in the tree.
-     */
-    static inMemory(files: IInMemoryFile[], prefix?: string): Result<FileTree>;
-    /**
-     * Gets an item from the tree.
-     * @param itemPath - The path to the item.
-     * @returns {@link Success | Success} with the item if successful,
-     * or {@link Failure | Failure} with an error message otherwise.
-     */
-    getItem(itemPath: string): Result<FileTreeItem>;
-    /**
-     * Gets a file item from the tree.
-     * @param filePath - The path to the file.
-     * @returns {@link Success | Success} with the {@link FileTree.IFileTreeFileItem | file item}
-     * if successful, or {@link Failure | Failure} with an error message otherwise.
-     */
-    getFile(filePath: string): Result<IFileTreeFileItem>;
-    /**
-     * Gets a directory item from the tree.
-     * @param directoryPath - The path to the directory.
-     * @returns {@link Success | Success} with the {@link FileTree.IFileTreeDirectoryItem | directory item}
-     * if successful, or {@link Failure | Failure} with an error message otherwise.
-     */
-    getDirectory(directoryPath: string): Result<IFileTreeDirectoryItem>;
-}
-/**
- * Helper function to create a new {@link FileTree.FileTree | FileTree} instance
- * with accessors for the filesystem.
- * @param prefix - An optional prefix to prepended to supplied relative paths.
- * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance
- * if successful, or {@link Failure | Failure} with an error message otherwise.
- * @public
- */
-export declare function forFilesystem(prefix?: string): Result<FileTree>;
-/**
- * Helper function to create a new {@link FileTree.FileTree | FileTree} instance
- * with accessors for an in-memory file tree.
- * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
- * @param prefix - An optional prefix to add to the paths of all files in the tree.
- * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance
- * if successful, or {@link Failure | Failure} with an error message otherwise.
- * @public
- */
-export declare function inMemory(files: IInMemoryFile[], prefix?: string): Result<FileTree>;
-//# sourceMappingURL=fileTree.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileTree.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,MAAM,EAAiB,MAAM,SAAS,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AAEnE;;;GAGG;AACH,qBAAa,QAAQ;IACnB;;;OAGG;IACI,GAAG,EAAE,kBAAkB,CAAC;IAE/B;;;;;OAKG;IACH,SAAS,aAAa,GAAG,EAAE,kBAAkB;IAI7C;;;;;OAKG;WACW,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC;IAI/D;;;;;OAKG;WACW,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;IAI9D;;;;;;OAMG;WACW,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;IAMjF;;;;;OAKG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;IAKtD;;;;;OAKG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAS3D;;;;;OAKG;IACI,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,sBAAsB,CAAC;CAQ3E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAElF"}

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

@@ -1,135 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2025 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileTree = void 0;
-exports.forFilesystem = forFilesystem;
-exports.inMemory = inMemory;
-const base_1 = require("../base");
-const fsTree_1 = require("./fsTree");
-const in_memory_1 = require("./in-memory");
-/**
- * Represents a file tree.
- * @public
- */
-class FileTree {
-    /**
-     * Protected constructor for derived classes.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    constructor(hal) {
-        this.hal = hal;
-    }
-    /**
-     * Creates a new {@link FileTree.FileTree | FileTree} instance with the supplied
-     * accessors.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     */
-    static create(hal) {
-        return (0, base_1.captureResult)(() => new FileTree(hal));
-    }
-    /**
-     * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors
-     * for the filesystem.
-     * @param prefix - An optional prefix to prepended to supplied relative
-     * paths.
-     */
-    static forFilesystem(prefix) {
-        return (0, base_1.captureResult)(() => new FileTree(new fsTree_1.FsFileTreeAccessors(prefix)));
-    }
-    /**
-     * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors
-     * for an in-memory file tree.
-     * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to
-     * include in the tree.
-     * @param prefix - An optional prefix to add to the paths of all files in the tree.
-     */
-    static inMemory(files, prefix) {
-        return in_memory_1.InMemoryTreeAccessors.create(files, prefix).onSuccess((hal) => (0, base_1.captureResult)(() => new FileTree(hal)));
-    }
-    /**
-     * Gets an item from the tree.
-     * @param itemPath - The path to the item.
-     * @returns {@link Success | Success} with the item if successful,
-     * or {@link Failure | Failure} with an error message otherwise.
-     */
-    getItem(itemPath) {
-        const absolutePath = this.hal.resolveAbsolutePath(itemPath);
-        return this.hal.getItem(absolutePath);
-    }
-    /**
-     * Gets a file item from the tree.
-     * @param filePath - The path to the file.
-     * @returns {@link Success | Success} with the {@link FileTree.IFileTreeFileItem | file item}
-     * if successful, or {@link Failure | Failure} with an error message otherwise.
-     */
-    getFile(filePath) {
-        return this.getItem(filePath).onSuccess((item) => {
-            if (item.type === 'file') {
-                return (0, base_1.succeed)(item);
-            }
-            return (0, base_1.fail)(`${filePath}: not a file`);
-        });
-    }
-    /**
-     * Gets a directory item from the tree.
-     * @param directoryPath - The path to the directory.
-     * @returns {@link Success | Success} with the {@link FileTree.IFileTreeDirectoryItem | directory item}
-     * if successful, or {@link Failure | Failure} with an error message otherwise.
-     */
-    getDirectory(directoryPath) {
-        return this.getItem(directoryPath).onSuccess((item) => {
-            if (item.type === 'directory') {
-                return (0, base_1.succeed)(item);
-            }
-            return (0, base_1.fail)(`${directoryPath}: not a directory`);
-        });
-    }
-}
-exports.FileTree = FileTree;
-/**
- * Helper function to create a new {@link FileTree.FileTree | FileTree} instance
- * with accessors for the filesystem.
- * @param prefix - An optional prefix to prepended to supplied relative paths.
- * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance
- * if successful, or {@link Failure | Failure} with an error message otherwise.
- * @public
- */
-function forFilesystem(prefix) {
-    return FileTree.forFilesystem(prefix);
-}
-/**
- * Helper function to create a new {@link FileTree.FileTree | FileTree} instance
- * with accessors for an in-memory file tree.
- * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
- * @param prefix - An optional prefix to add to the paths of all files in the tree.
- * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance
- * if successful, or {@link Failure | Failure} with an error message otherwise.
- * @public
- */
-function inMemory(files, prefix) {
-    return FileTree.inMemory(files, prefix);
-}
-//# sourceMappingURL=fileTree.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileTree.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileTree.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAoHH,sCAEC;AAWD,4BAEC;AAjID,kCAA+D;AAO/D,qCAA+C;AAC/C,2CAAmE;AAEnE;;;GAGG;AACH,MAAa,QAAQ;IAOnB;;;;;OAKG;IACH,YAAsB,GAAuB;QAC3C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,GAAuB;QAC1C,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,aAAa,CAAC,MAAe;QACzC,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,4BAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,CAAC,KAAsB,EAAE,MAAe;QAC5D,OAAO,iCAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CACnE,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CACvC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,QAAgB;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,IAAA,WAAI,EAAC,GAAG,QAAQ,cAAc,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,aAAqB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YACpD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC9B,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,IAAA,WAAI,EAAC,GAAG,aAAa,mBAAmB,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA1FD,4BA0FC;AAED;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,MAAe;IAC3C,OAAO,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,KAAsB,EAAE,MAAe;IAC9D,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC","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 { captureResult, Result, fail, succeed } from '../base';\nimport {\n  FileTreeItem,\n  IFileTreeAccessors,\n  IFileTreeDirectoryItem,\n  IFileTreeFileItem\n} from './fileTreeAccessors';\nimport { FsFileTreeAccessors } from './fsTree';\nimport { IInMemoryFile, InMemoryTreeAccessors } from './in-memory';\n\n/**\n * Represents a file tree.\n * @public\n */\nexport class FileTree {\n  /**\n   * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.\n   * @public\n   */\n  public hal: IFileTreeAccessors;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @public\n   */\n  protected constructor(hal: IFileTreeAccessors) {\n    this.hal = hal;\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileTree | FileTree} instance with the supplied\n   * accessors.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   */\n  public static create(hal: IFileTreeAccessors): Result<FileTree> {\n    return captureResult(() => new FileTree(hal));\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors\n   * for the filesystem.\n   * @param prefix - An optional prefix to prepended to supplied relative\n   * paths.\n   */\n  public static forFilesystem(prefix?: string): Result<FileTree> {\n    return captureResult(() => new FileTree(new FsFileTreeAccessors(prefix)));\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors\n   * for an in-memory file tree.\n   * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to\n   * include in the tree.\n   * @param prefix - An optional prefix to add to the paths of all files in the tree.\n   */\n  public static inMemory(files: IInMemoryFile[], prefix?: string): Result<FileTree> {\n    return InMemoryTreeAccessors.create(files, prefix).onSuccess((hal) =>\n      captureResult(() => new FileTree(hal))\n    );\n  }\n\n  /**\n   * Gets an item from the tree.\n   * @param itemPath - The path to the item.\n   * @returns {@link Success | Success} with the item if successful,\n   * or {@link Failure | Failure} with an error message otherwise.\n   */\n  public getItem(itemPath: string): Result<FileTreeItem> {\n    const absolutePath = this.hal.resolveAbsolutePath(itemPath);\n    return this.hal.getItem(absolutePath);\n  }\n\n  /**\n   * Gets a file item from the tree.\n   * @param filePath - The path to the file.\n   * @returns {@link Success | Success} with the {@link FileTree.IFileTreeFileItem | file item}\n   * if successful, or {@link Failure | Failure} with an error message otherwise.\n   */\n  public getFile(filePath: string): Result<IFileTreeFileItem> {\n    return this.getItem(filePath).onSuccess((item) => {\n      if (item.type === 'file') {\n        return succeed(item);\n      }\n      return fail(`${filePath}: not a file`);\n    });\n  }\n\n  /**\n   * Gets a directory item from the tree.\n   * @param directoryPath - The path to the directory.\n   * @returns {@link Success | Success} with the {@link FileTree.IFileTreeDirectoryItem | directory item}\n   * if successful, or {@link Failure | Failure} with an error message otherwise.\n   */\n  public getDirectory(directoryPath: string): Result<IFileTreeDirectoryItem> {\n    return this.getItem(directoryPath).onSuccess((item) => {\n      if (item.type === 'directory') {\n        return succeed(item);\n      }\n      return fail(`${directoryPath}: not a directory`);\n    });\n  }\n}\n\n/**\n * Helper function to create a new {@link FileTree.FileTree | FileTree} instance\n * with accessors for the filesystem.\n * @param prefix - An optional prefix to prepended to supplied relative paths.\n * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance\n * if successful, or {@link Failure | Failure} with an error message otherwise.\n * @public\n */\nexport function forFilesystem(prefix?: string): Result<FileTree> {\n  return FileTree.forFilesystem(prefix);\n}\n\n/**\n * Helper function to create a new {@link FileTree.FileTree | FileTree} instance\n * with accessors for an in-memory file tree.\n * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n * @param prefix - An optional prefix to add to the paths of all files in the tree.\n * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance\n * if successful, or {@link Failure | Failure} with an error message otherwise.\n * @public\n */\nexport function inMemory(files: IInMemoryFile[], prefix?: string): Result<FileTree> {\n  return FileTree.inMemory(files, prefix);\n}\n"]}

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

@@ -1,134 +0,0 @@
-import { Result } from '../base';
-import { Converter } from '../conversion';
-import { Validator } from '../validation';
-/**
- * Type of item in a file tree.
- * @public
- */
-export type FileTreeItemType = 'directory' | 'file';
-/**
- * Interface for a file in a file tree.
- * @public
- */
-export interface IFileTreeFileItem {
-    /**
-     * Indicates that this {@link FileTree.FileTreeItem | file tree item} is a file.
-     */
-    readonly type: 'file';
-    /**
-     * The absolute path of the file.
-     */
-    readonly absolutePath: string;
-    /**
-     * The name of the file
-     */
-    readonly name: string;
-    /**
-     * The base name of the file (without extension)
-     */
-    readonly baseName: string;
-    /**
-     * The extension of the file
-     */
-    readonly extension: string;
-    /**
-     * Gets the contents of the file as parsed JSON.
-     * @returns {@link Success | Success} with the parsed contents if successful, or
-     * {@link Failure | Failure}with an error message otherwise.
-     */
-    getContents(): Result<unknown>;
-    /**
-     * Gets the contents of the file as parsed JSON, converted to a specific type.
-     * @param converter - A {@link Validation.Validator | Validator} or {@link Conversion.Converter | Converter}
-     * to convert the parsed JSON contents to the desired type.
-     * @returns {@link Success | Success} with the converted contents if successful, or
-     * {@link Failure | Failure} with an error message otherwise.
-     */
-    getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;
-    /**
-     * Gets the raw contents of the file as a string.
-     * @returns {@link Success | Success} with the raw contents if successful, or
-     * {@link Failure | Failure} with an error message otherwise.
-     */
-    getRawContents(): Result<string>;
-}
-/**
- * Interface for a directory in a file tree.
- * @public
- */
-export interface IFileTreeDirectoryItem {
-    /**
-     * Indicates that this {@link FileTree.FileTreeItem | file tree item} is a directory
-     */
-    readonly type: 'directory';
-    /**
-     * The absolute path of the directory.
-     */
-    readonly absolutePath: string;
-    /**
-     * The name of the directory
-     */
-    readonly name: string;
-    /**
-     * Gets the children of the directory.
-     * @returns {@link Success | Success} with the children of the directory if successful,
-     * or {@link Failure | Failure} with an error message otherwise.
-     */
-    getChildren(): Result<ReadonlyArray<FileTreeItem>>;
-}
-/**
- * Type for an item in a file tree.
- * @public
- */
-export type FileTreeItem = IFileTreeFileItem | IFileTreeDirectoryItem;
-/**
- * Common abstraction layer interface for a tree of files
- * (e.g. a file system or a zip file).
- * @public
- */
-export interface IFileTreeAccessors {
-    /**
-     * Resolves paths to an absolute path.
-     * @param paths - Paths to resolve.
-     * @returns The resolved absolute path.
-     */
-    resolveAbsolutePath(...paths: string[]): string;
-    /**
-     * Gets the extension of a path.
-     * @param path - Path to get the extension of.
-     * @returns The extension of the path.
-     */
-    getExtension(path: string): string;
-    /**
-     * 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;
-    /**
-     * Joins paths together.
-     * @param paths - Paths to join.
-     * @returns The joined paths.
-     */
-    joinPaths(...paths: string[]): string;
-    /**
-     * Gets an item from the file tree.
-     * @param path - Path of the item to get.
-     * @returns The item if it exists.
-     */
-    getItem(path: string): Result<FileTreeItem>;
-    /**
-     * 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>;
-    /**
-     * 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>>;
-}
-//# sourceMappingURL=fileTreeAccessors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileTreeAccessors.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileTreeAccessors.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,WAAW,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/B;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAElE;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,WAAW,IAAI,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEhD;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnD;;;;OAIG;IACH,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEtC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAE5C;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9C;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;CAChE"}

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

@@ -1,24 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2025 Erik Fortune
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=fileTreeAccessors.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileTreeAccessors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 { Result } from '../base';\nimport { Converter } from '../conversion';\nimport { Validator } from '../validation';\n\n/**\n * Type of item in a file tree.\n * @public\n */\nexport type FileTreeItemType = 'directory' | 'file';\n\n/**\n * Interface for a file in a file tree.\n * @public\n */\nexport interface IFileTreeFileItem {\n  /**\n   * Indicates that this {@link FileTree.FileTreeItem | file tree item} is a file.\n   */\n  readonly type: 'file';\n\n  /**\n   * The absolute path of the file.\n   */\n  readonly absolutePath: string;\n\n  /**\n   * The name of the file\n   */\n  readonly name: string;\n\n  /**\n   * The base name of the file (without extension)\n   */\n  readonly baseName: string;\n\n  /**\n   * The extension of the file\n   */\n  readonly extension: string;\n\n  /**\n   * Gets the contents of the file as parsed JSON.\n   * @returns {@link Success | Success} with the parsed contents if successful, or\n   * {@link Failure | Failure}with an error message otherwise.\n   */\n  getContents(): Result<unknown>;\n\n  /**\n   * Gets the contents of the file as parsed JSON, converted to a specific type.\n   * @param converter - A {@link Validation.Validator | Validator} or {@link Conversion.Converter | Converter}\n   * to convert the parsed JSON contents to the desired type.\n   * @returns {@link Success | Success} with the converted contents if successful, or\n   * {@link Failure | Failure} with an error message otherwise.\n   */\n  getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;\n\n  /**\n   * Gets the raw contents of the file as a string.\n   * @returns {@link Success | Success} with the raw contents if successful, or\n   * {@link Failure | Failure} with an error message otherwise.\n   */\n  getRawContents(): Result<string>;\n}\n\n/**\n * Interface for a directory in a file tree.\n * @public\n */\nexport interface IFileTreeDirectoryItem {\n  /**\n   * Indicates that this {@link FileTree.FileTreeItem | file tree item} is a directory\n   */\n  readonly type: 'directory';\n\n  /**\n   * The absolute path of the directory.\n   */\n  readonly absolutePath: string;\n\n  /**\n   * The name of the directory\n   */\n  readonly name: string;\n\n  /**\n   * Gets the children of the directory.\n   * @returns {@link Success | Success} with the children of the directory if successful,\n   * or {@link Failure | Failure} with an error message otherwise.\n   */\n  getChildren(): Result<ReadonlyArray<FileTreeItem>>;\n}\n\n/**\n * Type for an item in a file tree.\n * @public\n */\nexport type FileTreeItem = IFileTreeFileItem | IFileTreeDirectoryItem;\n\n/**\n * Common abstraction layer interface for a tree of files\n * (e.g. a file system or a zip file).\n * @public\n */\nexport interface IFileTreeAccessors {\n  /**\n   * Resolves paths to an absolute path.\n   * @param paths - Paths to resolve.\n   * @returns The resolved absolute path.\n   */\n  resolveAbsolutePath(...paths: string[]): string;\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  getExtension(path: string): string;\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  getBaseName(path: string, suffix?: string): string;\n\n  /**\n   * Joins paths together.\n   * @param paths - Paths to join.\n   * @returns The joined paths.\n   */\n  joinPaths(...paths: string[]): string;\n\n  /**\n   * Gets an item from the file tree.\n   * @param path - Path of the item to get.\n   * @returns The item if it exists.\n   */\n  getItem(path: string): Result<FileTreeItem>;\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  getFileContents(path: string): Result<string>;\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  getChildren(path: string): Result<ReadonlyArray<FileTreeItem>>;\n}\n"]}

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

@@ -1,45 +0,0 @@
-import { FileTreeItem, IFileTreeAccessors } from './fileTreeAccessors';
-import { Result } from '../base';
-/**
- * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses the
- * file system to access files and directories.
- * @public
- */
-export declare class FsFileTreeAccessors implements IFileTreeAccessors {
-    readonly prefix: string | undefined;
-    /**
-     * Protected constructor for derived classes.
-     * @param prefix - Optional prefix for the tree.
-     * @public
-     */
-    constructor(prefix?: string);
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
-     */
-    resolveAbsolutePath(...paths: string[]): string;
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
-     */
-    getExtension(itemPath: string): string;
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
-     */
-    getBaseName(itemPath: string, suffix?: string): string;
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
-     */
-    joinPaths(...paths: string[]): string;
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getItem}
-     */
-    getItem(itemPath: string): Result<FileTreeItem>;
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
-     */
-    getFileContents(filePath: string): Result<string>;
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
-     */
-    getChildren(dirPath: string): Result<ReadonlyArray<FileTreeItem>>;
-}
-//# sourceMappingURL=fsTree.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fsTree.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fsTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAiB,MAAM,EAAE,MAAM,SAAS,CAAC;AAIhD;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,kBAAkB;IAC5D,SAAgB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3C;;;;OAIG;gBACgB,MAAM,CAAC,EAAE,MAAM;IAIlC;;OAEG;IACI,mBAAmB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAOtD;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAI7D;;OAEG;IACI,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAI5C;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;IAYtD;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAIxD;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;CAezE"}