@fgv/ts-res 5.0.0-5 → 5.0.0-7

package/lib/packlets/resource-types/resourceType.d.ts

@@ -1,6 +1,6 @@
 import { JsonValue } from '@fgv/ts-json-base';
 import { ICollectible, Result } from '@fgv/ts-utils';
-import { ResourceTypeIndex, ResourceTypeName, ResourceValueMergeMethod, ResourceId } from '../common';
+import { CandidateCompleteness, ResourceTypeIndex, ResourceTypeName, ResourceValueMergeMethod, ResourceId } from '../common';
 /**
  * Parameters used to validate a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}.
  * @public
@@ -56,30 +56,39 @@ export declare abstract class ResourceType<T = unknown> implements ICollectible<
     /**
      * Validates a JSON value for use as a partial resource instance value.
      * @param json - The JSON value to validate.
-     * @param isPartial - `true` indicates that the value is expected to be partial.
+     * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.
      * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,
      * `Failure` with an error message otherwise.
      * @public
      */
-    abstract validate(json: JsonValue, isPartial: true): Result<Partial<T>>;
+    abstract validate(json: JsonValue, completeness: CandidateCompleteness): Result<Partial<T>>;
     /**
      * Validates a JSON value for use as a complete resource instance value.
      * @param json - The JSON value to validate.
-     * @param isPartial - `false` indicates that the value is expected to be complete.
+     * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.
      * @returns `Success` with the strongly-typed resource value if the JSON is valid,
      * `Failure` with an error message otherwise.
      * @public
      */
-    abstract validate(json: JsonValue, isPartial: false): Result<T>;
+    abstract validate(json: JsonValue, completeness: 'full'): Result<T>;
+    /**
+     * Validates a JSON value for use as a partial resource instance value.
+     * @param json - The JSON value to validate.
+     * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.
+     * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,
+     * `Failure` with an error message otherwise.
+     * @public
+     */
+    abstract validate(json: JsonValue, completeness: 'partial'): Result<Partial<T>>;
     /**
      * Validates a JSON value for use as a full or partial resource instance value.
      * @param json - The JSON value to validate.
-     * @param isPartial - Indicates whether the value is expected to be partial.
+     * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.
      * @returns `Success` with the strongly-typed full or partial resource value if
      * the JSON is valid, `Failure` with an error message otherwise.
      * @public
      */
-    abstract validate(json: JsonValue, isPartial?: boolean): Result<T | Partial<T>>;
+    abstract validate(json: JsonValue, completeness?: CandidateCompleteness): Result<T | Partial<T>>;
     /**
      * Sets the index for this resource type.  Once set, the index cannot be changed.
      */

package/lib/packlets/resource-types/resourceType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceType.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceType.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAGL,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,UAAU,EACX,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,WAAW,sCAAsC;IACrD;;;OAGG;IACH,EAAE,EAAE,UAAU,CAAC;IAEf;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,wBAAwB,CAAC;CACvC;AAED;;;;;GAKG;AACH,8BAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,YAAY,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC1G,OAAO,CAAC,YAAY,CAA+D;IACnF;;OAEG;IACH,IAAW,GAAG,IAAI,gBAAgB,CAEjC;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,iBAAiB,GAAG,SAAS,CAEhD;IAED,SAAS,aAAa,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM;IAS3D;;;;;;;OAOG;aACa,mBAAmB,CAAC,KAAK,EAAE,sCAAsC,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1G;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9E;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;IAEtE;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtF;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;CAG1D"}
+{"version":3,"file":"resourceType.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceType.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,qBAAqB,EAGrB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,UAAU,EACX,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,WAAW,sCAAsC;IACrD;;;OAGG;IACH,EAAE,EAAE,UAAU,CAAC;IAEf;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,wBAAwB,CAAC;CACvC;AAED;;;;;GAKG;AACH,8BAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,YAAY,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC1G,OAAO,CAAC,YAAY,CAA+D;IACnF;;OAEG;IACH,IAAW,GAAG,IAAI,gBAAgB,CAEjC;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,iBAAiB,GAAG,SAAS,CAEhD;IAED,SAAS,aAAa,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM;IAS3D;;;;;;;OAOG;aACa,mBAAmB,CAAC,KAAK,EAAE,sCAAsC,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1G;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,qBAAqB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAElG;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAE1E;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtF;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEvG;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;CAG1D"}

package/lib/packlets/resource-types/resourceType.js.map

