@fgv/ts-utils 5.0.0-9 → 5.0.1-1

package/lib/packlets/conversion/objectConverter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"objectConverter.js","sourceRoot":"","sources":["../../../src/packlets/conversion/objectConverter.ts"],"names":[],"mappings":"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","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 { fail, isKeyOf, Result, succeed } from '../base';\nimport { Validator } from '../validation';\nimport { BaseConverter } from './baseConverter';\nimport { Converter } from './converter';\nimport { field, optionalField } from './converters';\n\n/**\n * Options for an {@link Conversion.ObjectConverter | ObjectConverter}.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface ObjectConverterOptions<T> {\n  /**\n   * If present, lists optional fields. Missing non-optional fields cause an error.\n   */\n  optionalFields?: (keyof T)[];\n  /**\n   * If true, unrecognized fields yield an error.  If false or undefined (default),\n   * unrecognized fields are ignored.\n   */\n  strict?: boolean;\n  /**\n   * Optional description to be included in error messages.\n   */\n  description?: string;\n\n  /**\n   * Optional modifier to apply to the converter.\n   */\n  modifier?: 'partial' | 'required';\n}\n\n/**\n * Per-property converters or validators for each of the properties in type T.\n * @remarks\n * Used to construct a {@link Conversion.ObjectConverter | ObjectConverter}\n * @public\n */\nexport type FieldConverters<T, TC = unknown> = {\n  [key in keyof T]: Converter<T[key], TC | unknown> | Validator<T[key], TC>;\n};\n\n/**\n * A {@link Converter | Converter} which converts an object of type `<T>` without changing shape, given\n * a {@link Conversion.FieldConverters | FieldConverters<T>} for the fields in the object.\n * @remarks\n * By default, if all of the required fields exist and can be converted, returns a new object with\n * the converted values under the original key names.  If any required fields do not exist or cannot\n * be converted, the entire conversion fails. See {@link Conversion.ObjectConverterOptions | ObjectConverterOptions}\n * for other conversion options.\n * @public\n */\nexport class ObjectConverter<T, TC = unknown> extends BaseConverter<T, TC> {\n  /**\n   * Fields converted by this {@link Conversion.ObjectConverter | ObjectConverter}.\n   */\n  public readonly fields: FieldConverters<T, TC>;\n  /**\n   * Options used to initialize this {@link Conversion.ObjectConverter | ObjectConverter}.\n   */\n  public readonly options: ObjectConverterOptions<T>;\n\n  /**\n   * Constructs a new {@link Conversion.ObjectConverter | ObjectConverter<T, TC>} using options\n   * supplied in a {@link Conversion.ObjectConverterOptions | ObjectConverterOptions<T>}.\n   * @param fields - A {@link Conversion.FieldConverters | FieldConverters<T>} containing\n   * a {@link Converter} for each field\n   * @param options - An optional @see ObjectConverterOptions to configure the conversion\n   * {@label WITH_OPTIONS}\n   */\n  public constructor(fields: FieldConverters<T, TC>, options?: ObjectConverterOptions<T>);\n\n  /**\n   * Constructs a new {@link Conversion.ObjectConverter | ObjectConverter<T, TC>} with optional\n   * properties specified as an array of `keyof T`.\n   * @param fields - A {@link Conversion.FieldConverters | FieldConverters<T>} containing\n   * a {@link Converter} for each field.\n   * @param optional - An array of `keyof T` listing fields that are not required.\n   * {@label WITH_KEYS}\n   * @deprecated Use {@link Conversion.Converter.optional | .optional()} on the individual\n   * fields, or pass {@link Conversion.ObjectConverterOptions | ObjectConverterOptions<T>} to the constructor.\n   */\n  public constructor(fields: FieldConverters<T, TC>, optional?: (keyof T)[]);\n  /**\n   * Concrete implementation of {@link Converters.(ObjectConverter:constructor)}\n   * @internal\n   */\n  public constructor(fields: FieldConverters<T, TC>, opt?: ObjectConverterOptions<T> | (keyof T)[]) {\n    const options = Array.isArray(opt) ? { optionalFields: opt } : opt ?? { optionalFields: [] };\n\n    super((from: unknown, __self, context?: TC) => ObjectConverter._convert(from, context, fields, options));\n\n    this.fields = fields;\n    this.options = options;\n  }\n\n  /**\n   * Converts the supplied object using the {@link Conversion.ObjectConverter | ObjectConverter}\n   * with all fields optional.\n   * @param from - The object to be converted.\n   * @param context - An optional context object passed to the field converters.\n   * @returns A {@link Result} containing the converted object or an error message.\n   */\n  public convertPartial(from: unknown, context?: TC): Result<Partial<T>> {\n    const options: ObjectConverterOptions<T> = { ...this.options, modifier: 'partial' };\n    return ObjectConverter._convert(from, context, this.fields, options);\n  }\n\n  /**\n   * Converts the supplied object using the {@link Conversion.ObjectConverter | ObjectConverter}\n   * with all fields required.\n   * @param from - The object to be converted.\n   * @param context - An optional context object passed to the field converters.\n   * @returns A {@link Result} containing the converted object or an error message.\n   */\n  public convertRequired(from: unknown, context?: TC): Result<Required<T>> {\n    const options: ObjectConverterOptions<T> = { ...this.options, modifier: 'required' };\n    return ObjectConverter._convert(from, context, this.fields, options) as Result<Required<T>>;\n  }\n\n  /**\n   * Creates a new {@link Conversion.ObjectConverter | ObjectConverter} derived from this one but with\n   * all properties optional.\n   * @returns A new {@link Conversion.ObjectConverter | ObjectConverter} with the additional optional source properties.\n   * {@label WITHOUT_OPTIONS}\n   */\n  public partial(): ObjectConverter<Partial<T>, TC>;\n\n  /**\n   * Creates a new {@link Conversion.ObjectConverter | ObjectConverter} derived from this one but with\n   * new optional properties as specified by a supplied {@link Conversion.ObjectConverterOptions | ObjectConverterOptions<T>}.\n   * @param options - The {@link Conversion.ObjectConverterOptions | options} to be applied to the new\n   * converter.\n   * @returns A new {@link Conversion.ObjectConverter | ObjectConverter} with the additional optional source properties.\n   * {@label WITH_OPTIONS}\n   * @deprecated Pass just the keys to be made optional.\n   */\n  public partial(options: ObjectConverterOptions<T>): ObjectConverter<Partial<T>, TC>;\n\n  /**\n   * Creates a new {@link Conversion.ObjectConverter | ObjectConverter} derived from this one but with\n   * new optional properties as specified by a supplied array of `keyof T`.\n   * @param optional - The keys of the source object properties to be made optional.\n   * @returns A new {@link Conversion.ObjectConverter | ObjectConverter} with the additional optional source\n   * properties.\n   * {@label WITH_KEYS}\n   */\n  public partial(optional: (keyof T)[]): ObjectConverter<Partial<T>, TC>;\n\n  /**\n   * Concrete implementation of\n   * {@link Conversion.ObjectConverter.(partial:1) | ObjectConverter.partial(ObjectConverterOptions)} and\n   * {@link Conversion.ObjectConverter.(partial:2) | ObjectConverter.partial((keyof T))[]}.\n   * @internal\n   */\n  public partial(opt?: ObjectConverterOptions<T> | (keyof T)[]): ObjectConverter<Partial<T>, TC> {\n    const options: ObjectConverterOptions<Partial<T>> =\n      opt === undefined\n        ? { ...this.options, modifier: 'partial' }\n        : Array.isArray(opt)\n        ? { ...this.options, optionalFields: [...opt] }\n        : (opt as ObjectConverterOptions<Partial<T>>);\n    return new ObjectConverter<Partial<T>, TC>(this.fields as FieldConverters<Partial<T>, TC>, options)._with(\n      this._traits()\n    );\n  }\n\n  /**\n   * Creates a new {@link Conversion.ObjectConverter | ObjectConverter} derived from this one but with\n   * new optional properties as specified by a supplied array of `keyof T`.\n   * @param addOptionalProperties - The keys to be made optional.\n   * @returns A new {@link Conversion.ObjectConverter | ObjectConverter} with the additional optional source\n   * properties.\n   */\n  public addPartial(addOptionalProperties: (keyof T)[]): ObjectConverter<Partial<T>, TC> {\n    /* c8 ignore next 1 - coverage having a bad day */\n    const myOptional = this.options.optionalFields ?? [];\n    const optional = [...myOptional, ...addOptionalProperties];\n    return this.partial(optional)._with(this._traits());\n  }\n\n  /**\n   * Creates a new {@link Conversion.ObjectConverter | ObjectConverter} derived from this one but with\n   * all properties required.\n   * @returns A new {@link Conversion.ObjectConverter | ObjectConverter} with the additional required source properties.\n   */\n  public required(): ObjectConverter<Required<T>, TC> {\n    const options: ObjectConverterOptions<Required<T>> = { ...this.options, modifier: 'required' };\n    return new ObjectConverter<Required<T>, TC>(\n      this.fields as FieldConverters<Required<T>, TC>,\n      options\n    )._with(this._traits());\n  }\n\n  private static _convert<T, TC>(\n    from: unknown,\n    context: TC | undefined,\n    fields: FieldConverters<T, TC>,\n    options: ObjectConverterOptions<T>\n  ): Result<T> {\n    // eslint bug thinks key is used before defined\n    // eslint-disable-next-line no-use-before-define\n    const converted = {} as { [key in keyof T]: T[key] };\n    const errors: string[] = [];\n    for (const key in fields) {\n      if (fields[key]) {\n        const isOptional =\n          options.modifier === 'partial' ||\n          (options.modifier !== 'required' &&\n            (fields[key].isOptional === true || options.optionalFields?.includes(key) === true));\n        const result = isOptional\n          ? optionalField(key, fields[key]).convert(from, context)\n          : field(key, fields[key]).convert(from, context);\n        if (result.isSuccess() && result.value !== undefined) {\n          converted[key] = result.value;\n        } else if (result.isFailure()) {\n          errors.push(result.message);\n        }\n      }\n    }\n\n    if (options.strict === true) {\n      if (typeof from === 'object' && !Array.isArray(from)) {\n        for (const key in from) {\n          if (from.hasOwnProperty(key) && (!isKeyOf(key, fields) || fields[key] === undefined)) {\n            errors.push(`${key}: unexpected property in source object`);\n          }\n        }\n      } else {\n        errors.push('source is not an object');\n      }\n    }\n    return errors.length === 0\n      ? succeed(converted)\n      : fail(options.description ? `${options.description}: ${errors.join('\\n')}` : errors.join('\\n'));\n  }\n}\n"]}

