@fgv/ts-res 4.5.0-0

package/lib/packlets/import/importManager.d.ts

@@ -0,0 +1,93 @@
+import { FileTree, Result } from '@fgv/ts-utils';
+import { ResourceManager } from '../resources';
+import { ImportContext } from './importContext';
+import { IImportable } from './importable';
+import { IImporter } from './importers';
+import { IReadOnlyQualifierCollector } from '../qualifiers';
+/**
+ * Parameters for creating an {@link  Import.ImportManager | ImportManager}.
+ * @public
+ */
+export interface IImporterCreateParams {
+    /**
+     * The {@link Resources.ResourceManager | resource manager} into which resources
+     * will be imported.
+     */
+    resources: ResourceManager;
+    /**
+     * An optional initial {@link Import.ImportContext | import context} for the import operation.
+     */
+    initialContext?: ImportContext;
+    /**
+     * An optional `FileTree` for importing path items.
+     */
+    fileTree?: FileTree.FileTree;
+    /**
+     * An optional list of {@link Import.Importers.IImporter | importers} to use for the import.
+     */
+    importers?: IImporter[];
+}
+/**
+ * Class to manage the import of resources from various sources.
+ * @public
+ */
+export declare class ImportManager {
+    /**
+     * The {@link Resources.ResourceManager | resource manager} into which resources
+     * will be imported.
+     */
+    readonly resources: ResourceManager;
+    /**
+     * The list of {@link Import.Importers.IImporter | importers} to use for the
+     * import operations.
+     */
+    get importers(): ReadonlyArray<IImporter>;
+    /**
+     * The initial {@link Import.ImportContext | import context} for the import operation.
+     */
+    initialContext: ImportContext;
+    protected _stack: IImportable[];
+    protected _importers: IImporter[];
+    /**
+     * Protected constructor for the {@link Import.ImportManager | ImportManager}.
+     * @param params - Parameters for creating the {@link Import.ImportManager | ImportManager}.
+     */
+    protected constructor(params: IImporterCreateParams);
+    /**
+     * Factory method to create a new {@link Import.ImportManager | ImportManager}.
+     * @param params - Parameters for creating the {@link Import.ImportManager | ImportManager}.
+     * @returns `Success` with the new {@link Import.ImportManager | ImportManager}
+     * if successful, or `Failure` with an error message if creation fails.
+     */
+    static create(params: IImporterCreateParams): Result<ImportManager>;
+    /**
+     * Imports resources from an {@link Import.IImportable | importable} object.
+     * @param importable - The {@link Import.IImportable | importable} object to import.
+     * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,
+     * or `Failure` with an error message if the import fails.
+     */
+    import(importable: IImportable): Result<ImportManager>;
+    /**
+     * Imports resources from a file system path.
+     * @param filePath - The path to import resources from.
+     * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,
+     * or `Failure` with an error message if the import fails.
+     */
+    importFromFileSystem(filePath: string): Result<ImportManager>;
+    /**
+     * Gets the default importers using supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers}
+     * and optional `FileTree`.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for the import.
+     * @param tree - An optional `FileTree` for importing path items.
+     * @returns A read-only array of {@link Import.Importers.IImporter | importers}.
+     */
+    static getDefaultImporters(qualifiers: IReadOnlyQualifierCollector, tree?: FileTree.FileTree): ReadonlyArray<IImporter>;
+    /**
+     * Imports any items on the import stack.
+     * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,
+     * or `Failure` with an error message if the import fails.
+     * @public
+     */
+    protected _import(): Result<ImportManager>;
+}
+//# sourceMappingURL=importManager.d.ts.map

package/lib/packlets/import/importManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importManager.d.ts","sourceRoot":"","sources":["../../../src/packlets/import/importManager.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,QAAQ,EAAqB,MAAM,EAAW,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAmB,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAsB,SAAS,EAA8B,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;OAEG;IACH,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;OAGG;IACH,SAAgB,SAAS,EAAE,eAAe,CAAC;IAE3C;;;OAGG;IACH,IAAW,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,CAE/C;IAED;;OAEG;IACI,cAAc,EAAE,aAAa,CAAC;IAErC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAM;IACrC,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,CAAM;IAEvC;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,qBAAqB;IAQnD;;;;;OAKG;WACW,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,aAAa,CAAC;IAI1E;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC;IAK7D;;;;;OAKG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;IAKpE;;;;;;OAMG;WACW,mBAAmB,CAC/B,UAAU,EAAE,2BAA2B,EACvC,IAAI,CAAC,EAAE,QAAQ,CAAC,QAAQ,GACvB,aAAa,CAAC,SAAS,CAAC;IAS3B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC;CAiC3C"}