@@ -1 +1 @@
-{"version":3,"file":"resourceType.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceType.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAGH,4CAAkE;AAClE,sCAOmB;AAgCnB;;;;;GAKG;AACH,MAAsB,YAAY;IAEhC;;OAEG;IACH,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,YAAsB,GAAqB,EAAE,KAAc;QACzD,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAW,CAAC,WAAW,CAAsC;YACnF,GAAG;YACH,qDAAqD;YACrD,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;YACtF,cAAc,EAAE,gBAAa,CAAC,iBAAiB;SAChD,CAAC,CAAC;IACL,CAAC;IA0CD;;OAEG;IACI,QAAQ,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAvED,oCAuEC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonValue } from '@fgv/ts-json-base';\nimport { Collections, ICollectible, Result } from '@fgv/ts-utils';\nimport {\n  Convert as CommonConvert,\n  Validate,\n  ResourceTypeIndex,\n  ResourceTypeName,\n  ResourceValueMergeMethod,\n  ResourceId\n} from '../common';\n\n/**\n * Parameters used to validate a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}.\n * @public\n */\nexport interface IResourceCandidateValidationProperties {\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.id}\n   * @public\n   */\n  id: ResourceId;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.isPartial}\n   * @public\n   */\n  isPartial: boolean;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.json}\n   * @public\n   */\n  json: JsonValue;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.mergeMethod}\n   * @public\n   */\n  mergeMethod: ResourceValueMergeMethod;\n}\n\n/**\n * Abstract base class for resource types which are responsible for\n * validating and converting JSON values into the appropriate strongly-typed\n * resource value.\n * @public\n */\nexport abstract class ResourceType<T = unknown> implements ICollectible<ResourceTypeName, ResourceTypeIndex> {\n  private _collectible: Collections.Collectible<ResourceTypeName, ResourceTypeIndex>;\n  /**\n   * The key for this resource type.\n   */\n  public get key(): ResourceTypeName {\n    return this._collectible.key;\n  }\n\n  /**\n   * The index for this resource type.\n   */\n  public get index(): ResourceTypeIndex | undefined {\n    return this._collectible.index;\n  }\n\n  protected constructor(key: ResourceTypeName, index?: number) {\n    this._collectible = new Collections.Collectible<ResourceTypeName, ResourceTypeIndex>({\n      key,\n      /* c8 ignore next 1 - coverage having a rough time */\n      index: index !== undefined ? Validate.toResourceTypeIndex(index).orThrow() : undefined,\n      indexConverter: CommonConvert.resourceTypeIndex\n    });\n  }\n\n  /**\n   * Validates properties of a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for\n   * a resource instance value.\n   * @param props - The {@link ResourceTypes.IResourceCandidateValidationProperties | properties } to validate.\n   * @returns `Success` with the strongly-typed resource value if the JSON and merge method\n   * are valid, `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validateDeclaration(props: IResourceCandidateValidationProperties): Result<T | Partial<T>>;\n\n  /**\n   * Validates a JSON value for use as a partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param isPartial - `true` indicates that the value is expected to be partial.\n   * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, isPartial: true): Result<Partial<T>>;\n\n  /**\n   * Validates a JSON value for use as a complete resource instance value.\n   * @param json - The JSON value to validate.\n   * @param isPartial - `false` indicates that the value is expected to be complete.\n   * @returns `Success` with the strongly-typed resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, isPartial: false): Result<T>;\n\n  /**\n   * Validates a JSON value for use as a full or partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param isPartial - Indicates whether the value is expected to be partial.\n   * @returns `Success` with the strongly-typed full or partial resource value if\n   * the JSON is valid, `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, isPartial?: boolean): Result<T | Partial<T>>;\n\n  /**\n   * Sets the index for this resource type.  Once set, the index cannot be changed.\n   */\n  public setIndex(index: number): Result<ResourceTypeIndex> {\n    return this._collectible.setIndex(index);\n  }\n}\n"]}
+{"version":3,"file":"resourceType.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceType.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAGH,4CAAkE;AAClE,sCAQmB;AAgCnB;;;;;GAKG;AACH,MAAsB,YAAY;IAEhC;;OAEG;IACH,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,YAAsB,GAAqB,EAAE,KAAc;QACzD,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAW,CAAC,WAAW,CAAsC;YACnF,GAAG;YACH,qDAAqD;YACrD,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;YACtF,cAAc,EAAE,gBAAa,CAAC,iBAAiB;SAChD,CAAC,CAAC;IACL,CAAC;IAoDD;;OAEG;IACI,QAAQ,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAjFD,oCAiFC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonValue } from '@fgv/ts-json-base';\nimport { Collections, ICollectible, Result } from '@fgv/ts-utils';\nimport {\n  CandidateCompleteness,\n  Convert as CommonConvert,\n  Validate,\n  ResourceTypeIndex,\n  ResourceTypeName,\n  ResourceValueMergeMethod,\n  ResourceId\n} from '../common';\n\n/**\n * Parameters used to validate a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}.\n * @public\n */\nexport interface IResourceCandidateValidationProperties {\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.id}\n   * @public\n   */\n  id: ResourceId;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.isPartial}\n   * @public\n   */\n  isPartial: boolean;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.json}\n   * @public\n   */\n  json: JsonValue;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.mergeMethod}\n   * @public\n   */\n  mergeMethod: ResourceValueMergeMethod;\n}\n\n/**\n * Abstract base class for resource types which are responsible for\n * validating and converting JSON values into the appropriate strongly-typed\n * resource value.\n * @public\n */\nexport abstract class ResourceType<T = unknown> implements ICollectible<ResourceTypeName, ResourceTypeIndex> {\n  private _collectible: Collections.Collectible<ResourceTypeName, ResourceTypeIndex>;\n  /**\n   * The key for this resource type.\n   */\n  public get key(): ResourceTypeName {\n    return this._collectible.key;\n  }\n\n  /**\n   * The index for this resource type.\n   */\n  public get index(): ResourceTypeIndex | undefined {\n    return this._collectible.index;\n  }\n\n  protected constructor(key: ResourceTypeName, index?: number) {\n    this._collectible = new Collections.Collectible<ResourceTypeName, ResourceTypeIndex>({\n      key,\n      /* c8 ignore next 1 - coverage having a rough time */\n      index: index !== undefined ? Validate.toResourceTypeIndex(index).orThrow() : undefined,\n      indexConverter: CommonConvert.resourceTypeIndex\n    });\n  }\n\n  /**\n   * Validates properties of a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for\n   * a resource instance value.\n   * @param props - The {@link ResourceTypes.IResourceCandidateValidationProperties | properties } to validate.\n   * @returns `Success` with the strongly-typed resource value if the JSON and merge method\n   * are valid, `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validateDeclaration(props: IResourceCandidateValidationProperties): Result<T | Partial<T>>;\n\n  /**\n   * Validates a JSON value for use as a partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.\n   * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, completeness: CandidateCompleteness): Result<Partial<T>>;\n\n  /**\n   * Validates a JSON value for use as a complete resource instance value.\n   * @param json - The JSON value to validate.\n   * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.\n   * @returns `Success` with the strongly-typed resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, completeness: 'full'): Result<T>;\n\n  /**\n   * Validates a JSON value for use as a partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.\n   * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, completeness: 'partial'): Result<Partial<T>>;\n\n  /**\n   * Validates a JSON value for use as a full or partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.\n   * @returns `Success` with the strongly-typed full or partial resource value if\n   * the JSON is valid, `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, completeness?: CandidateCompleteness): Result<T | Partial<T>>;\n\n  /**\n   * Sets the index for this resource type.  Once set, the index cannot be changed.\n   */\n  public setIndex(index: number): Result<ResourceTypeIndex> {\n    return this._collectible.setIndex(index);\n  }\n}\n"]}

