@fgv/ts-res 4.5.0-2 → 5.0.0-0

package/lib/packlets/resource-types/index.js

@@ -31,11 +31,37 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     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;
+    };
+})();
 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 });
+exports.Config = void 0;
+const Config = __importStar(require("./config"));
+exports.Config = Config;
 __exportStar(require("./resourceType"), exports);
 __exportStar(require("./resourceTypeCollector"), exports);
 __exportStar(require("./jsonResourceType"), exports);
+__exportStar(require("./helpers"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,0DAAwC;AACxC,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 './resourceType';\nexport * from './resourceTypeCollector';\nexport * from './jsonResourceType';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAAmC;AAO1B,wBAAM;AALf,iDAA+B;AAC/B,0DAAwC;AACxC,qDAAmC;AACnC,4CAA0B","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 Config from './config';\n\nexport * from './resourceType';\nexport * from './resourceTypeCollector';\nexport * from './jsonResourceType';\nexport * from './helpers';\n\nexport { Config };\n"]}

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

@@ -1,6 +1,6 @@
-import { JsonObject, JsonValue } from '@fgv/ts-json-base';
-import { ResourceType } from './resourceType';
-import { ResourceTypeName, ResourceValueMergeMethod } from '../common';
+import { JsonObject } from '@fgv/ts-json-base';
+import { IResourceCandidateValidationProperties, ResourceType } from './resourceType';
+import { ResourceTypeName } from '../common';
 import { Result } from '@fgv/ts-utils';
 /**
  * Parameters to create a {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.
@@ -38,17 +38,9 @@ export declare class JsonResourceType extends ResourceType<JsonObject> {
      */
     static create(params?: IJsonResourceTypeCreateParams): Result<JsonResourceType>;
     /**
-     * {@inheritdoc ResourceTypes.ResourceType.(validateDeclaration:1)}
+     * {@inheritdoc ResourceTypes.ResourceType.validateDeclaration}
      */
-    validateDeclaration(json: JsonValue, isPartial: true, mergeMethod?: ResourceValueMergeMethod): Result<Partial<JsonObject>>;
-    /**
-     * {@inheritdoc ResourceTypes.ResourceType.(validateDeclaration:2)}
-     */
-    validateDeclaration(json: JsonValue, isPartial: false, mergeMethod?: ResourceValueMergeMethod): Result<JsonObject>;
-    /**
-     * {@inheritdoc ResourceTypes.ResourceType.(validateDeclaration:3)}
-     */
-    validateDeclaration(json: JsonValue, isPartial: boolean, mergeMethod?: ResourceValueMergeMethod): Result<JsonObject | Partial<JsonObject>>;
+    validateDeclaration(props: IResourceCandidateValidationProperties): Result<JsonObject>;
     /**
      * {@inheritdoc ResourceTypes.ResourceType.(validate:1)}
      */

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

@@ -1 +1 @@
-{"version":3,"file":"jsonResourceType.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/jsonResourceType.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgC,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAW,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,UAAU,CAAC;IAC5D;;;;;OAKG;IACH,SAAS,aAAa,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM;IAI3D;;;;;OAKG;WACW,MAAM,CAAC,MAAM,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAMtF;;OAEG;IACI,mBAAmB,CACxB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,IAAI,EACf,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B;;OAEG;IACI,mBAAmB,CACxB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,KAAK,EAChB,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,UAAU,CAAC;IACrB;;OAEG;IACI,mBAAmB,CACxB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,OAAO,EAClB,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAS3C;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;IACtE;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IACvE;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC;CAI1E"}
+{"version":3,"file":"jsonResourceType.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/jsonResourceType.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgC,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,sCAAsC,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAW,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,UAAU,CAAC;IAC5D;;;;;OAKG;IACH,SAAS,aAAa,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM;IAI3D;;;;;OAKG;WACW,MAAM,CAAC,MAAM,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAMtF;;OAEG;IAEI,mBAAmB,CAAC,KAAK,EAAE,sCAAsC,GAAG,MAAM,CAAC,UAAU,CAAC;IAI7F;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;IACtE;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IACvE;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC;CAI1E"}

package/lib/packlets/resource-types/jsonResourceType.js

@@ -52,8 +52,11 @@ class JsonResourceType extends resourceType_1.ResourceType {
             return (0, ts_utils_1.captureResult)(() => new JsonResourceType(key, params === null || params === void 0 ? void 0 : params.index));
         });
     }