package/lib/packlets/import/importManager.js

@@ -0,0 +1,133 @@
+"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.ImportManager = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const importContext_1 = require("./importContext");
+const fsItemImporter_1 = require("./importers/fsItemImporter");
+const importers_1 = require("./importers");
+/**
+ * Class to manage the import of resources from various sources.
+ * @public
+ */
+class ImportManager {
+    /**
+     * The list of {@link Import.Importers.IImporter | importers} to use for the
+     * import operations.
+     */
+    get importers() {
+        return this._importers;
+    }
+    /**
+     * Protected constructor for the {@link Import.ImportManager | ImportManager}.
+     * @param params - Parameters for creating the {@link Import.ImportManager | ImportManager}.
+     */
+    constructor(params) {
+        var _a, _b;
+        this._stack = [];
+        this._importers = [];
+        this.resources = params.resources;
+        this.initialContext = (_a = params.initialContext) !== null && _a !== void 0 ? _a : importContext_1.ImportContext.create().orThrow();
+        this._importers = Array.from((_b = params.importers) !== null && _b !== void 0 ? _b : ImportManager.getDefaultImporters(this.resources.qualifiers, params.fileTree));
+    }
+    /**
+     * Factory method to create a new {@link Import.ImportManager | ImportManager}.
+     * @param params - Parameters for creating the {@link Import.ImportManager | ImportManager}.
+     * @returns `Success` with the new {@link Import.ImportManager | ImportManager}
+     * if successful, or `Failure` with an error message if creation fails.
+     */
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new ImportManager(params));
+    }
+    /**
+     * Imports resources from an {@link Import.IImportable | importable} object.
+     * @param importable - The {@link Import.IImportable | importable} object to import.
+     * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,
+     * or `Failure` with an error message if the import fails.
+     */
+    import(importable) {
+        this._stack.push(importable);
+        return this._import();
+    }
+    /**
+     * Imports resources from a file system path.
+     * @param filePath - The path to import resources from.
+     * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,
+     * or `Failure` with an error message if the import fails.
+     */
+    importFromFileSystem(filePath) {
+        const importable = { type: 'path', path: filePath };
+        return this.import(importable);
+    }
+    /**
+     * Gets the default importers using supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers}
+     * and optional `FileTree`.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for the import.
+     * @param tree - An optional `FileTree` for importing path items.
+     * @returns A read-only array of {@link Import.Importers.IImporter | importers}.
+     */
+    static getDefaultImporters(qualifiers, tree) {
+        return [
+            importers_1.PathImporter.create({ qualifiers, tree }).orThrow(),
+            fsItemImporter_1.FsItemImporter.create({ qualifiers }).orThrow(),
+            importers_1.JsonImporter.create().orThrow(),
+            importers_1.CollectionImporter.create().orThrow()
+        ];
+    }
+    /**
+     * Imports any items on the import stack.
+     * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,
+     * or `Failure` with an error message if the import fails.
+     * @public
+     */
+    _import() {
+        const errors = new ts_utils_1.MessageAggregator();
+        while (this._stack.length > 0) {
+            const item = this._stack.pop();
+            if (item !== undefined) {
+                let processed = false;
+                let consumed = false;
+                for (const importer of this._importers) {
+                    if (consumed || !importer.types.includes(item.type)) {
+                        continue;
+                    }
+                    const result = importer.import(item, this.resources).aggregateError(errors);
+                    processed = processed || result.detail !== 'skipped';
+                    consumed = consumed || result.detail === 'consumed';
+                    if (result.isSuccess()) {
+                        this._stack.push(...result.value);
+                    }
+                    else if (result.detail !== 'skipped') {
+                        errors.addMessage(`${item.type}: ${result.message}`);
+                    }
+                }
+                if (!processed) {
+                    errors.addMessage(`${item.type}: No matching importer found`);
+                }
+            }
+        }
+        return errors.returnOrReport((0, ts_utils_1.succeed)(this));
+    }
+}
+exports.ImportManager = ImportManager;
+//# sourceMappingURL=importManager.js.map

