@fgv/ts-res 5.0.0-2 → 5.0.0-21

package/lib/packlets/bundle/bundleUtils.d.ts

@@ -0,0 +1,70 @@
+import { Result } from '@fgv/ts-utils';
+import { SystemConfiguration } from '../config';
+import { Compiled as ResourceJsonCompiled } from '../resource-json';
+import { IBundleMetadata } from './model';
+/**
+ * Components extracted from a bundle for reuse in different contexts.
+ * @public
+ */
+export interface IBundleComponents {
+    /**
+     * The system configuration from the bundle.
+     */
+    systemConfiguration: SystemConfiguration;
+    /**
+     * The compiled resource collection from the bundle.
+     */
+    compiledCollection: ResourceJsonCompiled.ICompiledResourceCollection;
+    /**
+     * The bundle metadata including build information.
+     */
+    metadata: IBundleMetadata;
+}
+/**
+ * Utility functions for working with resource bundles.
+ * Provides reusable logic for bundle detection, parsing, and component extraction.
+ * @public
+ */
+export declare class BundleUtils {
+    /**
+     * Checks if the given object appears to be a bundle file by examining its structure.
+     * This is a lightweight check that doesn't perform full validation.
+     * @param data - The data to check
+     * @returns True if the data appears to be a bundle structure
+     * @public
+     */
+    static isBundleFile(data: unknown): boolean;
+    /**
+     * Extracts and validates components from a bundle for reuse.
+     * Performs full validation of the bundle structure and creates typed components.
+     * @param bundleData - The raw bundle data to extract components from
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static extractBundleComponents(bundleData: unknown): Result<IBundleComponents>;
+    /**
+     * Extracts just the metadata from potential bundle data without full validation.
+     * Useful for displaying bundle information without processing the entire bundle.
+     * @param data - The data to extract metadata from
+     * @returns Success with metadata if found and valid, Failure otherwise
+     * @public
+     */
+    static extractBundleMetadata(data: unknown): Result<IBundleMetadata>;
+    /**
+     * Parses bundle data from a JSON string.
+     * Convenience method that combines JSON parsing with bundle component extraction.
+     * @param jsonString - The JSON string containing bundle data
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static parseBundleFromJson(jsonString: string): Result<IBundleComponents>;
+    /**
+     * Checks if a file name suggests it might be a bundle file.
+     * This is a heuristic check based on file naming conventions.
+     * @param fileName - The file name to check
+     * @returns True if the file name suggests a bundle file
+     * @public
+     */
+    static isBundleFileName(fileName: string): boolean;
+}
+//# sourceMappingURL=bundleUtils.d.ts.map

package/lib/packlets/bundle/bundleUtils.js