package/lib/packlets/resources/common.d.ts

@@ -57,4 +57,16 @@ export interface ICompiledResourceOptionsWithFilter extends ResourceJson.Compile
      */
     filterForContext?: IValidatedContextDecl;
 }
+/**
+ * Options for ResourceManagerBuilder clone operations.
+ * Extends IDeclarationOptions to include support for applying edits when cloning.
+ * @public
+ */
+export interface IResourceManagerCloneOptions extends IResourceDeclarationOptions {
+    /**
+     * Optional array of loose condition declarations to be applied as edits during the clone operation.
+     * These conditions can modify or extend the resource candidates in the cloned manager.
+     */
+    readonly candidates?: ReadonlyArray<ResourceJson.Json.ILooseResourceCandidateDecl>;
+}
 //# sourceMappingURL=common.d.ts.map

package/lib/packlets/resources/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/common.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,2BAA4B,SAAQ,YAAY,CAAC,OAAO,CAAC,mBAAmB;IAC3F;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IAEzC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kCAAmC,SAAQ,YAAY,CAAC,QAAQ,CAAC,wBAAwB;IACxG;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/common.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,2BAA4B,SAAQ,YAAY,CAAC,OAAO,CAAC,mBAAmB;IAC3F;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IAEzC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kCAAmC,SAAQ,YAAY,CAAC,QAAQ,CAAC,wBAAwB;IACxG;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA6B,SAAQ,2BAA2B;IAC/E;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;CACpF"}