package/lib/packlets/import/importManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importManager.js","sourceRoot":"","sources":["../../../src/packlets/import/importManager.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, FileTree, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { ResourceManager } from '../resources';\nimport { ImportContext } from './importContext';\nimport { IImportable, IImportablePath } from './importable';\nimport { FsItemImporter } from './importers/fsItemImporter';\nimport { CollectionImporter, IImporter, JsonImporter, PathImporter } from './importers';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\n\n/**\n * Parameters for creating an {@link  Import.ImportManager | ImportManager}.\n * @public\n */\nexport interface IImporterCreateParams {\n  /**\n   * The {@link Resources.ResourceManager | resource manager} into which resources\n   * will be imported.\n   */\n  resources: ResourceManager;\n\n  /**\n   * An optional initial {@link Import.ImportContext | import context} for the import operation.\n   */\n  initialContext?: ImportContext;\n\n  /**\n   * An optional `FileTree` for importing path items.\n   */\n  fileTree?: FileTree.FileTree;\n\n  /**\n   * An optional list of {@link Import.Importers.IImporter | importers} to use for the import.\n   */\n  importers?: IImporter[];\n}\n\n/**\n * Class to manage the import of resources from various sources.\n * @public\n */\nexport class ImportManager {\n  /**\n   * The {@link Resources.ResourceManager | resource manager} into which resources\n   * will be imported.\n   */\n  public readonly resources: ResourceManager;\n\n  /**\n   * The list of {@link Import.Importers.IImporter | importers} to use for the\n   * import operations.\n   */\n  public get importers(): ReadonlyArray<IImporter> {\n    return this._importers;\n  }\n\n  /**\n   * The initial {@link Import.ImportContext | import context} for the import operation.\n   */\n  public initialContext: ImportContext;\n\n  protected _stack: IImportable[] = [];\n  protected _importers: IImporter[] = [];\n\n  /**\n   * Protected constructor for the {@link Import.ImportManager | ImportManager}.\n   * @param params - Parameters for creating the {@link Import.ImportManager | ImportManager}.\n   */\n  protected constructor(params: IImporterCreateParams) {\n    this.resources = params.resources;\n    this.initialContext = params.initialContext ?? ImportContext.create().orThrow();\n    this._importers = Array.from(\n      params.importers ?? ImportManager.getDefaultImporters(this.resources.qualifiers, params.fileTree)\n    );\n  }\n\n  /**\n   * Factory method to create a new {@link Import.ImportManager | ImportManager}.\n   * @param params - Parameters for creating the {@link Import.ImportManager | ImportManager}.\n   * @returns `Success` with the new {@link Import.ImportManager | ImportManager}\n   * if successful, or `Failure` with an error message if creation fails.\n   */\n  public static create(params: IImporterCreateParams): Result<ImportManager> {\n    return captureResult(() => new ImportManager(params));\n  }\n\n  /**\n   * Imports resources from an {@link Import.IImportable | importable} object.\n   * @param importable - The {@link Import.IImportable | importable} object to import.\n   * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,\n   * or `Failure` with an error message if the import fails.\n   */\n  public import(importable: IImportable): Result<ImportManager> {\n    this._stack.push(importable);\n    return this._import();\n  }\n\n  /**\n   * Imports resources from a file system path.\n   * @param filePath - The path to import resources from.\n   * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,\n   * or `Failure` with an error message if the import fails.\n   */\n  public importFromFileSystem(filePath: string): Result<ImportManager> {\n    const importable: IImportablePath = { type: 'path', path: filePath };\n    return this.import(importable);\n  }\n\n  /**\n   * Gets the default importers using supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers}\n   * and optional `FileTree`.\n   * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for the import.\n   * @param tree - An optional `FileTree` for importing path items.\n   * @returns A read-only array of {@link Import.Importers.IImporter | importers}.\n   */\n  public static getDefaultImporters(\n    qualifiers: IReadOnlyQualifierCollector,\n    tree?: FileTree.FileTree\n  ): ReadonlyArray<IImporter> {\n    return [\n      PathImporter.create({ qualifiers, tree }).orThrow(),\n      FsItemImporter.create({ qualifiers }).orThrow(),\n      JsonImporter.create().orThrow(),\n      CollectionImporter.create().orThrow()\n    ];\n  }\n\n  /**\n   * Imports any items on the import stack.\n   * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,\n   * or `Failure` with an error message if the import fails.\n   * @public\n   */\n  protected _import(): Result<ImportManager> {\n    const errors: MessageAggregator = new MessageAggregator();\n\n    while (this._stack.length > 0) {\n      const item = this._stack.pop();\n      if (item !== undefined) {\n        let processed: boolean = false;\n        let consumed: boolean = false;\n\n        for (const importer of this._importers) {\n          if (consumed || !importer.types.includes(item.type)) {\n            continue;\n          }\n\n          const result = importer.import(item, this.resources).aggregateError(errors);\n          processed = processed || result.detail !== 'skipped';\n          consumed = consumed || result.detail === 'consumed';\n\n          if (result.isSuccess()) {\n            this._stack.push(...result.value);\n          } else if (result.detail !== 'skipped') {\n            errors.addMessage(`${item.type}: ${result.message}`);\n          }\n        }\n\n        if (!processed) {\n          errors.addMessage(`${item.type}: No matching importer found`);\n        }\n      }\n    }\n\n    return errors.returnOrReport(succeed(this));\n  }\n}\n"]}