package/lib/packlets/conversion/stringConverter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stringConverter.d.ts","sourceRoot":"","sources":["../../../src/packlets/conversion/stringConverter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;GAIG;AAGH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC;IAChG;;;;;OAKG;gBAED,cAAc,CAAC,EAAE,EAAE,EACnB,MAAM,CAAC,EAAE,eAAe,EACxB,SAAS,GAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,MAAM,CAAC,CAAC,CAA4B;IAK1G;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IAIrE;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EACzC,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,EAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EACjC,MAAM,CAAC,EAAE,eAAe,GACvB,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC;IAMzB;;;;;;;;OAQG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC;IAE7F;;;;;;;;OAQG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC;IAE/F;;;;;;;;OAQG;IACI,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC;IAE7F;;;;;;;;OAQG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC;CAwC9F"}

package/lib/packlets/conversion/stringConverter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stringConverter.js","sourceRoot":"","sources":["../../../src/packlets/conversion/stringConverter.ts"],"names":[],"mappings":"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","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 { Result, fail, succeed } from '../base';\nimport { BaseConverter } from './baseConverter';\nimport { Converter, ConverterTraits } from './converter';\n\n/**\n * Options for {@link Conversion.StringConverter | StringConverter}\n * matching method\n * @public\n */\n\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport interface StringMatchOptions {\n  /**\n   * An optional message to be displayed if a non-matching string\n   * is encountered.\n   */\n  message?: string;\n}\n\n/**\n * The {@link Conversion.StringConverter | StringConverter} class extends\n * {@link Conversion.BaseConverter | BaseConverter} to provide string-specific\n * helper methods.\n * @public\n */\nexport class StringConverter<T extends string = string, TC = unknown> extends BaseConverter<T, TC> {\n  /**\n   * Construct a new {@link Conversion.StringConverter | StringConverter}.\n   * @param defaultContext - Optional context used by the conversion.\n   * @param traits - Optional traits to be applied to the conversion.\n   * @param converter - Optional conversion function to be used for the conversion.\n   */\n  public constructor(\n    defaultContext?: TC,\n    traits?: ConverterTraits,\n    converter: (from: unknown, self: Converter<T, TC>, context?: TC) => Result<T> = StringConverter._convert\n  ) {\n    super(converter, defaultContext, traits);\n  }\n\n  /**\n   * @internal\n   */\n  protected static _convert<T extends string>(from: unknown): Result<T> {\n    return typeof from === 'string' ? succeed(from as T) : fail(`Not a string: ${JSON.stringify(from)}`);\n  }\n\n  /**\n   * @internal\n   */\n  protected static _wrap<T extends string, TC>(\n    wrapped: StringConverter<T, TC>,\n    converter: (from: T) => Result<T>,\n    traits?: ConverterTraits\n  ): StringConverter<T, TC> {\n    return new StringConverter<T, TC>(undefined, undefined, (from: unknown) => {\n      return wrapped.convert(from).onSuccess(converter);\n    })._with(wrapped._traits(traits));\n  }\n\n  /**\n   * Returns a {@link Conversion.StringConverter | StringConverter} which constrains the result to match\n   * a supplied string.\n   * @param match - The string to be matched\n   * @param options - Optional {@link Conversion.StringMatchOptions} for this conversion.\n   * @returns {@link Success} with a matching string or {@link Failure} with an informative\n   * error if the string does not match.\n   * {@label WITH_STRING}\n   */\n  public matching(match: string, options?: Partial<StringMatchOptions>): StringConverter<T, TC>;\n\n  /**\n   * Returns a {@link Conversion.StringConverter | StringConverter} which constrains the result to match\n   * one of a supplied array of strings.\n   * @param match - The array of allowed strings.\n   * @param options - Optional {@link Conversion.StringMatchOptions} for this conversion.\n   * @returns {@link Success} with a matching string or {@link Failure} with an informative\n   * error if the string does not match.\n   * {@label WITH_ARRAY}\n   */\n  public matching(match: string[], options?: Partial<StringMatchOptions>): StringConverter<T, TC>;\n\n  /**\n   * Returns a {@link Conversion.StringConverter | StringConverter} which constrains the result to match\n   * one of a supplied `Set` of strings.\n   * @param match - The `Set` of allowed strings.\n   * @param options - Optional {@link Conversion.StringMatchOptions} for this conversion.\n   * @returns {@link Success} with a matching string or {@link Failure} with an informative\n   * error if the string does not match.\n   * {@label WITH_SET}\n   */\n  public matching(match: Set<T>, options?: Partial<StringMatchOptions>): StringConverter<T, TC>;\n\n  /**\n   * Returns a {@link Conversion.StringConverter | StringConverter} which constrains the result to match\n   * a supplied regular expression.\n   * @param match - The regular expression to be used as a constraint.\n   * @param options - Optional {@link Conversion.StringMatchOptions} for this conversion\n   * @returns {@link Success} with a matching string or {@link Failure} with an informative\n   * error if the string does not match.\n   * {@label WITH_REGEXP}\n   */\n  public matching(match: RegExp, options?: Partial<StringMatchOptions>): StringConverter<T, TC>;\n\n  /**\n   * Concrete implementation of {@link Conversion.StringConverter.matching#string | StringConverter.matching(string)},\n   * {@link Conversion.StringConverter.matching#array | StringConverter.matching(string[])},\n   * {@link Conversion.StringConverter.matching#set | StringConverter.matching(Set<string>)}, and\n   * {@link Conversion.StringConverter.matching#regexp | StringConverter.matching(RegExp)}.\n   * @internal\n   */\n  public matching(\n    match: string | string[] | Set<T> | RegExp,\n    options?: Partial<StringMatchOptions>\n  ): StringConverter<T, TC> {\n    const message = options?.message;\n    if (typeof match === 'string') {\n      return StringConverter._wrap<T, TC>(this, (from: T) => {\n        return match === from\n          ? succeed(from as T)\n          : fail(message ? `\"${from}\": ${message}` : `\"${from}\": does not match \"${match}\"`);\n      });\n    } else if (match instanceof RegExp) {\n      return StringConverter._wrap<T, TC>(this, (from: T) => {\n        return match.test(from)\n          ? succeed(from as T)\n          : fail(message ? `\"${from}\": ${message}` : `\"${from}\": does not match \"${match}\"`);\n      });\n    } else if (match instanceof Set) {\n      return StringConverter._wrap<T, TC>(this, (from: T) => {\n        return match.has(from)\n          ? succeed(from as T)\n          : fail(message ? `\"${from}\": ${message}` : `\"${from}\": not found in set`);\n      });\n    } else {\n      return StringConverter._wrap<T, TC>(this, (from: T) => {\n        return match.includes(from)\n          ? succeed(from as T)\n          : fail(message ? `\"${from}\": ${message}` : `\"${from}\": not found in [${match.join(',')}]`);\n      });\n    }\n  }\n}\n"]}

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

