@fgv/ts-utils 4.3.0 → 4.5.0-0

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

@@ -0,0 +1,116 @@
+"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

@@ -0,0 +1 @@
+{"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"]}

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

@@ -0,0 +1,67 @@
+import { Result } from '../../base';
+import { FileTreeItem, IFileTreeAccessors } from '../fileTreeAccessors';
+/**
+ * Represents a single file in an in-memory {@link FileTree.FileTree | file tree}.
+ * @public
+ */
+export interface IInMemoryFile {
+    /**
+     * The absolute path of the file in the tree.
+     */
+    readonly path: string;
+    /**
+     * The contents of the file
+     */
+    readonly contents: unknown;
+}
+/**
+ * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses an in-memory
+ * tree to access files and directories.
+ * @public
+ */
+export declare class InMemoryTreeAccessors implements IFileTreeAccessors {
+    private readonly _tree;
+    /**
+     * Protected constructor for derived classes.
+     * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
+     * @param prefix - Optional prefix for the tree.
+     * @public
+     */
+    protected constructor(files: IInMemoryFile[], prefix?: string);
+    /**
+     * Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied
+     * in-memory files.
+     * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
+     * @param prefix - Optional prefix for the tree.
+     */
+    static create(files: IInMemoryFile[], prefix?: string): Result<InMemoryTreeAccessors>;
+    /**
+     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
+     */
+    resolveAbsolutePath(...paths: string[]): string;
+    /**
+     * {@inheritdoc FileTree.IFileTreeAccessors.getExtension}
+     */
+    getExtension(path: string): string;
+    /**
+     * {@inheritdoc FileTree.IFileTreeAccessors.getBaseName}
+     */
+    getBaseName(path: 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(path: string): Result<string>;
+    /**
+     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
+     */
+    getChildren(path: string): Result<ReadonlyArray<FileTreeItem>>;
+}
+//# sourceMappingURL=inMemoryTree.d.ts.map

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":"AAsBA,OAAO,EAAuB,MAAM,EAAW,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC;;;;;OAKG;IACH,SAAS,aAAa,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM;IAO7D;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAI5F;;OAEG;IACI,mBAAmB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAMtD;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQzC;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IASzD;;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,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAepD;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;CAoBtE"}

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

@@ -0,0 +1,150 @@
+"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.InMemoryTreeAccessors = void 0;
+const base_1 = require("../../base");
+const directoryItem_1 = require("../directoryItem");
+const fileItem_1 = require("../fileItem");
+const treeBuilder_1 = require("./treeBuilder");
+/**
+ * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses an in-memory
+ * tree to access files and directories.
+ * @public
+ */
+class InMemoryTreeAccessors {
+    /**
+     * Protected constructor for derived classes.
+     * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
+     * @param prefix - Optional prefix for the tree.
+     * @public
+     */
+    constructor(files, prefix) {
+        this._tree = treeBuilder_1.TreeBuilder.create(prefix).orThrow();
+        for (const file of files) {
+            this._tree.addFile(file.path, file.contents).orThrow();
+        }
+    }
+    /**
+     * Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied
+     * in-memory files.
+     * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
+     * @param prefix - Optional prefix for the tree.
+     */
+    static create(files, prefix) {
+        return (0, base_1.captureResult)(() => new InMemoryTreeAccessors(files, prefix));
+    }
+    /**
+     * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
+     */
+    resolveAbsolutePath(...paths) {
+        const parts = paths[0].startsWith('/') ? paths : [this._tree.prefix, ...paths];
+        const joined = parts.flatMap((p) => p.split('/').filter((s) => s.length > 0)).join('/');
+        return `/${joined}`;
+    }
+    /**
+     * {@inheritdoc FileTree.IFileTreeAccessors.getExtension}
+     */
+    getExtension(path) {
+        const parts = path.split('.');
+        if (parts.length === 1) {
+            return '';
+        }
+        return `.${parts.pop()}`;
+    }
+    /**
+     * {@inheritdoc FileTree.IFileTreeAccessors.getBaseName}
+     */
+    getBaseName(path, suffix) {
+        var _a;
+        /* c8 ignore next 1 - ?? is defense in depth should never happen */
+        const base = (_a = path.split('/').pop()) !== null && _a !== void 0 ? _a : '';
+        if (suffix && base.endsWith(suffix)) {
+            return base.slice(0, base.length - suffix.length);
+        }
+        return base;
+    }
+    /**
+     * {@inheritdoc FileTree.IFileTreeAccessors.joinPaths}
+     */
+    joinPaths(...paths) {
+        return paths.join('/');
+    }
+    /**
+     * {@inheritDoc FileTree.IFileTreeAccessors.getItem}
+     */
+    getItem(itemPath) {
+        const existing = this._tree.byAbsolutePath.get(itemPath);
+        if (existing) {
+            if (existing instanceof treeBuilder_1.InMemoryFile) {
+                return fileItem_1.FileItem.create(existing.absolutePath, this);
+            }
+            else if (existing instanceof treeBuilder_1.InMemoryDirectory) {
+                return directoryItem_1.DirectoryItem.create(existing.absolutePath, this);
+            }
+        }
+        return (0, base_1.fail)(`${itemPath}: not found`);
+    }
+    /**
+     * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
+     */
+    getFileContents(path) {
+        const item = this._tree.byAbsolutePath.get(path);
+        if (item === undefined) {
+            return (0, base_1.fail)(`${path}: not found`);
+        }
+        if (!(item instanceof treeBuilder_1.InMemoryFile)) {
+            return (0, base_1.fail)(`${path}: not a file`);
+        }
+        // if the body is a string we don't want to add quotes
+        if (typeof item.contents === 'string') {
+            return (0, base_1.succeed)(item.contents);
+        }
+        return (0, base_1.captureResult)(() => JSON.stringify(item.contents));
+    }
+    /**
+     * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
+     */
+    getChildren(path) {
+        const item = this._tree.byAbsolutePath.get(path);
+        if (item === undefined) {
+            return (0, base_1.fail)(`${path}: not found`);
+        }
+        if (!(item instanceof treeBuilder_1.InMemoryDirectory)) {
+            return (0, base_1.fail)(`${path}: not a directory`);
+        }
+        return (0, base_1.captureResult)(() => {
+            const children = [];
+            for (const child of item.children.values()) {
+                if (child instanceof treeBuilder_1.InMemoryFile) {
+                    children.push(fileItem_1.FileItem.create(child.absolutePath, this).orThrow());
+                }
+                else if (child instanceof treeBuilder_1.InMemoryDirectory) {
+                    children.push(directoryItem_1.DirectoryItem.create(child.absolutePath, this).orThrow());
+                }
+            }
+            return children;
+        });
+    }
+}
+exports.InMemoryTreeAccessors = InMemoryTreeAccessors;
+//# sourceMappingURL=inMemoryTree.js.map

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 { captureResult, fail, Result, succeed } from '../../base';\nimport { DirectoryItem } from '../directoryItem';\nimport { FileItem } from '../fileItem';\nimport { FileTreeItem, IFileTreeAccessors } from '../fileTreeAccessors';\nimport { InMemoryDirectory, InMemoryFile, TreeBuilder } from './treeBuilder';\n\n/**\n * Represents a single file in an in-memory {@link FileTree.FileTree | file tree}.\n * @public\n */\nexport interface IInMemoryFile {\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/**\n * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses an in-memory\n * tree to access files and directories.\n * @public\n */\nexport class InMemoryTreeAccessors implements IFileTreeAccessors {\n  private readonly _tree: TreeBuilder;\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 prefix - Optional prefix for the tree.\n   * @public\n   */\n  protected constructor(files: IInMemoryFile[], prefix?: string) {\n    this._tree = TreeBuilder.create(prefix).orThrow();\n    for (const file of files) {\n      this._tree.addFile(file.path, file.contents).orThrow();\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(files: IInMemoryFile[], prefix?: string): Result<InMemoryTreeAccessors> {\n    return captureResult(() => new InMemoryTreeAccessors(files, prefix));\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}\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   * {@inheritdoc FileTree.IFileTreeAccessors.getExtension}\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   * {@inheritdoc FileTree.IFileTreeAccessors.getBaseName}\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   * {@inheritdoc FileTree.IFileTreeAccessors.joinPaths}\n   */\n  public joinPaths(...paths: string[]): string {\n    return paths.join('/');\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.getItem}\n   */\n  public getItem(itemPath: string): Result<FileTreeItem> {\n    const existing = this._tree.byAbsolutePath.get(itemPath);\n    if (existing) {\n      if (existing instanceof InMemoryFile) {\n        return FileItem.create(existing.absolutePath, this);\n      } else if (existing instanceof InMemoryDirectory) {\n        return DirectoryItem.create(existing.absolutePath, this);\n      }\n    }\n    return fail(`${itemPath}: not found`);\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}\n   */\n  public getFileContents(path: string): Result<string> {\n    const item = this._tree.byAbsolutePath.get(path);\n    if (item === undefined) {\n      return fail(`${path}: not found`);\n    }\n    if (!(item instanceof InMemoryFile)) {\n      return fail(`${path}: not a file`);\n    }\n    // if the body is a string we don't want to add quotes\n    if (typeof item.contents === 'string') {\n      return succeed(item.contents);\n    }\n    return captureResult(() => JSON.stringify(item.contents));\n  }\n\n  /**\n   * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}\n   */\n  public getChildren(path: string): Result<ReadonlyArray<FileTreeItem>> {\n    const item = this._tree.byAbsolutePath.get(path);\n    if (item === undefined) {\n      return fail(`${path}: not found`);\n    }\n    if (!(item instanceof InMemoryDirectory)) {\n      return fail(`${path}: not a directory`);\n    }\n    return captureResult(() => {\n      const children: FileTreeItem[] = [];\n      for (const child of item.children.values()) {\n        if (child instanceof InMemoryFile) {\n          children.push(FileItem.create(child.absolutePath, this).orThrow());\n        } else if (child instanceof InMemoryDirectory) {\n          children.push(DirectoryItem.create(child.absolutePath, this).orThrow());\n        }\n      }\n      return children;\n    });\n  }\n}\n"]}

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

@@ -0,0 +1,2 @@
+export * from './inMemoryTree';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,39 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./inMemoryTree"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,106 @@
+import { Result } from '../../base';
+/**
+ * Represents a file in an in-memory file tree.
+ * @public
+ */
+export declare class InMemoryFile {
+    /**
+     * The absolute path of the file.
+     */
+    readonly absolutePath: string;
+    /**
+     * The contents of the file.
+     */
+    readonly contents: unknown;
+    /**
+     * Creates a new {@link InMemoryFile | InMemoryFile} instance.
+     * @param absolutePath - The absolute path of the file.
+     * @param contents - The contents of the file.
+     */
+    constructor(absolutePath: string, contents: unknown);
+}
+/**
+ * Represents a directory in an in-memory file tree.
+ * @public
+ */
+export declare class InMemoryDirectory {
+    /**
+     * The absolute path of the directory.
+     */
+    readonly absolutePath: string;
+    protected _children: Map<string, InMemoryDirectory | InMemoryFile>;
+    /**
+     * The children of the directory.
+     */
+    get children(): ReadonlyMap<string, InMemoryDirectory | InMemoryFile>;
+    /**
+     * Creates an empty new {@link InMemoryDirectory | InMemoryDirectory} instance.
+     * @param absolutePath - The absolute path of the directory.
+     */
+    constructor(absolutePath: string);
+    /**
+     * Gets or adds a child directory with the specified name.
+     * @param name - The name of the child directory.
+     * @returns {@link Success | Success} with the child directory if successful, or
+     * {@link Failure | Failure} with an error message otherwise.
+     */
+    getOrAddDirectory(name: string): Result<InMemoryDirectory>;
+    /**
+     * Adds a file to the directory.
+     * @param name - The name of the file.
+     * @param contents - The contents of the file.
+     * @returns {@link Success | Success} with the new file if successful, or
+     * {@link Failure | Failure} with an error message otherwise.
+     */
+    addFile(name: string, contents: unknown): Result<InMemoryFile>;
+    /**
+     * Gets the absolute path for a child of this directory with the supplied
+     * name.
+     * @param name - The name of the child.
+     * @returns {@link Success | Success} with the absolute path if successful, or
+     * {@link Failure | Failure} with an error message otherwise.
+     */
+    getChildPath(name: string): string;
+}
+/**
+ * Helper class to build an in-memory file tree.
+ * @public
+ */
+export declare class TreeBuilder {
+    /**
+     * The prefix for all paths in the tree.
+     */
+    readonly prefix: string;
+    /**
+     * The root directory of the tree.
+     */
+    readonly root: InMemoryDirectory;
+    /**
+     * A map of all directories and files in the tree by absolute path.
+     */
+    readonly byAbsolutePath: Map<string, InMemoryDirectory | InMemoryFile>;
+    /**
+     * Protected constructor for derived classes.
+     * @param prefix - The prefix for all paths in the tree.
+     * @public
+     */
+    protected constructor(prefix?: string);
+    /**
+     * Creates a new {@link TreeBuilder | TreeBuilder} instance.
+     * @param prefix - The prefix for all paths in the tree.
+     * @returns {@link Success | Success} with the new {@link TreeBuilder | TreeBuilder} instance if successful,
+     * or {@link Failure | Failure} with an error message otherwise.
+     * @public
+     */
+    static create(prefix?: string): Result<TreeBuilder>;
+    /**
+     * Adds a file to the tree.
+     * @param absolutePath - The absolute path of the file.
+     * @param contents - The contents of the file.
+     * @returns {@link Success | Success} with the new file if successful, or
+     * {@link Failure | Failure} with an error message otherwise.
+     * @public
+     */
+    addFile(absolutePath: string, contents: unknown): Result<InMemoryFile>;
+}
+//# sourceMappingURL=treeBuilder.d.ts.map

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,YAAY,CAAC;AAElE;;;GAGG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC;;OAEG;IACH,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAElC;;;;OAIG;gBACgB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;CAI3D;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC,CAAC;IAEnE;;OAEG;IACH,IAAW,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC,CAE3E;IAED;;;OAGG;gBACgB,YAAY,EAAE,MAAM;IAKvC;;;;;OAKG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAajE;;;;;;OAMG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC;IASrE;;;;;;OAMG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAM1C;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,iBAAiB,CAAC;IAExC;;OAEG;IACH,SAAgB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC,CAAC;IAE9E;;;;OAIG;IACH,SAAS,aAAa,MAAM,CAAC,EAAE,MAAM;IAUrC;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;IAI1D;;;;;;;OAOG;IACI,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC;CAsB9E"}