@fgv/ts-utils 4.5.0-3 → 4.5.0

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"}

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

@@ -1,116 +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.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FsFileTreeAccessors = void 0;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const base_1 = require("../base");
-const directoryItem_1 = require("./directoryItem");
-const fileItem_1 = require("./fileItem");
-/**
- * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses the
- * file system to access files and directories.
- * @public
- */
-class FsFileTreeAccessors {
-    /**
-     * Protected constructor for derived classes.
-     * @param prefix - Optional prefix for the tree.
-     * @public
-     */
-    constructor(prefix) {
-        this.prefix = prefix;
-    }
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
-     */
-    resolveAbsolutePath(...paths) {
-        if (this.prefix && !path_1.default.isAbsolute(paths[0])) {
-            return path_1.default.resolve(this.prefix, ...paths);
-        }
-        return path_1.default.resolve(...paths);
-    }
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
-     */
-    getExtension(itemPath) {
-        return path_1.default.extname(itemPath);
-    }
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
-     */
-    getBaseName(itemPath, suffix) {
-        return path_1.default.basename(itemPath, suffix);
-    }
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
-     */
-    joinPaths(...paths) {
-        return path_1.default.join(...paths);
-    }
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getItem}
-     */
-    getItem(itemPath) {
-        return (0, base_1.captureResult)(() => {
-            const stat = fs_1.default.statSync(this.resolveAbsolutePath(itemPath));
-            if (stat.isDirectory()) {
-                return directoryItem_1.DirectoryItem.create(itemPath, this).orThrow();
-            }
-            else if (stat.isFile()) {
-                return fileItem_1.FileItem.create(itemPath, this).orThrow();
-            }
-            throw new Error(`${itemPath}: not a file or directory`);
-        });
-    }
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
-     */
-    getFileContents(filePath) {
-        return (0, base_1.captureResult)(() => fs_1.default.readFileSync(this.resolveAbsolutePath(filePath), 'utf8'));
-    }
-    /**
-     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
-     */
-    getChildren(dirPath) {
-        return (0, base_1.captureResult)(() => {
-            const children = [];
-            const files = fs_1.default.readdirSync(this.resolveAbsolutePath(dirPath), { withFileTypes: true });
-            files.forEach((file) => {
-                const fullPath = this.resolveAbsolutePath(dirPath, file.name);
-                if (file.isDirectory()) {
-                    children.push(directoryItem_1.DirectoryItem.create(fullPath, this).orThrow());
-                }
-                else if (file.isFile()) {
-                    children.push(fileItem_1.FileItem.create(fullPath, this).orThrow());
-                }
-            });
-            return children;
-        });
-    }
-}
-exports.FsFileTreeAccessors = FsFileTreeAccessors;
-//# sourceMappingURL=fsTree.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fsTree.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fsTree.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 { FileTreeItem, IFileTreeAccessors } from './fileTreeAccessors';\nimport path from 'path';\nimport fs from 'fs';\nimport { captureResult, Result } from '../base';\nimport { DirectoryItem } from './directoryItem';\nimport { FileItem } from './fileItem';\n\n/**\n * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses the\n * file system to access files and directories.\n * @public\n */\nexport class FsFileTreeAccessors implements IFileTreeAccessors {\n  public readonly prefix: string | undefined;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param prefix - Optional prefix for the tree.\n   * @public\n   */\n  public constructor(prefix?: string) {\n    this.prefix = prefix;\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}\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   * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}\n   */\n  public getExtension(itemPath: string): string {\n    return path.extname(itemPath);\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}\n   */\n  public getBaseName(itemPath: string, suffix?: string): string {\n    return path.basename(itemPath, suffix);\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}\n   */\n  public joinPaths(...paths: string[]): string {\n    return path.join(...paths);\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.getItem}\n   */\n  public getItem(itemPath: string): Result<FileTreeItem> {\n    return captureResult(() => {\n      const stat = fs.statSync(this.resolveAbsolutePath(itemPath));\n      if (stat.isDirectory()) {\n        return DirectoryItem.create(itemPath, this).orThrow();\n      } else if (stat.isFile()) {\n        return FileItem.create(itemPath, this).orThrow();\n      }\n      throw new Error(`${itemPath}: not a file or directory`);\n    });\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}\n   */\n  public getFileContents(filePath: string): Result<string> {\n    return captureResult(() => fs.readFileSync(this.resolveAbsolutePath(filePath), 'utf8'));\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}\n   */\n  public getChildren(dirPath: string): Result<ReadonlyArray<FileTreeItem>> {\n    return captureResult(() => {\n      const children: FileTreeItem[] = [];\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(fullPath, this).orThrow());\n        } else if (file.isFile()) {\n          children.push(FileItem.create(fullPath, this).orThrow());\n        }\n      });\n      return children;\n    });\n  }\n}\n"]}