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

package/lib/packlets/runtime/cacheListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheListener.js","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheListener.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AA+CH;;;GAGG;AACH,MAAa,iCAAiC;IAC5C;;OAEG;IACI,UAAU,CAAC,KAAgC,EAAE,KAAa;QAC/D,QAAQ;IACV,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,KAAgC,EAAE,KAAa;QAChE,QAAQ;IACV,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,KAAgC,EAAE,KAAa;QACjE,QAAQ;IACV,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,KAAgC;QAClD,QAAQ;IACV,CAAC;CACF;AA5BD,8EA4BC","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\n/**\n * Type indicating which {@link Runtime.ResourceResolver | ResourceResolver} cache is affected.\n * @public\n */\nexport type ResourceResolverCacheType = 'condition' | 'conditionSet' | 'decision';\n\n/**\n * Type indicating the action performed on a {@link Runtime.ResourceResolver | ResourceResolver} cache.\n * @public\n */\nexport type ResourceResolverCacheActivity = 'hit' | 'miss' | 'error' | 'clear';\n\n/**\n * A listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n * @public\n */\nexport interface IResourceResolverCacheListener {\n  /**\n   * Called when a cache hit occurs.\n   * @param cache - The type of cache that was hit.\n   * @param index - The index of the cache that was hit.\n   */\n  onCacheHit(cache: ResourceResolverCacheType, index: number): void;\n\n  /**\n   * Called when a cache miss occurs.\n   * @param cache - The type of cache that was missed.\n   * @param index - The index of the cache that was missed.\n   */\n  onCacheMiss(cache: ResourceResolverCacheType, index: number): void;\n\n  /**\n   * Called when a cache error occurs.\n   * @param cache - The type of cache that had an error.\n   * @param index - The index of the cache that had an error.\n   */\n  onCacheError(cache: ResourceResolverCacheType, index: number): void;\n\n  /**\n   * Called when a cache is cleared.\n   * @param cache - The type of cache that was cleared.\n   */\n  onCacheClear(cache: ResourceResolverCacheType): void;\n}\n\n/**\n * A no-op implementation of {@link Runtime.IResourceResolverCacheListener}.\n * @public\n */\nexport class NoOpResourceResolverCacheListener implements IResourceResolverCacheListener {\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}\n   */\n  public onCacheHit(cache: ResourceResolverCacheType, index: number): void {\n    // no-op\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}\n   */\n  public onCacheMiss(cache: ResourceResolverCacheType, index: number): void {\n    // no-op\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}\n   */\n  public onCacheError(cache: ResourceResolverCacheType, index: number): void {\n    // no-op\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}\n   */\n  public onCacheClear(cache: ResourceResolverCacheType): void {\n    // no-op\n  }\n}\n"]}

package/lib/packlets/runtime/cacheMetrics.d.ts

@@ -0,0 +1,82 @@
+import { IResourceResolverCacheListener, ResourceResolverCacheType } from './cacheListener';
+/**
+ * Cache metrics interface for tracking cache performance.
+ * @public
+ */
+export interface ICacheMetrics {
+    hits: number;
+    misses: number;
+    errors: number;
+    clears: number;
+    totalAccesses: number;
+    hitRate: number;
+    onHit(index: number): void;
+    onMiss(index: number): void;
+    onError(index: number): void;
+    onClear(): void;
+    reset(): void;
+}
+/**
+ * Aggregate cache metrics for a specific cache type.
+ * @public
+ */
+export declare class AggregateCacheMetrics implements ICacheMetrics {
+    private _hits;
+    private _misses;
+    private _errors;
+    private _clears;
+    constructor();
+    onHit(__index: number): void;
+    onMiss(__index: number): void;
+    onError(__index: number): void;
+    onClear(): void;
+    get hits(): number;
+    get misses(): number;
+    get errors(): number;
+    get clears(): number;
+    get totalAccesses(): number;
+    get hitRate(): number;
+    get errorRate(): number;
+    reset(): void;
+}
+/**
+ * Overall cache metrics across all cache types.
+ * @public
+ */
+export type OverallCacheMetrics<TM extends ICacheMetrics = ICacheMetrics> = Record<ResourceResolverCacheType, TM>;
+/**
+ * A metrics implementation of {@link Runtime.IResourceResolverCacheListener} that tracks
+ * hit counts and rates across all cache types.
+ * @public
+ */
+export declare class ResourceResolverCacheMetricsListener<TM extends ICacheMetrics> implements IResourceResolverCacheListener {
+    private readonly _metrics;
+    constructor(factory: () => TM);
+    constructor(metrics: OverallCacheMetrics<TM>);
+    /**
+     * Get the metrics for all cache types.
+     * @returns The metrics for all cache types.
+     */
+    get metrics(): Readonly<OverallCacheMetrics>;
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}
+     */
+    onCacheHit(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}
+     */
+    onCacheMiss(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}
+     */
+    onCacheError(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}
+     */
+    onCacheClear(cache: ResourceResolverCacheType): void;
+    /**
+     * Reset all metrics to zero.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=cacheMetrics.d.ts.map

package/lib/packlets/runtime/cacheMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheMetrics.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheMetrics.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAa;;IASrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,IAAI,IAAI;IAOtB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAEM,KAAK,IAAI,IAAI;CAMrB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,EAAE,SAAS,aAAa,GAAG,aAAa,IAAI,MAAM,CAChF,yBAAyB,EACzB,EAAE,CACH,CAAC;AAEF;;;;GAIG;AACH,qBAAa,oCAAoC,CAAC,EAAE,SAAS,aAAa,CACxE,YAAW,8BAA8B;IAEzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAEhC,OAAO,EAAE,MAAM,EAAE;gBACjB,OAAO,EAAE,mBAAmB,CAAC,EAAE,CAAC;IAanD;;;OAGG;IACH,IAAW,OAAO,IAAI,QAAQ,CAAC,mBAAmB,CAAC,CAElD;IAED;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxE;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzE;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1E;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;IAI3D;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}

package/lib/packlets/runtime/cacheMetrics.js

@@ -0,0 +1,143 @@
+"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.ResourceResolverCacheMetricsListener = exports.AggregateCacheMetrics = void 0;
+/**
+ * Aggregate cache metrics for a specific cache type.
+ * @public
+ */
+class AggregateCacheMetrics {
+    constructor() {
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears = 0;
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears = 0;
+    }
+    onHit(__index) {
+        this._hits++;
+    }
+    onMiss(__index) {
+        this._misses++;
+    }
+    onError(__index) {
+        this._errors++;
+    }
+    onClear() {
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears++;
+    }
+    get hits() {
+        return this._hits;
+    }
+    get misses() {
+        return this._misses;
+    }
+    get errors() {
+        return this._errors;
+    }
+    get clears() {
+        return this._clears;
+    }
+    get totalAccesses() {
+        return this._hits + this._misses + this._errors;
+    }
+    get hitRate() {
+        return this.totalAccesses > 0 ? (this._hits / this.totalAccesses) * 100 : 0;
+    }
+    get errorRate() {
+        return this.totalAccesses > 0 ? (this._errors / this.totalAccesses) * 100 : 0;
+    }
+    reset() {
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears = 0;
+    }
+}
+exports.AggregateCacheMetrics = AggregateCacheMetrics;
+/**
+ * A metrics implementation of {@link Runtime.IResourceResolverCacheListener} that tracks
+ * hit counts and rates across all cache types.
+ * @public
+ */
+class ResourceResolverCacheMetricsListener {
+    constructor(factoryOrMetrics) {
+        if (typeof factoryOrMetrics === 'function') {
+            this._metrics = {
+                condition: factoryOrMetrics(),
+                conditionSet: factoryOrMetrics(),
+                decision: factoryOrMetrics()
+            };
+        }
+        else {
+            this._metrics = factoryOrMetrics;
+        }
+    }
+    /**
+     * Get the metrics for all cache types.
+     * @returns The metrics for all cache types.
+     */
+    get metrics() {
+        return this._metrics;
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}
+     */
+    onCacheHit(cache, index) {
+        this._metrics[cache].onHit(index);
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}
+     */
+    onCacheMiss(cache, index) {
+        this._metrics[cache].onMiss(index);
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}
+     */
+    onCacheError(cache, index) {
+        this._metrics[cache].onError(index);
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}
+     */
+    onCacheClear(cache) {
+        this._metrics[cache].onClear();
+    }
+    /**
+     * Reset all metrics to zero.
+     */
+    reset() {
+        this._metrics.condition.reset();
+        this._metrics.conditionSet.reset();
+        this._metrics.decision.reset();
+    }
+}
+exports.ResourceResolverCacheMetricsListener = ResourceResolverCacheMetricsListener;
+//# sourceMappingURL=cacheMetrics.js.map

package/lib/packlets/runtime/cacheMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheMetrics.js","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheMetrics.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { IResourceResolverCacheListener, ResourceResolverCacheType } from './cacheListener';\n\n/**\n * Cache metrics interface for tracking cache performance.\n * @public\n */\nexport interface ICacheMetrics {\n  hits: number;\n  misses: number;\n  errors: number;\n  clears: number;\n  totalAccesses: number;\n  hitRate: number;\n  onHit(index: number): void;\n  onMiss(index: number): void;\n  onError(index: number): void;\n  onClear(): void;\n  reset(): void;\n}\n\n/**\n * Aggregate cache metrics for a specific cache type.\n * @public\n */\nexport class AggregateCacheMetrics implements ICacheMetrics {\n  private _hits: number = 0;\n  private _misses: number = 0;\n  private _errors: number = 0;\n  private _clears: number = 0;\n\n  public constructor() {\n    this._hits = 0;\n    this._misses = 0;\n    this._errors = 0;\n    this._clears = 0;\n  }\n\n  public onHit(__index: number): void {\n    this._hits++;\n  }\n\n  public onMiss(__index: number): void {\n    this._misses++;\n  }\n\n  public onError(__index: number): void {\n    this._errors++;\n  }\n\n  public onClear(): void {\n    this._hits = 0;\n    this._misses = 0;\n    this._errors = 0;\n    this._clears++;\n  }\n\n  public get hits(): number {\n    return this._hits;\n  }\n\n  public get misses(): number {\n    return this._misses;\n  }\n\n  public get errors(): number {\n    return this._errors;\n  }\n\n  public get clears(): number {\n    return this._clears;\n  }\n\n  public get totalAccesses(): number {\n    return this._hits + this._misses + this._errors;\n  }\n\n  public get hitRate(): number {\n    return this.totalAccesses > 0 ? (this._hits / this.totalAccesses) * 100 : 0;\n  }\n\n  public get errorRate(): number {\n    return this.totalAccesses > 0 ? (this._errors / this.totalAccesses) * 100 : 0;\n  }\n\n  public reset(): void {\n    this._hits = 0;\n    this._misses = 0;\n    this._errors = 0;\n    this._clears = 0;\n  }\n}\n\n/**\n * Overall cache metrics across all cache types.\n * @public\n */\nexport type OverallCacheMetrics<TM extends ICacheMetrics = ICacheMetrics> = Record<\n  ResourceResolverCacheType,\n  TM\n>;\n\n/**\n * A metrics implementation of {@link Runtime.IResourceResolverCacheListener} that tracks\n * hit counts and rates across all cache types.\n * @public\n */\nexport class ResourceResolverCacheMetricsListener<TM extends ICacheMetrics>\n  implements IResourceResolverCacheListener\n{\n  private readonly _metrics: OverallCacheMetrics<TM>;\n\n  public constructor(factory: () => TM);\n  public constructor(metrics: OverallCacheMetrics<TM>);\n  public constructor(factoryOrMetrics: OverallCacheMetrics<TM> | (() => TM)) {\n    if (typeof factoryOrMetrics === 'function') {\n      this._metrics = {\n        condition: factoryOrMetrics(),\n        conditionSet: factoryOrMetrics(),\n        decision: factoryOrMetrics()\n      };\n    } else {\n      this._metrics = factoryOrMetrics;\n    }\n  }\n\n  /**\n   * Get the metrics for all cache types.\n   * @returns The metrics for all cache types.\n   */\n  public get metrics(): Readonly<OverallCacheMetrics> {\n    return this._metrics;\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}\n   */\n  public onCacheHit(cache: ResourceResolverCacheType, index: number): void {\n    this._metrics[cache].onHit(index);\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}\n   */\n  public onCacheMiss(cache: ResourceResolverCacheType, index: number): void {\n    this._metrics[cache].onMiss(index);\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}\n   */\n  public onCacheError(cache: ResourceResolverCacheType, index: number): void {\n    this._metrics[cache].onError(index);\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}\n   */\n  public onCacheClear(cache: ResourceResolverCacheType): void {\n    this._metrics[cache].onClear();\n  }\n\n  /**\n   * Reset all metrics to zero.\n   */\n  public reset(): void {\n    this._metrics.condition.reset();\n    this._metrics.conditionSet.reset();\n    this._metrics.decision.reset();\n  }\n}\n"]}

package/lib/packlets/runtime/compiledResourceCollection.d.ts

@@ -0,0 +1,167 @@
+import { Collections, Result } from '@fgv/ts-utils';
+import { ReadOnlyConditionCollector, ReadOnlyConditionSetCollector } from '../conditions';
+import { ReadOnlyAbstractDecisionCollector } from '../decisions';
+import { QualifierCollector } from '../qualifiers';
+import { ResourceType, ResourceTypeCollector } from '../resource-types';
+import { QualifierType, QualifierTypeCollector } from '../qualifier-types';
+import { ResourceId } from '../common';
+import { IResourceManager, IResource } from './iResourceManager';
+import * as ResourceJson from '../resource-json';
+import { IReadOnlyResourceTreeRoot } from './resource-tree';
+import * as Context from '../context';
+/**
+ * Interface for parameters to create a {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.
+ * @public
+ */
+export interface ICompiledResourceCollectionCreateParams {
+    /**
+     * The compiled resource collection data.
+     */
+    compiledCollection: ResourceJson.Compiled.ICompiledResourceCollection;
+    /**
+     * Map of qualifier type names to qualifier type objects.
+     */
+    qualifierTypes: Collections.IReadOnlyResultMap<string, QualifierType>;
+    /**
+     * Map of resource type names to resource type objects.
+     */
+    resourceTypes: Collections.IReadOnlyResultMap<string, ResourceType>;
+}
+/**
+ * A compiled resource collection implements {@link Runtime.IResourceManager | IResourceManager}
+ * by reconstructing runtime objects from compiled data. This provides an efficient way to load
+ * and use pre-compiled resource collections without rebuilding them from scratch.
+ * @public
+ */
+export declare class CompiledResourceCollection implements IResourceManager {
+    readonly conditions: ReadOnlyConditionCollector;
+    readonly conditionSets: ReadOnlyConditionSetCollector;
+    readonly decisions: ReadOnlyAbstractDecisionCollector;
+    private readonly _qualifierTypes;
+    private readonly _qualifiers;
+    private readonly _resourceTypes;
+    private readonly _builtResources;
+    private _cachedResourceTree?;
+    /**
+     * A {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector} which
+     * contains the {@link QualifierTypes.QualifierType | qualifier types} used in this collection.
+     */
+    get qualifierTypes(): QualifierTypeCollector;
+    /**
+     * A {@link Qualifiers.QualifierCollector | QualifierCollector} which
+     * contains the {@link Qualifiers.Qualifier | qualifiers} used in this collection.
+     */
+    get qualifiers(): QualifierCollector;
+    /**
+     * A {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector} which
+     * contains the {@link ResourceTypes.ResourceType | resource types} used in this collection.
+     */
+    get resourceTypes(): ResourceTypeCollector;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.builtResources}
+     */
+    get builtResources(): Collections.IReadOnlyValidatingResultMap<ResourceId, IResource>;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numResources}
+     */
+    get numResources(): number;
+    protected _numCandidates?: number;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numCandidates}
+     */
+    get numCandidates(): number;
+    /**
+     * Constructor for a {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.
+     * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.
+     * @internal
+     */
+    protected constructor(params: ICompiledResourceCollectionCreateParams);
+    /**
+     * Creates a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.
+     * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.
+     * @returns `Success` with the new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params: ICompiledResourceCollectionCreateParams): Result<CompiledResourceCollection>;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.getBuiltResource}
+     */
+    getBuiltResource(id: string): Result<IResource>;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.validateContext}
+     */
+    validateContext(context: Context.IContextDecl): Result<Context.IValidatedContextDecl>;
+    /**
+     * Gets a resource tree built from the resources in this collection.
+     * The tree provides hierarchical access to resources based on their ResourceId structure.
+     * For example, resources with IDs like "app.messages.welcome" create a tree structure
+     * where "app" and "messages" are branch nodes, and "welcome" is a leaf containing the resource.
+     *
+     * String-based validation is available through the `children.validating` property,
+     * allowing callers to use `tree.children.validating.getById(stringId)` for validated access.
+     *
+     * Uses lazy initialization with caching for performance.
+     * @returns Result containing the resource tree root, or failure if tree construction fails
+     * @public
+     */
+    getBuiltResourceTree(): Result<IReadOnlyResourceTreeRoot<IResource>>;
+    /**
+     * Reconstructs a QualifierTypeCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param qualifierTypes - Map of qualifier type names to qualifier type objects
+     * @returns The reconstructed QualifierTypeCollector
+     * @internal
+     */
+    private _buildQualifierTypes;
+    /**
+     * Reconstructs a QualifierCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param qualifierTypes - The reconstructed QualifierTypeCollector
+     * @returns The reconstructed QualifierCollector
+     * @internal
+     */
+    private _buildQualifiers;
+    /**
+     * Reconstructs a ResourceTypeCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param resourceTypes - Map of resource type names to resource type objects
+     * @returns The reconstructed ResourceTypeCollector
+     * @internal
+     */
+    private _buildResourceTypes;
+    /**
+     * Reconstructs a ConditionCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param qualifiers - The reconstructed QualifierCollector
+     * @returns The reconstructed ConditionCollector
+     * @internal
+     */
+    private _buildConditions;
+    /**
+     * Reconstructs a ConditionSetCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param conditions - The reconstructed ConditionCollector
+     * @returns The reconstructed ConditionSetCollector
+     * @internal
+     */
+    private _buildConditionSets;
+    /**
+     * Reconstructs an AbstractDecisionCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param conditionSets - The reconstructed ConditionSetCollector
+     * @returns The reconstructed AbstractDecisionCollector
+     * @internal
+     */
+    private _buildDecisions;
+    /**
+     * Reconstructs a ValidatingResultMap of resources from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param resourceTypes - The reconstructed ResourceTypeCollector
+     * @param decisions - The reconstructed AbstractDecisionCollector
+     * @returns The reconstructed ValidatingResultMap of resources
+     * @internal
+     */
+    private _buildResources;
+}
+//# sourceMappingURL=compiledResourceCollection.d.ts.map

package/lib/packlets/runtime/compiledResourceCollection.d.ts.map

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