-    validateDeclaration(json, __isPartial, __mergeMethod) {
-        return ts_json_base_1.Converters.jsonObject.convert(json);
+    /**
+     * {@inheritdoc ResourceTypes.ResourceType.validateDeclaration}
+     */
+    validateDeclaration(props) {
+        return ts_json_base_1.Converters.jsonObject.convert(props.json);
     }
     validate(json, __isPartial) {
         return ts_json_base_1.Converters.jsonObject.convert(json);

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

@@ -1 +1 @@
-{"version":3,"file":"jsonResourceType.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/jsonResourceType.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,oDAAwF;AACxF,iDAA8C;AAC9C,sCAAgF;AAChF,4CAAsD;AAoBtD;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,2BAAwB;IAC5D;;;;;OAKG;IACH,YAAsB,GAAqB,EAAE,KAAc;QACzD,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,MAAsC;;QACzD,OAAO,gBAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,mCAAI,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/E,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IA0BM,mBAAmB,CACxB,IAAe,EACf,WAAoB,EACpB,aAAwC;QAExC,OAAO,yBAAc,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAcM,QAAQ,CAAC,IAAgB,EAAE,WAAoB;QACpD,OAAO,yBAAc,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF;AAtED,4CAsEC","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 { Converters as JsonConverters, JsonObject, JsonValue } from '@fgv/ts-json-base';\nimport { ResourceType } from './resourceType';\nimport { Convert, ResourceTypeName, ResourceValueMergeMethod } from '../common';\nimport { captureResult, Result } from '@fgv/ts-utils';\n\n/**\n * Parameters to create a {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n * @public\n */\nexport interface IJsonResourceTypeCreateParams {\n  /**\n   * Optional key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * Defaults to 'json'.\n   */\n  key?: string;\n\n  /**\n   * Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType}\n   * instance.\n   */\n  index?: number;\n}\n\n/**\n * Implementation of a {@link ResourceTypes.ResourceType | ResourceType} for JSON values.\n * @public\n */\nexport class JsonResourceType extends ResourceType<JsonObject> {\n  /**\n   * Protected {@link ResourceTypes.JsonResourceType | JsonResourceType} constructor for use by subclasses.\n   * Use {@link ResourceTypes.JsonResourceType.create | JsonResourceType.create} to create a new instance.\n   * @param key - The key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param index - Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   */\n  protected constructor(key: ResourceTypeName, index?: number) {\n    super(key, index);\n  }\n\n  /**\n   * Factory method to create a new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param params - {@link ResourceTypes.IJsonResourceTypeCreateParams | Parameters} to create the new instance.\n   * @returns `Success` with the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance if successful\n   * or `Failure` with an error message if not.\n   */\n  public static create(params?: IJsonResourceTypeCreateParams): Result<JsonResourceType> {\n    return Convert.resourceTypeName.convert(params?.key ?? 'json').onSuccess((key) => {\n      return captureResult(() => new JsonResourceType(key, params?.index));\n    });\n  }\n\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validateDeclaration:1)}\n   */\n  public validateDeclaration(\n    json: JsonValue,\n    isPartial: true,\n    mergeMethod?: ResourceValueMergeMethod\n  ): Result<Partial<JsonObject>>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validateDeclaration:2)}\n   */\n  public validateDeclaration(\n    json: JsonValue,\n    isPartial: false,\n    mergeMethod?: ResourceValueMergeMethod\n  ): Result<JsonObject>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validateDeclaration:3)}\n   */\n  public validateDeclaration(\n    json: JsonValue,\n    isPartial: boolean,\n    mergeMethod?: ResourceValueMergeMethod\n  ): Result<JsonObject | Partial<JsonObject>>;\n  public validateDeclaration(\n    json: JsonValue,\n    __isPartial: boolean,\n    __mergeMethod?: ResourceValueMergeMethod\n  ): Result<JsonObject | Partial<JsonObject>> {\n    return JsonConverters.jsonObject.convert(json);\n  }\n\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:1)}\n   */\n  public validate(json: JsonObject, isPartial: true): Result<JsonObject>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:2)}\n   */\n  public validate(json: JsonObject, isPartial: false): Result<JsonObject>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:3)}\n   */\n  public validate(json: JsonObject, isPartial: boolean): Result<JsonObject>;\n  public validate(json: JsonObject, __isPartial: boolean): Result<JsonObject> {\n    return JsonConverters.jsonObject.convert(json);\n  }\n}\n"]}
+{"version":3,"file":"jsonResourceType.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/jsonResourceType.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,oDAA6E;AAC7E,iDAAsF;AACtF,sCAAsD;AACtD,4CAAsD;AAoBtD;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,2BAAwB;IAC5D;;;;;OAKG;IACH,YAAsB,GAAqB,EAAE,KAAc;QACzD,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,MAAsC;;QACzD,OAAO,gBAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,mCAAI,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/E,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IAEI,mBAAmB,CAAC,KAA6C;QACtE,OAAO,yBAAc,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAcM,QAAQ,CAAC,IAAgB,EAAE,WAAqB;QACrD,OAAO,yBAAc,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF;AA9CD,4CA8CC","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 { Converters as JsonConverters, JsonObject } from '@fgv/ts-json-base';\nimport { IResourceCandidateValidationProperties, ResourceType } from './resourceType';\nimport { Convert, ResourceTypeName } from '../common';\nimport { captureResult, Result } from '@fgv/ts-utils';\n\n/**\n * Parameters to create a {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n * @public\n */\nexport interface IJsonResourceTypeCreateParams {\n  /**\n   * Optional key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * Defaults to 'json'.\n   */\n  key?: string;\n\n  /**\n   * Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType}\n   * instance.\n   */\n  index?: number;\n}\n\n/**\n * Implementation of a {@link ResourceTypes.ResourceType | ResourceType} for JSON values.\n * @public\n */\nexport class JsonResourceType extends ResourceType<JsonObject> {\n  /**\n   * Protected {@link ResourceTypes.JsonResourceType | JsonResourceType} constructor for use by subclasses.\n   * Use {@link ResourceTypes.JsonResourceType.create | JsonResourceType.create} to create a new instance.\n   * @param key - The key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param index - Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   */\n  protected constructor(key: ResourceTypeName, index?: number) {\n    super(key, index);\n  }\n\n  /**\n   * Factory method to create a new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param params - {@link ResourceTypes.IJsonResourceTypeCreateParams | Parameters} to create the new instance.\n   * @returns `Success` with the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance if successful\n   * or `Failure` with an error message if not.\n   */\n  public static create(params?: IJsonResourceTypeCreateParams): Result<JsonResourceType> {\n    return Convert.resourceTypeName.convert(params?.key ?? 'json').onSuccess((key) => {\n      return captureResult(() => new JsonResourceType(key, params?.index));\n    });\n  }\n\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.validateDeclaration}\n   */\n\n  public validateDeclaration(props: IResourceCandidateValidationProperties): Result<JsonObject> {\n    return JsonConverters.jsonObject.convert(props.json);\n  }\n\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:1)}\n   */\n  public validate(json: JsonObject, isPartial: true): Result<JsonObject>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:2)}\n   */\n  public validate(json: JsonObject, isPartial: false): Result<JsonObject>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:3)}\n   */\n  public validate(json: JsonObject, isPartial: boolean): Result<JsonObject>;\n  public validate(json: JsonObject, __isPartial?: boolean): Result<JsonObject> {\n    return JsonConverters.jsonObject.convert(json);\n  }\n}\n"]}

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