package/lib/packlets/import/importable.d.ts

@@ -0,0 +1,71 @@
+import { JsonValue } from '@fgv/ts-json-base';
+import * as ResourceJson from '../resource-json';
+import { ImportContext } from './importContext';
+import { FsItem } from './fsItem';
+/**
+ * Base interface for importable entities.
+ * @public
+ */
+export interface IImportable {
+    type: string;
+    context?: ImportContext;
+}
+/**
+ * Represents a filesystem path to be imported.
+ * @public
+ */
+export interface IImportablePath extends IImportable {
+    type: 'path';
+    path: string;
+    context?: ImportContext;
+}
+/**
+ * Represents a filesystem item to be imported.
+ * @public
+ */
+export interface IImportableFsItem extends IImportable {
+    type: 'fsItem';
+    item: FsItem;
+    context?: ImportContext;
+}
+/**
+ * Represents some JSON to be imported.
+ * @public
+ */
+export interface IImportableJson extends IImportable {
+    type: 'json';
+    json: JsonValue;
+    context?: ImportContext;
+}
+/**
+ * Represents a resource collection to be imported.
+ * @public
+ */
+export interface IImportableResourceCollection extends IImportable {
+    type: 'resourceCollection';
+    collection: ResourceJson.ResourceDeclCollection;
+    context?: ImportContext;
+}
+/**
+ * Represents a resource tree to be imported.
+ * @public
+ */
+export interface IImportableResourceTree extends IImportable {
+    type: 'resourceTree';
+    tree: ResourceJson.ResourceDeclTree;
+    context?: ImportContext;
+}
+/**
+ * Type of importable entities.
+ * @public
+ */
+export type Importable = IImportablePath | IImportableFsItem | IImportableJson | IImportableResourceCollection | IImportableResourceTree;
+/**
+ * Type guard for {@link Import.Importable | importables}.
+ * @param i - The entity to check.
+ * @returns `true` if the supplied {@link Import.IImportable | IImportable} is a
+ * {@link Import.Importable | known importable}, `false` otherwise.
+ * @public
+ */
+export declare function isImportable(i: IImportable): i is Importable;
+//# sourceMappingURL=importable.d.ts.map

package/lib/packlets/import/importable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importable.d.ts","sourceRoot":"","sources":["../../../src/packlets/import/importable.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA8B,SAAQ,WAAW;IAChE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,YAAY,CAAC,sBAAsB,CAAC;IAChD,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC,gBAAgB,CAAC;IACpC,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,6BAA6B,GAC7B,uBAAuB,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,IAAI,UAAU,CAE5D"}

package/lib/packlets/import/importable.js