@@ -1,47 +0,0 @@
-import { Result } from '../base';
-import { FileTreeItem, IFileTreeAccessors, IFileTreeDirectoryItem } from './fileTreeAccessors';
-/**
- * Class representing a directory in a file tree.
- * @public
- */
-export declare class DirectoryItem implements IFileTreeDirectoryItem {
-    /**
-     * {@inheritdoc FileTree.IFileTreeDirectoryItem."type"}
-     */
-    readonly type: 'directory';
-    /**
-     * {@inheritdoc FileTree.IFileTreeDirectoryItem.absolutePath}
-     */
-    readonly absolutePath: string;
-    /**
-     * {@inheritdoc FileTree.IFileTreeDirectoryItem.name}
-     */
-    get name(): string;
-    /**
-     * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.
-     * @public
-     */
-    protected readonly _hal: IFileTreeAccessors;
-    /**
-     * Protected constructor for derived classes.
-     * @param path - Relative path of the directory.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    protected constructor(path: string, hal: IFileTreeAccessors);
-    /**
-     * Creates a new DirectoryItem instance.
-     * @param path - Relative path of the directory.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @returns A {@link Result | result} containing the new DirectoryItem instance if successful,
-     * or a failure if an error occurs.
-     */
-    static create(path: string, hal: IFileTreeAccessors): Result<DirectoryItem>;
-    /**
-     * {@inheritdoc FileTree.IFileTreeDirectoryItem.getChildren}
-     */
-    getChildren(): Result<ReadonlyArray<FileTreeItem>>;
-}
-//# sourceMappingURL=directoryItem.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"directoryItem.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/directoryItem.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE/F;;;GAGG;AACH,qBAAa,aAAc,YAAW,sBAAsB;IAC1D;;OAEG;IACH,SAAgB,IAAI,EAAE,WAAW,CAAe;IAEhD;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAE5C;;;;;;OAMG;IACH,SAAS,aAAa,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB;IAK3D;;;;;;;OAOG;WACW,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,aAAa,CAAC;IAIlF;;OAEG;IACI,WAAW,IAAI,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;CAG1D"}

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