@@ -1,6 +1,32 @@
 import { JsonValue } from '@fgv/ts-json-base';
 import { ICollectible, Result } from '@fgv/ts-utils';
-import { ResourceTypeIndex, ResourceTypeName, ResourceValueMergeMethod } from '../common';
+import { ResourceTypeIndex, ResourceTypeName, ResourceValueMergeMethod, ResourceId } from '../common';
+/**
+ * Parameters used to validate a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}.
+ * @public
+ */
+export interface IResourceCandidateValidationProperties {
+    /**
+     * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.id}
+     * @public
+     */
+    id: ResourceId;
+    /**
+     * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.isPartial}
+     * @public
+     */
+    isPartial: boolean;
+    /**
+     * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.json}
+     * @public
+     */
+    json: JsonValue;
+    /**
+     * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.mergeMethod}
+     * @public
+     */
+    mergeMethod: ResourceValueMergeMethod;
+}
 /**
  * Abstract base class for resource types which are responsible for
  * validating and converting JSON values into the appropriate strongly-typed
@@ -19,39 +45,14 @@ export declare abstract class ResourceType<T = unknown> implements ICollectible<
     get index(): ResourceTypeIndex | undefined;
     protected constructor(key: ResourceTypeName, index?: number);
     /**
-     * Validates a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for
-     * a partial resource instance value.
-     * @param json - The JSON value to validate.
-     * @param isPartial - `true` indicates that the value is expected to be incomplete.
-     * @param mergeMethod - The method to use when merging with previously resolved values.
-     * @returns `Success` with the strongly-typed resource value if the JSON and merge
-     * method are valid, `Failure` with an error message otherwise.
-     * @public
-     */
-    abstract validateDeclaration(json: JsonValue, isPartial: true, mergeMethod?: ResourceValueMergeMethod): Result<Partial<T>>;
-    /**
-     * Validates a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for
-     * 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 mergeMethod - The method to use when merging with previously resolved values.
-     * @returns `Success` with the strongly-typed resource value if the JSON and merge method
-     * are valid, `Failure` with an error message otherwise.
-     * @public
-     */
-    abstract validateDeclaration(json: JsonValue, isPartial: false, mergeMethod?: ResourceValueMergeMethod): Result<T>;
-    /**
-     * Validates a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for
+     * Validates properties of a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for
      * a resource instance value.
-     * @param json - The JSON value to validate.
-     * @param isPartial - Indicates whether the value is expected to be incomplete.
-     * @param mergeMethod - The method to use when merging with previously resolved values.
+     * @param props - The {@link ResourceTypes.IResourceCandidateValidationProperties | properties } to validate.
      * @returns `Success` with the strongly-typed resource value if the JSON and merge method
      * are valid, `Failure` with an error message otherwise.
      * @public
      */