@@ -0,0 +1,35 @@
+"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.isImportable = isImportable;
+/**
+ * Type guard for {@link Import.Importable | importables}.
+ * @param i - The entity to check.
+ * @returns `true` if the supplied {@link Import.IImportable | IImportable} is a
+ * {@link Import.Importable | known importable}, `false` otherwise.
+ * @public
+ */
+function isImportable(i) {
+    return ['path', 'fsItem', 'json', 'resourceCollection', 'resourceTree'].includes(i.type);
+}
+//# sourceMappingURL=importable.js.map

package/lib/packlets/import/importable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importable.js","sourceRoot":"","sources":["../../../src/packlets/import/importable.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAoFH,oCAEC;AATD;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,CAAc;IACzC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3F,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 { JsonValue } from '@fgv/ts-json-base';\nimport * as ResourceJson from '../resource-json';\nimport { ImportContext } from './importContext';\nimport { FsItem } from './fsItem';\n\n/**\n * Base interface for importable entities.\n * @public\n */\nexport interface IImportable {\n  type: string;\n  context?: ImportContext;\n}\n\n/**\n * Represents a filesystem path to be imported.\n * @public\n */\nexport interface IImportablePath extends IImportable {\n  type: 'path';\n  path: string;\n  context?: ImportContext;\n}\n\n/**\n * Represents a filesystem item to be imported.\n * @public\n */\nexport interface IImportableFsItem extends IImportable {\n  type: 'fsItem';\n  item: FsItem;\n  context?: ImportContext;\n}\n\n/**\n * Represents some JSON to be imported.\n * @public\n */\nexport interface IImportableJson extends IImportable {\n  type: 'json';\n  json: JsonValue;\n  context?: ImportContext;\n}\n\n/**\n * Represents a resource collection to be imported.\n * @public\n */\nexport interface IImportableResourceCollection extends IImportable {\n  type: 'resourceCollection';\n  collection: ResourceJson.ResourceDeclCollection;\n  context?: ImportContext;\n}\n\n/**\n * Represents a resource tree to be imported.\n * @public\n */\nexport interface IImportableResourceTree extends IImportable {\n  type: 'resourceTree';\n  tree: ResourceJson.ResourceDeclTree;\n  context?: ImportContext;\n}\n\n/**\n * Type of importable entities.\n * @public\n */\nexport type Importable =\n  | IImportablePath\n  | IImportableFsItem\n  | IImportableJson\n  | IImportableResourceCollection\n  | IImportableResourceTree;\n\n/**\n * Type guard for {@link Import.Importable | importables}.\n * @param i - The entity to check.\n * @returns `true` if the supplied {@link Import.IImportable | IImportable} is a\n * {@link Import.Importable | known importable}, `false` otherwise.\n * @public\n */\nexport function isImportable(i: IImportable): i is Importable {\n  return ['path', 'fsItem', 'json', 'resourceCollection', 'resourceTree'].includes(i.type);\n}\n"]}

package/lib/packlets/import/importers/collectionImporter.d.ts