@@ -1,71 +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.DirectoryItem = void 0;
-const base_1 = require("../base");
-/**
- * Class representing a directory in a file tree.
- * @public
- */
-class DirectoryItem {
-    /**
-     * {@inheritdoc FileTree.IFileTreeDirectoryItem.name}
-     */
-    get name() {
-        return this._hal.getBaseName(this.absolutePath);
-    }
-    /**
-     * Protected constructor for derived classes.
-     * @param path - Relative path of the directory.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    constructor(path, hal) {
-        /**
-         * {@inheritdoc FileTree.IFileTreeDirectoryItem."type"}
-         */
-        this.type = 'directory';
-        this._hal = hal;
-        this.absolutePath = hal.resolveAbsolutePath(path);
-    }
-    /**
-     * Creates a new DirectoryItem instance.
-     * @param path - Relative path of the directory.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @returns A {@link Result | result} containing the new DirectoryItem instance if successful,
-     * or a failure if an error occurs.
-     */
-    static create(path, hal) {
-        return (0, base_1.captureResult)(() => new DirectoryItem(path, hal));
-    }
-    /**
-     * {@inheritdoc FileTree.IFileTreeDirectoryItem.getChildren}
-     */
-    getChildren() {
-        return this._hal.getChildren(this.absolutePath);
-    }
-}
-exports.DirectoryItem = DirectoryItem;
-//# sourceMappingURL=directoryItem.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"directoryItem.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/directoryItem.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,kCAAgD;AAGhD;;;GAGG;AACH,MAAa,aAAa;IAWxB;;OAEG;IACH,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IAQD;;;;;;OAMG;IACH,YAAsB,IAAY,EAAE,GAAuB;QA9B3D;;WAEG;QACa,SAAI,GAAgB,WAAW,CAAC;QA4B9C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,GAAuB;QACxD,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACI,WAAW;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;CACF;AAtDD,sCAsDC","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 } from '../base';\nimport { FileTreeItem, IFileTreeAccessors, IFileTreeDirectoryItem } from './fileTreeAccessors';\n\n/**\n * Class representing a directory in a file tree.\n * @public\n */\nexport class DirectoryItem implements IFileTreeDirectoryItem {\n  /**\n   * {@inheritdoc FileTree.IFileTreeDirectoryItem.\"type\"}\n   */\n  public readonly type: 'directory' = 'directory';\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeDirectoryItem.absolutePath}\n   */\n  public readonly absolutePath: string;\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeDirectoryItem.name}\n   */\n  public get name(): string {\n    return this._hal.getBaseName(this.absolutePath);\n  }\n\n  /**\n   * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.\n   * @public\n   */\n  protected readonly _hal: IFileTreeAccessors;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param path - Relative path of the directory.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @public\n   */\n  protected constructor(path: string, hal: IFileTreeAccessors) {\n    this._hal = hal;\n    this.absolutePath = hal.resolveAbsolutePath(path);\n  }\n\n  /**\n   * Creates a new DirectoryItem instance.\n   * @param path - Relative path of the directory.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @returns A {@link Result | result} containing the new DirectoryItem instance if successful,\n   * or a failure if an error occurs.\n   */\n  public static create(path: string, hal: IFileTreeAccessors): Result<DirectoryItem> {\n    return captureResult(() => new DirectoryItem(path, hal));\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeDirectoryItem.getChildren}\n   */\n  public getChildren(): Result<ReadonlyArray<FileTreeItem>> {\n    return this._hal.getChildren(this.absolutePath);\n  }\n}\n"]}

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

