@fgv/ts-res 5.0.0-9 → 5.0.1-0

package/lib/packlets/resources/candidateReducer.js

@@ -132,6 +132,7 @@ class CandidateReducer {
                             hasCollisions = true;
                         }
                         else {
+                            /* c8 ignore next 12 - complex collision handling for partial candidates rarely triggered */
                             // 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
@@ -142,6 +143,7 @@ class CandidateReducer {
                         }
                     }
                     else {
+                        /* c8 ignore next 15 - complex collision reversion logic rarely triggered in practice */
                         // Complex collision case - revert all reduced candidates to unchanged
                         for (const candidateInfo of reducedCandidates) {
                             // Revert to original conditions and mark as unchanged
@@ -224,6 +226,7 @@ class CandidateReducer {
     reduceCandidate(candidate) {
         var _a;
         const candidateInfo = this._candidateInfos.find((info) => info.originalCandidate === candidate);
+        /* c8 ignore next 3 - defensive coding: candidate should always be found if properly managed */
         if (!candidateInfo) {
             return (0, ts_utils_1.fail)(`Candidate not found in reducer state`);
         }

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

@@ -0,0 +1,92 @@
+import { JsonValue } from '@fgv/ts-json-base';
+import { Collections, Hash, Result } from '@fgv/ts-utils';
+import { CandidateValueIndex, CandidateValueKey } from '../common';
+/**
+ * Interface for a candidate value that can be collected and indexed.
+ * Candidate values are normalized JSON values that can be shared across
+ * multiple resource candidates to reduce duplication.
+ * @public
+ */
+export interface ICandidateValue extends Collections.ICollectible<CandidateValueKey, CandidateValueIndex> {
+    /**
+     * The unique key for this candidate value, derived from the hash of the normalized JSON.
+     */
+    readonly key: CandidateValueKey;
+    /**
+     * The index of this candidate value in the collection.
+     */
+    readonly index: CandidateValueIndex | undefined;
+    /**
+     * The normalized JSON value.
+     */
+    readonly json: JsonValue;
+    /**
+     * Sets the index of this candidate value.
+     * @param index - The index to set.
+     * @returns `Success` with the index if successful, or `Failure` with an error message if not.
+     */
+    setIndex(index: number): Result<CandidateValueIndex>;
+}
+/**
+ * Parameters for creating a {@link Resources.CandidateValue | CandidateValue}.
+ * @public
+ */
+export interface ICandidateValueCreateParams {
+    /**
+     * The JSON value to store. Will be normalized during creation.
+     */
+    json: JsonValue;
+    /**
+     * Optional normalizer to use for normalizing the JSON value.
+     * If not provided, a default Crc32Normalizer will be used.
+     */
+    normalizer?: Hash.Crc32Normalizer;
+    /**
+     * Optional index if the value is already indexed.
+     */
+    index?: number;
+}
+/**
+ * Implementation of a candidate value that stores normalized JSON data.
+ * The value is normalized on creation and a hash-based key is generated
+ * for efficient deduplication.
+ * @public
+ */
+export declare class CandidateValue implements ICandidateValue {
+    private readonly _collectible;
+    private readonly _json;
+    /**
+     * The unique key for this candidate value.
+     */
+    get key(): CandidateValueKey;
+    /**
+     * The index of this candidate value in the collection.
+     */
+    get index(): CandidateValueIndex | undefined;
+    /**
+     * The normalized JSON value.
+     */
+    get json(): JsonValue;
+    /**
+     * Constructor for a {@link Resources.CandidateValue} object.
+     * @param params - Parameters to create the candidate value.
+     * @internal
+     */
+    protected constructor(params: ICandidateValueCreateParams);
+    /**
+     * Creates a new {@link Resources.CandidateValue} object.
+     * @param params - Parameters to create the candidate value.
+     * @returns `Success` with the new candidate value if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params: ICandidateValueCreateParams): Result<CandidateValue>;
+    /**
+     * Sets the index of this candidate value.
+     * @param index - The index to set.
+     * @returns `Success` with the index if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    setIndex(index: number): Result<CandidateValueIndex>;
+}
+//# sourceMappingURL=candidateValue.d.ts.map

package/lib/packlets/resources/candidateValue.js

@@ -0,0 +1,128 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CandidateValue = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+const Common = __importStar(require("../common"));
+/**
+ * Implementation of a candidate value that stores normalized JSON data.
+ * The value is normalized on creation and a hash-based key is generated
+ * for efficient deduplication.
+ * @public
+ */
+class CandidateValue {
+    /**
+     * The unique key for this candidate value.
+     */
+    get key() {
+        return this._collectible.key;
+    }
+    /**
+     * The index of this candidate value in the collection.
+     */
+    get index() {
+        return this._collectible.index;
+    }
+    /**
+     * The normalized JSON value.
+     */
+    get json() {
+        return this._json;
+    }
+    /**
+     * Constructor for a {@link Resources.CandidateValue} object.
+     * @param params - Parameters to create the candidate value.
+     * @internal
+     */
+    constructor(params) {
+        var _a;
+        const normalizer = (_a = params.normalizer) !== null && _a !== void 0 ? _a : new ts_utils_1.Hash.Crc32Normalizer();
+        // Normalize the JSON value
+        const normalizedResult = normalizer.normalize(params.json);
+        this._json = normalizedResult.orThrow();
+        // Generate key from the normalized value using computeHash
+        const keyResult = normalizer.computeHash(this._json);
+        const key = common_1.Convert.candidateValueKey.convert(keyResult.orThrow()).orThrow();
+        // Create the collectible with the key and optional index
+        this._collectible = new ts_utils_1.Collections.Collectible({
+            key,
+            index: params.index,
+            indexConverter: Common.Convert.candidateValueIndex
+        });
+    }
+    /**
+     * Creates a new {@link Resources.CandidateValue} object.
+     * @param params - Parameters to create the candidate value.
+     * @returns `Success` with the new candidate value if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new CandidateValue(params));
+    }
+    /**
+     * Sets the index of this candidate value.
+     * @param index - The index to set.
+     * @returns `Success` with the index if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    setIndex(index) {
+        return this._collectible.setIndex(index);
+    }
+}
+exports.CandidateValue = CandidateValue;
+//# sourceMappingURL=candidateValue.js.map

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

@@ -0,0 +1,55 @@
+import { JsonValue } from '@fgv/ts-json-base';
+import { Hash, Result, ValidatingCollector } from '@fgv/ts-utils';
+import { CandidateValue } from './candidateValue';
+/**
+ * Parameters for creating a {@link Resources.CandidateValueCollector}.
+ * @public
+ */
+export interface ICandidateValueCollectorCreateParams {
+    /**
+     * Optional normalizer to use for normalizing JSON values.
+     * If not provided, a default Crc32Normalizer will be used.
+     */
+    normalizer?: Hash.HashingNormalizer;
+    /**
+     * Optional initial candidate values to add to the collection.
+     */
+    candidateValues?: (CandidateValue | JsonValue)[];
+}
+/**
+ * A `ValidatingCollector` for {@link Resources.CandidateValue | CandidateValues},
+ * which collects candidate values supplied as either {@link Resources.CandidateValue | CandidateValue} or
+ * `JsonValue`.
+ * @public
+ */
+export declare class CandidateValueCollector extends ValidatingCollector<CandidateValue> {
+    readonly normalizer: Hash.HashingNormalizer;
+    /**
+     * Constructor for a {@link Resources.CandidateValueCollector} object.
+     * @param params - Parameters to create the collector.
+     * @internal
+     */
+    protected constructor(params?: ICandidateValueCollectorCreateParams);
+    /**
+     * Creates a new {@link Resources.CandidateValueCollector} object.
+     * @param params - Parameters to create the collector.
+     * @returns `Success` with the new collector if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params?: ICandidateValueCollectorCreateParams): Result<CandidateValueCollector>;
+    /**
+     * Returns an array of JSON values ordered by their indices.
+     * @returns Array of JsonValue objects in index order.
+     * @public
+     */
+    getValuesByIndex(): JsonValue[];
+    /**
+     * Converter method to handle CandidateValue | JsonValue.
+     * @param from - The value to convert.
+     * @returns `Success` with the CandidateValue if successful, or `Failure` with an error message if not.
+     * @internal
+     */
+    private _toCandidateValue;
+}
+//# sourceMappingURL=candidateValueCollector.d.ts.map

package/lib/packlets/resources/candidateValueCollector.js

@@ -0,0 +1,96 @@
+"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.CandidateValueCollector = void 0;
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+const candidateValue_1 = require("./candidateValue");
+/**
+ * A `ValidatingCollector` for {@link Resources.CandidateValue | CandidateValues},
+ * which collects candidate values supplied as either {@link Resources.CandidateValue | CandidateValue} or
+ * `JsonValue`.
+ * @public
+ */
+class CandidateValueCollector extends ts_utils_1.ValidatingCollector {
+    /**
+     * Constructor for a {@link Resources.CandidateValueCollector} object.
+     * @param params - Parameters to create the collector.
+     * @internal
+     */
+    constructor(params = {}) {
+        var _a, _b;
+        super({
+            converters: new ts_utils_1.Collections.KeyValueConverters({
+                key: common_1.Convert.candidateValueKey,
+                value: (from) => this._toCandidateValue(from)
+            })
+        });
+        this.normalizer = (_a = params === null || params === void 0 ? void 0 : params.normalizer) !== null && _a !== void 0 ? _a : new ts_utils_1.Hash.Crc32Normalizer();
+        (_b = params.candidateValues) === null || _b === void 0 ? void 0 : _b.forEach((candidateValue) => this.validating.add(candidateValue));
+    }
+    /**
+     * Creates a new {@link Resources.CandidateValueCollector} object.
+     * @param params - Parameters to create the collector.
+     * @returns `Success` with the new collector if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new CandidateValueCollector(params));
+    }
+    /**
+     * Returns an array of JSON values ordered by their indices.
+     * @returns Array of JsonValue objects in index order.
+     * @public
+     */
+    getValuesByIndex() {
+        // Use the base class valuesByIndex() method to get CandidateValues in index order,
+        // then extract their JSON values
+        return this.valuesByIndex().map((candidateValue) => candidateValue.json);
+    }
+    /**
+     * Converter method to handle CandidateValue | JsonValue.
+     * @param from - The value to convert.
+     * @returns `Success` with the CandidateValue if successful, or `Failure` with an error message if not.
+     * @internal
+     */
+    _toCandidateValue(from) {
+        /* c8 ignore next 3 - functional code tested but coverage intermittently missed */
+        if (from instanceof candidateValue_1.CandidateValue) {
+            return (0, ts_utils_1.succeed)(from);
+        }
+        // Validate as JsonValue and create new CandidateValue
+        return ts_json_base_1.Validators.jsonValue
+            .validate(from)
+            .withErrorFormat((msg) => `Invalid JSON value: ${msg}`)
+            .onSuccess((jsonValue) => {
+            return candidateValue_1.CandidateValue.create({
+                json: jsonValue,
+                normalizer: this.normalizer
+            });
+        });
+    }
+}
+exports.CandidateValueCollector = CandidateValueCollector;
+//# sourceMappingURL=candidateValueCollector.js.map

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

@@ -1,5 +1,7 @@
 import * as ResourceJson from '../resource-json';
 import { IValidatedContextDecl } from '../context';
+import { IReadOnlyQualifierCollector } from '../qualifiers';
+import { ReadOnlyResourceTypeCollector } from '../resource-types';
 /**
  * Options for resource declaration operations with strongly-typed context filtering.
  * Extends the base IDeclarationOptions with proper type safety for context filtering.
@@ -68,5 +70,17 @@ export interface IResourceManagerCloneOptions extends IResourceDeclarationOption
      * These conditions can modify or extend the resource candidates in the cloned manager.
      */
     readonly candidates?: ReadonlyArray<ResourceJson.Json.ILooseResourceCandidateDecl>;
+    /**
+     * Optional qualifier collector to use for the cloned manager.
+     * If not provided, uses the same qualifiers as the original manager.
+     * This allows creating clones with different qualifier configurations.
+     */
+    readonly qualifiers?: IReadOnlyQualifierCollector;
+    /**
+     * Optional resource type collector to use for the cloned manager.
+     * If not provided, uses the same resource types as the original manager.
+     * This allows creating clones with different resource type configurations.
+     */
+    readonly resourceTypes?: ReadOnlyResourceTypeCollector;
 }
 //# sourceMappingURL=common.d.ts.map

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

@@ -1,4 +1,6 @@
 export * from './candidateReducer';
+export * from './candidateValue';
+export * from './candidateValueCollector';
 export * from './resourceCandidate';
 export * from './resource';
 export * from './resourceBuilder';

package/lib/packlets/resources/index.js

@@ -36,6 +36,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./candidateReducer"), exports);
+__exportStar(require("./candidateValue"), exports);
+__exportStar(require("./candidateValueCollector"), exports);
 __exportStar(require("./resourceCandidate"), exports);
 __exportStar(require("./resource"), exports);
 __exportStar(require("./resourceBuilder"), exports);

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

@@ -1,5 +1,5 @@
 import { Result } from '@fgv/ts-utils';
-import { ResourceId } from '../common';
+import { ResourceId, ResourceName } from '../common';
 import { ResourceCandidate } from './resourceCandidate';
 import { ResourceType } from '../resource-types';
 import { ConcreteDecision, AbstractDecisionCollector } from '../decisions';
@@ -40,10 +40,14 @@ export declare class Resource implements IResource {
      * The unique {@link ResourceId | id} of the resource.
      */
     readonly id: ResourceId;
+    /**
+     * The name of the resource.
+     */
+    readonly name: ResourceName;
     /**
      * The {@link ResourceTypes.ResourceType | type} of the resource.
      */
-    readonly _resourceType: ResourceType;
+    readonly resourceType: ResourceType;
     /**
      * The array of {@link Resources.ResourceCandidate | candidates} for the resource.
      */
@@ -52,10 +56,6 @@ export declare class Resource implements IResource {
      * {@link Decisions.ConcreteDecision | Decision} for optimized resource resolution.
      */
     readonly decision: ConcreteDecision;
-    /**
-     * Gets the resource type (implements IResource interface).
-     */
-    get resourceType(): ResourceType;
     /**
      * Gets the resource type name as a string.
      */

package/lib/packlets/resources/resource.js

@@ -33,17 +33,11 @@ const decisions_1 = require("../decisions");
  * @public
  */
 class Resource {
-    /**
-     * Gets the resource type (implements IResource interface).
-     */
-    get resourceType() {
-        return this._resourceType;
-    }
     /**
      * Gets the resource type name as a string.
      */
     get resourceTypeName() {
-        return this._resourceType.key;
+        return this.resourceType.key;
     }
     /**
      * Constructor for a {@link Resources.Resource | Resource} object.
@@ -53,7 +47,8 @@ class Resource {
     constructor(params) {
         const id = params.id ? common_1.Validate.toResourceId(params.id).orThrow() : undefined;
         this.id = Resource._validateCandidateResourceIds(id, params.candidates).orThrow();
-        this._resourceType = resourceCandidate_1.ResourceCandidate.validateResourceTypes(params.candidates, params.resourceType)
+        this.name = common_1.Helpers.getNameForResourceId(this.id).orThrow();
+        this.resourceType = resourceCandidate_1.ResourceCandidate.validateResourceTypes(params.candidates, params.resourceType)
             .onSuccess((t) => {
             /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
             if (t === undefined) {
@@ -120,9 +115,9 @@ class Resource {
      */
     toCompiled(options) {
         const candidates = this._getMatchingCandidates(options).map((c) => ({
-            json: c.json,
             isPartial: c.isPartial,
-            mergeMethod: c.mergeMethod
+            mergeMethod: c.mergeMethod,
+            valueIndex: c.candidateValue.index
         }));
         return {
             id: this.id,

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

@@ -5,6 +5,7 @@ import { ReadOnlyResourceTypeCollector, ResourceType } from '../resource-types';
 import { Resource } from './resource';
 import { ConditionSetCollector } from '../conditions';
 import { AbstractDecisionCollector } from '../decisions';
+import { CandidateValueCollector } from './candidateValueCollector';
 import * as ResourceJson from '../resource-json';
 import * as Context from '../context';
 /**
@@ -17,6 +18,7 @@ export interface IResourceBuilderCreateParams {
     conditionSets: ConditionSetCollector;
     resourceTypes: ReadOnlyResourceTypeCollector;
     decisions: AbstractDecisionCollector;
+    candidateValues: CandidateValueCollector;
 }
 /**
  * Possible result details returned by the resource builder
@@ -66,6 +68,10 @@ export declare class ResourceBuilder {
      * Collector for {@link Decisions.AbstractDecision | abstract decisions}.
      */
     protected _decisions: AbstractDecisionCollector;
+    /**
+     * Collector for candidate values.
+     */
+    protected _candidateValues: CandidateValueCollector;
     /**
      * Constructor for a {@link Resources.ResourceBuilder | ResourceBuilder} object.
      * @param params - Parameters to construct the new {@link Resources.ResourceBuilder | ResourceBuilder}.

package/lib/packlets/resources/resourceBuilder.js

@@ -56,6 +56,7 @@ class ResourceBuilder {
         this._resourceTypes = params.resourceTypes;
         this._conditionSets = params.conditionSets;
         this._decisions = params.decisions;
+        this._candidateValues = params.candidateValues;
         this._candidates = new ts_utils_1.ResultMap();
         if (params.typeName) {
             this._resourceType = this._resourceTypes.validating.get(params.typeName).orThrow();
@@ -93,7 +94,8 @@ class ResourceBuilder {
             id: this.id,
             resourceType: this._resourceType,
             decl: childDecl,
-            conditionSets: this._conditionSets
+            conditionSets: this._conditionSets,
+            candidateValues: this._candidateValues
         })
             .withDetail('failure', 'success')
             .onSuccess((candidate) => {
@@ -101,6 +103,7 @@ class ResourceBuilder {
                 .getOrAdd(candidate.conditions.toString(), candidate)
                 .onSuccess((added, detail) => {
                 if (detail === 'exists') {
+                    /* c8 ignore next 5 - defensive coding: conflicting candidates with same conditions should not occur */
                     if (!resourceCandidate_1.ResourceCandidate.equal(added, candidate)) {
                         return (0, ts_utils_1.failWithDetail)(`${this.id}: conflicting candidates.`, 'exists');
                     }

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

@@ -1,8 +1,10 @@
 import { JsonObject } from '@fgv/ts-json-base';
-import { QualifierName, ResourceId, ResourceValueMergeMethod } from '../common';
+import { CandidateCompleteness, QualifierName, ResourceId, ResourceValueMergeMethod } from '../common';
 import { Condition, ConditionSet, ConditionSetCollector } from '../conditions';
 import * as ResourceJson from '../resource-json';
 import { ResourceType } from '../resource-types';
+import { CandidateValue } from './candidateValue';
+import { CandidateValueCollector } from './candidateValueCollector';
 import { Result } from '@fgv/ts-utils';
 import * as Context from '../context';
 import { IResourceCandidate } from '../runtime';
@@ -16,6 +18,7 @@ export interface IResourceCandidateCreateParams {
     resourceType?: ResourceType;
     parentConditions?: ReadonlyArray<Condition>;
     conditionSets: ConditionSetCollector;
+    candidateValues: CandidateValueCollector;
 }
 /**
  * Options for creating a {@link Resources.ResourceCandidate | ResourceCandidate} declaration.
@@ -43,10 +46,16 @@ export declare class ResourceCandidate implements IResourceCandidate {
      * is a possible instance.
      */
     readonly id: ResourceId;
+    /**
+     * The candidate value that contains the JSON representation of the instance data.
+     */
+    readonly candidateValue: CandidateValue;
     /**
      * The JSON representation of the instance data to be applied.
+     * @remarks
+     * This property provides access to the JSON data from the underlying candidate value.
      */
-    readonly json: JsonObject;
+    get json(): JsonObject;
     /**
      * The conditions under which this candidate applies.
      */
@@ -64,6 +73,10 @@ export declare class ResourceCandidate implements IResourceCandidate {
      * this candidate belongs.
      */
     readonly resourceType: ResourceType | undefined;
+    /**
+     * The completeness of the candidate value.
+     */
+    get completeness(): CandidateCompleteness;
     /**
      * Constructor for a {@link Resources.ResourceCandidate | ResourceCandidate} object.
      * @param params - Parameters to create a new {@link Resources.ResourceCandidate | ResourceCandidate}.

package/lib/packlets/resources/resourceCandidate.js

@@ -66,6 +66,20 @@ const ts_utils_1 = require("@fgv/ts-utils");
  * @public
  */
 class ResourceCandidate {
+    /**
+     * The JSON representation of the instance data to be applied.
+     * @remarks
+     * This property provides access to the JSON data from the underlying candidate value.
+     */
+    get json() {
+        return this.candidateValue.json;
+    }
+    /**
+     * The completeness of the candidate value.
+     */
+    get completeness() {
+        return this.isPartial ? 'partial' : 'full';
+    }
     /**
      * Constructor for a {@link Resources.ResourceCandidate | ResourceCandidate} object.
      * @param params - Parameters to create a new {@link Resources.ResourceCandidate | ResourceCandidate}.
@@ -74,7 +88,7 @@ class ResourceCandidate {
     constructor(params) {
         var _a, _b;
         this.id = common_1.Validate.toResourceId(params.id).orThrow();
-        this.json = params.decl.json;
+        this.candidateValue = params.candidateValues.validating.getOrAdd(params.decl.json).orThrow();
         this.conditions = ResourceCandidate._mergeConditions(params.conditionSets, params.decl.conditions, params.parentConditions).orThrow();
         this.isPartial = (_a = params.decl.isPartial) !== null && _a !== void 0 ? _a : false;
         this.mergeMethod = (_b = params.decl.mergeMethod) !== null && _b !== void 0 ? _b : 'augment';
@@ -175,10 +189,8 @@ class ResourceCandidate {
             rc1.mergeMethod === rc2.mergeMethod &&
             conditions_1.ConditionSet.compare(rc1.conditions, rc2.conditions) === 0;
         if (equal) {
-            const normalizer = new ts_utils_1.Hash.Crc32Normalizer();
-            const n1 = normalizer.computeHash(rc1.json).orDefault('(n1 normalization failed)');
-            const n2 = normalizer.computeHash(rc2.json).orDefault('(n2 normalization failed)');
-            equal = n1 === n2;
+            // Compare candidate values by their keys for efficient JSON comparison
+            equal = rc1.candidateValue.key === rc2.candidateValue.key;
         }
         return equal;
     }