@fgv/ts-res 4.5.0-0

package/lib/packlets/decisions/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../../src/packlets/decisions/decision.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, Collections, Hash, Result } from '@fgv/ts-utils';\nimport { Convert as CommonConvert, DecisionIndex, DecisionKey } from '../common';\nimport { JsonValue } from '@fgv/ts-json-base';\nimport { Candidate, ICandidate } from './candidate';\nimport { IDecision } from './common';\nimport { ConditionSet } from '../conditions';\n\n/**\n * Parameters used to create a new {@link Decisions.Decision | Decision}\n * with the {@link Decisions.Decision.createDecision | createDecision}\n * static method.\n * @public\n */\nexport interface IDecisionCreateParams<TVALUE extends JsonValue = JsonValue> {\n  candidates: ReadonlyArray<ICandidate<TVALUE>>;\n  index?: number;\n}\n\n/**\n * Parameters used to construct a new {@link Decisions.Decision | Decision} with\n * the protected constructor.\n * @public\n */\nexport interface IDecisionConstructorParams<TVALUE extends JsonValue = JsonValue>\n  extends IDecisionCreateParams<TVALUE> {\n  isAbstract: boolean;\n}\n\n/**\n * Simple collectible implementation of {@link Decisions.IDecision | IDecision}.\n * @public\n */\nexport class Decision<TVALUE extends JsonValue = JsonValue> implements IDecision<TVALUE> {\n  /**\n   * The sorted {@link Conditions.ConditionSet  | ConditionSets} that make up this decision.\n   * @public\n   */\n  public readonly candidates: ReadonlyArray<Candidate<TVALUE>>;\n\n  /**\n   * Unique global key for this decision, derived from the contents\n   * of the decision.\n   */\n  public get key(): DecisionKey {\n    return this._collectible.key;\n  }\n\n  /**\n   * Unique global index for this decision.\n   */\n  public get index(): DecisionIndex | undefined {\n    return this._collectible.index;\n  }\n\n  /**\n   * Key for the empty decision (no condition sets).\n   */\n  public static readonly EmptyDecisionKey: DecisionKey = CommonConvert.decisionKey.convert('').orThrow();\n\n  /**\n   * Key for the default-only decision (single condition set with no conditions).\n   */\n  public static readonly DefaultOnlyDecisionKey: DecisionKey = CommonConvert.decisionKey\n    .convert('00000000')\n    .orThrow();\n\n  private _collectible: Collections.Collectible<DecisionKey, DecisionIndex>;\n\n  /**\n   * Constructor for a {@link Decisions.Decision | Decision} object.\n   * @param params - {@link Decisions.IDecisionConstructorParams | Parameters} used to create the decision.\n   * @public\n   */\n  protected constructor(params: IDecisionConstructorParams<TVALUE>) {\n    this.candidates = Array.from(params.candidates)\n      .map((c) => Candidate.createCandidate(c).orThrow())\n      .sort(Candidate.compare)\n      .reverse();\n\n    /* c8 ignore next 3 - coverage having a rough time */\n    const key = params.isAbstract\n      ? Decision.getAbstractKey(this.candidates.map((c) => c.conditionSet))\n      : Decision.getKey(this.candidates);\n\n    this._collectible = new Collections.Collectible<DecisionKey, DecisionIndex>({\n      key,\n      index: params.index,\n      indexConverter: CommonConvert.decisionIndex\n    });\n  }\n\n  /**\n   * Creates a new {@link Decisions.Decision | Decision} object.\n   * @param params - {@link Decisions.IDecisionCreateParams | Parameters} used to create the decision.\n   * @returns `Success` with the new decision if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public static createDecision(params: IDecisionCreateParams): Result<Decision> {\n    return captureResult(() => new Decision({ ...params, isAbstract: false }));\n  }\n\n  /**\n   * Sets the index for this decision.  Once set, index is immutable.\n   * @param index - The index to set.\n   * @returns `Success` with the new index if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public setIndex(index: number): Result<DecisionIndex> {\n    return this._collectible.setIndex(index);\n  }\n\n  /**\n   * Helper function to return a stable key for a the condition sets that\n   * make up a {@link Decisions.Decision | decision}.  The abstract\n   * key is a `+`-separated list of the hashes of the sorted condition sets\n   * that make up the decision.\n   * @param conditionSets - The condition sets to use to create the key.\n   * @returns A key derived from the condition set hashes.\n   * @public\n   */\n  public static getAbstractKey(conditionSets: ReadonlyArray<ConditionSet>): DecisionKey {\n    return CommonConvert.decisionKey\n      .convert(\n        Array.from(conditionSets)\n          .sort(ConditionSet.compare)\n          .reverse()\n          .map((c) => c.toHash())\n          .join('+')\n      )\n      .orThrow();\n  }\n\n  /**\n   * Helper function to return a stable key for a set of condition sets.\n   * @param conditionSets - The condition sets to use to create the key.\n   * @returns A key derived from the condition set hashes.\n   * @public\n   */\n  public static getKey<TVALUE extends JsonValue = JsonValue>(\n    candidates: ReadonlyArray<ICandidate<TVALUE>>\n  ): DecisionKey {\n    const abstractKey = Decision.getAbstractKey(candidates.map((c) => c.conditionSet));\n    const valueKey = Hash.Crc32Normalizer.crc32Hash(candidates.map((c) => JSON.stringify(c.value)));\n    return CommonConvert.decisionKey.convert(`${abstractKey}|${valueKey}`).orThrow();\n  }\n}\n"]}