package/lib/packlets/resources/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/packlets/resources/common.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 * as ResourceJson from '../resource-json';\nimport { IValidatedContextDecl } from '../context';\n\n/**\n * Options for resource declaration operations with strongly-typed context filtering.\n * Extends the base IDeclarationOptions with proper type safety for context filtering.\n *\n * @example\n * ```typescript\n * // Preferred Result pattern with onSuccess chaining\n * resourceManager.validateContext({ language: 'en' })\n *   .onSuccess((validatedContext) => {\n *     return resourceManager.clone({ filterForContext: validatedContext });\n *   })\n *   .onSuccess((clonedManager) => {\n *     return clonedManager.getResourceCollectionDecl();\n *   })\n *   .onFailure((error) => {\n *     console.error('Failed to create filtered clone:', error);\n *   });\n * ```\n * @public\n */\nexport interface IResourceDeclarationOptions extends ResourceJson.Helpers.IDeclarationOptions {\n  /**\n   * If provided, filters resource candidates to only include those that can match the\n   * specified validated context. This provides strongly-typed context filtering.\n   *\n   * Use resourceManager.validateContext() to create a validated context from an IContextDecl.\n   */\n  filterForContext?: IValidatedContextDecl;\n\n  /**\n   * If true, reduces the qualifiers of the resource candidates by removing qualifiers that are made\n   * irrelevant by the filterForContext.\n   * @defaultValue false\n   */\n  reduceQualifiers?: boolean;\n\n  /**\n   * Whether to include metadata in compiled outputs.\n   * Metadata includes human-readable information like semantic keys\n   * that can be useful for debugging or tooling.\n   * @defaultValue false\n   */\n  includeMetadata?: boolean;\n}\n\n/**\n * Extended compiled resource options that includes context filtering capabilities.\n * This interface combines the standard compilation options with strongly-typed\n * context filtering for resource candidates.\n * @public\n */\nexport interface ICompiledResourceOptionsWithFilter extends ResourceJson.Compiled.ICompiledResourceOptions {\n  /**\n   * If provided, filters resource candidates to only include those that can match the\n   * specified validated context. This provides strongly-typed context filtering.\n   *\n   * Use resourceManager.validateContext() to create a validated context from an IContextDecl.\n   */\n  filterForContext?: IValidatedContextDecl;\n}\n"]}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/packlets/resources/common.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 * as ResourceJson from '../resource-json';\nimport { IValidatedContextDecl } from '../context';\n\n/**\n * Options for resource declaration operations with strongly-typed context filtering.\n * Extends the base IDeclarationOptions with proper type safety for context filtering.\n *\n * @example\n * ```typescript\n * // Preferred Result pattern with onSuccess chaining\n * resourceManager.validateContext({ language: 'en' })\n *   .onSuccess((validatedContext) => {\n *     return resourceManager.clone({ filterForContext: validatedContext });\n *   })\n *   .onSuccess((clonedManager) => {\n *     return clonedManager.getResourceCollectionDecl();\n *   })\n *   .onFailure((error) => {\n *     console.error('Failed to create filtered clone:', error);\n *   });\n * ```\n * @public\n */\nexport interface IResourceDeclarationOptions extends ResourceJson.Helpers.IDeclarationOptions {\n  /**\n   * If provided, filters resource candidates to only include those that can match the\n   * specified validated context. This provides strongly-typed context filtering.\n   *\n   * Use resourceManager.validateContext() to create a validated context from an IContextDecl.\n   */\n  filterForContext?: IValidatedContextDecl;\n\n  /**\n   * If true, reduces the qualifiers of the resource candidates by removing qualifiers that are made\n   * irrelevant by the filterForContext.\n   * @defaultValue false\n   */\n  reduceQualifiers?: boolean;\n\n  /**\n   * Whether to include metadata in compiled outputs.\n   * Metadata includes human-readable information like semantic keys\n   * that can be useful for debugging or tooling.\n   * @defaultValue false\n   */\n  includeMetadata?: boolean;\n}\n\n/**\n * Extended compiled resource options that includes context filtering capabilities.\n * This interface combines the standard compilation options with strongly-typed\n * context filtering for resource candidates.\n * @public\n */\nexport interface ICompiledResourceOptionsWithFilter extends ResourceJson.Compiled.ICompiledResourceOptions {\n  /**\n   * If provided, filters resource candidates to only include those that can match the\n   * specified validated context. This provides strongly-typed context filtering.\n   *\n   * Use resourceManager.validateContext() to create a validated context from an IContextDecl.\n   */\n  filterForContext?: IValidatedContextDecl;\n}\n\n/**\n * Options for ResourceManagerBuilder clone operations.\n * Extends IDeclarationOptions to include support for applying edits when cloning.\n * @public\n */\nexport interface IResourceManagerCloneOptions extends IResourceDeclarationOptions {\n  /**\n   * Optional array of loose condition declarations to be applied as edits during the clone operation.\n   * These conditions can modify or extend the resource candidates in the cloned manager.\n   */\n  readonly candidates?: ReadonlyArray<ResourceJson.Json.ILooseResourceCandidateDecl>;\n}\n"]}

