@fgv/ts-res 5.0.1-0 → 5.0.1-10

package/dist/ts-res.d.ts

@@ -7,9 +7,10 @@ import { FileTree } from '@fgv/ts-json-base';
 import { Hash } from '@fgv/ts-utils';
 import { ICollectible } from '@fgv/ts-utils';
 import { IReadOnlyResultMap } from '@fgv/ts-utils';
-import { JsonCompatible } from '@fgv/ts-json-base';
+import { JsonCompatibleType } from '@fgv/ts-json-base';
 import { JsonObject } from '@fgv/ts-json-base';
 import { JsonValue } from '@fgv/ts-json-base';
+import { Logging } from '@fgv/ts-utils';
 import { ObjectConverter } from '@fgv/ts-utils';
 import { Result } from '@fgv/ts-utils';
 import { ResultMap } from '@fgv/ts-utils';
@@ -995,6 +996,10 @@ declare class CompiledResourceCollection implements IResourceManager<IResource>
      * contains the {@link Qualifiers.Qualifier | qualifiers} used in this collection.
      */
     get qualifiers(): IReadOnlyQualifierCollector;
+    /**
+     * The resource IDs contained in this compiled resource collection.
+     */
+    get resourceIds(): ReadonlyArray<ResourceId>;
     /**
      * A {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector} which
      * contains the {@link ResourceTypes.ResourceType | resource types} used in this collection.
@@ -2552,6 +2557,150 @@ declare const DefaultResourceTypes: ReadonlyArray<ResourceTypes.Config.IResource
  */
 declare const DefaultSystemConfiguration: ISystemConfiguration;
 