package/lib/packlets/decisions/index.d.ts

@@ -0,0 +1,7 @@
+export * from './common';
+export * from './candidate';
+export * from './decision';
+export * from './abstractDecision';
+export * from './abstractDecisionCollector';
+export * from './concreteDecision';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/decisions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/decisions/index.ts"],"names":[],"mappings":"AAsBA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}

package/lib/packlets/decisions/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common"), exports);
+__exportStar(require("./candidate"), exports);
+__exportStar(require("./decision"), exports);
+__exportStar(require("./abstractDecision"), exports);
+__exportStar(require("./abstractDecisionCollector"), exports);
+__exportStar(require("./concreteDecision"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/decisions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/decisions/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,8CAA4B;AAC5B,6CAA2B;AAC3B,qDAAmC;AACnC,8DAA4C;AAC5C,qDAAmC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './common';\nexport * from './candidate';\nexport * from './decision';\nexport * from './abstractDecision';\nexport * from './abstractDecisionCollector';\nexport * from './concreteDecision';\n"]}

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

@@ -0,0 +1,99 @@
+import { DetailedResult, FileTree, Result } from '@fgv/ts-utils';
+import * as Conditions from '../conditions';
+import { IReadOnlyQualifierCollector } from '../qualifiers';
+import { ImportContext } from './importContext';
+/**
+ * Result details for {@link Import.FsItem | FsItem} operations.
+ * @public
+ */
+export type FsItemResultDetail = 'failed' | 'skipped' | 'succeeded';
+/**
+ * Interface describing some single file system item.
+ * @public
+ */
+export interface IFsItemProps {
+    /**
+     * The underlying `FileTreeItem` for this item.
+     */
+    readonly item: FileTree.FileTreeItem;
+    /**
+     * The base name of the file system item, once
+     * any conditions set tokens have been removed.
+     */
+    readonly baseName: string;
+    /**
+     * {@link Conditions.IValidatedConditionDecl | Conditions} extracted
+     * from the base name of the {@link Import.FsItem | FsItem}.
+     */
+    readonly conditions: Conditions.IValidatedConditionDecl[];
+}
+/**
+ * Class describing some file system item to be imported.
+ * @public
+ */
+export declare class FsItem implements IFsItemProps {
+    /**
+     * {@inheritDoc Import.IFsItemProps.baseName}
+     */
+    readonly baseName: string;
+    /**
+     * {@inheritDoc Import.IFsItemProps.conditions}
+     */
+    readonly conditions: Conditions.IValidatedConditionDecl[];
+    /**
+     * {@inheritDoc Import.IFsItemProps.item}
+     */
+    readonly item: FileTree.FileTreeItem;
+    /**
+     * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for this item.
+     */
+    readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * Protected constructor creates a new {@link Import.FsItem | FsItem}.
+     * @param props - The {@link Import.IFsItemProps | file system item properties} to use for this item.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @param tree - file tree implementation to use for this item.
+     * @returns `Success` containing the new {@link Import.FsItem | FsItem} if successful, or a `Failure`
+     * containing an error message if not.
+     */
+    protected constructor(props: IFsItemProps, qualifiers: IReadOnlyQualifierCollector);
+    /**
+     * Creates a new {@link Import.FsItem | FsItem} from a `FileTreeItem`.
+     * @param item - The `FileTreeItem` to import.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @returns `Success` containing the new {@link Import.FsItem | FsItem} if successful, or a `Failure`
+     * containing an error message if not.  Note that the result detail `skipped` indicates that the item
+     * was not created because it is not relevant - this is a soft error that should be silently ignored.
+     */
+    static createForItem(item: FileTree.FileTreeItem, qualifiers: IReadOnlyQualifierCollector): DetailedResult<FsItem, FsItemResultDetail>;
+    /**
+     * Creates a new {@link Import.FsItem | FsItem} from a file system path.
+     * @param importPath - The path to the file system item to import.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @param fs - An optional {@link Import.IImporterFilesystem | file system implementation} to use for this item.
+     * @returns `Success` containing the new {@link Import.FsItem | FsItem} if an item is created
+     * successfully, or a `Failure` containing an error message if it is not.  Note that the result detail
+     * `skipped` indicates that the item was not created because it is not relevant - this is a soft error
+     * that should be silently ignored.
+     */
+    static createForPath(importPath: string, qualifiers: IReadOnlyQualifierCollector, tree?: FileTree.FileTree): DetailedResult<FsItem, FsItemResultDetail>;
+    /**
+     * Tries to parse a base name into a base name and a set of conditions.
+     * @param baseName - The base name to parse.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @returns `Success` containing the parsed base name and conditions on success, or `Failure` containing
+     * an error message if it is not.
+     */
+    static tryParseBaseName(baseName: string, qualifiers: IReadOnlyQualifierCollector): Result<Omit<IFsItemProps, 'item'>>;
+    /**
+     * Gets the context for this file system item.
+     * @returns `Success` containing the {@link Import.ImportContext | import context} for this item
+     * if successful, or a `Failure` containing an error message if an error occurs.
+     */
+    getContext(): Result<ImportContext>;
+}
+//# sourceMappingURL=fsItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fsItem.d.ts","sourceRoot":"","sources":["../../../src/packlets/import/fsItem.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,cAAc,EACd,QAAQ,EAER,MAAM,EAIP,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,uBAAuB,EAAE,CAAC;CAC3D;AAED;;;GAGG;AACH,qBAAa,MAAO,YAAW,YAAY;IACzC;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,SAAgB,UAAU,EAAE,UAAU,CAAC,uBAAuB,EAAE,CAAC;IAEjE;;OAEG;IACH,SAAgB,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC;IAE5C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;;;;;;;OAQG;IACH,SAAS,aAAa,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,2BAA2B;IAQlF;;;;;;;;OAQG;WACW,aAAa,CACzB,IAAI,EAAE,QAAQ,CAAC,YAAY,EAC3B,UAAU,EAAE,2BAA2B,GACtC,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAW7C;;;;;;;;;;OAUG;WACW,aAAa,CACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,2BAA2B,EACvC,IAAI,CAAC,EAAE,QAAQ,CAAC,QAAQ,GACvB,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAgB7C;;;;;;;OAOG;WACW,gBAAgB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAyBrC;;;;OAIG;IACI,UAAU,IAAI,MAAM,CAAC,aAAa,CAAC;CAa3C"}

package/lib/packlets/import/fsItem.js

@@ -0,0 +1,174 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsItem = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+const Conditions = __importStar(require("../conditions"));
+const importContext_1 = require("./importContext");
+/**
+ * Class describing some file system item to be imported.
+ * @public
+ */
+class FsItem {
+    /**
+     * Protected constructor creates a new {@link Import.FsItem | FsItem}.
+     * @param props - The {@link Import.IFsItemProps | file system item properties} to use for this item.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @param tree - file tree implementation to use for this item.
+     * @returns `Success` containing the new {@link Import.FsItem | FsItem} if successful, or a `Failure`
+     * containing an error message if not.
+     */
+    constructor(props, qualifiers) {
+        const { baseName, conditions, item } = props;
+        this.baseName = baseName;
+        this.conditions = conditions;
+        this.item = item;
+        this.qualifiers = qualifiers;
+    }
+    /**
+     * Creates a new {@link Import.FsItem | FsItem} from a `FileTreeItem`.
+     * @param item - The `FileTreeItem` to import.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @returns `Success` containing the new {@link Import.FsItem | FsItem} if successful, or a `Failure`
+     * containing an error message if not.  Note that the result detail `skipped` indicates that the item
+     * was not created because it is not relevant - this is a soft error that should be silently ignored.
+     */
+    static createForItem(item, qualifiers) {
+        const baseName = item.type === 'file' ? item.baseName : item.name;
+        return FsItem.tryParseBaseName(baseName, qualifiers)
+            .withErrorFormat((msg) => `${baseName}: error extracting conditions - ${msg}`)
+            .onSuccess(({ baseName: newBaseName, conditions }) => {
+            return (0, ts_utils_1.captureResult)(() => new FsItem({ baseName: newBaseName, conditions, item }, qualifiers));
+        })
+            .withDetail('failed', 'succeeded');
+    }
+    /**
+     * Creates a new {@link Import.FsItem | FsItem} from a file system path.
+     * @param importPath - The path to the file system item to import.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @param fs - An optional {@link Import.IImporterFilesystem | file system implementation} to use for this item.
+     * @returns `Success` containing the new {@link Import.FsItem | FsItem} if an item is created
+     * successfully, or a `Failure` containing an error message if it is not.  Note that the result detail
+     * `skipped` indicates that the item was not created because it is not relevant - this is a soft error
+     * that should be silently ignored.
+     */
+    static createForPath(importPath, qualifiers, tree) {
+        if (tree === undefined) {
+            const treeResult = ts_utils_1.FileTree.forFilesystem();
+            /* c8 ignore next 3 - defense in depth should never happen */
+            if (treeResult.isFailure()) {
+                return (0, ts_utils_1.failWithDetail)(treeResult.message, 'failed');
+            }
+            tree = treeResult.value;
+        }
+        return tree
+            .getItem(importPath)
+            .withDetail('failed')
+            .onSuccess((item) => FsItem.createForItem(item, qualifiers));
+    }
+    /**
+     * Tries to parse a base name into a base name and a set of conditions.
+     * @param baseName - The base name to parse.
+     * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
+     * embedded condition set tokens.
+     * @returns `Success` containing the parsed base name and conditions on success, or `Failure` containing
+     * an error message if it is not.
+     */
+    static tryParseBaseName(baseName, qualifiers) {
+        const nameParts = baseName.split('.');
+        const segmentToTest = nameParts.length > 1 ? nameParts[nameParts.length - 1] : nameParts[0];
+        const validatedConditions = common_1.Helpers.parseConditionSetTokenParts(segmentToTest).onSuccess((parts) => {
+            return (0, ts_utils_1.mapResults)(parts.map((part) => Conditions.ConditionTokens.validateConditionTokenParts(part, qualifiers))).onFailure((msg) => {
+                if (parts.length === 1 && parts[0].qualifier === undefined) {
+                    return (0, ts_utils_1.succeed)([]);
+                }
+                return (0, ts_utils_1.fail)(msg);
+            });
+        });
+        if (validatedConditions.isFailure()) {
+            return (0, ts_utils_1.fail)(validatedConditions.message);
+        }
+        const conditions = validatedConditions.value;
+        if (conditions.length > 0) {
+            baseName = nameParts.filter((s) => s !== segmentToTest).join('.');
+        }
+        return (0, ts_utils_1.succeed)({ baseName, conditions });
+    }
+    /**
+     * Gets the context for this file system item.
+     * @returns `Success` containing the {@link Import.ImportContext | import context} for this item
+     * if successful, or a `Failure` containing an error message if an error occurs.
+     */
+    getContext() {
+        return common_1.Validate.toOptionalResourceId(this.baseName).onSuccess((baseId) => {
+            const conditions = this.conditions.map((c) => {
+                return {
+                    qualifierName: c.qualifier.name,
+                    value: c.value,
+                    operator: c.operator,
+                    priority: c.priority
+                };
+            });
+            return importContext_1.ImportContext.create({ baseId, conditions });
+        });
+    }
+}
+exports.FsItem = FsItem;
+//# sourceMappingURL=fsItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fsItem.js","sourceRoot":"","sources":["../../../src/packlets/import/fsItem.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  FileTree,\n  mapResults,\n  Result,\n  fail,\n  succeed,\n  failWithDetail\n} from '@fgv/ts-utils';\nimport { Helpers as CommonHelpers, Validate } from '../common';\nimport * as Conditions from '../conditions';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\nimport { ImportContext } from './importContext';\n\n/**\n * Result details for {@link Import.FsItem | FsItem} operations.\n * @public\n */\nexport type FsItemResultDetail = 'failed' | 'skipped' | 'succeeded';\n\n/**\n * Interface describing some single file system item.\n * @public\n */\nexport interface IFsItemProps {\n  /**\n   * The underlying `FileTreeItem` for this item.\n   */\n  readonly item: FileTree.FileTreeItem;\n\n  /**\n   * The base name of the file system item, once\n   * any conditions set tokens have been removed.\n   */\n  readonly baseName: string;\n\n  /**\n   * {@link Conditions.IValidatedConditionDecl | Conditions} extracted\n   * from the base name of the {@link Import.FsItem | FsItem}.\n   */\n  readonly conditions: Conditions.IValidatedConditionDecl[];\n}\n\n/**\n * Class describing some file system item to be imported.\n * @public\n */\nexport class FsItem implements IFsItemProps {\n  /**\n   * {@inheritDoc Import.IFsItemProps.baseName}\n   */\n  public readonly baseName: string;\n\n  /**\n   * {@inheritDoc Import.IFsItemProps.conditions}\n   */\n  public readonly conditions: Conditions.IValidatedConditionDecl[];\n\n  /**\n   * {@inheritDoc Import.IFsItemProps.item}\n   */\n  public readonly item: FileTree.FileTreeItem;\n\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for this item.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Protected constructor creates a new {@link Import.FsItem | FsItem}.\n   * @param props - The {@link Import.IFsItemProps | file system item properties} to use for this item.\n   * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse\n   * embedded condition set tokens.\n   * @param tree - file tree implementation to use for this item.\n   * @returns `Success` containing the new {@link Import.FsItem | FsItem} if successful, or a `Failure`\n   * containing an error message if not.\n   */\n  protected constructor(props: IFsItemProps, qualifiers: IReadOnlyQualifierCollector) {\n    const { baseName, conditions, item } = props;\n    this.baseName = baseName;\n    this.conditions = conditions;\n    this.item = item;\n    this.qualifiers = qualifiers;\n  }\n\n  /**\n   * Creates a new {@link Import.FsItem | FsItem} from a `FileTreeItem`.\n   * @param item - The `FileTreeItem` to import.\n   * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse\n   * embedded condition set tokens.\n   * @returns `Success` containing the new {@link Import.FsItem | FsItem} if successful, or a `Failure`\n   * containing an error message if not.  Note that the result detail `skipped` indicates that the item\n   * was not created because it is not relevant - this is a soft error that should be silently ignored.\n   */\n  public static createForItem(\n    item: FileTree.FileTreeItem,\n    qualifiers: IReadOnlyQualifierCollector\n  ): DetailedResult<FsItem, FsItemResultDetail> {\n    const baseName: string = item.type === 'file' ? item.baseName : item.name;\n\n    return FsItem.tryParseBaseName(baseName, qualifiers)\n      .withErrorFormat((msg) => `${baseName}: error extracting conditions - ${msg}`)\n      .onSuccess(({ baseName: newBaseName, conditions }) => {\n        return captureResult(() => new FsItem({ baseName: newBaseName, conditions, item }, qualifiers));\n      })\n      .withDetail('failed', 'succeeded');\n  }\n\n  /**\n   * Creates a new {@link Import.FsItem | FsItem} from a file system path.\n   * @param importPath - The path to the file system item to import.\n   * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse\n   * embedded condition set tokens.\n   * @param fs - An optional {@link Import.IImporterFilesystem | file system implementation} to use for this item.\n   * @returns `Success` containing the new {@link Import.FsItem | FsItem} if an item is created\n   * successfully, or a `Failure` containing an error message if it is not.  Note that the result detail\n   * `skipped` indicates that the item was not created because it is not relevant - this is a soft error\n   * that should be silently ignored.\n   */\n  public static createForPath(\n    importPath: string,\n    qualifiers: IReadOnlyQualifierCollector,\n    tree?: FileTree.FileTree\n  ): DetailedResult<FsItem, FsItemResultDetail> {\n    if (tree === undefined) {\n      const treeResult = FileTree.forFilesystem();\n      /* c8 ignore next 3 - defense in depth should never happen */\n      if (treeResult.isFailure()) {\n        return failWithDetail(treeResult.message, 'failed');\n      }\n      tree = treeResult.value;\n    }\n\n    return tree\n      .getItem(importPath)\n      .withDetail<FsItemResultDetail>('failed')\n      .onSuccess((item) => FsItem.createForItem(item, qualifiers));\n  }\n\n  /**\n   * Tries to parse a base name into a base name and a set of conditions.\n   * @param baseName - The base name to parse.\n   * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse\n   * embedded condition set tokens.\n   * @returns `Success` containing the parsed base name and conditions on success, or `Failure` containing\n   * an error message if it is not.\n   */\n  public static tryParseBaseName(\n    baseName: string,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<Omit<IFsItemProps, 'item'>> {\n    const nameParts = baseName.split('.');\n    const segmentToTest = nameParts.length > 1 ? nameParts[nameParts.length - 1] : nameParts[0];\n    const validatedConditions = CommonHelpers.parseConditionSetTokenParts(segmentToTest).onSuccess(\n      (parts) => {\n        return mapResults(\n          parts.map((part) => Conditions.ConditionTokens.validateConditionTokenParts(part, qualifiers))\n        ).onFailure((msg) => {\n          if (parts.length === 1 && parts[0].qualifier === undefined) {\n            return succeed([]);\n          }\n          return fail(msg);\n        });\n      }\n    );\n    if (validatedConditions.isFailure()) {\n      return fail(validatedConditions.message);\n    }\n    const conditions = validatedConditions.value;\n    if (conditions.length > 0) {\n      baseName = nameParts.filter((s) => s !== segmentToTest).join('.');\n    }\n    return succeed({ baseName, conditions });\n  }\n\n  /**\n   * Gets the context for this file system item.\n   * @returns `Success` containing the {@link Import.ImportContext | import context} for this item\n   * if successful, or a `Failure` containing an error message if an error occurs.\n   */\n  public getContext(): Result<ImportContext> {\n    return Validate.toOptionalResourceId(this.baseName).onSuccess((baseId) => {\n      const conditions = this.conditions.map((c) => {\n        return {\n          qualifierName: c.qualifier.name,\n          value: c.value,\n          operator: c.operator,\n          priority: c.priority\n        };\n      });\n      return ImportContext.create({ baseId, conditions });\n    });\n  }\n}\n"]}

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

@@ -0,0 +1,85 @@
+import { Result } from '@fgv/ts-utils';
+import { IConditionDecl } from '../conditions';
+import { ResourceId } from '../common';
+/**
+ * Accumulated context of a resource import operation.
+ * @public
+ */
+export interface IImportContext {
+    /**
+     * Base ID for the import context for resources imported
+     * in this context.
+     */
+    readonly baseId?: string;
+    /**
+     * Conditions to be applied to resources imported in this context.
+     */
+    readonly conditions?: ReadonlyArray<IConditionDecl>;
+}
+/**
+ * Accumulated context of a resource import operation.
+ * @public
+ */
+export interface IValidatedImportContext {
+    /**
+     * Base ID for the import context for resources imported
+     * in this context.
+     */
+    readonly baseId?: ResourceId;
+    /**
+     * Conditions to be applied to resources imported in this context.
+     */
+    readonly conditions: ReadonlyArray<IConditionDecl>;
+}
+/**
+ * Class to accumulate context for a resource import operation.
+ * @public
+ */
+export declare class ImportContext implements IValidatedImportContext {
+    /**
+     * {@inheritdoc Import.IImportContext.baseId}
+     */
+    readonly baseId: ResourceId | undefined;
+    /**
+     * {@inheritdoc Import.IImportContext.conditions}
+     */
+    readonly conditions: ReadonlyArray<IConditionDecl>;
+    /**
+     * Protected {@link Import.ImportContext | import context} for derived classes.
+     * Public consumers use {@link Import.ImportContext.create | create} to create new instances.
+     * @param baseId - The base ID for the import context.
+     * @param conditions - Conditions to be applied to resources imported in this context.
+     */
+    protected constructor({ baseId, conditions }: IImportContext);
+    /**
+     * Factory method to create a new {@link Import.ImportContext | import context}.
+     * @param context - The {@link Import.IImportContext | import context} to create
+     * the new context from.
+     * @returns `Success` with the new {@link Import.ImportContext | import context}
+     * if successful, or `Failure` with an error message if creation fails.
+     */
+    static create(context?: IImportContext): Result<ImportContext>;
+    /**
+     * Adds conditions to the import context.
+     * @param conditions - Conditions to be added to the import context.
+     * @returns `Success` with a new {@link Import.ImportContext | import context} containing the added conditions
+     * if successful, or `Failure` with an error message if the operation fails.
+     */
+    withConditions(conditions: IConditionDecl[]): Result<ImportContext>;
+    /**
+     * Appends names to the base ID of the import context.
+     * @param name - The base name to set.
+     * @returns `Success` with a new {@link Import.ImportContext | import context} containing the new base ID
+     * if successful, or `Failure` with an error message if the operation fails.
+     */
+    withName(...names: string[]): Result<ImportContext>;
+    /**
+     * Extends the import context with additional name segments and conditions.
+     * @param context - The {@link Import.IImportContext | import context} to extend this context with.
+     * @returns `Success` with a new {@link Import.ImportContext | import context}
+     * containing the extended context if successful, or `Failure` with an error
+     * message if the operation fails.
+     */
+    extend(context?: IValidatedImportContext): Result<ImportContext>;
+}
+//# sourceMappingURL=importContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"importContext.d.ts","sourceRoot":"","sources":["../../../src/packlets/import/importContext.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACrD;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,uBAAuB;IAC3D;;OAEG;IACH,SAAgB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAE/C;;OAEG;IACH,SAAgB,UAAU,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,SAAS,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,cAAc;IAK5D;;;;;;OAMG;WACW,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC;IAMrE;;;;;OAKG;IACI,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC;IAO1E;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC;IAM1D;;;;;;OAMG;IACI,MAAM,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAAC,aAAa,CAAC;CAQxE"}

package/lib/packlets/import/importContext.js

@@ -0,0 +1,94 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportContext = void 0;
+const common_1 = require("../common");
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * Class to accumulate context for a resource import operation.
+ * @public
+ */
+class ImportContext {
+    /**
+     * Protected {@link Import.ImportContext | import context} for derived classes.
+     * Public consumers use {@link Import.ImportContext.create | create} to create new instances.
+     * @param baseId - The base ID for the import context.
+     * @param conditions - Conditions to be applied to resources imported in this context.
+     */
+    constructor({ baseId, conditions }) {
+        this.baseId = common_1.Helpers.joinOptionalResourceIds(baseId).orThrow();
+        this.conditions = Array.from(conditions !== null && conditions !== void 0 ? conditions : []);
+    }
+    /**
+     * Factory method to create a new {@link Import.ImportContext | import context}.
+     * @param context - The {@link Import.IImportContext | import context} to create
+     * the new context from.
+     * @returns `Success` with the new {@link Import.ImportContext | import context}
+     * if successful, or `Failure` with an error message if creation fails.
+     */
+    static create(context) {
+        /* c8 ignore next */
+        context = context !== null && context !== void 0 ? context : { conditions: [] };
+        return (0, ts_utils_1.captureResult)(() => new ImportContext(context));
+    }
+    /**
+     * Adds conditions to the import context.
+     * @param conditions - Conditions to be added to the import context.
+     * @returns `Success` with a new {@link Import.ImportContext | import context} containing the added conditions
+     * if successful, or `Failure` with an error message if the operation fails.
+     */
+    withConditions(conditions) {
+        return ImportContext.create({
+            baseId: this.baseId,
+            conditions: [...this.conditions, ...conditions]
+        });
+    }
+    /**
+     * Appends names to the base ID of the import context.
+     * @param name - The base name to set.
+     * @returns `Success` with a new {@link Import.ImportContext | import context} containing the new base ID
+     * if successful, or `Failure` with an error message if the operation fails.
+     */
+    withName(...names) {
+        return common_1.Helpers.joinResourceIds(this.baseId, ...names).onSuccess((baseId) => {
+            return ImportContext.create({ baseId, conditions: this.conditions });
+        });
+    }
+    /**
+     * Extends the import context with additional name segments and conditions.
+     * @param context - The {@link Import.IImportContext | import context} to extend this context with.
+     * @returns `Success` with a new {@link Import.ImportContext | import context}
+     * containing the extended context if successful, or `Failure` with an error
+     * message if the operation fails.
+     */
+    extend(context) {
+        /* c8 ignore next 1 */
+        context = context !== null && context !== void 0 ? context : { conditions: [] };
+        const conditions = [...this.conditions, ...context.conditions];
+        return common_1.Helpers.joinOptionalResourceIds(this.baseId, context.baseId).onSuccess((baseId) => {
+            return ImportContext.create({ baseId, conditions });
+        });
+    }
+}
+exports.ImportContext = ImportContext;
+//# sourceMappingURL=importContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"importContext.js","sourceRoot":"","sources":["../../../src/packlets/import/importContext.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,sCAAoC;AACpC,4CAAsD;AAoCtD;;;GAGG;AACH,MAAa,aAAa;IAWxB;;;;;OAKG;IACH,YAAsB,EAAE,MAAM,EAAE,UAAU,EAAkB;QAC1D,IAAI,CAAC,MAAM,GAAG,gBAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,OAAwB;QAC3C,oBAAoB;QACpB,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACxC,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,UAA4B;QAChD,OAAO,aAAa,CAAC,MAAM,CAAC;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,KAAe;QAChC,OAAO,gBAAO,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACzE,OAAO,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,OAAiC;QAC7C,sBAAsB;QACtB,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/D,OAAO,gBAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACvF,OAAO,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA3ED,sCA2EC","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 { Helpers } from '../common';\nimport { captureResult, Result } from '@fgv/ts-utils';\nimport { IConditionDecl } from '../conditions';\nimport { ResourceId } from '../common';\n\n/**\n * Accumulated context of a resource import operation.\n * @public\n */\nexport interface IImportContext {\n  /**\n   * Base ID for the import context for resources imported\n   * in this context.\n   */\n  readonly baseId?: string;\n  /**\n   * Conditions to be applied to resources imported in this context.\n   */\n  readonly conditions?: ReadonlyArray<IConditionDecl>;\n}\n\n/**\n * Accumulated context of a resource import operation.\n * @public\n */\nexport interface IValidatedImportContext {\n  /**\n   * Base ID for the import context for resources imported\n   * in this context.\n   */\n  readonly baseId?: ResourceId;\n  /**\n   * Conditions to be applied to resources imported in this context.\n   */\n  readonly conditions: ReadonlyArray<IConditionDecl>;\n}\n\n/**\n * Class to accumulate context for a resource import operation.\n * @public\n */\nexport class ImportContext implements IValidatedImportContext {\n  /**\n   * {@inheritdoc Import.IImportContext.baseId}\n   */\n  public readonly baseId: ResourceId | undefined;\n\n  /**\n   * {@inheritdoc Import.IImportContext.conditions}\n   */\n  public readonly conditions: ReadonlyArray<IConditionDecl>;\n\n  /**\n   * Protected {@link Import.ImportContext | import context} for derived classes.\n   * Public consumers use {@link Import.ImportContext.create | create} to create new instances.\n   * @param baseId - The base ID for the import context.\n   * @param conditions - Conditions to be applied to resources imported in this context.\n   */\n  protected constructor({ baseId, conditions }: IImportContext) {\n    this.baseId = Helpers.joinOptionalResourceIds(baseId).orThrow();\n    this.conditions = Array.from(conditions ?? []);\n  }\n\n  /**\n   * Factory method to create a new {@link Import.ImportContext | import context}.\n   * @param context - The {@link Import.IImportContext | import context} to create\n   * the new context from.\n   * @returns `Success` with the new {@link Import.ImportContext | import context}\n   * if successful, or `Failure` with an error message if creation fails.\n   */\n  public static create(context?: IImportContext): Result<ImportContext> {\n    /* c8 ignore next */\n    context = context ?? { conditions: [] };\n    return captureResult(() => new ImportContext(context));\n  }\n\n  /**\n   * Adds conditions to the import context.\n   * @param conditions - Conditions to be added to the import context.\n   * @returns `Success` with a new {@link Import.ImportContext | import context} containing the added conditions\n   * if successful, or `Failure` with an error message if the operation fails.\n   */\n  public withConditions(conditions: IConditionDecl[]): Result<ImportContext> {\n    return ImportContext.create({\n      baseId: this.baseId,\n      conditions: [...this.conditions, ...conditions]\n    });\n  }\n\n  /**\n   * Appends names to the base ID of the import context.\n   * @param name - The base name to set.\n   * @returns `Success` with a new {@link Import.ImportContext | import context} containing the new base ID\n   * if successful, or `Failure` with an error message if the operation fails.\n   */\n  public withName(...names: string[]): Result<ImportContext> {\n    return Helpers.joinResourceIds(this.baseId, ...names).onSuccess((baseId) => {\n      return ImportContext.create({ baseId, conditions: this.conditions });\n    });\n  }\n\n  /**\n   * Extends the import context with additional name segments and conditions.\n   * @param context - The {@link Import.IImportContext | import context} to extend this context with.\n   * @returns `Success` with a new {@link Import.ImportContext | import context}\n   * containing the extended context if successful, or `Failure` with an error\n   * message if the operation fails.\n   */\n  public extend(context?: IValidatedImportContext): Result<ImportContext> {\n    /* c8 ignore next 1 */\n    context = context ?? { conditions: [] };\n    const conditions = [...this.conditions, ...context.conditions];\n    return Helpers.joinOptionalResourceIds(this.baseId, context.baseId).onSuccess((baseId) => {\n      return ImportContext.create({ baseId, conditions });\n    });\n  }\n}\n"]}