-    abstract validateDeclaration(json: JsonValue, isPartial: boolean, mergeMethod?: ResourceValueMergeMethod): Result<T | Partial<T>>;
-    abstract validateDeclaration(json: JsonValue, isPartial: boolean, mergeMethod?: ResourceValueMergeMethod): Result<T | Partial<T>>;
+    abstract validateDeclaration(props: IResourceCandidateValidationProperties): Result<T | Partial<T>>;
     /**
      * Validates a JSON value for use as a partial resource instance value.
      * @param json - The JSON value to validate.
@@ -60,7 +61,7 @@ export declare abstract class ResourceType<T = unknown> implements ICollectible<
      * `Failure` with an error message otherwise.
      * @public
      */
-    abstract validate(json: JsonValue, isPartial: true): Result<T>;
+    abstract validate(json: JsonValue, isPartial: true): Result<Partial<T>>;
     /**
      * Validates a JSON value for use as a complete resource instance value.
      * @param json - The JSON value to validate.
@@ -69,7 +70,7 @@ export declare abstract class ResourceType<T = unknown> implements ICollectible<
      * `Failure` with an error message otherwise.
      * @public
      */
-    abstract validate(json: JsonValue, isPartial: false): Result<Partial<T>>;
+    abstract validate(json: JsonValue, isPartial: false): Result<T>;
     /**
      * Validates a JSON value for use as a full or partial resource instance value.
      * @param json - The JSON value to validate.
@@ -78,7 +79,7 @@ export declare abstract class ResourceType<T = unknown> implements ICollectible<
      * 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, isPartial?: boolean): 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,EACzB,MAAM,WAAW,CAAC;AAEnB;;;;;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;;;;;;;;;OASG;aACa,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,IAAI,EACf,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAErB;;;;;;;;;OASG;aACa,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,KAAK,EAChB,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,CAAC,CAAC;IAEZ;;;;;;;;;OASG;aACa,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,OAAO,EAClB,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;aAET,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,OAAO,EAClB,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzB;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC;IAErE;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE/E;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErF;;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,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"}

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,sCAMmB;AAEnB;;;;;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;IAsFD;;OAEG;IACI,QAAQ,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAnHD,oCAmHC","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} from '../common';\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 a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for\n   * 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 incomplete.\n   * @param mergeMethod - The method to use when merging with previously resolved values.\n   * @returns `Success` with the strongly-typed resource value if the JSON and merge\n   * method are valid, `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validateDeclaration(\n    json: JsonValue,\n    isPartial: true,\n    mergeMethod?: ResourceValueMergeMethod\n  ): Result<Partial<T>>;\n\n  /**\n   * Validates a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for\n   * 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   * @param mergeMethod - The method to use when merging with previously resolved values.\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(\n    json: JsonValue,\n    isPartial: false,\n    mergeMethod?: ResourceValueMergeMethod\n  ): Result<T>;\n\n  /**\n   * Validates a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for\n   * a resource instance value.\n   * @param json - The JSON value to validate.\n   * @param isPartial - Indicates whether the value is expected to be incomplete.\n   * @param mergeMethod - The method to use when merging with previously resolved values.\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(\n    json: JsonValue,\n    isPartial: boolean,\n    mergeMethod?: ResourceValueMergeMethod\n  ): Result<T | Partial<T>>;\n\n  public abstract validateDeclaration(\n    json: JsonValue,\n    isPartial: boolean,\n    mergeMethod?: ResourceValueMergeMethod\n  ): 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<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<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 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,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"]}

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

@@ -0,0 +1,98 @@
+import { ResourceId, ResourceValueMergeMethod } from '../common';
+import * as Context from '../context';
+import * as ResourceJson from '../resource-json';
+import { ResourceCandidate } from './resourceCandidate';
+import { JsonObject } from '@fgv/ts-json-base';
+import { Result } from '@fgv/ts-utils';
+/**
+ * Action taken on a candidate during reduction processing.
+ * @public
+ */
+export type CandidateAction = 'unchanged' | 'reduced' | 'suppressed';
+/**
+ * Information about a candidate being processed by the reducer.
+ * @public
+ */
+export interface ICandidateInfo {
+    readonly originalCandidate: ResourceCandidate;
+    action: CandidateAction;
+    conditions: ResourceJson.Json.ILooseConditionDecl[];
+    conditionSetKey: string;
+    readonly json?: JsonObject;
+}
+/**
+ * Represents a reduced candidate after applying reduction logic.
+ * @public
+ */
+export interface IReducedCandidate {
+    readonly candidate: ResourceCandidate;
+    readonly conditions: ResourceJson.Json.ConditionSetDecl;
+    readonly json?: JsonObject;
+    readonly isPartial?: boolean;
+    readonly mergeMethod?: ResourceValueMergeMethod;
+}
+/**
+ * Manages candidate reduction logic for filtering and qualifier reduction operations.
+ * Encapsulates the state and logic needed to consistently process candidates for reduction.
+ * @public
+ */
+export declare class CandidateReducer {
+    private readonly _candidateInfos;
+    private readonly _filterForContext;
+    private readonly _qualifiersToReduce;
+    /**
+     * Constructor for CandidateReducer.
+     * @param candidates - The set of candidates to potentially reduce
+     * @param filterForContext - Context to filter candidates against
+     */
+    constructor(candidates: ReadonlyArray<ResourceCandidate>, filterForContext: Context.IValidatedContextDecl);
+    /**
+     * Computes a string key for a set of condition declarations for collision detection.
+     * @param conditions - The conditions to compute a key for
+     * @returns A string key representing the condition set
+     */
+    private static _computeConditionSetKey;
+    /**
+     * Merges a partial candidate's JSON value into a base candidate's JSON value.
+     * @param baseJson - The base JSON value to merge into
+     * @param partialJson - The partial JSON value to merge from
+     * @returns The merged JSON value
+     * @internal
+     */
+    private static _mergeJsonValues;
+    /**
+     * Resolves collisions using smart collision resolution rules.
+     * - If a reduced candidate collides with an unchanged candidate and only one reduced candidate collides:
+     *   - If reduced candidate is complete: suppress unchanged, keep reduced
+     *   - If reduced candidate is partial: merge into unchanged, suppress reduced
+     * - Otherwise: revert reduced candidates to unchanged to avoid collisions
+     * @internal
+     */
+    private _resolveCollisions;
+    /**
+     * Static convenience method to construct an array of properly reduced
+     * {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declarations}
+     * from a set of {@link Resources.ResourceCandidate | resource candidates}.
+     * @param candidates - The candidates to reduce
+     * @param filterForContext - Optional context to filter against
+     * @returns Result with array of reduced candidate declarations, or Failure if reduction fails
+     */
+    static reduceToChildResourceCandidateDecls(candidates: ReadonlyArray<ResourceCandidate>, filterForContext?: Context.IValidatedContextDecl): Result<ResourceJson.Json.IChildResourceCandidateDecl[]>;
+    /**
+     * Static convenience method to construct an array of properly reduced
+     * {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declarations}
+     * from a set of {@link Resources.ResourceCandidate | resource candidates}.
+     * @param id - The id of the resource
+     * @param candidates - The candidates to reduce
+     * @param filterForContext - Optional context to filter against
+     * @returns Result with array of reduced candidate declarations, or Failure if reduction fails
+     */
+    static reduceToLooseResourceCandidateDecls(id: ResourceId, candidates: ReadonlyArray<ResourceCandidate>, filterForContext?: Context.IValidatedContextDecl): Result<ResourceJson.Json.ILooseResourceCandidateDecl[]>;
+    /**
+     * Reduces a single candidate according to the configured reduction rules.
+     * @param candidate - The candidate to reduce
+     * @returns Either a reduced candidate declaration or an error if the candidate is not found
+     */
+    reduceCandidate(candidate: ResourceCandidate): Result<IReducedCandidate | undefined>;
+}
+//# sourceMappingURL=candidateReducer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candidateReducer.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/candidateReducer.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,UAAU,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAA6B,MAAM,eAAe,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IAEjE;;;;OAIG;gBAED,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,gBAAgB,EAAE,OAAO,CAAC,qBAAqB;IAiCjD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAWtC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAW/B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IA2E1B;;;;;;;OAOG;WACW,mCAAmC,CAC/C,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC,qBAAqB,GAC/C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC;IAyB1D;;;;;;;;OAQG;WACW,mCAAmC,CAC/C,EAAE,EAAE,UAAU,EACd,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC,qBAAqB,GAC/C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC;IA0B1D;;;;OAIG;IACI,eAAe,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,GAAG,SAAS,CAAC;CAuB5F"}