package/lib/packlets/resources/resourceManagerBuilder.d.ts

@@ -8,9 +8,10 @@ import { IResourceManager } from '../runtime';
 import { ResourceBuilder, ResourceBuilderResultDetail } from './resourceBuilder';
 import { Resource } from './resource';
 import { ResourceCandidate } from './resourceCandidate';
-import { IResourceDeclarationOptions } from './common';
+import { IResourceDeclarationOptions, IResourceManagerCloneOptions } from './common';
 import * as ResourceJson from '../resource-json';
 import * as Context from '../context';
+import * as Config from '../config';
 /**
  * Interface for parameters to the {@link Resources.ResourceManagerBuilder.create | ResourceManagerBuilder create method}.
  * @public
@@ -96,6 +97,15 @@ export declare class ResourceManagerBuilder implements IResourceManager {
      * @public
      */
     static create(params: IResourceManagerBuilderCreateParams): Result<ResourceManagerBuilder>;
+    /**
+     * Creates a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object from a predefined system configuration.
+     * @param name - The name of the predefined system configuration to use.
+     * @param qualifierDefaultValues - Optional default values for qualifiers.
+     * @returns `Success` with the new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static createPredefined(name: Config.PredefinedSystemConfiguration, qualifierDefaultValues?: Config.ISystemConfigurationInitParams['qualifierDefaultValues']): Result<ResourceManagerBuilder>;
     /**
      * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds
      * a {@link Resources.ResourceCandidate | candidate} to the manager.
@@ -211,10 +221,47 @@ export declare class ResourceManagerBuilder implements IResourceManager {
      * Creates a filtered clone of this ResourceManagerBuilder using the specified context.
      * This is a convenience method that creates a new ResourceManagerBuilder with the same
      * configuration but filtered to include only candidates that match the provided context.
-     * @param options - Options for the cloning operation, including the strongly-typed filterForContext property.
+     * If candidates are provided for editing, they will be applied with collision detection.
+     * @param options - Options for the cloning operation, including the strongly-typed filterForContext property and optional candidates for edits.
      * @returns A Result containing the new filtered ResourceManagerBuilder.
      * @public
      */
-    clone(options?: IResourceDeclarationOptions): Result<ResourceManagerBuilder>;
+    clone(options?: IResourceManagerCloneOptions): Result<ResourceManagerBuilder>;
+    /**
+     * Creates a resource ID keyed map from an array of loose resource candidate declarations.
+     * This enables efficient detection of edit collisions by grouping candidates by their target resource.
+     * @param candidates - Array of loose resource candidate declarations to organize
+     * @returns A Result containing a Map where keys are validated ResourceIds and values are arrays of candidates for that resource
+     * @internal
+     */
+    private static _createCandidatesByResourceMap;
+    /**
+     * Generates a proper ConditionSet token for collision detection using the existing ConditionSet.getKeyForDecl method.
+     * @param conditionSet - The condition set to generate a token for
+     * @param conditionCollector - The condition collector needed for validation context
+     * @returns A Result containing the ConditionSet token if successful, or failure if validation fails
+     * @internal
+     */
+    private static _getConditionSetToken;
+    /**
+     * Applies candidate edits to a resource declaration, handling collisions using condition set tokens.
+     * If there's no collision, adds the candidate. If there's a collision, replaces the original candidate with the edit.
+     * @param resourceDecl - The original resource declaration to potentially modify
+     * @param candidatesByResource - Map of resource IDs to arrays of candidate edits
+     * @param conditionCollector - The condition collector needed for generating condition tokens
+     * @returns A Result containing the resource declaration to use (original or modified)
+     * @internal
+     */
+    private static _applyEditsToResourceDeclaration;
+    /**
+     * Creates a new resource declaration from an array of candidate declarations.
+     * This is used when cloning to create new resources that don't exist in the original manager.
+     * @param resourceId - The validated resource ID for the new resource
+     * @param candidates - Array of loose candidate declarations for the new resource
+     * @param conditionCollector - The condition collector for validation context
+     * @returns A Result containing the new resource declaration if successful, or failure if validation fails
+     * @internal
+     */
+    private static _createResourceDeclFromCandidates;
 }
 //# sourceMappingURL=resourceManagerBuilder.d.ts.map

