@fgv/ts-res 4.5.0-3 → 5.0.0-10

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

@@ -1 +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"}
+{"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,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,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,sBAAsB,CAAC;IAElC;;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,sBAAsB,CAAC;IAElD;;;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.map

@@ -1 +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"]}
+{"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 { ResourceManagerBuilder } 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.ResourceManagerBuilder | resource manager builder} into which resources\n   * will be imported.\n   */\n  resources: ResourceManagerBuilder;\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.ResourceManagerBuilder | resource manager builder} into which resources\n   * will be imported.\n   */\n  public readonly resources: ResourceManagerBuilder;\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/importers/collectionImporter.d.ts

@@ -1,5 +1,5 @@
 import { DetailedResult, Result } from '@fgv/ts-utils';
-import { ResourceManager } from '../../resources';
+import { ResourceManagerBuilder } from '../../resources';
 import { IImportable } from '../importable';
 import { IImporter, ImporterResultDetail } from './importer';
 /**
@@ -20,22 +20,20 @@ export declare class CollectionImporter implements IImporter {
     /**
      * Creates a new {@link Import.Importers.CollectionImporter | CollectionImporter} instance.
      * @returns `Success` with the new {@link Import.Importers.CollectionImporter | CollectionImporter} if successful,
-     * `Failure` o4
-     *
-     * therwise.
+     * `Failure` otherwise.
      */
     static create(): Result<CollectionImporter>;
     /**
      * {@inheritdoc Import.Importers.IImporter.import}
      */
-    import(item: IImportable, manager: ResourceManager): DetailedResult<IImportable[], ImporterResultDetail>;
+    import(item: IImportable, manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
     /**
-     * Adds a {@link ResourceJson.Normalized.ILooseResourceDecl | declared resource} to
-     * the supplied {@link Resources.ResourceManager | resource manager}, merging an
+     * Adds a {@link ResourceJson.Normalized.IImporterResourceDecl | declared resource} to
+     * the supplied {@link Resources.ResourceManagerBuilder | resource manager builder}, merging an
      * optional {@link Import.ImportContext | import context} if provided.
-     * @param manager - The {@link Resources.ResourceManager | resource manager} to which
+     * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to which
      * the resource will be added.
-     * @param resource - The {@link ResourceJson.Normalized.ILooseResourceDecl | resource}
+     * @param resource - The {@link ResourceJson.Normalized.IImporterResourceDecl | resource}
      * to add.
      * @param context - Optional {@link Import.ImportContext | import context} to merge
      * with the resource.
@@ -44,12 +42,12 @@ export declare class CollectionImporter implements IImporter {
      */
     private _addResource;
     /**
-     * Adds a {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | declared resource candidate}
-     * to the supplied {@link Resources.ResourceManager | resource manager}, merging an optional
+     * Adds a {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | declared resource candidate}
+     * to the supplied {@link Resources.ResourceManagerBuilder | resource manager builder}, merging an optional
      * {@link Import.ImportContext | import context} if provided.
-     * @param manager - The {@link Resources.ResourceManager | resource manager} to which the
+     * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to which the
      * candidate will be added.
-     * @param candidate - The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | candidate}
+     * @param candidate - The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | 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,

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

@@ -1 +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"}
+{"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,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC7F,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;;;;OAIG;WACW,MAAM,IAAI,MAAM,CAAC,kBAAkB,CAAC;IAIlD;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAwBtD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;CAkBtB"}

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

@@ -58,6 +58,7 @@ exports.CollectionImporter = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 const importable_1 = require("../importable");
 const ResourceJson = __importStar(require("../../resource-json"));
+const importContext_1 = require("../importContext");
 /**
  * {@link Import.Importers.IImporter | Importer} implementation which imports
  * a {@link ResourceJson.ResourceDeclCollection | resource collection} or
@@ -77,9 +78,7 @@ class CollectionImporter {
     /**
      * Creates a new {@link Import.Importers.CollectionImporter | CollectionImporter} instance.
      * @returns `Success` with the new {@link Import.Importers.CollectionImporter | CollectionImporter} if successful,
-     * `Failure` o4
-     *
-     * therwise.
+     * `Failure` otherwise.
      */
     static create() {
         return (0, ts_utils_1.captureResult)(() => new CollectionImporter());
@@ -94,23 +93,27 @@ class CollectionImporter {
             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');
+        const container = item.type === 'resourceCollection' ? item.collection : item.tree;
+        return importContext_1.ImportContext.forContainerImport(container.context, item.context)
+            .onSuccess((context) => {
+            const errors = new ts_utils_1.MessageAggregator();
+            for (const resource of container.getImporterResources()) {
+                this._addResource(manager, resource, context).aggregateError(errors);
+            }
+            for (const candidate of container.getImporterCandidates()) {
+                this._addCandidate(manager, candidate, 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
+     * Adds a {@link ResourceJson.Normalized.IImporterResourceDecl | declared resource} to
+     * the supplied {@link Resources.ResourceManagerBuilder | resource manager builder}, merging an
      * optional {@link Import.ImportContext | import context} if provided.
-     * @param manager - The {@link Resources.ResourceManager | resource manager} to which
+     * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to which
      * the resource will be added.
-     * @param resource - The {@link ResourceJson.Normalized.ILooseResourceDecl | resource}
+     * @param resource - The {@link ResourceJson.Normalized.IImporterResourceDecl | resource}
      * to add.
      * @param context - Optional {@link Import.ImportContext | import context} to merge
      * with the resource.
@@ -120,16 +123,19 @@ class CollectionImporter {
     _addResource(manager, resource, context) {
         if (context) {
             return ResourceJson.Helpers.mergeLooseResource(resource, context.baseId, context.conditions).onSuccess((merged) => manager.addResource(merged));
+        } /* c8 ignore next 4 - defense in depth, should be guarded elsewhere */
+        else if (!ResourceJson.Json.isLooseResourceDecl(resource)) {
+            return fail('cannot add child resource to manager');
         }
         return manager.addResource(resource);
     }
     /**
-     * Adds a {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | declared resource candidate}
-     * to the supplied {@link Resources.ResourceManager | resource manager}, merging an optional
+     * Adds a {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | declared resource candidate}
+     * to the supplied {@link Resources.ResourceManagerBuilder | resource manager builder}, merging an optional
      * {@link Import.ImportContext | import context} if provided.
-     * @param manager - The {@link Resources.ResourceManager | resource manager} to which the
+     * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to which the
      * candidate will be added.
-     * @param candidate - The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | candidate}
+     * @param candidate - The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | 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,
@@ -138,6 +144,9 @@ class CollectionImporter {
     _addCandidate(manager, candidate, context) {
         if (context) {
             return ResourceJson.Helpers.mergeLooseCandidate(candidate, context.baseId, context.conditions).onSuccess((merged) => manager.addLooseCandidate(merged));
+        } /* c8 ignore next 4 - defense in depth, should be guarded elsewhere */
+        else if (!ResourceJson.Json.isLooseResourceCandidateDecl(candidate)) {
+            return fail('cannot add child resource candidate to manager');
         }
         return manager.addLooseCandidate(candidate);
     }

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

@@ -1 +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"]}
+{"version":3,"file":"collectionImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/collectionImporter.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 {\n  captureResult,\n  DetailedResult,\n  failWithDetail,\n  MessageAggregator,\n  Result,\n  succeed\n} from '@fgv/ts-utils';\nimport { ResourceBuilder, ResourceCandidate, ResourceManagerBuilder } 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` otherwise.\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: ResourceManagerBuilder\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 container = item.type === 'resourceCollection' ? item.collection : item.tree;\n\n    return ImportContext.forContainerImport(container.context, item.context)\n      .onSuccess((context) => {\n        const errors: MessageAggregator = new MessageAggregator();\n        for (const resource of container.getImporterResources()) {\n          this._addResource(manager, resource, context).aggregateError(errors);\n        }\n\n        for (const candidate of container.getImporterCandidates()) {\n          this._addCandidate(manager, candidate, context).aggregateError(errors);\n        }\n        return errors.returnOrReport(succeed([]));\n      })\n      .withDetail('failed', 'consumed');\n  }\n\n  /**\n   * Adds a {@link ResourceJson.Normalized.IImporterResourceDecl | declared resource} to\n   * the supplied {@link Resources.ResourceManagerBuilder | resource manager builder}, merging an\n   * optional {@link Import.ImportContext | import context} if provided.\n   * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to which\n   * the resource will be added.\n   * @param resource - The {@link ResourceJson.Normalized.IImporterResourceDecl | 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: ResourceManagerBuilder,\n    resource: ResourceJson.Normalized.IImporterResourceDecl,\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    } /* c8 ignore next 4 - defense in depth, should be guarded elsewhere */ else if (\n      !ResourceJson.Json.isLooseResourceDecl(resource)\n    ) {\n      return fail('cannot add child resource to manager');\n    }\n    return manager.addResource(resource);\n  }\n\n  /**\n   * Adds a {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | declared resource candidate}\n   * to the supplied {@link Resources.ResourceManagerBuilder | resource manager builder}, merging an optional\n   * {@link Import.ImportContext | import context} if provided.\n   * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to which the\n   * candidate will be added.\n   * @param candidate - The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | 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: ResourceManagerBuilder,\n    candidate: ResourceJson.Normalized.IImporterResourceCandidateDecl,\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    } /* c8 ignore next 4 - defense in depth, should be guarded elsewhere */ else if (\n      !ResourceJson.Json.isLooseResourceCandidateDecl(candidate)\n    ) {\n      return fail('cannot add child resource candidate to manager');\n    }\n    return manager.addLooseCandidate(candidate);\n  }\n}\n"]}

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

@@ -1,5 +1,5 @@
 import { DetailedResult, Result } from '@fgv/ts-utils';
-import { ResourceManager } from '../../resources';
+import { ResourceManagerBuilder } from '../../resources';
 import { IImportable } from '../importable';
 import { IImporter, ImporterResultDetail } from './importer';
 import { IReadOnlyQualifierCollector } from '../../qualifiers';
@@ -38,7 +38,7 @@ export declare class FsItemImporter implements IImporter {
     /**
      * {@inheritdoc Import.Importers.IImporter.import}
      */
-    import(item: IImportable, __manager: ResourceManager): DetailedResult<IImportable[], ImporterResultDetail>;
+    import(item: IImportable, __manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
     /**
      * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.
      * @param item - The importable to convert.

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

@@ -1 +1 @@
-{"version":3,"file":"fsItemImporter.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/fsItemImporter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,cAAc,EAEd,MAAM,EAIP,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAA+B,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,2BAA2B,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,SAAgB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAc;IAE1D;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,2BAA2B;IAIzD;;;;OAIG;WACW,MAAM,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAAC,cAAc,CAAC;IAIjF;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,eAAe,GACzB,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAuDtD;;;;OAIG;IACH,SAAS,CAAC,8BAA8B,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC;CASxG"}
+{"version":3,"file":"fsItemImporter.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/fsItemImporter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,cAAc,EAEd,MAAM,EAIP,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,WAAW,EAA+B,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,2BAA2B,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,SAAgB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAc;IAE1D;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,2BAA2B;IAIzD;;;;OAIG;WACW,MAAM,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAAC,cAAc,CAAC;IAIjF;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,sBAAsB,GAChC,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAuDtD;;;;OAIG;IACH,SAAS,CAAC,8BAA8B,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC;CASxG"}

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

@@ -60,7 +60,7 @@ class FsItemImporter {
         const { value: context, message: getContextMessage } = fsItem.getContext().onSuccess((fsItemContext) => {
             return item.context ? item.context.extend(fsItemContext) : (0, ts_utils_1.succeed)(fsItemContext);
         });
-        /* c8 ignore next 3 - defense in depth nearly impossible to reproduce */
+        /* c8 ignore next 3 - defensive coding: getContext failure is extremely rare in practice */
         if (getContextMessage) {
             return (0, ts_utils_1.failWithDetail)(getContextMessage, 'failed');
         }
@@ -98,7 +98,7 @@ class FsItemImporter {
                     .withDetail('failed', 'processed');
             }
         }
-        /* c8 ignore next 2 - defense in depth near impossible to reproduce */
+        /* c8 ignore next 2 - defensive coding: fallback case for unsupported file types */
         return (0, ts_utils_1.succeedWithDetail)([], 'skipped');
     }
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"fsItemImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/fsItemImporter.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 {\n  captureResult,\n  DetailedResult,\n  failWithDetail,\n  Result,\n  succeed,\n  succeedWithDetail,\n  MessageAggregator\n} from '@fgv/ts-utils';\nimport { Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { ResourceManager } from '../../resources';\nimport { IImportable, IImportableJson, Importable } from '../importable';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { FsItem, FsItemResultDetail } from '../fsItem';\n\n/**\n * Parameters for creating a {@link Import.Importers.FsItemImporter | FsItemImporter}.\n * @public\n */\nexport interface IFsItemImporterCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n}\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a `FileTree`.\n * @public\n */\nexport class FsItemImporter implements IImporter {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * The types of {@link Import.IImportable | importables} that this importer can handle.\n   */\n  public readonly types: ReadonlyArray<string> = ['fsItem'];\n\n  /**\n   * Protected constructor for the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   */\n  protected constructor(params: IFsItemImporterCreateParams) {\n    this.qualifiers = params.qualifiers;\n  }\n\n  /**\n   * Creates a new {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @returns `Success` with the new `FsItemImporter` if successful, `Failure` with an error message if not.\n   */\n  public static create(params: IFsItemImporterCreateParams): Result<FsItemImporter> {\n    return captureResult(() => new FsItemImporter(params));\n  }\n\n  /**\n   * {@inheritdoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    __manager: ResourceManager\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    const {\n      value: fsItem,\n      message: getTreeMessage,\n      detail: getTreeDetail\n    } = this._getFileTreeItemFromImportable(item);\n    if (getTreeMessage !== undefined) {\n      return failWithDetail(getTreeMessage, getTreeDetail === 'skipped' ? 'skipped' : 'failed');\n    }\n\n    const { value: context, message: getContextMessage } = fsItem.getContext().onSuccess((fsItemContext) => {\n      return item.context ? item.context.extend(fsItemContext) : succeed(fsItemContext);\n    });\n\n    /* c8 ignore next 3 - defense in depth nearly impossible to reproduce */\n    if (getContextMessage) {\n      return failWithDetail(getContextMessage, 'failed');\n    }\n\n    if (fsItem.item.type === 'directory') {\n      return fsItem.item\n        .getChildren()\n        .onSuccess((children) => {\n          const errors = new MessageAggregator();\n          const items: Importable[] = [];\n          for (const child of children) {\n            const { value: item, message, detail } = FsItem.createForItem(child, this.qualifiers);\n            if (item) {\n              items.push({ type: 'fsItem', item, context });\n            } else if (detail !== 'skipped') {\n              errors.addMessage(message);\n            }\n          }\n          return errors.returnOrReport(succeed(items));\n        })\n        .withDetail('failed', 'processed');\n    } else if (fsItem.item.type === 'file') {\n      if (fsItem.item.extension === '.json') {\n        return fsItem.item\n          .getContents(JsonConverters.jsonValue)\n          .onSuccess((json) => {\n            const jsonItem: IImportableJson = {\n              type: 'json',\n              json,\n              context\n            };\n            return succeed([jsonItem]);\n          })\n          .withDetail('failed', 'processed');\n      }\n    }\n    /* c8 ignore next 2 - defense in depth near impossible to reproduce */\n    return succeedWithDetail([], 'skipped');\n  }\n\n  /**\n   * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.\n   * @param item - The importable to convert.\n   * @returns `Success` containing the `FsItem` if successful, `Failure` with an error message if not.\n   */\n  protected _getFileTreeItemFromImportable(item: IImportable): DetailedResult<FsItem, FsItemResultDetail> {\n    if (item.type === 'fsItem') {\n      if ('item' in item && item.item instanceof FsItem) {\n        return succeedWithDetail(item.item, 'succeeded');\n      }\n      return failWithDetail(`malformed fsItem importable does not contain a valid item`, 'failed');\n    }\n    return failWithDetail(`${item.type}: invalid importable type for an FsItemImporter`, 'skipped');\n  }\n}\n"]}
+{"version":3,"file":"fsItemImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/fsItemImporter.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 {\n  captureResult,\n  DetailedResult,\n  failWithDetail,\n  Result,\n  succeed,\n  succeedWithDetail,\n  MessageAggregator\n} from '@fgv/ts-utils';\nimport { Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { ResourceManagerBuilder } from '../../resources';\nimport { IImportable, IImportableJson, Importable } from '../importable';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { FsItem, FsItemResultDetail } from '../fsItem';\n\n/**\n * Parameters for creating a {@link Import.Importers.FsItemImporter | FsItemImporter}.\n * @public\n */\nexport interface IFsItemImporterCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n}\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a `FileTree`.\n * @public\n */\nexport class FsItemImporter implements IImporter {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * The types of {@link Import.IImportable | importables} that this importer can handle.\n   */\n  public readonly types: ReadonlyArray<string> = ['fsItem'];\n\n  /**\n   * Protected constructor for the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   */\n  protected constructor(params: IFsItemImporterCreateParams) {\n    this.qualifiers = params.qualifiers;\n  }\n\n  /**\n   * Creates a new {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @returns `Success` with the new `FsItemImporter` if successful, `Failure` with an error message if not.\n   */\n  public static create(params: IFsItemImporterCreateParams): Result<FsItemImporter> {\n    return captureResult(() => new FsItemImporter(params));\n  }\n\n  /**\n   * {@inheritdoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    __manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    const {\n      value: fsItem,\n      message: getTreeMessage,\n      detail: getTreeDetail\n    } = this._getFileTreeItemFromImportable(item);\n    if (getTreeMessage !== undefined) {\n      return failWithDetail(getTreeMessage, getTreeDetail === 'skipped' ? 'skipped' : 'failed');\n    }\n\n    const { value: context, message: getContextMessage } = fsItem.getContext().onSuccess((fsItemContext) => {\n      return item.context ? item.context.extend(fsItemContext) : succeed(fsItemContext);\n    });\n\n    /* c8 ignore next 3 - defensive coding: getContext failure is extremely rare in practice */\n    if (getContextMessage) {\n      return failWithDetail(getContextMessage, 'failed');\n    }\n\n    if (fsItem.item.type === 'directory') {\n      return fsItem.item\n        .getChildren()\n        .onSuccess((children) => {\n          const errors = new MessageAggregator();\n          const items: Importable[] = [];\n          for (const child of children) {\n            const { value: item, message, detail } = FsItem.createForItem(child, this.qualifiers);\n            if (item) {\n              items.push({ type: 'fsItem', item, context });\n            } else if (detail !== 'skipped') {\n              errors.addMessage(message);\n            }\n          }\n          return errors.returnOrReport(succeed(items));\n        })\n        .withDetail('failed', 'processed');\n    } else if (fsItem.item.type === 'file') {\n      if (fsItem.item.extension === '.json') {\n        return fsItem.item\n          .getContents(JsonConverters.jsonValue)\n          .onSuccess((json) => {\n            const jsonItem: IImportableJson = {\n              type: 'json',\n              json,\n              context\n            };\n            return succeed([jsonItem]);\n          })\n          .withDetail('failed', 'processed');\n      }\n    }\n    /* c8 ignore next 2 - defensive coding: fallback case for unsupported file types */\n    return succeedWithDetail([], 'skipped');\n  }\n\n  /**\n   * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.\n   * @param item - The importable to convert.\n   * @returns `Success` containing the `FsItem` if successful, `Failure` with an error message if not.\n   */\n  protected _getFileTreeItemFromImportable(item: IImportable): DetailedResult<FsItem, FsItemResultDetail> {\n    if (item.type === 'fsItem') {\n      if ('item' in item && item.item instanceof FsItem) {\n        return succeedWithDetail(item.item, 'succeeded');\n      }\n      return failWithDetail(`malformed fsItem importable does not contain a valid item`, 'failed');\n    }\n    return failWithDetail(`${item.type}: invalid importable type for an FsItemImporter`, 'skipped');\n  }\n}\n"]}

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

@@ -1,6 +1,6 @@
 import { DetailedResult } from '@fgv/ts-utils';
 import { IImportable } from '../importable';
-import { ResourceManager } from '../../resources';
+import { ResourceManagerBuilder } from '../../resources';
 /**
  * Possible results of an import operation.
  * @public
@@ -22,10 +22,10 @@ export interface IImporter {
      * Imports an item, extracting any resources or candidates from it and returns an optional
      * list of additional importable items derived from it.
      * @param item - The {@link Import.IImportable | importable} item to import.
-     * @param manager - The {@link Resources.ResourceManager | resource manager} to use for the import.
+     * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to use for the import.
      * @returns `Success` with a list of additional importable items derived from the original, or
      * `Failure` with an error message and a {@link Import.Importers.ImporterResultDetail | result detail}.
      */
-    import(item: IImportable, manager: ResourceManager): DetailedResult<IImportable[], ImporterResultDetail>;
+    import(item: IImportable, manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
 }
 //# sourceMappingURL=importer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/importer.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC,CAAC;CAC1G"}
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/importer.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;OAOG;IACH,MAAM,CACJ,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC,CAAC;CACxD"}

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

@@ -1 +1 @@
-{"version":3,"file":"importer.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/importer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { DetailedResult } from '@fgv/ts-utils';\nimport { IImportable } from '../importable';\nimport { ResourceManager } from '../../resources';\n\n/**\n * Possible results of an import operation.\n * @public\n */\nexport type ImporterResultDetail = 'consumed' | 'processed' | 'skipped' | 'failed';\n\n/**\n * Generic interface for an importer than accepts a typed\n * {@link Import.IImportable | importable} item, extracts any resources\n * or candidates from it, and returns an optional list of\n * additional importable items derived from the original.\n * @public\n */\nexport interface IImporter {\n  /**\n   * The types of {@link Import.Importable | importable} items that this importer can process.\n   */\n  readonly types: ReadonlyArray<string>;\n\n  /**\n   * Imports an item, extracting any resources or candidates from it and returns an optional\n   * list of additional importable items derived from it.\n   * @param item - The {@link Import.IImportable | importable} item to import.\n   * @param manager - The {@link Resources.ResourceManager | resource manager} to use for the import.\n   * @returns `Success` with a list of additional importable items derived from the original, or\n   * `Failure` with an error message and a {@link Import.Importers.ImporterResultDetail | result detail}.\n   */\n  import(item: IImportable, manager: ResourceManager): DetailedResult<IImportable[], ImporterResultDetail>;\n}\n"]}
+{"version":3,"file":"importer.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/importer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { DetailedResult } from '@fgv/ts-utils';\nimport { IImportable } from '../importable';\nimport { ResourceManagerBuilder } from '../../resources';\n\n/**\n * Possible results of an import operation.\n * @public\n */\nexport type ImporterResultDetail = 'consumed' | 'processed' | 'skipped' | 'failed';\n\n/**\n * Generic interface for an importer than accepts a typed\n * {@link Import.IImportable | importable} item, extracts any resources\n * or candidates from it, and returns an optional list of\n * additional importable items derived from the original.\n * @public\n */\nexport interface IImporter {\n  /**\n   * The types of {@link Import.Importable | importable} items that this importer can process.\n   */\n  readonly types: ReadonlyArray<string>;\n\n  /**\n   * Imports an item, extracting any resources or candidates from it and returns an optional\n   * list of additional importable items derived from it.\n   * @param item - The {@link Import.IImportable | importable} item to import.\n   * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to use for the import.\n   * @returns `Success` with a list of additional importable items derived from the original, or\n   * `Failure` with an error message and a {@link Import.Importers.ImporterResultDetail | result detail}.\n   */\n  import(\n    item: IImportable,\n    manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail>;\n}\n"]}

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

@@ -1,6 +1,6 @@
 import { DetailedResult, Result } from '@fgv/ts-utils';
 import { IImporter, ImporterResultDetail } from './importer';
-import { ResourceManager } from '../../resources';
+import { ResourceManagerBuilder } from '../../resources';
 import { IImportable } from '../importable';
 /**
  * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a JSON object.
@@ -24,9 +24,8 @@ export declare class JsonImporter implements IImporter {
     /**
      * {@inheritdoc Import.Importers.IImporter.import}
      */
-    import(item: IImportable, manager: ResourceManager): DetailedResult<IImportable[], ImporterResultDetail>;
+    import(item: IImportable, manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
     private _tryImportResourceCollection;
     private _tryImportResourceTree;
-    private _tryImportResource;
 }
 //# sourceMappingURL=jsonImporter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsonImporter.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/jsonImporter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,cAAc,EAAkB,MAAM,EAAW,MAAM,eAAe,CAAC;AAE/F,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAA6C,MAAM,eAAe,CAAC;AAGvF;;;GAGG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C;;OAEG;IACH,SAAgB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAY;IAExD;;OAEG;IACH,SAAS;IAET;;;;OAIG;WACW,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC;IAI5C;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,eAAe,GACvB,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAWtD,OAAO,CAAC,4BAA4B;IAepC,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,kBAAkB;CAkB3B"}
+{"version":3,"file":"jsonImporter.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/jsonImporter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,cAAc,EAAkB,MAAM,EAAW,MAAM,eAAe,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,WAAW,EAA6C,MAAM,eAAe,CAAC;AAGvF;;;GAGG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C;;OAEG;IACH,SAAgB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAY;IAExD;;OAEG;IACH,SAAS;IAET;;;;OAIG;WACW,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC;IAI5C;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAsBtD,OAAO,CAAC,4BAA4B;IAepC,OAAO,CAAC,sBAAsB;CAqC/B"}

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

@@ -56,7 +56,6 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JsonImporter = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
-const ts_json_base_1 = require("@fgv/ts-json-base");
 const importable_1 = require("../importable");
 const ResourceJson = __importStar(require("../../resource-json"));
 /**
@@ -86,14 +85,22 @@ class JsonImporter {
      */
     import(item, manager) {
         var _a, _b;
+        /* c8 ignore next 1 - coverage intermittently misses the next line */
         if (!(0, importable_1.isImportable)(item) || item.type !== 'json') {
-            /* c8 ignore next 1 - defense in depth */
+            /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
             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 JSON importable (${item.type})`, 'skipped');
         }
-        return this._tryImportResourceCollection(item)
+        return (this._tryImportResourceCollection(item)
             .onFailure(() => this._tryImportResourceTree(item))
-            .onFailure(() => this._tryImportResource(item, manager));
+            // experimenting with this, accepting any JSON object here makes it
+            // very hard to distinguish a collection or tree with a typo from a
+            // legitimate single loose resource, which yields extremely confusing
+            // error messages. Disabled until/unless we come up with a better plan.
+            //.onFailure(() => this._tryImportResource(item, manager));
+            .onFailure(() => { var _a, _b; 
+        /* c8 ignore next 1 - defense in depth */
+        return (0, ts_utils_1.failWithDetail)(`${(_b = (_a = item.context) === null || _a === void 0 ? void 0 : _a.baseId) !== null && _b !== void 0 ? _b : 'unknown'}: unrecognized JSON format.`, 'failed'); }));
     }
     _tryImportResourceCollection(item) {
         return ResourceJson.ResourceDeclCollection.create(item.json)
@@ -119,22 +126,6 @@ class JsonImporter {
         })
             .withDetail('skipped', 'consumed');
     }
-    _tryImportResource(item, manager) {
-        return ts_json_base_1.Converters.jsonObject
-            .convert(item.json)
-            .onSuccess((json) => {
-            var _a, _b, _c;
-            /* c8 ignore next 2 - defense in depth */
-            const id = (_b = (_a = item.context) === null || _a === void 0 ? void 0 : _a.baseId) !== null && _b !== void 0 ? _b : '';
-            const conditions = (_c = item.context) === null || _c === void 0 ? void 0 : _c.conditions;
-            const candidate = { id, conditions, json };
-            return manager.addLooseCandidate(candidate);
-        })
-            .onSuccess(() => {
-            return (0, ts_utils_1.succeed)([]);
-        })
-            .withDetail('failed', 'consumed');
-    }
 }
 exports.JsonImporter = JsonImporter;
 //# sourceMappingURL=jsonImporter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsonImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/jsonImporter.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, DetailedResult, failWithDetail, Result, succeed } from '@fgv/ts-utils';\nimport { Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { ResourceManager } from '../../resources';\nimport { IImportable, IImportableJson, Importable, isImportable } from '../importable';\nimport * as ResourceJson from '../../resource-json';\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a JSON object.\n * @public\n */\nexport class JsonImporter implements IImporter {\n  /**\n   * {@inheritdoc Import.Importers.IImporter.types}\n   */\n  public readonly types: ReadonlyArray<string> = ['json'];\n\n  /**\n   * Protected {@link Import.Importers.JsonImporter | JsonImporter} constructor for derived classes.\n   */\n  protected constructor() {}\n\n  /**\n   * Creates a new {@link Import.Importers.JsonImporter | JsonImporter} instance.\n   * @returns `Success` with the new {@link Import.Importers.JsonImporter | JsonImporter} if successful,\n   * `Failure` otherwise.\n   */\n  public static create(): Result<JsonImporter> {\n    return captureResult(() => new JsonImporter());\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 !== 'json') {\n      /* c8 ignore next 1 - defense in depth */\n      const name = item.context?.baseId ?? 'unknown';\n      return failWithDetail(`${name}: not a valid JSON importable (${item.type})`, 'skipped');\n    }\n    return this._tryImportResourceCollection(item)\n      .onFailure(() => this._tryImportResourceTree(item))\n      .onFailure(() => this._tryImportResource(item, manager));\n  }\n\n  private _tryImportResourceCollection(\n    item: IImportableJson\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    return ResourceJson.ResourceDeclCollection.create(item.json)\n      .onSuccess((collection) => {\n        const importable: Importable = {\n          type: 'resourceCollection',\n          collection,\n          context: item.context\n        };\n        return succeed([importable]);\n      })\n      .withDetail('skipped', 'consumed');\n  }\n\n  private _tryImportResourceTree(item: IImportableJson): DetailedResult<IImportable[], ImporterResultDetail> {\n    return ResourceJson.ResourceDeclTree.create(item.json)\n      .onSuccess((tree) => {\n        const importable: Importable = {\n          type: 'resourceTree',\n          tree,\n          context: item.context\n        };\n        return succeed([importable]);\n      })\n      .withDetail('skipped', 'consumed');\n  }\n\n  private _tryImportResource(\n    item: IImportableJson,\n    manager: ResourceManager\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    return JsonConverters.jsonObject\n      .convert(item.json)\n      .onSuccess((json) => {\n        /* c8 ignore next 2 - defense in depth */\n        const id = item.context?.baseId ?? '';\n        const conditions = item.context?.conditions;\n        const candidate: ResourceJson.Json.ILooseResourceCandidateDecl = { id, conditions, json };\n        return manager.addLooseCandidate(candidate);\n      })\n      .onSuccess(() => {\n        return succeed([]);\n      })\n      .withDetail('failed', 'consumed');\n  }\n}\n"]}
+{"version":3,"file":"jsonImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/jsonImporter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAA+F;AAG/F,8CAAuF;AACvF,kEAAoD;AAEpD;;;GAGG;AACH,MAAa,YAAY;IAMvB;;OAEG;IACH;QARA;;WAEG;QACa,UAAK,GAA0B,CAAC,MAAM,CAAC,CAAC;IAK/B,CAAC;IAE1B;;;;OAIG;IACI,MAAM,CAAC,MAAM;QAClB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,MAAM,CACX,IAAiB,EACjB,OAA+B;;QAE/B,qEAAqE;QACrE,IAAI,CAAC,IAAA,yBAAY,EAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChD,uFAAuF;YACvF,MAAM,IAAI,GAAG,MAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,MAAM,mCAAI,SAAS,CAAC;YAC/C,OAAO,IAAA,yBAAc,EAAC,GAAG,IAAI,kCAAkC,IAAI,CAAC,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,CACL,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC;aACpC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YACnD,mEAAmE;YACnE,mEAAmE;YACnE,qEAAqE;YACrE,uEAAuE;YACvE,2DAA2D;aAC1D,SAAS,CAAC,GAAG,EAAE;QACd,yCAAyC;QACzC,OAAA,IAAA,yBAAc,EAAC,GAAG,MAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,MAAM,mCAAI,SAAS,6BAA6B,EAAE,QAAQ,CAAC,CAAA,EAAA,CAC5F,CACJ,CAAC;IACJ,CAAC;IAEO,4BAA4B,CAClC,IAAqB;QAErB,OAAO,YAAY,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACzD,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACxB,MAAM,UAAU,GAAe;gBAC7B,IAAI,EAAE,oBAAoB;gBAC1B,UAAU;gBACV,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;YACF,OAAO,IAAA,kBAAO,EAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC;aACD,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAEO,sBAAsB,CAAC,IAAqB;QAClD,OAAO,YAAY,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACnD,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,UAAU,GAAe;gBAC7B,IAAI,EAAE,cAAc;gBACpB,IAAI;gBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;YACF,OAAO,IAAA,kBAAO,EAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC;aACD,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;CA0BF;AApGD,oCAoGC","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, DetailedResult, failWithDetail, Result, succeed } from '@fgv/ts-utils';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { ResourceManagerBuilder } from '../../resources';\nimport { IImportable, IImportableJson, Importable, isImportable } from '../importable';\nimport * as ResourceJson from '../../resource-json';\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a JSON object.\n * @public\n */\nexport class JsonImporter implements IImporter {\n  /**\n   * {@inheritdoc Import.Importers.IImporter.types}\n   */\n  public readonly types: ReadonlyArray<string> = ['json'];\n\n  /**\n   * Protected {@link Import.Importers.JsonImporter | JsonImporter} constructor for derived classes.\n   */\n  protected constructor() {}\n\n  /**\n   * Creates a new {@link Import.Importers.JsonImporter | JsonImporter} instance.\n   * @returns `Success` with the new {@link Import.Importers.JsonImporter | JsonImporter} if successful,\n   * `Failure` otherwise.\n   */\n  public static create(): Result<JsonImporter> {\n    return captureResult(() => new JsonImporter());\n  }\n\n  /**\n   * {@inheritdoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    /* c8 ignore next 1 - coverage intermittently misses the next line */\n    if (!isImportable(item) || item.type !== 'json') {\n      /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n      const name = item.context?.baseId ?? 'unknown';\n      return failWithDetail(`${name}: not a valid JSON importable (${item.type})`, 'skipped');\n    }\n    return (\n      this._tryImportResourceCollection(item)\n        .onFailure(() => this._tryImportResourceTree(item))\n        // experimenting with this, accepting any JSON object here makes it\n        // very hard to distinguish a collection or tree with a typo from a\n        // legitimate single loose resource, which yields extremely confusing\n        // error messages. Disabled until/unless we come up with a better plan.\n        //.onFailure(() => this._tryImportResource(item, manager));\n        .onFailure(() =>\n          /* c8 ignore next 1 - defense in depth */\n          failWithDetail(`${item.context?.baseId ?? 'unknown'}: unrecognized JSON format.`, 'failed')\n        )\n    );\n  }\n\n  private _tryImportResourceCollection(\n    item: IImportableJson\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    return ResourceJson.ResourceDeclCollection.create(item.json)\n      .onSuccess((collection) => {\n        const importable: Importable = {\n          type: 'resourceCollection',\n          collection,\n          context: item.context\n        };\n        return succeed([importable]);\n      })\n      .withDetail('skipped', 'consumed');\n  }\n\n  private _tryImportResourceTree(item: IImportableJson): DetailedResult<IImportable[], ImporterResultDetail> {\n    return ResourceJson.ResourceDeclTree.create(item.json)\n      .onSuccess((tree) => {\n        const importable: Importable = {\n          type: 'resourceTree',\n          tree,\n          context: item.context\n        };\n        return succeed([importable]);\n      })\n      .withDetail('skipped', 'consumed');\n  }\n\n  /* \n   * This is disabled for now because it's too easy to accidentally import\n   * a single loose resource as a collection or tree, which yields extremely\n   * confusing error messages.\n\n  private _tryImportResource(\n    item: IImportableJson,\n    manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    return JsonConverters.jsonObject\n      .convert(item.json)\n      .onSuccess((json) => {\n        // c8 ignore next 2 - defense in depth\n        const id = item.context?.baseId ?? '';\n        const conditions = item.context?.conditions;\n        const candidate: ResourceJson.Json.ILooseResourceCandidateDecl = { id, conditions, json };\n        return manager.addLooseCandidate(candidate);\n      })\n      .onSuccess(() => {\n        return succeed([]);\n      })\n      .withDetail('failed', 'consumed');\n  }\n  */\n}\n"]}

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

@@ -1,5 +1,5 @@
 import { DetailedResult, Result, FileTree } from '@fgv/ts-utils';
-import { ResourceManager } from '../../resources';
+import { ResourceManagerBuilder } from '../../resources';
 import { IImportable } from '../importable';
 import { IImporter, ImporterResultDetail } from './importer';
 import { IReadOnlyQualifierCollector } from '../../qualifiers';
@@ -50,7 +50,7 @@ export declare class PathImporter implements IImporter {
     /**
      * {@inheritdoc Import.Importers.IImporter.import}
      */
-    import(item: IImportable, __manager: ResourceManager): DetailedResult<IImportable[], ImporterResultDetail>;
+    import(item: IImportable, __manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
     /**
      * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.
      * @param item - The importable to convert.

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

@@ -1 +1 @@
-{"version":3,"file":"pathImporter.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/pathImporter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,cAAc,EAEd,MAAM,EAEN,QAAQ,EACT,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,2BAA2B,CAAC;IACxC,IAAI,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,SAAgB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAExC;;OAEG;IACH,SAAgB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAY;IAExD;;;OAGG;IACH,SAAgB,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1C;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,yBAAyB;IAMvD;;;;OAIG;WACW,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAAC,YAAY,CAAC;IAI7E;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,eAAe,GACzB,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAqBtD;;;;OAIG;IACH,SAAS,CAAC,8BAA8B,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC;CASxG"}
+{"version":3,"file":"pathImporter.d.ts","sourceRoot":"","sources":["../../../../src/packlets/import/importers/pathImporter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,cAAc,EAEd,MAAM,EAEN,QAAQ,EACT,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,2BAA2B,CAAC;IACxC,IAAI,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,SAAgB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAExC;;OAEG;IACH,SAAgB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAY;IAExD;;;OAGG;IACH,SAAgB,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1C;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,yBAAyB;IAMvD;;;;OAIG;WACW,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAAC,YAAY,CAAC;IAI7E;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,sBAAsB,GAChC,cAAc,CAAC,WAAW,EAAE,EAAE,oBAAoB,CAAC;IAqBtD;;;;OAIG;IACH,SAAS,CAAC,8BAA8B,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC;CASxG"}

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

@@ -1 +1 @@
-{"version":3,"file":"pathImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/pathImporter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAOuB;AAKvB,sCAAuD;AAYvD;;;;GAIG;AACH,MAAa,YAAY;IAsBvB;;;OAGG;IACH,YAAsB,MAAiC;;QAfvD;;WAEG;QACa,UAAK,GAA0B,CAAC,MAAM,CAAC,CAAC;QAatD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,MAAA,MAAM,CAAC,IAAI,mCAAI,mBAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,CAAC,eAAe,GAAG,MAAA,MAAM,CAAC,eAAe,mCAAI,EAAE,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,MAAiC;QACpD,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,MAAM,CACX,IAAiB,EACjB,SAA0B;QAE1B,MAAM,EACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACtB,GAAG,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACxF,OAAO,IAAA,4BAAiB,EAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;QAED,8EAA8E;QAC9E,mCAAmC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,OAAO,IAAA,4BAAiB,EAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IACrF,CAAC;IAED;;;;OAIG;IACO,8BAA8B,CAAC,IAAiB;QACxD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpD,OAAO,eAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,IAAA,yBAAc,EAAC,0DAA0D,EAAE,QAAQ,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,IAAA,yBAAc,EAAC,GAAG,IAAI,CAAC,IAAI,8CAA8C,EAAE,SAAS,CAAC,CAAC;IAC/F,CAAC;CACF;AAlFD,oCAkFC","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  Result,\n  succeedWithDetail,\n  FileTree\n} from '@fgv/ts-utils';\nimport { ResourceManager } from '../../resources';\nimport { IImportable } from '../importable';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { FsItem, FsItemResultDetail } from '../fsItem';\n\n/**\n * Parameters for creating a {@link Import.Importers.PathImporter | PathImporter}.\n * @public\n */\nexport interface IPathImporterCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n  tree?: FileTree.FileTree;\n  ignoreFileTypes?: string[];\n}\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a `FileTree`\n * given a path.\n * @public\n */\nexport class PathImporter implements IImporter {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * The `FileTree` from which resources will be imported.\n   */\n  public readonly tree: FileTree.FileTree;\n\n  /**\n   * The types of {@link Import.IImportable | importables} that this importer can handle.\n   */\n  public readonly types: ReadonlyArray<string> = ['path'];\n\n  /**\n   * The types of files to ignore when importing.  Any file not ignored is converted\n   * to an {@link Import.IImportableFsItem | IImportableFsItem}.\n   */\n  public readonly ignoreFileTypes: string[];\n\n  /**\n   * Protected constructor for the {@link Import.Importers.PathImporter | PathImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.PathImporter | PathImporter}.\n   */\n  protected constructor(params: IPathImporterCreateParams) {\n    this.qualifiers = params.qualifiers;\n    this.tree = params.tree ?? FileTree.forFilesystem().orThrow();\n    this.ignoreFileTypes = params.ignoreFileTypes ?? [];\n  }\n\n  /**\n   * Creates a new {@link Import.Importers.PathImporter | PathImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.PathImporter | dirPathImporter}.\n   * @returns `Success` with the new `PathImporter` if successful, `Failure` with an error message if not.\n   */\n  public static create(params: IPathImporterCreateParams): Result<PathImporter> {\n    return captureResult(() => new PathImporter(params));\n  }\n\n  /**\n   * {@inheritdoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    __manager: ResourceManager\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    const {\n      value: fsItem,\n      message: getTreeMessage,\n      detail: getTreeDetail\n    } = this._getFileTreeItemFromImportable(item);\n    if (getTreeMessage !== undefined) {\n      return failWithDetail(getTreeMessage, getTreeDetail === 'skipped' ? 'skipped' : 'failed');\n    }\n\n    if (fsItem.item.type === 'file' && this.ignoreFileTypes.includes(fsItem.item.extension)) {\n      return succeedWithDetail([], 'processed');\n    }\n\n    // extracted characteristics are in the fsItem so add them to the context when\n    // that is imported instead of now.\n    const context = item.context;\n\n    return succeedWithDetail([{ type: 'fsItem', item: fsItem, context }], 'processed');\n  }\n\n  /**\n   * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.\n   * @param item - The importable to convert.\n   * @returns `Success` containing the `FsItem` if successful, `Failure` with an error message if not.\n   */\n  protected _getFileTreeItemFromImportable(item: IImportable): DetailedResult<FsItem, FsItemResultDetail> {\n    if (item.type === 'path') {\n      if ('path' in item && typeof item.path === 'string') {\n        return FsItem.createForPath(item.path, this.qualifiers, this.tree);\n      }\n      return failWithDetail(`malformed path importable does not contain a string path`, 'failed');\n    }\n    return failWithDetail(`${item.type}: invalid importable type for a PathImporter`, 'skipped');\n  }\n}\n"]}
+{"version":3,"file":"pathImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/pathImporter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAOuB;AAKvB,sCAAuD;AAYvD;;;;GAIG;AACH,MAAa,YAAY;IAsBvB;;;OAGG;IACH,YAAsB,MAAiC;;QAfvD;;WAEG;QACa,UAAK,GAA0B,CAAC,MAAM,CAAC,CAAC;QAatD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,MAAA,MAAM,CAAC,IAAI,mCAAI,mBAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,CAAC,eAAe,GAAG,MAAA,MAAM,CAAC,eAAe,mCAAI,EAAE,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,MAAiC;QACpD,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,MAAM,CACX,IAAiB,EACjB,SAAiC;QAEjC,MAAM,EACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACtB,GAAG,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACxF,OAAO,IAAA,4BAAiB,EAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;QAED,8EAA8E;QAC9E,mCAAmC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,OAAO,IAAA,4BAAiB,EAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IACrF,CAAC;IAED;;;;OAIG;IACO,8BAA8B,CAAC,IAAiB;QACxD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpD,OAAO,eAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,IAAA,yBAAc,EAAC,0DAA0D,EAAE,QAAQ,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,IAAA,yBAAc,EAAC,GAAG,IAAI,CAAC,IAAI,8CAA8C,EAAE,SAAS,CAAC,CAAC;IAC/F,CAAC;CACF;AAlFD,oCAkFC","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  Result,\n  succeedWithDetail,\n  FileTree\n} from '@fgv/ts-utils';\nimport { ResourceManagerBuilder } from '../../resources';\nimport { IImportable } from '../importable';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { FsItem, FsItemResultDetail } from '../fsItem';\n\n/**\n * Parameters for creating a {@link Import.Importers.PathImporter | PathImporter}.\n * @public\n */\nexport interface IPathImporterCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n  tree?: FileTree.FileTree;\n  ignoreFileTypes?: string[];\n}\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a `FileTree`\n * given a path.\n * @public\n */\nexport class PathImporter implements IImporter {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * The `FileTree` from which resources will be imported.\n   */\n  public readonly tree: FileTree.FileTree;\n\n  /**\n   * The types of {@link Import.IImportable | importables} that this importer can handle.\n   */\n  public readonly types: ReadonlyArray<string> = ['path'];\n\n  /**\n   * The types of files to ignore when importing.  Any file not ignored is converted\n   * to an {@link Import.IImportableFsItem | IImportableFsItem}.\n   */\n  public readonly ignoreFileTypes: string[];\n\n  /**\n   * Protected constructor for the {@link Import.Importers.PathImporter | PathImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.PathImporter | PathImporter}.\n   */\n  protected constructor(params: IPathImporterCreateParams) {\n    this.qualifiers = params.qualifiers;\n    this.tree = params.tree ?? FileTree.forFilesystem().orThrow();\n    this.ignoreFileTypes = params.ignoreFileTypes ?? [];\n  }\n\n  /**\n   * Creates a new {@link Import.Importers.PathImporter | PathImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.PathImporter | dirPathImporter}.\n   * @returns `Success` with the new `PathImporter` if successful, `Failure` with an error message if not.\n   */\n  public static create(params: IPathImporterCreateParams): Result<PathImporter> {\n    return captureResult(() => new PathImporter(params));\n  }\n\n  /**\n   * {@inheritdoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    __manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    const {\n      value: fsItem,\n      message: getTreeMessage,\n      detail: getTreeDetail\n    } = this._getFileTreeItemFromImportable(item);\n    if (getTreeMessage !== undefined) {\n      return failWithDetail(getTreeMessage, getTreeDetail === 'skipped' ? 'skipped' : 'failed');\n    }\n\n    if (fsItem.item.type === 'file' && this.ignoreFileTypes.includes(fsItem.item.extension)) {\n      return succeedWithDetail([], 'processed');\n    }\n\n    // extracted characteristics are in the fsItem so add them to the context when\n    // that is imported instead of now.\n    const context = item.context;\n\n    return succeedWithDetail([{ type: 'fsItem', item: fsItem, context }], 'processed');\n  }\n\n  /**\n   * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.\n   * @param item - The importable to convert.\n   * @returns `Success` containing the `FsItem` if successful, `Failure` with an error message if not.\n   */\n  protected _getFileTreeItemFromImportable(item: IImportable): DetailedResult<FsItem, FsItemResultDetail> {\n    if (item.type === 'path') {\n      if ('path' in item && typeof item.path === 'string') {\n        return FsItem.createForPath(item.path, this.qualifiers, this.tree);\n      }\n      return failWithDetail(`malformed path importable does not contain a string path`, 'failed');\n    }\n    return failWithDetail(`${item.type}: invalid importable type for a PathImporter`, 'skipped');\n  }\n}\n"]}