@@ -0,0 +1,60 @@
+import { DetailedResult, Result } from '@fgv/ts-utils';
+import { ResourceManager } from '../../resources';
+import { IImportable } from '../importable';
+import { IImporter, ImporterResultDetail } from './importer';
+/**
+ * {@link Import.Importers.IImporter | Importer} implementation which imports
+ * a {@link ResourceJson.ResourceDeclCollection | resource collection} or
+ * {@link ResourceJson.ResourceDeclTree | resource tree} from an importable item.
+ * @public
+ */
+export declare class CollectionImporter implements IImporter {
+    /**
+     * {@inheritdoc Import.Importers.IImporter.types}
+     */
+    readonly types: string[];
+    /**
+     * Protected {@link Import.Importers.CollectionImporter | CollectionImporter} constructor for derived classes
+     */
+    protected constructor();
+    /**
+     * Creates a new {@link Import.Importers.CollectionImporter | CollectionImporter} instance.
+     * @returns `Success` with the new {@link Import.Importers.CollectionImporter | CollectionImporter} if successful,
+     * `Failure` o4
+     *
+     * therwise.
+     */
+    static create(): Result<CollectionImporter>;
+    /**
+     * {@inheritdoc Import.Importers.IImporter.import}
+     */
+    import(item: IImportable, manager: ResourceManager): DetailedResult<IImportable[], ImporterResultDetail>;
+    /**
+     * Adds a {@link ResourceJson.Normalized.ILooseResourceDecl | declared resource} to
+     * the supplied {@link Resources.ResourceManager | resource manager}, merging an
+     * optional {@link Import.ImportContext | import context} if provided.
+     * @param manager - The {@link Resources.ResourceManager | resource manager} to which
+     * the resource will be added.
+     * @param resource - The {@link ResourceJson.Normalized.ILooseResourceDecl | resource}
+     * to add.
+     * @param context - Optional {@link Import.ImportContext | import context} to merge
+     * with the resource.
+     * @returns `Success` with the {@link Resources.ResourceBuilder | resource builder}
+     * for the resource if successful, `Failure` with an error message if not.
+     */
+    private _addResource;
+    /**
+     * Adds a {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | declared resource candidate}
+     * to the supplied {@link Resources.ResourceManager | resource manager}, merging an optional
+     * {@link Import.ImportContext | import context} if provided.
+     * @param manager - The {@link Resources.ResourceManager | resource manager} to which the
+     * candidate will be added.
+     * @param candidate - The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | candidate}
+     * to add.
+     * @param context - Optional {@link Import.ImportContext | import context} to merge with the candidate.
+     * @returns `Success` with the {@link Resources.ResourceCandidate | resource candidate} if successful,
+     * `Failure` with an error message if not.
+     */
+    private _addCandidate;
+}
+//# sourceMappingURL=collectionImporter.d.ts.map

package/lib/packlets/import/importers/collectionImporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionImporter.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/collectionImporter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,cAAc,EAGd,MAAM,EAEP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAsC,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAI7D;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD;;OAEG;IACH,SAAgB,KAAK,EAAE,MAAM,EAAE,CAA0C;IAEzE;;OAEG;IACH,SAAS;IAET;;;;;;OAMG;WACW,MAAM,IAAI,MAAM,CAAC,kBAAkB,CAAC;IAIlD;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,eAAe,GACvB,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAoBtD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;CActB"}

package/lib/packlets/import/importers/collectionImporter.js