+/**
+ * Class for generating resource deltas between baseline and delta resolvers.
+ * Creates partial/augment candidates for updated resources and full/replace candidates for new resources.
+ * Uses Diff.jsonThreeWayDiff for efficient delta computation.
+ * @public
+ */
+declare class DeltaGenerator {
+    /**
+     * The baseline resource resolver to compare against.
+     * @internal
+     */
+    private readonly _baselineResolver;
+    /**
+     * The delta resource resolver containing changes.
+     * @internal
+     */
+    private readonly _deltaResolver;
+    /**
+     * The resource manager to clone and update.
+     * @internal
+     */
+    private readonly _resourceManager;
+    /**
+     * Logger for status and error reporting.
+     * @internal
+     */
+    private readonly _logger;
+    /**
+     * Constructor for a {@link Resources.DeltaGenerator | DeltaGenerator} object.
+     * @param params - Parameters to create a new {@link Resources.DeltaGenerator | DeltaGenerator}.
+     * @internal
+     */
+    protected constructor(params: IDeltaGeneratorParams);
+    /**
+     * Creates a new {@link Resources.DeltaGenerator | DeltaGenerator} object.
+     * @param params - Parameters to create a new {@link Resources.DeltaGenerator | DeltaGenerator}.
+     * @returns `Success` with the new {@link Resources.DeltaGenerator | DeltaGenerator} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params: IDeltaGeneratorParams): Result<DeltaGenerator>;
+    /**
+     * Generates deltas between baseline and delta resolvers.
+     * Creates a cloned resource manager with partial/augment candidates for updates
+     * and full/replace candidates for new resources.
+     *
+     * @param options - Options controlling delta generation behavior.
+     * @returns `Success` with the updated resource manager if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    generate(options?: IDeltaGeneratorOptions): Result<ResourceManagerBuilder>;
+    /**
+     * Validates the provided context declaration.
+     * @param context - The context declaration to validate.
+     * @returns `Success` with the validated context if successful, `Failure` otherwise.
+     * @internal
+     */
+    private _validateContext;
+    /**
+     * Enumerates target resource IDs for delta generation.
+     * If specific resource IDs are provided, uses those. Otherwise, discovers all resources
+     * from both the baseline resource manager and the delta resolver to ensure comprehensive
+     * coverage of all potential resources.
+     *
+     * @param requestedIds - Optional array of specific resource IDs to target.
+     * @param context - The validated context to use for resource discovery.
+     * @returns `Success` with array of resource IDs if successful, `Failure` otherwise.
+     * @internal
+     */
+    private _enumerateTargetResources;
+    /**
+     * Discovers all unique resource IDs from both baseline and delta resolvers.
+     * Creates a union of resource IDs from the baseline resource manager and delta resolver
+     * to ensure comprehensive coverage of all resources.
+     *
+     * @returns `Success` with array of unique resource IDs if successful, `Failure` otherwise.
+     * @internal
+     */
+    private _discoverAllResourceIds;
+    /**
+     * Creates a clone of the resource manager for delta operations.
+     * @returns `Success` with the cloned resource manager if successful, `Failure` otherwise.
+     * @internal
+     */
+    private _cloneResourceManager;
+    /**
+     * Generates deltas for the specified resources and adds them to the cloned manager.
+     *
+     * @param clonedManager - The cloned resource manager to update.
+     * @param resourceIds - Array of resource IDs to process.
+     * @param context - The context to use for resource resolution.
+     * @param skipUnchanged - Whether to skip resources that haven't changed.
+     * @returns `Success` with the updated manager if successful, `Failure` otherwise.
+     * @internal
+     */
+    private _generateDeltas;
+    /**
+     * Generates a delta for a single resource and adds appropriate candidates to the manager.
+     *
+     * @param manager - The resource manager to update.
+     * @param resourceId - The resource ID to process.
+     * @param context - The context to use for resource resolution.
+     * @param skipUnchanged - Whether to skip resources that haven't changed.
+     * @returns `Success` with the resource delta result if successful, `Failure` otherwise.
+     * @internal
+     */
+    private _generateResourceDelta;
+    /**
+     * Checks if two JSON values are identical.
+     * @param value1 - First value to compare.
+     * @param value2 - Second value to compare.
+     * @returns True if values are identical, false otherwise.
+     * @internal
+     */
+    private _areValuesIdentical;
+    /**
+     * Creates a new resource candidate for a newly discovered resource.
+     * Uses full/replace merge method since this is a completely new resource.
+     *
+     * @param manager - The resource manager to update.
+     * @param resourceId - The resource ID for the new resource.
+     * @param value - The resolved value for the new resource.
+     * @param context - The context used for resolution.
+     * @returns `Success` if the candidate was added successfully, `Failure` otherwise.
+     * @internal
+     */
+    private _createNewResourceCandidate;
+    /**
+     * Creates a delta candidate for an updated resource.
+     * Computes the difference between baseline and delta values and creates
+     * a partial/augment candidate with only the changed properties.
+     *
+     * @param manager - The resource manager to update.
+     * @param resourceId - The resource ID for the updated resource.
+     * @param baselineValue - The baseline resolved value.
+     * @param deltaValue - The delta resolved value.
+     * @param context - The context used for resolution.
+     * @returns `Success` if the candidate was added successfully, `Failure` otherwise.
+     * @internal
+     */
+    private _createDeltaCandidate;
+}
+
 /**
  * Type for handling empty branch nodes during tree composition.
  * The handler receives the branch node, names of failed children, and the resolver for recovery attempts.
@@ -2727,7 +2876,7 @@ declare function getDirectoryName(path: string): string;
 /**
  * Gets the name for a resource ID.
  * @param id - The resource ID to get the name for.
- * @returns The resource name if found, or undefined if not.
+ * @returns `Success` with the resource name if found, or `Failure` with an error message if not.
  * @public
  */
 declare function getNameForResourceId(id: string | undefined): Result<ResourceName>;
@@ -3813,6 +3962,49 @@ declare interface IDeclarationOptions {
     normalized?: boolean;
 }
 
