@fgv/ts-utils 4.5.1 → 5.0.0-0

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

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

@@ -0,0 +1,170 @@
+"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.TreeBuilder = exports.InMemoryDirectory = exports.InMemoryFile = void 0;
+const base_1 = require("../../base");
+/**
+ * Represents a file in an in-memory file tree.
+ * @public
+ */
+class InMemoryFile {
+    /**
+     * Creates a new {@link InMemoryFile | InMemoryFile} instance.
+     * @param absolutePath - The absolute path of the file.
+     * @param contents - The contents of the file.
+     */
+    constructor(absolutePath, contents) {
+        this.absolutePath = absolutePath;
+        this.contents = contents;
+    }
+}
+exports.InMemoryFile = InMemoryFile;
+/**
+ * Represents a directory in an in-memory file tree.
+ * @public
+ */
+class InMemoryDirectory {
+    /**
+     * The children of the directory.
+     */
+    get children() {
+        return this._children;
+    }
+    /**
+     * Creates an empty new {@link InMemoryDirectory | InMemoryDirectory} instance.
+     * @param absolutePath - The absolute path of the directory.
+     */
+    constructor(absolutePath) {
+        this.absolutePath = absolutePath;
+        this._children = new Map();
+    }
+    /**
+     * 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) {
+        const existing = this._children.get(name);
+        if (existing) {
+            if (existing instanceof InMemoryDirectory) {
+                return (0, base_1.succeed)(existing);
+            }
+            return (0, base_1.fail)(`${name}: not a directory`);
+        }
+        const child = new InMemoryDirectory(this.getChildPath(name));
+        this._children.set(name, child);
+        return (0, base_1.succeed)(child);
+    }
+    /**
+     * 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, contents) {
+        if (this._children.has(name)) {
+            return (0, base_1.fail)(`${name}: already exists`);
+        }
+        const child = new InMemoryFile(this.getChildPath(name), contents);
+        this._children.set(name, child);
+        return (0, base_1.succeed)(child);
+    }
+    /**
+     * 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) {
+        if (this.absolutePath === '/') {
+            return `/${name}`;
+        }
+        return [this.absolutePath, name].join('/');
+    }
+}
+exports.InMemoryDirectory = InMemoryDirectory;
+/**
+ * Helper class to build an in-memory file tree.
+ * @public
+ */
+class TreeBuilder {
+    /**
+     * Protected constructor for derived classes.
+     * @param prefix - The prefix for all paths in the tree.
+     * @public
+     */
+    constructor(prefix) {
+        this.prefix = prefix !== null && prefix !== void 0 ? prefix : '/';
+        if (!this.prefix.startsWith('/')) {
+            throw new Error(`${prefix}: not an absolute path`);
+        }
+        this.root = new InMemoryDirectory(this.prefix);
+        this.byAbsolutePath = new Map();
+        this.byAbsolutePath.set(this.prefix, this.root);
+    }
+    /**
+     * 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) {
+        return (0, base_1.captureResult)(() => new TreeBuilder(prefix));
+    }
+    /**
+     * 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, contents) {
+        const parts = absolutePath.split('/').filter((p) => p.length > 0);
+        if (parts.length === 0) {
+            return (0, base_1.fail)(`${absolutePath}: invalid file path`);
+        }
+        let dir = this.root;
+        while (parts.length > 1) {
+            const part = parts.shift();
+            const result = dir.getOrAddDirectory(part);
+            if (result.isFailure()) {
+                return (0, base_1.fail)(result.message);
+            }
+            dir = result.value;
+            if (!this.byAbsolutePath.has(dir.absolutePath)) {
+                this.byAbsolutePath.set(dir.absolutePath, dir);
+            }
+        }
+        return dir.addFile(parts[0], contents).onSuccess((file) => {
+            this.byAbsolutePath.set(file.absolutePath, file);
+            return (0, base_1.succeed)(file);
+        });
+    }
+}
+exports.TreeBuilder = TreeBuilder;
+//# sourceMappingURL=treeBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treeBuilder.js","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/treeBuilder.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 { Result, captureResult, fail, succeed } from '../../base';\n\n/**\n * Represents a file in an in-memory file tree.\n * @public\n */\nexport class InMemoryFile {\n  /**\n   * The absolute path of the file.\n   */\n  public readonly absolutePath: string;\n  /**\n   * The contents of the file.\n   */\n  public readonly contents: unknown;\n\n  /**\n   * Creates a new {@link InMemoryFile | InMemoryFile} instance.\n   * @param absolutePath - The absolute path of the file.\n   * @param contents - The contents of the file.\n   */\n  public constructor(absolutePath: string, contents: unknown) {\n    this.absolutePath = absolutePath;\n    this.contents = contents;\n  }\n}\n\n/**\n * Represents a directory in an in-memory file tree.\n * @public\n */\nexport class InMemoryDirectory {\n  /**\n   * The absolute path of the directory.\n   */\n  public readonly absolutePath: string;\n  protected _children: Map<string, InMemoryDirectory | InMemoryFile>;\n\n  /**\n   * The children of the directory.\n   */\n  public get children(): ReadonlyMap<string, InMemoryDirectory | InMemoryFile> {\n    return this._children;\n  }\n\n  /**\n   * Creates an empty new {@link InMemoryDirectory | InMemoryDirectory} instance.\n   * @param absolutePath - The absolute path of the directory.\n   */\n  public constructor(absolutePath: string) {\n    this.absolutePath = absolutePath;\n    this._children = new Map<string, InMemoryDirectory | InMemoryFile>();\n  }\n\n  /**\n   * Gets or adds a child directory with the specified name.\n   * @param name - The name of the child directory.\n   * @returns {@link Success | Success} with the child directory if successful, or\n   * {@link Failure | Failure} with an error message otherwise.\n   */\n  public getOrAddDirectory(name: string): Result<InMemoryDirectory> {\n    const existing = this._children.get(name);\n    if (existing) {\n      if (existing instanceof InMemoryDirectory) {\n        return succeed(existing);\n      }\n      return fail(`${name}: not a directory`);\n    }\n    const child = new InMemoryDirectory(this.getChildPath(name));\n    this._children.set(name, child);\n    return succeed(child);\n  }\n\n  /**\n   * Adds a file to the directory.\n   * @param name - The name of the file.\n   * @param contents - The contents of the file.\n   * @returns {@link Success | Success} with the new file if successful, or\n   * {@link Failure | Failure} with an error message otherwise.\n   */\n  public addFile(name: string, contents: unknown): Result<InMemoryFile> {\n    if (this._children.has(name)) {\n      return fail(`${name}: already exists`);\n    }\n    const child = new InMemoryFile(this.getChildPath(name), contents);\n    this._children.set(name, child);\n    return succeed(child);\n  }\n\n  /**\n   * Gets the absolute path for a child of this directory with the supplied\n   * name.\n   * @param name - The name of the child.\n   * @returns {@link Success | Success} with the absolute path if successful, or\n   * {@link Failure | Failure} with an error message otherwise.\n   */\n  public getChildPath(name: string): string {\n    if (this.absolutePath === '/') {\n      return `/${name}`;\n    }\n    return [this.absolutePath, name].join('/');\n  }\n}\n\n/**\n * Helper class to build an in-memory file tree.\n * @public\n */\nexport class TreeBuilder {\n  /**\n   * The prefix for all paths in the tree.\n   */\n  public readonly prefix: string;\n\n  /**\n   * The root directory of the tree.\n   */\n  public readonly root: InMemoryDirectory;\n\n  /**\n   * A map of all directories and files in the tree by absolute path.\n   */\n  public readonly byAbsolutePath: Map<string, InMemoryDirectory | InMemoryFile>;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param prefix - The prefix for all paths in the tree.\n   * @public\n   */\n  protected constructor(prefix?: string) {\n    this.prefix = prefix ?? '/';\n    if (!this.prefix.startsWith('/')) {\n      throw new Error(`${prefix}: not an absolute path`);\n    }\n    this.root = new InMemoryDirectory(this.prefix);\n    this.byAbsolutePath = new Map<string, InMemoryDirectory | InMemoryFile>();\n    this.byAbsolutePath.set(this.prefix, this.root);\n  }\n\n  /**\n   * Creates a new {@link TreeBuilder | TreeBuilder} instance.\n   * @param prefix - The prefix for all paths in the tree.\n   * @returns {@link Success | Success} with the new {@link TreeBuilder | TreeBuilder} instance if successful,\n   * or {@link Failure | Failure} with an error message otherwise.\n   * @public\n   */\n  public static create(prefix?: string): Result<TreeBuilder> {\n    return captureResult(() => new TreeBuilder(prefix));\n  }\n\n  /**\n   * Adds a file to the tree.\n   * @param absolutePath - The absolute path of the file.\n   * @param contents - The contents of the file.\n   * @returns {@link Success | Success} with the new file if successful, or\n   * {@link Failure | Failure} with an error message otherwise.\n   * @public\n   */\n  public addFile(absolutePath: string, contents: unknown): Result<InMemoryFile> {\n    const parts = absolutePath.split('/').filter((p) => p.length > 0);\n    if (parts.length === 0) {\n      return fail(`${absolutePath}: invalid file path`);\n    }\n    let dir = this.root;\n    while (parts.length > 1) {\n      const part = parts.shift()!;\n      const result = dir.getOrAddDirectory(part);\n      if (result.isFailure()) {\n        return fail(result.message);\n      }\n      dir = result.value;\n      if (!this.byAbsolutePath.has(dir.absolutePath)) {\n        this.byAbsolutePath.set(dir.absolutePath, dir);\n      }\n    }\n    return dir.addFile(parts[0], contents).onSuccess((file) => {\n      this.byAbsolutePath.set(file.absolutePath, file);\n      return succeed(file);\n    });\n  }\n}\n"]}

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

@@ -0,0 +1,8 @@
+import { IInMemoryFile, InMemoryTreeAccessors } from './in-memory';
+export * from './directoryItem';
+export * from './fileItem';
+export * from './fileTreeAccessors';
+export * from './fsTree';
+export * from './fileTree';
+export { IInMemoryFile, InMemoryTreeAccessors };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEnE,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,CAAC"}

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

@@ -0,0 +1,46 @@
+"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 });
+exports.InMemoryTreeAccessors = void 0;
+const in_memory_1 = require("./in-memory");
+Object.defineProperty(exports, "InMemoryTreeAccessors", { enumerable: true, get: function () { return in_memory_1.InMemoryTreeAccessors; } });
+__exportStar(require("./directoryItem"), exports);
+__exportStar(require("./fileItem"), exports);
+__exportStar(require("./fileTreeAccessors"), exports);
+__exportStar(require("./fsTree"), exports);
+__exportStar(require("./fileTree"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;AAEH,2CAAmE;AAQ3C,sGARA,iCAAqB,OAQA;AAN7C,kDAAgC;AAChC,6CAA2B;AAC3B,sDAAoC;AACpC,2CAAyB;AACzB,6CAA2B","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 { IInMemoryFile, InMemoryTreeAccessors } from './in-memory';\n\nexport * from './directoryItem';\nexport * from './fileItem';\nexport * from './fileTreeAccessors';\nexport * from './fsTree';\nexport * from './fileTree';\n\nexport { IInMemoryFile, InMemoryTreeAccessors };\n"]}

package/lib/packlets/hash/crcNormalizer.js

@@ -69,7 +69,7 @@ class Crc32Normalizer extends hashingNormalizer_1.HashingNormalizer {
         super(Crc32Normalizer.crc32Hash);
     }
     static crc32Hash(parts) {
-        return String(crc32(textEncoder.encode(parts.join('|'))));
+        return crc32(textEncoder.encode(parts.join('|'))).toString(16);
     }
 }
 exports.Crc32Normalizer = Crc32Normalizer;

package/lib/packlets/hash/crcNormalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"crcNormalizer.js","sourceRoot":"","sources":["../../../src/packlets/hash/crcNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,2DAAwD;AAExD,MAAM,WAAW,GAAgB,IAAI,WAAW,EAAE,CAAC;AAEnD,MAAM,UAAU,GAAW,UAAU,CAAC;AAEtC,MAAM,UAAU,GAAa,EAAE,CAAC;AAEhC,SAAS,KAAK,CAAC,KAAiB,EAAE,MAAc,UAAU;IACxD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,eAAe,EAAE,CAAC;IACpB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACtC,sCAAsC;QACtC,GAAG,GAAG,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE;IACrC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,SAAS,eAAe;IACtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,sCAAsC;gBACtC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACV,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACd,CAAC;YACH,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,qCAAiB;IACpD;QACE,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,KAAe;QACrC,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF;AARD,0CAQC","sourcesContent":["/*\n * Copyright (c) 2023 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 { HashingNormalizer } from './hashingNormalizer';\n\nconst textEncoder: TextEncoder = new TextEncoder();\n\nconst POLYNOMIAL: number = 0xedb88320;\n\nconst crc32Table: number[] = [];\n\nfunction crc32(bytes: Uint8Array, crc: number = 0xffffffff): number {\n  if (crc32Table.length === 0) {\n    buildCrc32Table();\n  }\n  for (let i = 0; i < bytes.length; ++i) {\n    // eslint-disable-next-line no-bitwise\n    crc = crc32Table[(crc ^ bytes[i]) & 0xff] ^ (crc >>> 8);\n  }\n  return (crc ^ -1) >>> 0;\n}\n\nconst toUInt32 = (n: number): number => {\n  if (n >= 0) {\n    return n;\n  }\n  return 0xffffffff - n * -1 + 1;\n};\n\nfunction buildCrc32Table(): void {\n  if (crc32Table.length === 0) {\n    for (let n = 0; n < 256; n++) {\n      let r = n;\n      for (let i = 0; i < 8; i++) {\n        // eslint-disable-next-line no-bitwise\n        if (r & 1) {\n          r = (r >>> 1) ^ POLYNOMIAL;\n        } else {\n          r = r >>> 1;\n        }\n      }\n      crc32Table.push(toUInt32(r));\n    }\n  }\n}\n\n/**\n * A {@link Hash.HashingNormalizer | hashing normalizer} which computes object\n * hash using the CRC32 algorithm.\n * @public\n */\nexport class Crc32Normalizer extends HashingNormalizer {\n  public constructor() {\n    super(Crc32Normalizer.crc32Hash);\n  }\n\n  public static crc32Hash(parts: string[]): string {\n    return String(crc32(textEncoder.encode(parts.join('|'))));\n  }\n}\n"]}
+{"version":3,"file":"crcNormalizer.js","sourceRoot":"","sources":["../../../src/packlets/hash/crcNormalizer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,2DAAwD;AAExD,MAAM,WAAW,GAAgB,IAAI,WAAW,EAAE,CAAC;AAEnD,MAAM,UAAU,GAAW,UAAU,CAAC;AAEtC,MAAM,UAAU,GAAa,EAAE,CAAC;AAEhC,SAAS,KAAK,CAAC,KAAiB,EAAE,MAAc,UAAU;IACxD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,eAAe,EAAE,CAAC;IACpB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACtC,sCAAsC;QACtC,GAAG,GAAG,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE;IACrC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,SAAS,eAAe;IACtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,sCAAsC;gBACtC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACV,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACd,CAAC;YACH,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,qCAAiB;IACpD;QACE,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,KAAe;QACrC,OAAO,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AARD,0CAQC","sourcesContent":["/*\n * Copyright (c) 2023 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 { HashingNormalizer } from './hashingNormalizer';\n\nconst textEncoder: TextEncoder = new TextEncoder();\n\nconst POLYNOMIAL: number = 0xedb88320;\n\nconst crc32Table: number[] = [];\n\nfunction crc32(bytes: Uint8Array, crc: number = 0xffffffff): number {\n  if (crc32Table.length === 0) {\n    buildCrc32Table();\n  }\n  for (let i = 0; i < bytes.length; ++i) {\n    // eslint-disable-next-line no-bitwise\n    crc = crc32Table[(crc ^ bytes[i]) & 0xff] ^ (crc >>> 8);\n  }\n  return (crc ^ -1) >>> 0;\n}\n\nconst toUInt32 = (n: number): number => {\n  if (n >= 0) {\n    return n;\n  }\n  return 0xffffffff - n * -1 + 1;\n};\n\nfunction buildCrc32Table(): void {\n  if (crc32Table.length === 0) {\n    for (let n = 0; n < 256; n++) {\n      let r = n;\n      for (let i = 0; i < 8; i++) {\n        // eslint-disable-next-line no-bitwise\n        if (r & 1) {\n          r = (r >>> 1) ^ POLYNOMIAL;\n        } else {\n          r = r >>> 1;\n        }\n      }\n      crc32Table.push(toUInt32(r));\n    }\n  }\n}\n\n/**\n * A {@link Hash.HashingNormalizer | hashing normalizer} which computes object\n * hash using the CRC32 algorithm.\n * @public\n */\nexport class Crc32Normalizer extends HashingNormalizer {\n  public constructor() {\n    super(Crc32Normalizer.crc32Hash);\n  }\n\n  public static crc32Hash(parts: string[]): string {\n    return crc32(textEncoder.encode(parts.join('|'))).toString(16);\n  }\n}\n"]}

package/lib/packlets/validation/validators.d.ts

@@ -75,7 +75,7 @@ export declare function recordOf<T, TC = unknown, TK extends string = string>(va
  * value in place.
  * @public
  */
-export declare function enumeratedValue<T extends string>(values: T[]): Validator<T, T[]>;
+export declare function enumeratedValue<T extends string>(values: ReadonlyArray<T>): Validator<T, ReadonlyArray<T>>;
 /**
  * Helper function to create a {@link Validation.Validator} which validates a literal value.
  * @param value - the literal value to be validated