package/lib/packlets/resources/candidateReducer.js

@@ -0,0 +1,247 @@
+"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.CandidateReducer = void 0;
+const resourceCandidate_1 = require("./resourceCandidate");
+const ts_json_1 = require("@fgv/ts-json");
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * Manages candidate reduction logic for filtering and qualifier reduction operations.
+ * Encapsulates the state and logic needed to consistently process candidates for reduction.
+ * @public
+ */
+class CandidateReducer {
+    /**
+     * Constructor for CandidateReducer.
+     * @param candidates - The set of candidates to potentially reduce
+     * @param filterForContext - Context to filter candidates against
+     */
+    constructor(candidates, filterForContext) {
+        var _a;
+        this._filterForContext = filterForContext;
+        // Use existing logic to determine reducible qualifiers
+        this._qualifiersToReduce =
+            (_a = resourceCandidate_1.ResourceCandidate.findReducibleQualifiers(candidates, filterForContext)) !== null && _a !== void 0 ? _a : new Set();
+        // Initialize candidate info array with initial reduction attempts
+        this._candidateInfos = candidates.map((candidate) => {
+            const filteredConditions = candidate.conditions.conditions.filter((c) => !this._qualifiersToReduce.has(c.qualifier.name));
+            const reducedConditions = filteredConditions.map((c) => c.toLooseConditionDecl());
+            const conditionSetKey = CandidateReducer._computeConditionSetKey(reducedConditions);
+            const action = filteredConditions.length < candidate.conditions.conditions.length ? 'reduced' : 'unchanged';
+            return {
+                originalCandidate: candidate,
+                action,
+                conditions: reducedConditions,
+                conditionSetKey,
+                json: undefined // Will be set later when needed
+            };
+        });
+        // Resolve collisions by reverting reduced candidates to unchanged when they collide
+        this._resolveCollisions();
+    }
+    /**
+     * Computes a string key for a set of condition declarations for collision detection.
+     * @param conditions - The conditions to compute a key for
+     * @returns A string key representing the condition set
+     */
+    static _computeConditionSetKey(conditions) {
+        if (conditions.length === 0) {
+            return '{}';
+        }
+        // Sort conditions by qualifier name for consistent keys
+        const sortedConditions = [...conditions].sort((a, b) => a.qualifierName.localeCompare(b.qualifierName));
+        const pairs = sortedConditions.map((c) => `${c.qualifierName}:${c.value}`);
+        return `{${pairs.join(',')}}`;
+    }
+    /**
+     * Merges a partial candidate's JSON value into a base candidate's JSON value.
+     * @param baseJson - The base JSON value to merge into
+     * @param partialJson - The partial JSON value to merge from
+     * @returns The merged JSON value
+     * @internal
+     */
+    static _mergeJsonValues(baseJson, partialJson) {
+        // Create JsonEditor with array replacement behavior for candidate merging
+        const editor = ts_json_1.JsonEditor.create({
+            merge: {
+                arrayMergeBehavior: 'replace'
+            }
+        }).orThrow(); // Should never fail with valid options
+        return editor.mergeObjectsInPlace({}, [baseJson, partialJson]).orThrow(); // Internal method should throw on error - this indicates a serious bug
+    }
+    /**
+     * Resolves collisions using smart collision resolution rules.
+     * - If a reduced candidate collides with an unchanged candidate and only one reduced candidate collides:
+     *   - If reduced candidate is complete: suppress unchanged, keep reduced
+     *   - If reduced candidate is partial: merge into unchanged, suppress reduced
+     * - Otherwise: revert reduced candidates to unchanged to avoid collisions
+     * @internal
+     */
+    _resolveCollisions() {
+        let hasCollisions = true;
+        let iterationCount = 0;
+        const maxIterations = this._candidateInfos.length; // Safety limit
+        while (hasCollisions && iterationCount < maxIterations) {
+            hasCollisions = false;
+            iterationCount++;
+            // Group candidates by their condition set keys (excluding suppressed)
+            const conditionKeyGroups = new Map();
+            for (const candidateInfo of this._candidateInfos) {
+                if (candidateInfo.action !== 'suppressed') {
+                    // Don't include suppressed candidates
+                    const key = candidateInfo.conditionSetKey;
+                    if (!conditionKeyGroups.has(key)) {
+                        conditionKeyGroups.set(key, []);
+                    }
+                    conditionKeyGroups.get(key).push(candidateInfo);
+                }
+            }
+            // Apply smart collision resolution
+            for (const [, candidatesWithSameKey] of conditionKeyGroups) {
+                if (candidatesWithSameKey.length > 1) {
+                    // Categorize candidates
+                    const unchangedCandidates = candidatesWithSameKey.filter((c) => c.action === 'unchanged');
+                    const reducedCandidates = candidatesWithSameKey.filter((c) => c.action === 'reduced');
+                    if (unchangedCandidates.length === 1 && reducedCandidates.length === 1) {
+                        // Simple case: one unchanged vs one reduced - apply smart resolution
+                        const unchangedCandidate = unchangedCandidates[0];
+                        const reducedCandidate = reducedCandidates[0];
+                        if (!reducedCandidate.originalCandidate.isPartial) {
+                            // Complete reduced candidate wins - suppress unchanged
+                            unchangedCandidate.action = 'suppressed';
+                            hasCollisions = true;
+                        }
+                        else {
+                            // Partial reduced candidate - merge into unchanged and suppress reduced
+                            const mergedJson = CandidateReducer._mergeJsonValues(unchangedCandidate.originalCandidate.json, reducedCandidate.originalCandidate.json);
+                            // Update unchanged candidate with merged JSON, keeping its isPartial status
+                            unchangedCandidate.json = mergedJson;
+                            // Suppress the reduced candidate
+                            reducedCandidate.action = 'suppressed';
+                            hasCollisions = true;
+                        }
+                    }
+                    else {
+                        // Complex collision case - revert all reduced candidates to unchanged
+                        for (const candidateInfo of reducedCandidates) {
+                            // Revert to original conditions and mark as unchanged
+                            const originalConditions = candidateInfo.originalCandidate.conditions.conditions.map((c) => c.toLooseConditionDecl());
+                            const originalKey = CandidateReducer._computeConditionSetKey(originalConditions);
+                            // Update the candidate info to revert to original state
+                            candidateInfo.action = 'unchanged';
+                            candidateInfo.conditions = originalConditions;
+                            candidateInfo.conditionSetKey = originalKey;
+                            hasCollisions = true;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Static convenience method to construct an array of properly reduced
+     * {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declarations}
+     * from a set of {@link Resources.ResourceCandidate | resource candidates}.
+     * @param candidates - The candidates to reduce
+     * @param filterForContext - Optional context to filter against
+     * @returns Result with array of reduced candidate declarations, or Failure if reduction fails
+     */
+    static reduceToChildResourceCandidateDecls(candidates, filterForContext) {
+        if (!filterForContext || Object.keys(filterForContext).length === 0) {
+            return (0, ts_utils_1.succeed)(candidates.map((candidate) => candidate.toChildResourceCandidateDecl()));
+        }
+        const reducer = new CandidateReducer(candidates, filterForContext);
+        const reductionResults = (0, ts_utils_1.mapResults)(candidates.map((candidate) => reducer.reduceCandidate(candidate)));
+        return reductionResults.onSuccess((reductions) => {
+            const validReductions = reductions.filter((reduction) => reduction !== undefined);
+            return (0, ts_utils_1.succeed)(validReductions.map((reduction) => {
+                var _a, _b, _c;
+                return ({
+                    /* c8 ignore next 3 -- defense in depth */
+                    json: (_a = reduction.json) !== null && _a !== void 0 ? _a : reduction.candidate.json,
+                    isPartial: (_b = reduction.isPartial) !== null && _b !== void 0 ? _b : reduction.candidate.isPartial,
+                    mergeMethod: (_c = reduction.mergeMethod) !== null && _c !== void 0 ? _c : reduction.candidate.mergeMethod,
+                    conditions: reduction.conditions
+                });
+            }));
+        });
+    }
+    /**
+     * Static convenience method to construct an array of properly reduced
+     * {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declarations}
+     * from a set of {@link Resources.ResourceCandidate | resource candidates}.
+     * @param id - The id of the resource
+     * @param candidates - The candidates to reduce
+     * @param filterForContext - Optional context to filter against
+     * @returns Result with array of reduced candidate declarations, or Failure if reduction fails
+     */
+    static reduceToLooseResourceCandidateDecls(id, candidates, filterForContext) {
+        if (!filterForContext || Object.keys(filterForContext).length === 0) {
+            return (0, ts_utils_1.succeed)(candidates.map((candidate) => candidate.toLooseResourceCandidateDecl()));
+        }
+        const reducer = new CandidateReducer(candidates, filterForContext);
+        const reductionResults = (0, ts_utils_1.mapResults)(candidates.map((candidate) => reducer.reduceCandidate(candidate)));
+        return reductionResults.onSuccess((reductions) => {
+            const validReductions = reductions.filter((reduction) => reduction !== undefined);
+            return (0, ts_utils_1.succeed)(validReductions.map((reduction) => {
+                var _a, _b, _c;
+                return ({
+                    id,
+                    /* c8 ignore next 3 -- defense in depth */
+                    json: (_a = reduction.json) !== null && _a !== void 0 ? _a : reduction.candidate.json,
+                    isPartial: (_b = reduction.isPartial) !== null && _b !== void 0 ? _b : reduction.candidate.isPartial,
+                    mergeMethod: (_c = reduction.mergeMethod) !== null && _c !== void 0 ? _c : reduction.candidate.mergeMethod,
+                    conditions: reduction.conditions
+                });
+            }));
+        });
+    }
+    /**
+     * Reduces a single candidate according to the configured reduction rules.
+     * @param candidate - The candidate to reduce
+     * @returns Either a reduced candidate declaration or an error if the candidate is not found
+     */
+    reduceCandidate(candidate) {
+        var _a;
+        const candidateInfo = this._candidateInfos.find((info) => info.originalCandidate === candidate);
+        if (!candidateInfo) {
+            return (0, ts_utils_1.fail)(`Candidate not found in reducer state`);
+        }
+        if (candidateInfo.action === 'suppressed') {
+            return (0, ts_utils_1.succeed)(undefined);
+        }
+        // Convert array of conditions back to ConditionSetDecl for compatibility
+        const conditionsAsRecord = candidateInfo.conditions.reduce((acc, condition) => {
+            return Object.assign(Object.assign({}, acc), { [condition.qualifierName]: condition.value });
+        }, {});
+        return (0, ts_utils_1.succeed)({
+            candidate,
+            conditions: conditionsAsRecord,
+            json: (_a = candidateInfo.json) !== null && _a !== void 0 ? _a : candidate.json,
+            isPartial: candidate.isPartial,
+            mergeMethod: candidate.mergeMethod
+        });
+    }
+}
+exports.CandidateReducer = CandidateReducer;
+//# sourceMappingURL=candidateReducer.js.map