@@ -0,0 +1,146 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionImporter = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const importable_1 = require("../importable");
+const ResourceJson = __importStar(require("../../resource-json"));
+/**
+ * {@link Import.Importers.IImporter | Importer} implementation which imports
+ * a {@link ResourceJson.ResourceDeclCollection | resource collection} or
+ * {@link ResourceJson.ResourceDeclTree | resource tree} from an importable item.
+ * @public
+ */
+class CollectionImporter {
+    /**
+     * Protected {@link Import.Importers.CollectionImporter | CollectionImporter} constructor for derived classes
+     */
+    constructor() {
+        /**
+         * {@inheritdoc Import.Importers.IImporter.types}
+         */
+        this.types = ['resourceCollection', 'resourceTree'];
+    }
+    /**
+     * Creates a new {@link Import.Importers.CollectionImporter | CollectionImporter} instance.
+     * @returns `Success` with the new {@link Import.Importers.CollectionImporter | CollectionImporter} if successful,
+     * `Failure` o4
+     *
+     * therwise.
+     */
+    static create() {
+        return (0, ts_utils_1.captureResult)(() => new CollectionImporter());
+    }
+    /**
+     * {@inheritdoc Import.Importers.IImporter.import}
+     */
+    import(item, manager) {
+        var _a, _b;
+        if (!(0, importable_1.isImportable)(item) || (item.type !== 'resourceCollection' && item.type !== 'resourceTree')) {
+            /* c8 ignore next 1 - defense in depth */
+            const name = (_b = (_a = item.context) === null || _a === void 0 ? void 0 : _a.baseId) !== null && _b !== void 0 ? _b : 'unknown';
+            return (0, ts_utils_1.failWithDetail)(`${name}: not a valid resource collection importable (${item.type})`, 'skipped');
+        }
+        const collection = item.type === 'resourceCollection' ? item.collection : item.tree;
+        const errors = new ts_utils_1.MessageAggregator();
+        for (const resource of collection.getLooseResources()) {
+            this._addResource(manager, resource, item.context).aggregateError(errors);
+        }
+        for (const candidate of collection.getLooseCandidates()) {
+            this._addCandidate(manager, candidate, item.context).aggregateError(errors);
+        }
+        return errors.returnOrReport((0, ts_utils_1.succeed)([])).withDetail('failed', 'consumed');
+    }
+    /**
+     * Adds a {@link ResourceJson.Normalized.ILooseResourceDecl | declared resource} to
+     * the supplied {@link Resources.ResourceManager | resource manager}, merging an
+     * optional {@link Import.ImportContext | import context} if provided.
+     * @param manager - The {@link Resources.ResourceManager | resource manager} to which
+     * the resource will be added.
+     * @param resource - The {@link ResourceJson.Normalized.ILooseResourceDecl | resource}
+     * to add.
+     * @param context - Optional {@link Import.ImportContext | import context} to merge
+     * with the resource.
+     * @returns `Success` with the {@link Resources.ResourceBuilder | resource builder}
+     * for the resource if successful, `Failure` with an error message if not.
+     */
+    _addResource(manager, resource, context) {
+        if (context) {
+            return ResourceJson.Helpers.mergeLooseResource(resource, context.baseId, context.conditions).onSuccess((merged) => manager.addResource(merged));
+        }
+        return manager.addResource(resource);
+    }
+    /**
+     * Adds a {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | declared resource candidate}
+     * to the supplied {@link Resources.ResourceManager | resource manager}, merging an optional
+     * {@link Import.ImportContext | import context} if provided.
+     * @param manager - The {@link Resources.ResourceManager | resource manager} to which the
+     * candidate will be added.
+     * @param candidate - The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | candidate}
+     * to add.
+     * @param context - Optional {@link Import.ImportContext | import context} to merge with the candidate.
+     * @returns `Success` with the {@link Resources.ResourceCandidate | resource candidate} if successful,
+     * `Failure` with an error message if not.
+     */
+    _addCandidate(manager, candidate, context) {
+        if (context) {
+            return ResourceJson.Helpers.mergeLooseCandidate(candidate, context.baseId, context.conditions).onSuccess((merged) => manager.addLooseCandidate(merged));
+        }
+        return manager.addLooseCandidate(candidate);
+    }
+}
+exports.CollectionImporter = CollectionImporter;
+//# sourceMappingURL=collectionImporter.js.map