@@ -1,64 +0,0 @@
-import { Result } from '../base';
-import { Converter } from '../conversion';
-import { Validator } from '../validation';
-import { IFileTreeAccessors, IFileTreeFileItem } from './fileTreeAccessors';
-/**
- * Class representing a file in a file tree.
- * @public
- */
-export declare class FileItem implements IFileTreeFileItem {
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem."type"}
-     */
-    readonly type: 'file';
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.absolutePath}
-     */
-    readonly absolutePath: string;
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.name}
-     */
-    get name(): string;
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.baseName}
-     */
-    get baseName(): string;
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.extension}
-     */
-    get extension(): string;
-    /**
-     * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.
-     * @public
-     */
-    protected readonly _hal: IFileTreeAccessors;
-    /**
-     * Protected constructor for derived classes.
-     * @param path - Relative path of the file.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    protected constructor(path: string, hal: IFileTreeAccessors);
-    /**
-     * Creates a new {@link FileTree.FileItem | FileItem} instance.
-     * @param path - Relative path of the file.
-     * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for
-     * file system operations.
-     * @public
-     */
-    static create(path: string, hal: IFileTreeAccessors): Result<FileItem>;
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.(getContents:1)}
-     */
-    getContents(): Result<unknown>;
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.(getContents:2)}
-     */
-    getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;
-    /**
-     * {@inheritdoc FileTree.IFileTreeFileItem.getRawContents}
-     */
-    getRawContents(): Result<string>;
-}
-//# sourceMappingURL=fileItem.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileItem.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileItem.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,MAAM,EAAW,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE5E;;;GAGG;AACH,qBAAa,QAAS,YAAW,iBAAiB;IAChD;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAU;IAEtC;;OAEG;IACH,SAAgB,YAAY,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAE5C;;;;;;OAMG;IACH,SAAS,aAAa,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB;IAK3D;;;;;;OAMG;WACW,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC;IAI7E;;OAEG;IACI,WAAW,IAAI,MAAM,CAAC,OAAO,CAAC;IACrC;;OAEG;IACI,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAaxE;;OAEG;IACI,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC;CAGxC"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileItem.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileItem.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,kCAAyD;AAKzD;;;GAGG;AACH,MAAa,QAAQ;IAWnB;;OAEG;IACH,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAQD;;;;;;OAMG;IACH,YAAsB,IAAY,EAAE,GAAuB;QA5C3D;;WAEG;QACa,SAAI,GAAW,MAAM,CAAC;QA0CpC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,GAAuB;QACxD,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAUM,WAAW,CAAI,SAAuC;QAC3D,OAAO,IAAI,CAAC,IAAI;aACb,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;aAClC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC,CAAC;aACzF,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACpB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,IAAA,cAAO,EAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;CACF;AAvFD,4BAuFC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, Result, succeed } from '../base';\nimport { Converter } from '../conversion';\nimport { Validator } from '../validation';\nimport { IFileTreeAccessors, IFileTreeFileItem } from './fileTreeAccessors';\n\n/**\n * Class representing a file in a file tree.\n * @public\n */\nexport class FileItem implements IFileTreeFileItem {\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.\"type\"}\n   */\n  public readonly type: 'file' = 'file';\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.absolutePath}\n   */\n  public readonly absolutePath: string;\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.name}\n   */\n  public get name(): string {\n    return this._hal.getBaseName(this.absolutePath);\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.baseName}\n   */\n  public get baseName(): string {\n    return this._hal.getBaseName(this.absolutePath, this.extension);\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.extension}\n   */\n  public get extension(): string {\n    return this._hal.getExtension(this.absolutePath);\n  }\n\n  /**\n   * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.\n   * @public\n   */\n  protected readonly _hal: IFileTreeAccessors;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param path - Relative path of the file.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @public\n   */\n  protected constructor(path: string, hal: IFileTreeAccessors) {\n    this._hal = hal;\n    this.absolutePath = hal.resolveAbsolutePath(path);\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileItem | FileItem} instance.\n   * @param path - Relative path of the file.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @public\n   */\n  public static create(path: string, hal: IFileTreeAccessors): Result<FileItem> {\n    return captureResult(() => new FileItem(path, hal));\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.(getContents:1)}\n   */\n  public getContents(): Result<unknown>;\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.(getContents:2)}\n   */\n  public getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;\n  public getContents<T>(converter?: Validator<T> | Converter<T>): Result<T | unknown> {\n    return this._hal\n      .getFileContents(this.absolutePath)\n      .onSuccess((body) => captureResult(() => JSON.parse(body)).onFailure(() => succeed(body)))\n      .onSuccess((parsed) => {\n        if (converter !== undefined) {\n          return converter.convert(parsed);\n        }\n        return succeed(parsed);\n      });\n  }\n\n  /**\n   * {@inheritdoc FileTree.IFileTreeFileItem.getRawContents}\n   */\n  public getRawContents(): Result<string> {\n    return this._hal.getFileContents(this.absolutePath);\n  }\n}\n"]}

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

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

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"fileTree.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileTree.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAoHH,sCAEC;AAWD,4BAEC;AAjID,kCAA+D;AAO/D,qCAA+C;AAC/C,2CAAmE;AAEnE;;;GAGG;AACH,MAAa,QAAQ;IAOnB;;;;;OAKG;IACH,YAAsB,GAAuB;QAC3C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,GAAuB;QAC1C,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,aAAa,CAAC,MAAe;QACzC,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,4BAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,CAAC,KAAsB,EAAE,MAAe;QAC5D,OAAO,iCAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CACnE,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CACvC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,QAAgB;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,IAAA,WAAI,EAAC,GAAG,QAAQ,cAAc,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,aAAqB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YACpD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC9B,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,IAAA,WAAI,EAAC,GAAG,aAAa,mBAAmB,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA1FD,4BA0FC;AAED;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,MAAe;IAC3C,OAAO,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,KAAsB,EAAE,MAAe;IAC9D,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, Result, fail, succeed } from '../base';\nimport {\n  FileTreeItem,\n  IFileTreeAccessors,\n  IFileTreeDirectoryItem,\n  IFileTreeFileItem\n} from './fileTreeAccessors';\nimport { FsFileTreeAccessors } from './fsTree';\nimport { IInMemoryFile, InMemoryTreeAccessors } from './in-memory';\n\n/**\n * Represents a file tree.\n * @public\n */\nexport class FileTree {\n  /**\n   * The {@link FileTree.IFileTreeAccessors | accessors} to use for file system operations.\n   * @public\n   */\n  public hal: IFileTreeAccessors;\n\n  /**\n   * Protected constructor for derived classes.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   * @public\n   */\n  protected constructor(hal: IFileTreeAccessors) {\n    this.hal = hal;\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileTree | FileTree} instance with the supplied\n   * accessors.\n   * @param hal - The {@link FileTree.IFileTreeAccessors | accessors} to use for\n   * file system operations.\n   */\n  public static create(hal: IFileTreeAccessors): Result<FileTree> {\n    return captureResult(() => new FileTree(hal));\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors\n   * for the filesystem.\n   * @param prefix - An optional prefix to prepended to supplied relative\n   * paths.\n   */\n  public static forFilesystem(prefix?: string): Result<FileTree> {\n    return captureResult(() => new FileTree(new FsFileTreeAccessors(prefix)));\n  }\n\n  /**\n   * Creates a new {@link FileTree.FileTree | FileTree} instance with accessors\n   * for an in-memory file tree.\n   * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to\n   * include in the tree.\n   * @param prefix - An optional prefix to add to the paths of all files in the tree.\n   */\n  public static inMemory(files: IInMemoryFile[], prefix?: string): Result<FileTree> {\n    return InMemoryTreeAccessors.create(files, prefix).onSuccess((hal) =>\n      captureResult(() => new FileTree(hal))\n    );\n  }\n\n  /**\n   * Gets an item from the tree.\n   * @param itemPath - The path to the item.\n   * @returns {@link Success | Success} with the item if successful,\n   * or {@link Failure | Failure} with an error message otherwise.\n   */\n  public getItem(itemPath: string): Result<FileTreeItem> {\n    const absolutePath = this.hal.resolveAbsolutePath(itemPath);\n    return this.hal.getItem(absolutePath);\n  }\n\n  /**\n   * Gets a file item from the tree.\n   * @param filePath - The path to the file.\n   * @returns {@link Success | Success} with the {@link FileTree.IFileTreeFileItem | file item}\n   * if successful, or {@link Failure | Failure} with an error message otherwise.\n   */\n  public getFile(filePath: string): Result<IFileTreeFileItem> {\n    return this.getItem(filePath).onSuccess((item) => {\n      if (item.type === 'file') {\n        return succeed(item);\n      }\n      return fail(`${filePath}: not a file`);\n    });\n  }\n\n  /**\n   * Gets a directory item from the tree.\n   * @param directoryPath - The path to the directory.\n   * @returns {@link Success | Success} with the {@link FileTree.IFileTreeDirectoryItem | directory item}\n   * if successful, or {@link Failure | Failure} with an error message otherwise.\n   */\n  public getDirectory(directoryPath: string): Result<IFileTreeDirectoryItem> {\n    return this.getItem(directoryPath).onSuccess((item) => {\n      if (item.type === 'directory') {\n        return succeed(item);\n      }\n      return fail(`${directoryPath}: not a directory`);\n    });\n  }\n}\n\n/**\n * Helper function to create a new {@link FileTree.FileTree | FileTree} instance\n * with accessors for the filesystem.\n * @param prefix - An optional prefix to prepended to supplied relative paths.\n * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance\n * if successful, or {@link Failure | Failure} with an error message otherwise.\n * @public\n */\nexport function forFilesystem(prefix?: string): Result<FileTree> {\n  return FileTree.forFilesystem(prefix);\n}\n\n/**\n * Helper function to create a new {@link FileTree.FileTree | FileTree} instance\n * with accessors for an in-memory file tree.\n * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n * @param prefix - An optional prefix to add to the paths of all files in the tree.\n * @returns {@link Success | Success} with the new {@link FileTree.FileTree | FileTree} instance\n * if successful, or {@link Failure | Failure} with an error message otherwise.\n * @public\n */\nexport function inMemory(files: IInMemoryFile[], prefix?: string): Result<FileTree> {\n  return FileTree.inMemory(files, prefix);\n}\n"]}