@@ -0,0 +1,117 @@
+"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.BundleUtils = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const config_1 = require("../config");
+const convert_1 = require("./convert");
+/**
+ * Utility functions for working with resource bundles.
+ * Provides reusable logic for bundle detection, parsing, and component extraction.
+ * @public
+ */
+class BundleUtils {
+    /**
+     * Checks if the given object appears to be a bundle file by examining its structure.
+     * This is a lightweight check that doesn't perform full validation.
+     * @param data - The data to check
+     * @returns True if the data appears to be a bundle structure
+     * @public
+     */
+    static isBundleFile(data) {
+        return convert_1.bundle.convert(data).isSuccess();
+    }
+    /**
+     * Extracts and validates components from a bundle for reuse.
+     * Performs full validation of the bundle structure and creates typed components.
+     * @param bundleData - The raw bundle data to extract components from
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static extractBundleComponents(bundleData) {
+        return convert_1.bundle
+            .convert(bundleData)
+            .withErrorFormat((err) => `Invalid bundle structure: ${err}`)
+            .onSuccess((bundle) => {
+            return config_1.SystemConfiguration.create(bundle.config)
+                .withErrorFormat((err) => `Invalid system configuration in bundle: ${err}`)
+                .onSuccess((systemConfiguration) => {
+                return (0, ts_utils_1.succeed)({
+                    systemConfiguration,
+                    compiledCollection: bundle.compiledCollection,
+                    metadata: bundle.metadata
+                });
+            });
+        });
+    }
+    /**
+     * Extracts just the metadata from potential bundle data without full validation.
+     * Useful for displaying bundle information without processing the entire bundle.
+     * @param data - The data to extract metadata from
+     * @returns Success with metadata if found and valid, Failure otherwise
+     * @public
+     */
+    static extractBundleMetadata(data) {
+        return convert_1.bundle
+            .convert(data)
+            .onSuccess((bundle) => {
+            return (0, ts_utils_1.succeed)(bundle.metadata);
+        })
+            .withErrorFormat((err) => {
+            return `Not a bundle file: ${err}`;
+        });
+    }
+    /**
+     * Parses bundle data from a JSON string.
+     * Convenience method that combines JSON parsing with bundle component extraction.
+     * @param jsonString - The JSON string containing bundle data
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static parseBundleFromJson(jsonString) {
+        try {
+            const data = JSON.parse(jsonString);
+            return BundleUtils.extractBundleComponents(data);
+        }
+        catch (error) {
+            /* c8 ignore next 1 - defense in depth */
+            return (0, ts_utils_1.fail)(`Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Checks if a file name suggests it might be a bundle file.
+     * This is a heuristic check based on file naming conventions.
+     * @param fileName - The file name to check
+     * @returns True if the file name suggests a bundle file
+     * @public
+     */
+    static isBundleFileName(fileName) {
+        const lowerName = fileName.toLowerCase();
+        return (lowerName.endsWith('.bundle.json') ||
+            lowerName.endsWith('-bundle.json') ||
+            lowerName.endsWith('_bundle.json') ||
+            (lowerName.includes('bundle') && lowerName.endsWith('.json')));
+    }
+}
+exports.BundleUtils = BundleUtils;
+//# sourceMappingURL=bundleUtils.js.map

package/lib/packlets/bundle/convert.d.ts

@@ -0,0 +1,33 @@
+import { Converter } from '@fgv/ts-utils';
+import { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';
+/**
+ * `Converter` for a {@link Bundle.IBundleMetadata | bundle metadata} object.
+ * @public
+ */
+export declare const bundleMetadata: Converter<IBundleMetadata>;
+/**
+ * `Converter` for {@link Bundle.IBundleExportMetadata | bundle export metadata}.
+ * @public
+ */
+export declare const bundleExportMetadata: Converter<IBundleExportMetadata>;
+/**
+ * `Converter` for a {@link Bundle.IBundle | bundle} object.
+ * @public
+ */
+export declare const bundle: Converter<IBundle>;
+/**
+ * `Converter` for {@link Bundle.IBundleCreateParams | bundle creation parameters}.
+ * @public
+ */
+export declare const bundleCreateParams: Converter<IBundleCreateParams>;
+/**
+ * Lightweight converter for bundle structure validation without full processing.
+ * Useful for detecting bundle files without the overhead of full validation.
+ * @public
+ */
+export declare const bundleStructure: Converter<{
+    metadata: IBundleMetadata;
+    config: unknown;
+    compiledCollection: unknown;
+}>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/packlets/bundle/convert.js

@@ -0,0 +1,78 @@
+"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.bundleStructure = exports.bundleCreateParams = exports.bundle = exports.bundleExportMetadata = exports.bundleMetadata = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const config_1 = require("../config");
+const resource_json_1 = require("../resource-json");
+/**
+ * `Converter` for a {@link Bundle.IBundleMetadata | bundle metadata} object.
+ * @public
+ */
+exports.bundleMetadata = ts_utils_1.Converters.strictObject({
+    dateBuilt: ts_utils_1.Converters.string,
+    checksum: ts_utils_1.Converters.string,
+    version: ts_utils_1.Converters.string.optional(),
+    description: ts_utils_1.Converters.string.optional()
+});
+/**
+ * `Converter` for {@link Bundle.IBundleExportMetadata | bundle export metadata}.
+ * @public
+ */
+exports.bundleExportMetadata = ts_utils_1.Converters.strictObject({
+    exportedAt: ts_utils_1.Converters.string,
+    exportedFrom: ts_utils_1.Converters.string,
+    type: ts_utils_1.Converters.string,
+    filterContext: ts_json_base_1.Converters.jsonObject.optional()
+});
+/**
+ * `Converter` for a {@link Bundle.IBundle | bundle} object.
+ * @public
+ */
+exports.bundle = ts_utils_1.Converters.strictObject({
+    metadata: exports.bundleMetadata,
+    config: config_1.Convert.systemConfiguration,
+    compiledCollection: resource_json_1.Compiled.Convert.compiledResourceCollection,
+    exportMetadata: exports.bundleExportMetadata.optional()
+});
+/**
+ * `Converter` for {@link Bundle.IBundleCreateParams | bundle creation parameters}.
+ * @public
+ */
+exports.bundleCreateParams = ts_utils_1.Converters.strictObject({
+    version: ts_utils_1.Converters.string.optional(),
+    description: ts_utils_1.Converters.string.optional(),
+    dateBuilt: ts_utils_1.Converters.string.optional()
+});
+/**
+ * Lightweight converter for bundle structure validation without full processing.
+ * Useful for detecting bundle files without the overhead of full validation.
+ * @public
+ */
+exports.bundleStructure = ts_utils_1.Converters.strictObject({
+    metadata: exports.bundleMetadata,
+    config: ts_json_base_1.Converters.jsonValue,
+    compiledCollection: ts_json_base_1.Converters.jsonValue
+});
+//# sourceMappingURL=convert.js.map

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

@@ -0,0 +1,21 @@
+/**
+ * Bundle packlet providing functionality for creating and loading resource bundles.
+ *
+ * Resource bundles encapsulate compiled resources, configuration, and metadata with
+ * integrity verification. They provide a portable way to distribute pre-compiled
+ * resource collections.
+ *
+ * @packageDocumentation
+ */
+import * as Model from './model';
+import * as Convert from './convert';
+export type { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';
+export { BundleBuilder } from './bundleBuilder';
+export { BundleLoader } from './bundleLoader';
+export type { IBundleLoaderCreateParams } from './bundleLoader';
+export { BundleUtils } from './bundleUtils';
+export type { IBundleComponents } from './bundleUtils';
+export { Model, Convert };
+/** @internal */
+export { BundleNormalizer } from './bundleNormalizer';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/bundle/index.js

@@ -0,0 +1,83 @@
+"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.BundleNormalizer = exports.Convert = exports.Model = exports.BundleUtils = exports.BundleLoader = exports.BundleBuilder = void 0;
+/**
+ * Bundle packlet providing functionality for creating and loading resource bundles.
+ *
+ * Resource bundles encapsulate compiled resources, configuration, and metadata with
+ * integrity verification. They provide a portable way to distribute pre-compiled
+ * resource collections.
+ *
+ * @packageDocumentation
+ */
+const Model = __importStar(require("./model"));
+exports.Model = Model;
+const Convert = __importStar(require("./convert"));
+exports.Convert = Convert;
+// Builder and loader classes
+var bundleBuilder_1 = require("./bundleBuilder");
+Object.defineProperty(exports, "BundleBuilder", { enumerable: true, get: function () { return bundleBuilder_1.BundleBuilder; } });
+var bundleLoader_1 = require("./bundleLoader");
+Object.defineProperty(exports, "BundleLoader", { enumerable: true, get: function () { return bundleLoader_1.BundleLoader; } });
+// Utilities
+var bundleUtils_1 = require("./bundleUtils");
+Object.defineProperty(exports, "BundleUtils", { enumerable: true, get: function () { return bundleUtils_1.BundleUtils; } });
+// Internal utilities (not part of public API)
+/** @internal */
+var bundleNormalizer_1 = require("./bundleNormalizer");
+Object.defineProperty(exports, "BundleNormalizer", { enumerable: true, get: function () { return bundleNormalizer_1.BundleNormalizer; } });
+//# sourceMappingURL=index.js.map

package/lib/packlets/bundle/model.d.ts

@@ -0,0 +1,100 @@
+import { Hash } from '@fgv/ts-utils';
+import { Model as ConfigModel } from '../config';
+import { Compiled as ResourceJsonCompiled } from '../resource-json';
+/**
+ * Metadata for a resource bundle, including build information and integrity verification.
+ * @public
+ */
+export interface IBundleMetadata {
+    /**
+     * ISO timestamp indicating when the bundle was built.
+     */
+    dateBuilt: string;
+    /**
+     * SHA-256 checksum of the serialized compiled resource collection for integrity verification.
+     */
+    checksum: string;
+    /**
+     * Optional version identifier for the bundle.
+     */
+    version?: string;
+    /**
+     * Optional human-readable description of the bundle.
+     */
+    description?: string;
+}
+/**
+ * Optional export metadata for tracking bundle export information.
+ * @public
+ */
+export interface IBundleExportMetadata {
+    /**
+     * ISO timestamp indicating when the bundle was exported.
+     */
+    exportedAt: string;
+    /**
+     * Tool or application that exported the bundle.
+     */
+    exportedFrom: string;
+    /**
+     * Type of bundle export (e.g., 'ts-res-bundle', 'ts-res-bundle-filtered').
+     */
+    type: string;
+    /**
+     * Optional filter context if the bundle represents filtered data.
+     */
+    filterContext?: Record<string, unknown>;
+}
+/**
+ * A complete resource bundle that encapsulates built resources, configuration, and metadata.
+ * Bundles provide a portable, integrity-verified way to distribute pre-compiled resource collections.
+ * @public
+ */
+export interface IBundle {
+    /**
+     * Metadata about the bundle including build date and integrity checksum.
+     */
+    metadata: IBundleMetadata;
+    /**
+     * The system configuration that was used to build the resources in this bundle.
+     */
+    config: ConfigModel.ISystemConfiguration;
+    /**
+     * The compiled resource collection containing all resources, conditions, and decisions.
+     */
+    compiledCollection: ResourceJsonCompiled.ICompiledResourceCollection;
+    /**
+     * Optional export metadata for tracking when and how the bundle was exported.
+     */
+    exportMetadata?: IBundleExportMetadata;
+}
+/**
+ * Optional parameters for bundle creation.
+ * @public
+ */
+export interface IBundleCreateParams {
+    /**
+     * Optional version identifier to include in the bundle metadata.
+     */
+    version?: string;
+    /**
+     * Optional description to include in the bundle metadata.
+     */
+    description?: string;
+    /**
+     * Optional custom build date. If not provided, the current date will be used.
+     */
+    dateBuilt?: string;
+    /**
+     * Optional hash normalizer for generating checksums. If not provided,
+     * a CRC32 normalizer will be used for browser compatibility.
+     */
+    hashNormalizer?: Hash.HashingNormalizer;
+    /**
+     * Whether to normalize the ResourceManagerBuilder before bundle creation.
+     * When true, the builder is reconstructed in canonical order to ensure
+     * order-independent checksums. Defaults to false for Phase 1 compatibility.
+     */
+    normalize?: boolean;
+}
+//# sourceMappingURL=model.d.ts.map

package/lib/packlets/bundle/model.js

@@ -0,0 +1,24 @@
+"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 });
+//# sourceMappingURL=model.js.map

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

@@ -31,4 +31,11 @@ export declare function joinResourceIds(...ids: (string | undefined)[]): Result<
  * @public
  */
 export declare function joinOptionalResourceIds(...ids: (string | undefined)[]): Result<ResourceId | 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.
+ * @public
+ */
+export declare function getNameForResourceId(id: string | undefined): Result<ResourceName>;
 //# sourceMappingURL=resources.d.ts.map

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

@@ -24,6 +24,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.splitResourceId = splitResourceId;
 exports.joinResourceIds = joinResourceIds;
 exports.joinOptionalResourceIds = joinOptionalResourceIds;
+exports.getNameForResourceId = getNameForResourceId;
 const ts_utils_1 = require("@fgv/ts-utils");
 const resources_1 = require("../validate/resources");
 /**
@@ -82,4 +83,15 @@ function joinOptionalResourceIds(...ids) {
     const id = parts.join('.');
     return errors.returnOrReport(id ? (0, resources_1.toResourceId)(id) : (0, ts_utils_1.succeed)(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.
+ * @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');
+    });
+}
 //# sourceMappingURL=resources.js.map

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

@@ -38,4 +38,12 @@ export type ResourceValueMergeMethod = 'augment' | 'delete' | 'replace';
  * @public
  */
 export declare const allResourceValueMergeMethods: ResourceValueMergeMethod[];
+/**
+ * The completeness of a resource candidate value.  A full value is one that
+ * contains all of the required properties for the resource type.  A partial
+ * value is one that contains some of the required properties for the resource
+ * type.
+ * @public
+ */
+export type CandidateCompleteness = 'full' | 'partial';
 //# sourceMappingURL=resources.d.ts.map

package/lib/packlets/conditions/conditionSet.d.ts

@@ -2,6 +2,7 @@ import { Collections, Result } from '@fgv/ts-utils';
 import { Condition } from './condition';
 import { ConditionSetIndex, ConditionSetKey, QualifierName } from '../common';
 import { IValidatedConditionSetDecl } from './conditionSetDecls';
+import { ConditionCollector } from './conditionCollector';
 import * as ResourceJson from '../resource-json';
 import * as Context from '../context';
 /**
@@ -93,6 +94,14 @@ export declare class ConditionSet implements IValidatedConditionSetDecl {
      * @public
      */
     static getKeyForDecl(decl: IValidatedConditionSetDecl): Result<ConditionSetKey>;
+    /**
+     * Gets a condition set key from a loose condition set declaration.
+     * @param conditionSet - The loose condition set declaration to convert.
+     * @param conditionCollector - The condition collector used for validation.
+     * @returns `Success` with the condition set key if successful, `Failure` otherwise.
+     * @public
+     */
+    static getKeyFromLooseDecl(conditionSet: ResourceJson.Json.ConditionSetDecl | undefined, conditionCollector: ConditionCollector): Result<ConditionSetKey>;
     /**
      * Gets a {@link ConditionSetToken | condition set token} for this condition set,
      * if possible.