package/lib/packlets/resources/resourceManagerBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceManagerBuilder.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resourceManagerBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resourceManagerBuilder.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resourceManagerBuilder.ts"],"names":[],"mappings":"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"}

package/lib/packlets/resources/resourceManagerBuilder.js

@@ -63,6 +63,7 @@ const resourceBuilder_1 = require("./resourceBuilder");
 const resource_1 = require("./resource");
 const ResourceJson = __importStar(require("../resource-json"));
 const Context = __importStar(require("../context"));
+const Config = __importStar(require("../config"));
 /**
  * Builder for a collection of {@link Resources.Resource | resources}. Collects
  * {@link Resources.ResourceCandidate | candidates} for each resource into a
@@ -165,6 +166,22 @@ class ResourceManagerBuilder {
     static create(params) {
         return (0, ts_utils_1.captureResult)(() => new ResourceManagerBuilder(params));
     }
+    /**
+     * Creates a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object from a predefined system configuration.
+     * @param name - The name of the predefined system configuration to use.
+     * @param qualifierDefaultValues - Optional default values for qualifiers.
+     * @returns `Success` with the new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static createPredefined(name, qualifierDefaultValues) {
+        return Config.getPredefinedSystemConfiguration(name, qualifierDefaultValues ? { qualifierDefaultValues } : undefined).onSuccess((systemConfig) => {
+            return ResourceManagerBuilder.create({
+                qualifiers: systemConfig.qualifiers,
+                resourceTypes: systemConfig.resourceTypes
+            });
+        });
+    }
     /**
      * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds
      * a {@link Resources.ResourceCandidate | candidate} to the manager.
@@ -422,7 +439,8 @@ class ResourceManagerBuilder {
      * Creates a filtered clone of this ResourceManagerBuilder using the specified context.
      * This is a convenience method that creates a new ResourceManagerBuilder with the same
      * configuration but filtered to include only candidates that match the provided context.
-     * @param options - Options for the cloning operation, including the strongly-typed filterForContext property.
+     * If candidates are provided for editing, they will be applied with collision detection.
+     * @param options - Options for the cloning operation, including the strongly-typed filterForContext property and optional candidates for edits.
      * @returns A Result containing the new filtered ResourceManagerBuilder.
      * @public
      */