package/lib/packlets/import/importers/collectionImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/collectionImporter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAOuB;AAEvB,8CAA0D;AAE1D,kEAAoD;AAGpD;;;;;GAKG;AACH,MAAa,kBAAkB;IAM7B;;OAEG;IACH;QARA;;WAEG;QACa,UAAK,GAAa,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;IAKhD,CAAC;IAE1B;;;;;;OAMG;IACI,MAAM,CAAC,MAAM;QAClB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,MAAM,CACX,IAAiB,EACjB,OAAwB;;QAExB,IAAI,CAAC,IAAA,yBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,CAAC;YAChG,yCAAyC;YACzC,MAAM,IAAI,GAAG,MAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,MAAM,mCAAI,SAAS,CAAC;YAC/C,OAAO,IAAA,yBAAc,EAAC,GAAG,IAAI,iDAAiD,IAAI,CAAC,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC;QACzG,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAEpF,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,kBAAkB,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,MAAM,CAAC,cAAc,CAAC,IAAA,kBAAO,EAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,YAAY,CAClB,OAAwB,EACxB,QAAoD,EACpD,OAAuB;QAEvB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,SAAS,CACpG,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CACxC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;OAWG;IACK,aAAa,CACnB,OAAwB,EACxB,SAA8D,EAC9D,OAAuB;QAEvB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,YAAY,CAAC,OAAO,CAAC,mBAAmB,CAC7C,SAAS,EACT,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,UAAU,CACnB,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;CACF;AApGD,gDAoGC","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 {\n  captureResult,\n  DetailedResult,\n  failWithDetail,\n  MessageAggregator,\n  Result,\n  succeed\n} from '@fgv/ts-utils';\nimport { ResourceBuilder, ResourceCandidate, ResourceManager } from '../../resources';\nimport { IImportable, isImportable } from '../importable';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport * as ResourceJson from '../../resource-json';\nimport { ImportContext } from '../importContext';\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports\n * a {@link ResourceJson.ResourceDeclCollection | resource collection} or\n * {@link ResourceJson.ResourceDeclTree | resource tree} from an importable item.\n * @public\n */\nexport class CollectionImporter implements IImporter {\n  /**\n   * {@inheritdoc Import.Importers.IImporter.types}\n   */\n  public readonly types: string[] = ['resourceCollection', 'resourceTree'];\n\n  /**\n   * Protected {@link Import.Importers.CollectionImporter | CollectionImporter} constructor for derived classes\n   */\n  protected constructor() {}\n\n  /**\n   * Creates a new {@link Import.Importers.CollectionImporter | CollectionImporter} instance.\n   * @returns `Success` with the new {@link Import.Importers.CollectionImporter | CollectionImporter} if successful,\n   * `Failure` o4\n   *\n   * therwise.\n   */\n  public static create(): Result<CollectionImporter> {\n    return captureResult(() => new CollectionImporter());\n  }\n\n  /**\n   * {@inheritdoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    manager: ResourceManager\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    if (!isImportable(item) || (item.type !== 'resourceCollection' && item.type !== 'resourceTree')) {\n      /* c8 ignore next 1 - defense in depth */\n      const name = item.context?.baseId ?? 'unknown';\n      return failWithDetail(`${name}: not a valid resource collection importable (${item.type})`, 'skipped');\n    }\n\n    const collection = item.type === 'resourceCollection' ? item.collection : item.tree;\n\n    const errors: MessageAggregator = new MessageAggregator();\n    for (const resource of collection.getLooseResources()) {\n      this._addResource(manager, resource, item.context).aggregateError(errors);\n    }\n\n    for (const candidate of collection.getLooseCandidates()) {\n      this._addCandidate(manager, candidate, item.context).aggregateError(errors);\n    }\n    return errors.returnOrReport(succeed([])).withDetail('failed', 'consumed');\n  }\n\n  /**\n   * Adds a {@link ResourceJson.Normalized.ILooseResourceDecl | declared resource} to\n   * the supplied {@link Resources.ResourceManager | resource manager}, merging an\n   * optional {@link Import.ImportContext | import context} if provided.\n   * @param manager - The {@link Resources.ResourceManager | resource manager} to which\n   * the resource will be added.\n   * @param resource - The {@link ResourceJson.Normalized.ILooseResourceDecl | resource}\n   * to add.\n   * @param context - Optional {@link Import.ImportContext | import context} to merge\n   * with the resource.\n   * @returns `Success` with the {@link Resources.ResourceBuilder | resource builder}\n   * for the resource if successful, `Failure` with an error message if not.\n   */\n  private _addResource(\n    manager: ResourceManager,\n    resource: ResourceJson.Normalized.ILooseResourceDecl,\n    context?: ImportContext\n  ): Result<ResourceBuilder> {\n    if (context) {\n      return ResourceJson.Helpers.mergeLooseResource(resource, context.baseId, context.conditions).onSuccess(\n        (merged) => manager.addResource(merged)\n      );\n    }\n    return manager.addResource(resource);\n  }\n\n  /**\n   * Adds a {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | declared resource candidate}\n   * to the supplied {@link Resources.ResourceManager | resource manager}, merging an optional\n   * {@link Import.ImportContext | import context} if provided.\n   * @param manager - The {@link Resources.ResourceManager | resource manager} to which the\n   * candidate will be added.\n   * @param candidate - The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | candidate}\n   * to add.\n   * @param context - Optional {@link Import.ImportContext | import context} to merge with the candidate.\n   * @returns `Success` with the {@link Resources.ResourceCandidate | resource candidate} if successful,\n   * `Failure` with an error message if not.\n   */\n  private _addCandidate(\n    manager: ResourceManager,\n    candidate: ResourceJson.Normalized.ILooseResourceCandidateDecl,\n    context?: ImportContext\n  ): Result<ResourceCandidate> {\n    if (context) {\n      return ResourceJson.Helpers.mergeLooseCandidate(\n        candidate,\n        context.baseId,\n        context.conditions\n      ).onSuccess((merged) => manager.addLooseCandidate(merged));\n    }\n    return manager.addLooseCandidate(candidate);\n  }\n}\n"]}