+/**
+ * Interface for options controlling delta generation behavior.
+ * @public
+ */
+declare interface IDeltaGeneratorOptions {
+    /**
+     * Context to use when resolving resources. If not provided, uses empty context.
+     */
+    context?: Context.IContextDecl;
+    /**
+     * Array of specific resource IDs to include in delta generation.
+     * If not provided, generates deltas for all resources in the delta resolver.
+     */
+    resourceIds?: ReadonlyArray<string>;
+    /**
+     * Whether to skip resources that haven't changed. Default: true.
+     */
+    skipUnchanged?: boolean;
+}
+
+/**
+ * Interface for parameters to create a {@link Resources.DeltaGenerator | DeltaGenerator}.
+ * @public
+ */
+declare interface IDeltaGeneratorParams {
+    /**
+     * The baseline resource resolver to compare against.
+     */
+    baselineResolver: IResourceResolver;
+    /**
+     * The delta resource resolver containing changes.
+     */
+    deltaResolver: IResourceResolver;
+    /**
+     * The resource manager to clone and update.
+     */
+    resourceManager: ResourceManagerBuilder;
+    /**
+     * Optional logger for status and error reporting.
+     */
+    logger?: Logging.ILogger;
+}
+
 /**
  * @internal
  */
@@ -4768,13 +4960,13 @@ declare interface IQualifierType<TCFGJSON extends JsonObject = JsonObject> exten
      * Gets the configuration for this qualifier type.
      * @returns `Success` with the configuration if successful, `Failure` with an error message otherwise.
      */
-    getConfigurationJson(): Result<JsonCompatible<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
+    getConfigurationJson(): Result<JsonCompatibleType<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
     /**
      * Validates configuration JSON data for this qualifier type.
      * @param from - The unknown data to validate as configuration JSON.
      * @returns `Success` with validated JSON configuration if valid, `Failure` with an error message otherwise.
      */
-    validateConfigurationJson(from: unknown): Result<JsonCompatible<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
+    validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
 }
 
 /**
@@ -5266,6 +5458,10 @@ export declare interface IResourceManager<TR extends IResource = IResource> {
      * The number of resources in this resource manager.
      */
     readonly numResources: number;
+    /**
+     * The resource IDs that this resource manager can resolve.
+     */
+    readonly resourceIds: ReadonlyArray<ResourceId>;
     /**
      * The number of candidates in this resource manager.
      */