@@ -433,19 +451,196 @@ class ResourceManagerBuilder {
                 qualifiers: this.qualifiers,
                 resourceTypes: this.resourceTypes
             }).onSuccess((newManager) => {
-                // Add each resource from the filtered collection to the new manager
-                if (collection.resources) {
-                    for (const resourceDecl of collection.resources) {
-                        const addResult = newManager.addResource(resourceDecl);
-                        if (addResult.isFailure()) {
-                            return (0, ts_utils_1.fail)(`${resourceDecl.id}: Failed to add resource to cloned manager: ${addResult.message}`);
+                // Check if we have candidates to apply as edits
+                const editCandidates = (options === null || options === void 0 ? void 0 : options.candidates) || [];
+                const candidatesByResourceResult = editCandidates.length > 0
+                    ? ResourceManagerBuilder._createCandidatesByResourceMap(editCandidates)
+                    : (0, ts_utils_1.succeed)(new Map());
+                return candidatesByResourceResult.onSuccess((candidatesByResource) => {
+                    // Track which resource IDs have been processed from the original collection
+                    const processedResourceIds = new Set();
+                    // Add each resource from the filtered collection to the new manager
+                    if (collection.resources) {
+                        for (const resourceDecl of collection.resources) {
+                            processedResourceIds.add(resourceDecl.id);
+                            // Apply edits if there are candidates for this resource
+                            const editedDeclResult = ResourceManagerBuilder._applyEditsToResourceDeclaration(resourceDecl, candidatesByResource, this._conditions);
+                            if (editedDeclResult.isFailure()) {
+                                return (0, ts_utils_1.fail)(`${resourceDecl.id}: Failed to apply edits: ${editedDeclResult.message}`);
+                            }
+                            const addResult = newManager.addResource(editedDeclResult.value);
+                            if (addResult.isFailure()) {
+                                return (0, ts_utils_1.fail)(`${resourceDecl.id}: Failed to add resource to cloned manager: ${addResult.message}`);
+                            }
+                        }
+                    }
+                    // Handle any remaining candidates that target new resources not in the original collection
+                    const errors = new ts_utils_1.MessageAggregator();
+                    for (const [resourceId, candidates] of candidatesByResource) {
+                        if (!processedResourceIds.has(resourceId)) {
+                            // Create a new resource declaration for candidates targeting a new resource ID
+                            ResourceManagerBuilder._createResourceDeclFromCandidates(resourceId, candidates, this._conditions)
+                                .withErrorFormat((e) => `${resourceId}: Failed to create new resource from candidates: ${e}`)
+                                .onSuccess((newResourceDecl) => {
+                                return newManager
+                                    .addResource(newResourceDecl)
+                                    .withErrorFormat((e) => `${resourceId}: Failed to add new resource to cloned manager: ${e}`);
+                            })
+                                .aggregateError(errors);
                         }
                     }
+                    return errors.returnOrReport((0, ts_utils_1.succeed)(newManager));
+                });
+            });
+        });
+    }
+    /**
+     * Creates a resource ID keyed map from an array of loose resource candidate declarations.
+     * This enables efficient detection of edit collisions by grouping candidates by their target resource.
+     * @param candidates - Array of loose resource candidate declarations to organize
+     * @returns A Result containing a Map where keys are validated ResourceIds and values are arrays of candidates for that resource
+     * @internal
+     */
+    static _createCandidatesByResourceMap(candidates) {
+        const candidatesByResource = new Map();
+        for (const candidate of candidates) {
+            const { value: resourceId, message } = common_1.Validate.toResourceId(candidate.id);
+            if (message !== undefined) {
+                return (0, ts_utils_1.fail)(`Invalid resource ID "${candidate.id}": ${message}`);
+            }
+            const existingCandidates = candidatesByResource.get(resourceId);
+            if (existingCandidates) {
+                existingCandidates.push(candidate);
+            }
+            else {
+                candidatesByResource.set(resourceId, [candidate]);
+            }
+        }
+        return (0, ts_utils_1.succeed)(candidatesByResource);
+    }
+    /**
+     * Generates a proper ConditionSet token for collision detection using the existing ConditionSet.getKeyForDecl method.
+     * @param conditionSet - The condition set to generate a token for
+     * @param conditionCollector - The condition collector needed for validation context
+     * @returns A Result containing the ConditionSet token if successful, or failure if validation fails
+     * @internal
+     */
+    static _getConditionSetToken(conditionSet, conditionCollector) {
+        if (!conditionSet) {
+            return (0, ts_utils_1.succeed)(conditions_1.ConditionSet.UnconditionalKey);
+        }
+        // Convert ConditionSetDecl to IConditionSetDecl format
+        let conditionSetDecl;
+        if (Array.isArray(conditionSet)) {
+            // ConditionSetDeclAsArray: array of ILooseConditionDecl
+            conditionSetDecl = { conditions: conditionSet };
+        }
+        else {
+            // ConditionSetDeclAsRecord: Record<string, string | IChildConditionDecl>
+            const conditions = Object.entries(conditionSet).map(([qualifierName, value]) => {
+                if (typeof value === 'string') {
+                    return { qualifierName, value };
+                }
+                else {
+                    return Object.assign({ qualifierName }, value);
                 }
-                return (0, ts_utils_1.succeed)(newManager);
             });
+            conditionSetDecl = { conditions };
+        }
+        // Validate and convert to IValidatedConditionSetDecl
+        return conditions_1.Convert.validatedConditionSetDecl
+            .convert(conditionSetDecl, { conditions: conditionCollector })
+            .onSuccess((validatedDecl) => {
+            // Use proper ConditionSet.getKeyForDecl method to generate the token
+            return conditions_1.ConditionSet.getKeyForDecl(validatedDecl);
         });
     }