@@ -5317,6 +5513,10 @@ declare interface IResourceManagerCloneOptions extends IResourceDeclarationOptio
  * @public
  */
 export declare interface IResourceResolver {
+    /**
+     * The resource IDs that this resolver can resolve.
+     */
+    readonly resourceIds: ReadonlyArray<ResourceId>;
     /**
      * Resolves a resource to a composed value by merging matching candidates according to their merge methods.
      * Starting from the highest priority candidates, finds the first "full" candidate and merges all higher
@@ -6368,7 +6568,7 @@ declare const LanguagePrioritySystemConfiguration: ISystemConfiguration;
  * Accepts a list of language tags in the context by default.
  * @public
  */
-declare class LanguageQualifierType extends QualifierType<JsonCompatible<Config_2.ILanguageQualifierTypeConfig>> {
+declare class LanguageQualifierType extends QualifierType<JsonCompatibleType<Config_2.ILanguageQualifierTypeConfig>> {
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
      */
@@ -6411,11 +6611,11 @@ declare class LanguageQualifierType extends QualifierType<JsonCompatible<Config_
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
-    getConfigurationJson(): Result<JsonCompatible<Config_2.ISystemLanguageQualifierTypeConfig>>;
+    getConfigurationJson(): Result<JsonCompatibleType<Config_2.ISystemLanguageQualifierTypeConfig>>;
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
-    validateConfigurationJson(from: unknown): Result<JsonCompatible<Config_2.ISystemLanguageQualifierTypeConfig>>;
+    validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.ISystemLanguageQualifierTypeConfig>>;
     /**
      * Validates a {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | strongly typed configuration object}
      * for this qualifier type.
@@ -6446,7 +6646,7 @@ declare const languageQualifierTypeConfig: ObjectConverter<Model_2.ILanguageQual
  * optionally case-sensitive or matching against an ordered list of values at runtime.
  * @public
  */
-declare class LiteralQualifierType extends QualifierType<JsonCompatible<Config_2.ILiteralQualifierTypeConfig>> {
+declare class LiteralQualifierType extends QualifierType<JsonCompatibleType<Config_2.ILiteralQualifierTypeConfig>> {
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
      */
@@ -6495,11 +6695,11 @@ declare class LiteralQualifierType extends QualifierType<JsonCompatible<Config_2
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
-    getConfigurationJson(): Result<JsonCompatible<Config_2.ISystemLiteralQualifierTypeConfig>>;
+    getConfigurationJson(): Result<JsonCompatibleType<Config_2.ISystemLiteralQualifierTypeConfig>>;
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
-    validateConfigurationJson(from: unknown): Result<JsonCompatible<Config_2.ISystemLiteralQualifierTypeConfig>>;
+    validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.ISystemLiteralQualifierTypeConfig>>;
     /**
      * Validates a {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | strongly typed configuration object}
      * for this qualifier type.
@@ -7517,11 +7717,11 @@ export declare abstract class QualifierType<TCFGJSON extends JsonObject = JsonOb
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
-    abstract getConfigurationJson(): Result<JsonCompatible<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
+    abstract getConfigurationJson(): Result<JsonCompatibleType<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
-    abstract validateConfigurationJson(from: unknown): Result<JsonCompatible<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
+    abstract validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.setIndex}
      */
@@ -8457,6 +8657,10 @@ export declare class ResourceManagerBuilder implements IResourceManager<Resource
      * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
      */
     get conditions(): ReadOnlyConditionCollector;
+    /**
+     * The resource IDs that this resource manager can resolve.
+     */
+    get resourceIds(): ReadonlyArray<ResourceId>;
     /**
      * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which
      * contains the {@link Conditions.ConditionSet | condition sets} used so far by
@@ -8805,6 +9009,10 @@ export declare class ResourceResolver implements IResourceResolver {
      * The readonly qualifier collector that provides qualifier implementations.
      */
     get qualifiers(): IReadOnlyQualifierCollector;
+    /**
+     * The resource IDs that this resolver can resolve.
+     */
+    get resourceIds(): ReadonlyArray<ResourceId>;
     /**
      * The cache array for resolved conditions, indexed by condition index for O(1) lookup.
      * Each entry stores the resolved {@link Runtime.IConditionMatchResult | condition match result} for
@@ -9032,6 +9240,9 @@ declare namespace Resources {
         CandidateValue,
         ICandidateValueCollectorCreateParams,
         CandidateValueCollector,
+        IDeltaGeneratorParams,
+        IDeltaGeneratorOptions,
+        DeltaGenerator,
         IResourceCandidateCreateParams,
         ICandidateDeclOptions,
         ResourceCandidate,
@@ -9799,7 +10010,7 @@ declare const TerritoryPrioritySystemConfiguration: ISystemConfiguration;
  * implementation handles incorrect casing.
  * @public
  */
-declare class TerritoryQualifierType extends QualifierType<JsonCompatible<Config_2.ITerritoryQualifierTypeConfig>> {
+declare class TerritoryQualifierType extends QualifierType<JsonCompatibleType<Config_2.ITerritoryQualifierTypeConfig>> {
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
      */
@@ -9854,11 +10065,11 @@ declare class TerritoryQualifierType extends QualifierType<JsonCompatible<Config
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
-    getConfigurationJson(): Result<JsonCompatible<Config_2.ISystemTerritoryQualifierTypeConfig>>;
+    getConfigurationJson(): Result<JsonCompatibleType<Config_2.ISystemTerritoryQualifierTypeConfig>>;
     /**
      * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
-    validateConfigurationJson(from: unknown): Result<JsonCompatible<Config_2.ISystemTerritoryQualifierTypeConfig>>;
+    validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.ISystemTerritoryQualifierTypeConfig>>;
     /**
      * Validates a {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | strongly typed configuration object}
      * for this qualifier type.

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.52.12"
+      "packageVersion": "7.54.0"
     }
   ]
 }

package/lib/index.browser.d.ts

@@ -0,0 +1,24 @@
+import * as Bundle from './packlets/bundle';
+import * as QualifierTypes from './packlets/qualifier-types';
+import * as Qualifiers from './packlets/qualifiers';
+import * as Conditions from './packlets/conditions';
+import * as Config from './packlets/config/index.browser';
+import * as Context from './packlets/context';
+import * as Decisions from './packlets/decisions';
+import * as ResourceJson from './packlets/resource-json';
+import * as Resources from './packlets/resources';
+import * as ResourceTypes from './packlets/resource-types';
+import * as Import from './packlets/import/index.browser';
+import * as Runtime from './packlets/runtime';
+import * as ZipArchive from './packlets/zip-archive/index.browser';
+export * from './packlets/common';
+import { Condition, ConditionSet } from './packlets/conditions';
+import { Decision } from './packlets/decisions';
+import { QualifierType } from './packlets/qualifier-types';
+import { Qualifier } from './packlets/qualifiers';
+import { ResourceType } from './packlets/resource-types';
+import { Resource, ResourceCandidate, ResourceManagerBuilder } from './packlets/resources';
+import { IResourceManager, ResourceResolver } from './packlets/runtime';
+import { BundleBuilder, BundleLoader } from './packlets/bundle';
+export { Bundle, BundleBuilder, BundleLoader, Condition, Conditions, ConditionSet, Config, Context, Decision, Decisions, Import, IResourceManager, Qualifier, QualifierType, QualifierTypes, Qualifiers, Resource, ResourceCandidate, ResourceJson, ResourceResolver, ResourceManagerBuilder, ResourceType, ResourceTypes, Resources, Runtime, ZipArchive };
+//# sourceMappingURL=index.browser.d.ts.map

package/lib/index.browser.js

@@ -0,0 +1,116 @@
+"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;
+    };
+})();
+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.ZipArchive = exports.Runtime = exports.Resources = exports.ResourceTypes = exports.ResourceType = exports.ResourceManagerBuilder = exports.ResourceResolver = exports.ResourceJson = exports.ResourceCandidate = exports.Resource = exports.Qualifiers = exports.QualifierTypes = exports.QualifierType = exports.Qualifier = exports.Import = exports.Decisions = exports.Decision = exports.Context = exports.Config = exports.ConditionSet = exports.Conditions = exports.Condition = exports.BundleLoader = exports.BundleBuilder = exports.Bundle = void 0;
+// Browser entry point - excludes Node.js filesystem dependencies
+const Bundle = __importStar(require("./packlets/bundle"));
+exports.Bundle = Bundle;
+const QualifierTypes = __importStar(require("./packlets/qualifier-types"));
+exports.QualifierTypes = QualifierTypes;
+const Qualifiers = __importStar(require("./packlets/qualifiers"));
+exports.Qualifiers = Qualifiers;
+const Conditions = __importStar(require("./packlets/conditions"));
+exports.Conditions = Conditions;
+// eslint-disable-next-line @rushstack/packlets/mechanics -- browser-specific entry point excludes Node.js fs dependencies
+const Config = __importStar(require("./packlets/config/index.browser"));
+exports.Config = Config;
+const Context = __importStar(require("./packlets/context"));
+exports.Context = Context;
+const Decisions = __importStar(require("./packlets/decisions"));
+exports.Decisions = Decisions;
+const ResourceJson = __importStar(require("./packlets/resource-json"));
+exports.ResourceJson = ResourceJson;
+const Resources = __importStar(require("./packlets/resources"));
+exports.Resources = Resources;
+const ResourceTypes = __importStar(require("./packlets/resource-types"));
+exports.ResourceTypes = ResourceTypes;
+// eslint-disable-next-line @rushstack/packlets/mechanics -- browser-specific entry point excludes Node.js fs dependencies
+const Import = __importStar(require("./packlets/import/index.browser"));
+exports.Import = Import;
+const Runtime = __importStar(require("./packlets/runtime"));
+exports.Runtime = Runtime;
+// eslint-disable-next-line @rushstack/packlets/mechanics -- browser-specific entry point excludes Node.js fs dependencies
+const ZipArchive = __importStar(require("./packlets/zip-archive/index.browser"));
+exports.ZipArchive = ZipArchive;
+__exportStar(require("./packlets/common"), exports);
+const conditions_1 = require("./packlets/conditions");
+Object.defineProperty(exports, "Condition", { enumerable: true, get: function () { return conditions_1.Condition; } });
+Object.defineProperty(exports, "ConditionSet", { enumerable: true, get: function () { return conditions_1.ConditionSet; } });
+const decisions_1 = require("./packlets/decisions");
+Object.defineProperty(exports, "Decision", { enumerable: true, get: function () { return decisions_1.Decision; } });
+const qualifier_types_1 = require("./packlets/qualifier-types");
+Object.defineProperty(exports, "QualifierType", { enumerable: true, get: function () { return qualifier_types_1.QualifierType; } });
+const qualifiers_1 = require("./packlets/qualifiers");
+Object.defineProperty(exports, "Qualifier", { enumerable: true, get: function () { return qualifiers_1.Qualifier; } });
+const resource_types_1 = require("./packlets/resource-types");
+Object.defineProperty(exports, "ResourceType", { enumerable: true, get: function () { return resource_types_1.ResourceType; } });
+const resources_1 = require("./packlets/resources");
+Object.defineProperty(exports, "Resource", { enumerable: true, get: function () { return resources_1.Resource; } });
+Object.defineProperty(exports, "ResourceCandidate", { enumerable: true, get: function () { return resources_1.ResourceCandidate; } });
+Object.defineProperty(exports, "ResourceManagerBuilder", { enumerable: true, get: function () { return resources_1.ResourceManagerBuilder; } });
+const runtime_1 = require("./packlets/runtime");
+Object.defineProperty(exports, "ResourceResolver", { enumerable: true, get: function () { return runtime_1.ResourceResolver; } });
+const bundle_1 = require("./packlets/bundle");
+Object.defineProperty(exports, "BundleBuilder", { enumerable: true, get: function () { return bundle_1.BundleBuilder; } });
+Object.defineProperty(exports, "BundleLoader", { enumerable: true, get: function () { return bundle_1.BundleLoader; } });
+// Excluded from browser:
+// - Config: SystemConfiguration.loadFromFile() (requires Node.js fs via JsonFile)
+// - Import: PathImporter, FsItemImporter, FsItem.createForPath() (require Node.js fs)
+// - ZipArchive: ZipArchiveCreator methods using file paths (require Node.js fs)
+//# sourceMappingURL=index.browser.js.map

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

@@ -34,7 +34,7 @@ export declare function joinOptionalResourceIds(...ids: (string | undefined)[]):
 /**
  * Gets the name for a resource ID.
  * @param id - The resource ID to get the name for.
- * @returns The resource name if found, or undefined if not.
+ * @returns `Success` with the resource name if found, or `Failure` with an error message if not.
  * @public
  */
 export declare function getNameForResourceId(id: string | undefined): Result<ResourceName>;

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

@@ -87,12 +87,13 @@ function joinOptionalResourceIds(...ids) {
 /**
  * Gets the name for a resource ID.
  * @param id - The resource ID to get the name for.
- * @returns The resource name if found, or undefined if not.
+ * @returns `Success` with the resource name if found, or `Failure` with an error message if not.
  * @public
  */
 function getNameForResourceId(id) {
     return splitResourceId(id).onSuccess((parts) => {
-        return parts.length > 0 ? (0, ts_utils_1.succeed)(parts[parts.length - 1]) : fail('Empty id has no name');
+        /* c8 ignore next 1 - tested but coverage having issues */
+        return parts.length > 0 ? (0, ts_utils_1.succeed)(parts[parts.length - 1]) : fail(`${id}: invalid resource id`);
     });
 }
 //# sourceMappingURL=resources.js.map

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

@@ -66,6 +66,10 @@ export type CandidateValueKey = Brand<string, 'CandidateValueKey'>;
  * @public
  */
 export interface IResourceResolver {
+    /**
+     * The resource IDs that this resolver can resolve.
+     */
+    readonly resourceIds: ReadonlyArray<ResourceId>;
     /**
      * Resolves a resource to a composed value by merging matching candidates according to their merge methods.
      * Starting from the highest priority candidates, finds the first "full" candidate and merges all higher