+    /**
+     * Applies candidate edits to a resource declaration, handling collisions using condition set tokens.
+     * If there's no collision, adds the candidate. If there's a collision, replaces the original candidate with the edit.
+     * @param resourceDecl - The original resource declaration to potentially modify
+     * @param candidatesByResource - Map of resource IDs to arrays of candidate edits
+     * @param conditionCollector - The condition collector needed for generating condition tokens
+     * @returns A Result containing the resource declaration to use (original or modified)
+     * @internal
+     */
+    static _applyEditsToResourceDeclaration(resourceDecl, candidatesByResource, conditionCollector) {
+        const { value: resourceId, message } = common_1.Validate.toResourceId(resourceDecl.id);
+        if (message !== undefined) {
+            return (0, ts_utils_1.fail)(`Invalid resource ID "${resourceDecl.id}": ${message}`);
+        }
+        const editCandidates = candidatesByResource.get(resourceId);
+        if (!editCandidates || editCandidates.length === 0) {
+            return (0, ts_utils_1.succeed)(resourceDecl);
+        }
+        // Use Map approach: apply original candidates first, then replace with edits on collision
+        const candidatesByConditionKey = new Map();
+        // First, add all original candidates keyed by their condition set token
+        for (const candidate of resourceDecl.candidates || []) {
+            const conditionTokenResult = ResourceManagerBuilder._getConditionSetToken(candidate.conditions, conditionCollector);
+            if (conditionTokenResult.isFailure()) {
+                return (0, ts_utils_1.fail)(`Failed to generate condition token for original candidate: ${conditionTokenResult.message}`);
+            }
+            candidatesByConditionKey.set(conditionTokenResult.value, candidate);
+        }
+        // Then, apply edits (this replaces any colliding original candidates)
+        // Convert edit candidates (which have ids) to child candidates (without ids) for merging
+        for (const editCandidate of editCandidates) {
+            const conditionTokenResult = ResourceManagerBuilder._getConditionSetToken(editCandidate.conditions, conditionCollector);
+            if (conditionTokenResult.isFailure()) {
+                return (0, ts_utils_1.fail)(`Failed to generate condition token for edit candidate: ${conditionTokenResult.message}`);
+            }
+            const childCandidate = {
+                json: editCandidate.json,
+                conditions: editCandidate.conditions,
+                isPartial: editCandidate.isPartial,
+                mergeMethod: editCandidate.mergeMethod
+            };
+            candidatesByConditionKey.set(conditionTokenResult.value, childCandidate);
+        }
+        // Extract the final merged candidate list
+        const mergedCandidates = Array.from(candidatesByConditionKey.values());
+        const modifiedDecl = Object.assign(Object.assign({}, resourceDecl), { candidates: mergedCandidates });
+        return (0, ts_utils_1.succeed)(modifiedDecl);
+    }
+    /**
+     * Creates a new resource declaration from an array of candidate declarations.
+     * This is used when cloning to create new resources that don't exist in the original manager.
+     * @param resourceId - The validated resource ID for the new resource
+     * @param candidates - Array of loose candidate declarations for the new resource
+     * @param conditionCollector - The condition collector for validation context
+     * @returns A Result containing the new resource declaration if successful, or failure if validation fails
+     * @internal
+     */
+    static _createResourceDeclFromCandidates(resourceId, candidates, conditionCollector) {
+        // Convert candidate declarations to child candidate declarations
+        const childCandidates = [];
+        // Ensure we have candidates
+        if (candidates.length === 0) {
+            return (0, ts_utils_1.fail)('Cannot create resource declaration from empty candidates array');
+        }
+        // Extract resourceTypeName from the first candidate (all candidates for the same resource should have the same type)
+        const resourceTypeName = candidates[0].resourceTypeName;
+        if (!resourceTypeName) {
+            return (0, ts_utils_1.fail)('resourceTypeName is required for new resource candidates');
+        }
+        for (const candidate of candidates) {
+            const childCandidate = {
+                json: candidate.json,
+                conditions: candidate.conditions,
+                isPartial: candidate.isPartial,
+                mergeMethod: candidate.mergeMethod
+            };
+            childCandidates.push(childCandidate);
+        }
+        // Create the new resource declaration
+        const newResourceDecl = {
+            id: resourceId,
+            candidates: childCandidates,
+            resourceTypeName
+        };
+        return (0, ts_utils_1.succeed)(newResourceDecl);
+    }
 }
 exports.ResourceManagerBuilder = ResourceManagerBuilder;
 //# sourceMappingURL=resourceManagerBuilder.js.map