@fgv/ts-res 5.1.0-3 → 5.1.0-31

package/dist/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,iEAAiE;AAEjE,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,0HAA0H;AAC1H,OAAO,KAAK,MAAM,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,0HAA0H;AAC1H,OAAO,KAAK,MAAM,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,0HAA0H;AAC1H,OAAO,KAAK,UAAU,MAAM,sCAAsC,CAAC;AAEnE,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAoB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EACL,MAAM,EACN,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,MAAM,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,MAAM,EAEN,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,OAAO,EACP,UAAU,EACX,CAAC;AAEF,yBAAyB;AACzB,kFAAkF;AAClF,sFAAsF;AACtF,gFAAgF","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// Browser entry point - excludes Node.js filesystem dependencies\n\nimport * as Bundle from './packlets/bundle';\nimport * as QualifierTypes from './packlets/qualifier-types';\nimport * as Qualifiers from './packlets/qualifiers';\nimport * as Conditions from './packlets/conditions';\n// eslint-disable-next-line @rushstack/packlets/mechanics -- browser-specific entry point excludes Node.js fs dependencies\nimport * as Config from './packlets/config/index.browser';\nimport * as Context from './packlets/context';\nimport * as Decisions from './packlets/decisions';\nimport * as ResourceJson from './packlets/resource-json';\nimport * as Resources from './packlets/resources';\nimport * as ResourceTypes from './packlets/resource-types';\n// eslint-disable-next-line @rushstack/packlets/mechanics -- browser-specific entry point excludes Node.js fs dependencies\nimport * as Import from './packlets/import/index.browser';\nimport * as Runtime from './packlets/runtime';\n// eslint-disable-next-line @rushstack/packlets/mechanics -- browser-specific entry point excludes Node.js fs dependencies\nimport * as ZipArchive from './packlets/zip-archive/index.browser';\n\nexport * from './packlets/common';\n\nimport { Condition, ConditionSet } from './packlets/conditions';\nimport { Decision } from './packlets/decisions';\nimport { QualifierType } from './packlets/qualifier-types';\nimport { Qualifier } from './packlets/qualifiers';\nimport { ResourceType } from './packlets/resource-types';\nimport { Resource, ResourceCandidate, ResourceManagerBuilder } from './packlets/resources';\nimport { IResourceManager, ResourceResolver } from './packlets/runtime';\nimport { BundleBuilder, BundleLoader } from './packlets/bundle';\n\nexport {\n  Bundle,\n  BundleBuilder,\n  BundleLoader,\n  Condition,\n  Conditions,\n  ConditionSet,\n  Config,\n  Context,\n  Decision,\n  Decisions,\n  Import,\n  IResourceManager,\n  Qualifier,\n  QualifierType,\n  QualifierTypes,\n  Qualifiers,\n  Resource,\n  ResourceCandidate,\n  ResourceJson,\n  ResourceResolver,\n  ResourceManagerBuilder,\n  ResourceType,\n  ResourceTypes,\n  Resources,\n  Runtime,\n  ZipArchive\n};\n\n// Excluded from browser:\n// - Config: SystemConfiguration.loadFromFile() (requires Node.js fs via JsonFile)\n// - Import: PathImporter, FsItemImporter, FsItem.createForPath() (require Node.js fs)\n// - ZipArchive: ZipArchiveCreator methods using file paths (require Node.js fs)\n"]}

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAErD,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAoB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EACL,MAAM,EACN,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,MAAM,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,MAAM,EAEN,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,OAAO,EACP,UAAU,EACX,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Bundle from './packlets/bundle';\nimport * as QualifierTypes from './packlets/qualifier-types';\nimport * as Qualifiers from './packlets/qualifiers';\nimport * as Conditions from './packlets/conditions';\nimport * as Config from './packlets/config';\nimport * as Context from './packlets/context';\nimport * as Decisions from './packlets/decisions';\nimport * as ResourceJson from './packlets/resource-json';\nimport * as Resources from './packlets/resources';\nimport * as ResourceTypes from './packlets/resource-types';\nimport * as Import from './packlets/import';\nimport * as Runtime from './packlets/runtime';\nimport * as ZipArchive from './packlets/zip-archive';\n\nexport * from './packlets/common';\n\nimport { Condition, ConditionSet } from './packlets/conditions';\nimport { Decision } from './packlets/decisions';\nimport { QualifierType } from './packlets/qualifier-types';\nimport { Qualifier } from './packlets/qualifiers';\nimport { ResourceType } from './packlets/resource-types';\nimport { Resource, ResourceCandidate, ResourceManagerBuilder } from './packlets/resources';\nimport { IResourceManager, ResourceResolver } from './packlets/runtime';\nimport { BundleBuilder, BundleLoader } from './packlets/bundle';\n\nexport {\n  Bundle,\n  BundleBuilder,\n  BundleLoader,\n  Condition,\n  Conditions,\n  ConditionSet,\n  Config,\n  Context,\n  Decision,\n  Decisions,\n  Import,\n  IResourceManager,\n  Qualifier,\n  QualifierType,\n  QualifierTypes,\n  Qualifiers,\n  Resource,\n  ResourceCandidate,\n  ResourceJson,\n  ResourceResolver,\n  ResourceManagerBuilder,\n  ResourceType,\n  ResourceTypes,\n  Resources,\n  Runtime,\n  ZipArchive\n};\n"]}

package/dist/packlets/bundle/bundleBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleBuilder.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleBuilder.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 { Result, succeed, Hash } from '@fgv/ts-utils';\nimport { ResourceManagerBuilder } from '../resources';\nimport {\n  SystemConfiguration,\n  PredefinedSystemConfiguration,\n  getPredefinedSystemConfiguration\n} from '../config';\nimport { IBundle, IBundleCreateParams, IBundleMetadata } from './model';\nimport { BundleNormalizer } from './bundleNormalizer';\n\n/**\n * Builder for creating resource bundles from a ResourceManagerBuilder.\n * Handles the compilation, configuration extraction, and integrity verification\n * needed to create a complete, portable bundle.\n * @public\n */\nexport class BundleBuilder {\n  /**\n   * Creates a resource bundle from a ResourceManagerBuilder.\n   * @param builder - The ResourceManagerBuilder containing the resources to bundle\n   * @param systemConfig - The SystemConfiguration used to create the builder\n   * @param params - Optional parameters for bundle creation\n   * @returns Success with the created bundle if successful, Failure with error message otherwise\n   * @public\n   */\n  public static create(\n    builder: ResourceManagerBuilder,\n    systemConfig: SystemConfiguration,\n    params?: IBundleCreateParams\n  ): Result<IBundle> {\n    /* c8 ignore next 2 - defense in depth */\n    params = params ?? {};\n    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();\n\n    const builderToUse =\n      params.normalize === true\n        ? BundleNormalizer.normalize(builder, systemConfig)\n        : /* c8 ignore next 1 - is tested but coverage gets confused */\n          succeed(builder);\n\n    return builderToUse.onSuccess((targetBuilder) => {\n      return systemConfig.getConfig().onSuccess((config) => {\n        return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {\n          return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess((checksum) => {\n            /* c8 ignore next 1 - defense in depth */\n            const dateBuilt = params.dateBuilt ?? new Date().toISOString();\n\n            const metadata: IBundleMetadata = {\n              dateBuilt,\n              checksum,\n              version: params.version,\n              description: params.description\n            };\n\n            const bundle: IBundle = {\n              metadata,\n              config,\n              compiledCollection\n            };\n\n            return succeed(bundle);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Creates a resource bundle from a ResourceManagerBuilder using a predefined system configuration.\n   * This is a convenience method for the common case of using predefined configurations.\n   * @param builder - The ResourceManagerBuilder containing the resources to bundle\n   * @param configName - The name of the predefined system configuration used\n   * @param params - Optional parameters for bundle creation\n   * @returns Success with the created bundle if successful, Failure with error message otherwise\n   * @public\n   */\n  public static createFromPredefined(\n    builder: ResourceManagerBuilder,\n    configName: PredefinedSystemConfiguration,\n    params?: IBundleCreateParams\n  ): Result<IBundle> {\n    /* c8 ignore next 1 */\n    params = params ?? {};\n    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();\n\n    // Determine which builder to use based on normalization setting\n    const builderToUse = params.normalize\n      ? BundleNormalizer.normalizeFromPredefined(builder, configName)\n      : succeed(builder);\n\n    return builderToUse.onSuccess((targetBuilder) => {\n      return getPredefinedSystemConfiguration(configName).onSuccess((systemConfig) => {\n        return systemConfig.getConfig().onSuccess((config) => {\n          return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {\n            return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess(\n              (checksum) => {\n                /* c8 ignore next 1 - defense in depth */\n                const dateBuilt = params.dateBuilt ?? new Date().toISOString();\n\n                const metadata: IBundleMetadata = {\n                  dateBuilt,\n                  checksum,\n                  version: params.version,\n                  /* c8 ignore next 1 - defense in depth */\n                  description: params?.description\n                };\n\n                const bundle: IBundle = {\n                  metadata,\n                  config,\n                  compiledCollection\n                };\n\n                return succeed(bundle);\n              }\n            );\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Generates a hash checksum for the compiled resource collection.\n   * The checksum is calculated using the provided hash normalizer.\n   * @param compiledCollection - The compiled resource collection to generate checksum for\n   * @param hashNormalizer - The hash normalizer to use for checksum generation\n   * @returns Success with the checksum string if successful, Failure otherwise\n   * @internal\n   */\n  private static _generateChecksum(\n    compiledCollection: unknown,\n    hashNormalizer: Hash.HashingNormalizer\n  ): Result<string> {\n    return hashNormalizer.computeHash(compiledCollection);\n  }\n}\n"]}

package/dist/packlets/bundle/bundleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleLoader.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAU,OAAO,EAAE,IAAI,EAAe,IAAI,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAoB,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AA6BhD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;OAKG;IACI,MAAM,CAAC,uBAAuB,CAAC,MAAiC;;QACrE,yCAAyC;QACzC,MAAM,cAAc,GAAG,MAAA,MAAM,CAAC,cAAc,mCAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QAE3E,OAAO,YAAY,CAAC,sBAAsB,CACxC,MAAM,CAAC,MAAM,EACb,MAAA,MAAM,CAAC,wBAAwB,mCAAI,KAAK,EACxC,cAAc,CACf,CAAC,SAAS,CAAC,GAAG,EAAE;YACf,OAAO,YAAY,CAAC,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,YAAY,EAAE,EAAE;gBACvF,OAAO,YAAY,CAAC,iCAAiC,CACnD,MAAM,CAAC,MAAM,EACb,YAAY,CAAC,cAAc,EAC3B,YAAY,CAAC,aAAa,CAC3B,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,sBAAsB,CACnC,MAAe,EACf,gBAAyB,EACzB,cAAsC;QAEtC,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,YAAY,CAAC,iBAAiB,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC,SAAS,CACxF,CAAC,kBAAkB,EAAE,EAAE;YACrB,IAAI,kBAAkB,KAAK,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACpD,OAAO,IAAI,CACT,2DAA2D,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAS,kBAAkB,EAAE,CACjH,CAAC;YACJ,CAAC;YACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,iBAAiB,CAC9B,kBAA2B,EAC3B,cAAsC;QAEtC,OAAO,cAAc,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,0BAA0B,CAAC,MAAe;QACvD,OAAO,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,iCAAiC,CAC9C,MAAe,EACf,cAAqE,EACrE,aAAmE;QAEnE,OAAO,0BAA0B,CAAC,MAAM,CAAC;YACvC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,cAAc;YACd,aAAa;SACd,CAAC,CAAC;IACL,CAAC;CACF","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 { Result, succeed, fail, Collections, Hash } from '@fgv/ts-utils';\nimport { CompiledResourceCollection, IResourceManager } from '../runtime';\nimport { SystemConfiguration } from '../config';\nimport { ResourceType } from '../resource-types';\nimport { QualifierType } from '../qualifier-types';\nimport { IBundle } from './model';\n\n/**\n * Parameters for creating a BundleLoader.\n * @public\n */\nexport interface IBundleLoaderCreateParams {\n  /**\n   * The bundle to load.\n   */\n  bundle: IBundle;\n\n  /**\n   * Whether to skip checksum verification during loading.\n   * Default is false - checksum verification is performed.\n   */\n  skipChecksumVerification?: boolean;\n\n  /**\n   * Optional hash normalizer for verifying checksums. If not provided,\n   * a CRC32 normalizer will be used for browser compatibility.\n   * Must match the normalizer used during bundle creation.\n   */\n  hashNormalizer?: Hash.HashingNormalizer;\n}\n\n/**\n * Loader for creating an IResourceManager from a resource bundle.\n * Handles integrity verification and reconstruction of the runtime resource manager.\n * @public\n */\nexport class BundleLoader {\n  /**\n   * Creates an IResourceManager from a resource bundle.\n   * @param params - Parameters for bundle loading including the bundle and options\n   * @returns Success with the IResourceManager if successful, Failure with error message otherwise\n   * @public\n   */\n  public static createManagerFromBundle(params: IBundleLoaderCreateParams): Result<IResourceManager> {\n    /* c8 ignore next 1 - defense in depth */\n    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();\n\n    return BundleLoader._verifyBundleIntegrity(\n      params.bundle,\n      params.skipChecksumVerification ?? false,\n      hashNormalizer\n    ).onSuccess(() => {\n      return BundleLoader._createSystemConfiguration(params.bundle).onSuccess((systemConfig) => {\n        return BundleLoader._createCompiledResourceCollection(\n          params.bundle,\n          systemConfig.qualifierTypes,\n          systemConfig.resourceTypes\n        );\n      });\n    });\n  }\n\n  /**\n   * Verifies the integrity of a bundle by checking its checksum.\n   * @param bundle - The bundle to verify\n   * @param skipVerification - Whether to skip verification\n   * @param hashNormalizer - The hash normalizer to use for verification\n   * @returns Success if verification passes or is skipped, Failure otherwise\n   * @internal\n   */\n  private static _verifyBundleIntegrity(\n    bundle: IBundle,\n    skipVerification: boolean,\n    hashNormalizer: Hash.HashingNormalizer\n  ): Result<boolean> {\n    if (skipVerification) {\n      return succeed(true);\n    }\n\n    return BundleLoader._generateChecksum(bundle.compiledCollection, hashNormalizer).onSuccess(\n      (calculatedChecksum) => {\n        if (calculatedChecksum !== bundle.metadata.checksum) {\n          return fail(\n            `Bundle integrity verification failed: expected checksum ${bundle.metadata.checksum}, got ${calculatedChecksum}`\n          );\n        }\n        return succeed(true);\n      }\n    );\n  }\n\n  /**\n   * Generates a hash checksum for the compiled resource collection.\n   * @param compiledCollection - The compiled resource collection to generate checksum for\n   * @param hashNormalizer - The hash normalizer to use for checksum generation\n   * @returns Success with the checksum string if successful, Failure otherwise\n   * @internal\n   */\n  private static _generateChecksum(\n    compiledCollection: unknown,\n    hashNormalizer: Hash.HashingNormalizer\n  ): Result<string> {\n    return hashNormalizer.computeHash(compiledCollection);\n  }\n\n  /**\n   * Creates a SystemConfiguration from the bundle's configuration.\n   * @param bundle - The bundle containing the configuration\n   * @returns Success with the SystemConfiguration if successful, Failure otherwise\n   * @internal\n   */\n  private static _createSystemConfiguration(bundle: IBundle): Result<SystemConfiguration> {\n    return SystemConfiguration.create(bundle.config);\n  }\n\n  /**\n   * Creates a CompiledResourceCollection from the bundle.\n   * @param bundle - The bundle to load\n   * @param qualifierTypes - The qualifier type collector from the system configuration\n   * @param resourceTypes - The resource type collector from the system configuration\n   * @returns Success with the CompiledResourceCollection if successful, Failure otherwise\n   * @internal\n   */\n  private static _createCompiledResourceCollection(\n    bundle: IBundle,\n    qualifierTypes: Collections.IReadOnlyResultMap<string, QualifierType>,\n    resourceTypes: Collections.IReadOnlyResultMap<string, ResourceType>\n  ): Result<CompiledResourceCollection> {\n    return CompiledResourceCollection.create({\n      compiledCollection: bundle.compiledCollection,\n      qualifierTypes,\n      resourceTypes\n    });\n  }\n}\n"]}

package/dist/packlets/bundle/bundleNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleNormalizer.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleNormalizer.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 { Result, succeed, MessageAggregator } from '@fgv/ts-utils';\nimport { ResourceManagerBuilder } from '../resources';\nimport { ResourceCandidate } from '../resources';\nimport { SystemConfiguration, PredefinedSystemConfiguration } from '../config';\nimport { Condition, ConditionSet } from '../conditions';\n\n/**\n * Normalizes ResourceManagerBuilder instances to ensure consistent ordering\n * of internal entities, enabling order-independent bundle checksums.\n *\n * The normalization process rebuilds the ResourceManagerBuilder from the ground up\n * in a canonical order to ensure identical index assignments regardless of\n * original construction order.\n * @public\n */\nexport class BundleNormalizer {\n  /**\n   * Creates a normalized ResourceManagerBuilder from an existing builder.\n   * The normalized builder will have identical entities but arranged in\n   * canonical order to ensure consistent index assignments.\n   *\n   * @param originalBuilder - The ResourceManagerBuilder to normalize\n   * @param systemConfig - The SystemConfiguration used to create the original builder\n   * @returns Success with the normalized ResourceManagerBuilder if successful, Failure otherwise\n   */\n  public static normalize(\n    originalBuilder: ResourceManagerBuilder,\n    systemConfig: SystemConfiguration\n  ): Result<ResourceManagerBuilder> {\n    // Create a fresh builder using the same system configuration\n    return ResourceManagerBuilder.create({\n      qualifiers: systemConfig.qualifiers,\n      resourceTypes: systemConfig.resourceTypes\n    }).onSuccess((normalizedBuilder) => {\n      return BundleNormalizer._addNormalizedResources(originalBuilder, normalizedBuilder).onSuccess(() =>\n        succeed(normalizedBuilder)\n      );\n    });\n  }\n\n  /**\n   * Creates a normalized ResourceManagerBuilder using a predefined system configuration.\n   * This is a convenience method for the common case of using predefined configurations.\n   *\n   * @param originalBuilder - The ResourceManagerBuilder to normalize\n   * @param configName - The name of the predefined system configuration used\n   * @returns Success with the normalized ResourceManagerBuilder if successful, Failure otherwise\n   */\n  public static normalizeFromPredefined(\n    originalBuilder: ResourceManagerBuilder,\n    configName: PredefinedSystemConfiguration\n  ): Result<ResourceManagerBuilder> {\n    return ResourceManagerBuilder.createPredefined(configName).onSuccess((normalizedBuilder) => {\n      return BundleNormalizer._addNormalizedResources(originalBuilder, normalizedBuilder).onSuccess(() =>\n        succeed(normalizedBuilder)\n      );\n    });\n  }\n\n  /**\n   * Normalizes all conditions from the original builder by adding them to the\n   * normalized builder in sorted order using loose condition declarations.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all conditions were normalized successfully, Failure otherwise\n   * @internal\n   */\n  private static _normalizeConditions(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    const conditions = Array.from(originalBuilder.conditions.values()).sort(Condition.compare);\n\n    const errors = new MessageAggregator();\n    for (const condition of conditions) {\n      const looseDecl = condition.toLooseConditionDecl();\n      normalizedBuilder.addCondition(looseDecl).aggregateError(errors);\n    }\n\n    return errors.returnOrReport(succeed(true));\n  }\n\n  /**\n   * Normalizes all condition sets from the original builder by adding them to the\n   * normalized builder in sorted order using loose condition set declarations.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all condition sets were normalized successfully, Failure otherwise\n   * @internal\n   */\n  private static _normalizeConditionSets(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    const conditionSets = Array.from(originalBuilder.conditionSets.values()).sort(ConditionSet.compare);\n\n    const errors = new MessageAggregator();\n    for (const conditionSet of conditionSets) {\n      const conditions = conditionSet.toConditionSetArrayDecl();\n      normalizedBuilder.addConditionSet(conditions).aggregateError(errors);\n    }\n\n    return errors.returnOrReport(succeed(true));\n  }\n\n  /**\n   * Normalizes all candidates by sorting them first by resource ID, then by condition set.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all candidates were normalized successfully, Failure otherwise\n   * @internal\n   */\n  private static _normalizeCandidates(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    const candidates = Array.from(originalBuilder.getAllCandidates()).sort((c1, c2) => {\n      const idCompare = c1.id.localeCompare(c2.id);\n      return idCompare !== 0 ? idCompare : ResourceCandidate.compare(c1, c2);\n    });\n\n    const errors = new MessageAggregator();\n    for (const candidate of candidates) {\n      const decl = candidate.toLooseResourceCandidateDecl();\n      normalizedBuilder.addLooseCandidate(decl).aggregateError(errors);\n    }\n\n    return errors.returnOrReport(succeed(true));\n  }\n\n  /**\n   * Adds normalized resources to the target builder by first normalizing conditions,\n   * then condition sets, then candidates.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all resources were added successfully, Failure otherwise\n   * @internal\n   */\n  private static _addNormalizedResources(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    return BundleNormalizer._normalizeConditions(originalBuilder, normalizedBuilder)\n      .onSuccess(() => BundleNormalizer._normalizeConditionSets(originalBuilder, normalizedBuilder))\n      .onSuccess(() => BundleNormalizer._normalizeCandidates(originalBuilder, normalizedBuilder));\n  }\n}\n"]}

package/dist/packlets/bundle/bundleUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleUtils.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAU,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,WAAW,CAAC;AAuBtD;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACtB;;;;;;OAMG;IACI,MAAM,CAAC,YAAY,CAAC,IAAa;QACtC,OAAO,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,uBAAuB,CAAC,UAAmB;QACvD,OAAO,eAAe;aACnB,OAAO,CAAC,UAAU,CAAC;aACnB,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,6BAA6B,GAAG,EAAE,CAAC;aAC5D,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACpB,OAAO,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;iBAC7C,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,2CAA2C,GAAG,EAAE,CAAC;iBAC1E,SAAS,CAAC,CAAC,mBAAmB,EAAE,EAAE;gBACjC,OAAO,OAAO,CAAC;oBACb,mBAAmB;oBACnB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;oBAC7C,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC1B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,qBAAqB,CAAC,IAAa;QAC/C,OAAO,eAAe;aACnB,OAAO,CAAC,IAAI,CAAC;aACb,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACpB,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;aACD,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE;YACvB,OAAO,sBAAsB,GAAG,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,mBAAmB,CAAC,UAAkB;QAClD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACpC,OAAO,WAAW,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,OAAO,IAAI,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,OAAO,CACL,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;YAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;YAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;YAClC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAC9D,CAAC;IACJ,CAAC;CACF","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 { Result, succeed, fail } from '@fgv/ts-utils';\nimport { SystemConfiguration } from '../config';\nimport { Compiled as ResourceJsonCompiled } from '../resource-json';\nimport { IBundleMetadata } from './model';\nimport { bundle as bundleConverter } from './convert';\n\n/**\n * Components extracted from a bundle for reuse in different contexts.\n * @public\n */\nexport interface IBundleComponents {\n  /**\n   * The system configuration from the bundle.\n   */\n  systemConfiguration: SystemConfiguration;\n\n  /**\n   * The compiled resource collection from the bundle.\n   */\n  compiledCollection: ResourceJsonCompiled.ICompiledResourceCollection;\n\n  /**\n   * The bundle metadata including build information.\n   */\n  metadata: IBundleMetadata;\n}\n\n/**\n * Utility functions for working with resource bundles.\n * Provides reusable logic for bundle detection, parsing, and component extraction.\n * @public\n */\nexport class BundleUtils {\n  /**\n   * Checks if the given object appears to be a bundle file by examining its structure.\n   * This is a lightweight check that doesn't perform full validation.\n   * @param data - The data to check\n   * @returns True if the data appears to be a bundle structure\n   * @public\n   */\n  public static isBundleFile(data: unknown): boolean {\n    return bundleConverter.convert(data).isSuccess();\n  }\n\n  /**\n   * Extracts and validates components from a bundle for reuse.\n   * Performs full validation of the bundle structure and creates typed components.\n   * @param bundleData - The raw bundle data to extract components from\n   * @returns Success with bundle components if valid, Failure with error message otherwise\n   * @public\n   */\n  public static extractBundleComponents(bundleData: unknown): Result<IBundleComponents> {\n    return bundleConverter\n      .convert(bundleData)\n      .withErrorFormat((err) => `Invalid bundle structure: ${err}`)\n      .onSuccess((bundle) => {\n        return SystemConfiguration.create(bundle.config)\n          .withErrorFormat((err) => `Invalid system configuration in bundle: ${err}`)\n          .onSuccess((systemConfiguration) => {\n            return succeed({\n              systemConfiguration,\n              compiledCollection: bundle.compiledCollection,\n              metadata: bundle.metadata\n            });\n          });\n      });\n  }\n\n  /**\n   * Extracts just the metadata from potential bundle data without full validation.\n   * Useful for displaying bundle information without processing the entire bundle.\n   * @param data - The data to extract metadata from\n   * @returns Success with metadata if found and valid, Failure otherwise\n   * @public\n   */\n  public static extractBundleMetadata(data: unknown): Result<IBundleMetadata> {\n    return bundleConverter\n      .convert(data)\n      .onSuccess((bundle) => {\n        return succeed(bundle.metadata);\n      })\n      .withErrorFormat((err) => {\n        return `Not a bundle file: ${err}`;\n      });\n  }\n\n  /**\n   * Parses bundle data from a JSON string.\n   * Convenience method that combines JSON parsing with bundle component extraction.\n   * @param jsonString - The JSON string containing bundle data\n   * @returns Success with bundle components if valid, Failure with error message otherwise\n   * @public\n   */\n  public static parseBundleFromJson(jsonString: string): Result<IBundleComponents> {\n    try {\n      const data = JSON.parse(jsonString);\n      return BundleUtils.extractBundleComponents(data);\n    } catch (error) {\n      /* c8 ignore next 1 - defense in depth */\n      return fail(`Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Checks if a file name suggests it might be a bundle file.\n   * This is a heuristic check based on file naming conventions.\n   * @param fileName - The file name to check\n   * @returns True if the file name suggests a bundle file\n   * @public\n   */\n  public static isBundleFileName(fileName: string): boolean {\n    const lowerName = fileName.toLowerCase();\n    return (\n      lowerName.endsWith('.bundle.json') ||\n      lowerName.endsWith('-bundle.json') ||\n      lowerName.endsWith('_bundle.json') ||\n      (lowerName.includes('bundle') && lowerName.endsWith('.json'))\n    );\n  }\n}\n"]}

package/dist/packlets/bundle/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/bundle/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAa,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGpE;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAA+B,UAAU,CAAC,YAAY,CAAkB;IACjG,SAAS,EAAE,UAAU,CAAC,MAAM;IAC5B,QAAQ,EAAE,UAAU,CAAC,MAAM;IAC3B,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,UAAU,CAAC,YAAY,CAAwB;IAC7C,UAAU,EAAE,UAAU,CAAC,MAAM;IAC7B,YAAY,EAAE,UAAU,CAAC,MAAM;IAC/B,IAAI,EAAE,UAAU,CAAC,MAAM;IACvB,aAAa,EAAE,cAAc,CAAC,UAAU,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAuB,UAAU,CAAC,YAAY,CAAU;IACzE,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,aAAa,CAAC,mBAAmB;IACzC,kBAAkB,EAAE,oBAAoB,CAAC,OAAO,CAAC,0BAA0B;IAC3E,cAAc,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,UAAU,CAAC,YAAY,CAAsB;IAC3C,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAIvB,UAAU,CAAC,YAAY,CAAC;IAC3B,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,cAAc,CAAC,SAAS;IAChC,kBAAkB,EAAE,cAAc,CAAC,SAAS;CAC7C,CAAC,CAAC","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 { Converter, Converters } from '@fgv/ts-utils';\nimport { Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { Convert as ConfigConvert } from '../config';\nimport { Compiled as ResourceJsonCompiled } from '../resource-json';\nimport { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';\n\n/**\n * `Converter` for a {@link Bundle.IBundleMetadata | bundle metadata} object.\n * @public\n */\nexport const bundleMetadata: Converter<IBundleMetadata> = Converters.strictObject<IBundleMetadata>({\n  dateBuilt: Converters.string,\n  checksum: Converters.string,\n  version: Converters.string.optional(),\n  description: Converters.string.optional()\n});\n\n/**\n * `Converter` for {@link Bundle.IBundleExportMetadata | bundle export metadata}.\n * @public\n */\nexport const bundleExportMetadata: Converter<IBundleExportMetadata> =\n  Converters.strictObject<IBundleExportMetadata>({\n    exportedAt: Converters.string,\n    exportedFrom: Converters.string,\n    type: Converters.string,\n    filterContext: JsonConverters.jsonObject.optional()\n  });\n\n/**\n * `Converter` for a {@link Bundle.IBundle | bundle} object.\n * @public\n */\nexport const bundle: Converter<IBundle> = Converters.strictObject<IBundle>({\n  metadata: bundleMetadata,\n  config: ConfigConvert.systemConfiguration,\n  compiledCollection: ResourceJsonCompiled.Convert.compiledResourceCollection,\n  exportMetadata: bundleExportMetadata.optional()\n});\n\n/**\n * `Converter` for {@link Bundle.IBundleCreateParams | bundle creation parameters}.\n * @public\n */\nexport const bundleCreateParams: Converter<IBundleCreateParams> =\n  Converters.strictObject<IBundleCreateParams>({\n    version: Converters.string.optional(),\n    description: Converters.string.optional(),\n    dateBuilt: Converters.string.optional()\n  });\n\n/**\n * Lightweight converter for bundle structure validation without full processing.\n * Useful for detecting bundle files without the overhead of full validation.\n * @public\n */\nexport const bundleStructure: Converter<{\n  metadata: IBundleMetadata;\n  config: unknown;\n  compiledCollection: unknown;\n}> = Converters.strictObject({\n  metadata: bundleMetadata,\n  config: JsonConverters.jsonValue,\n  compiledCollection: JsonConverters.jsonValue\n});\n"]}

package/dist/packlets/bundle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/bundle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAKrC,6BAA6B;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAE1B,8CAA8C;AAC9C,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC","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 * Bundle packlet providing functionality for creating and loading resource bundles.\n *\n * Resource bundles encapsulate compiled resources, configuration, and metadata with\n * integrity verification. They provide a portable way to distribute pre-compiled\n * resource collections.\n *\n * @packageDocumentation\n */\n\nimport * as Model from './model';\nimport * as Convert from './convert';\n\n// Model interfaces\nexport type { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';\n\n// Builder and loader classes\nexport { BundleBuilder } from './bundleBuilder';\nexport { BundleLoader } from './bundleLoader';\nexport type { IBundleLoaderCreateParams } from './bundleLoader';\n\n// Utilities\nexport { BundleUtils } from './bundleUtils';\nexport type { IBundleComponents } from './bundleUtils';\n\nexport { Model, Convert };\n\n// Internal utilities (not part of public API)\n/** @internal */\nexport { BundleNormalizer } from './bundleNormalizer';\n"]}

package/dist/packlets/bundle/model.js.map

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

package/dist/packlets/common/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../../src/packlets/common/conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA2DH;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAwB,GAA0B,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwB,GAA0B,CAAC;AAQ5E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAsB,CAAC;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB,IAAyB,CAAC;AAQjF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC","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 { Brand } from '@fgv/ts-utils';\n\n/**\n * Branded string representing a validated qualifier name.\n * @public\n */\nexport type QualifierName = Brand<string, 'QualifierName'>;\n\n/**\n * Branded number representing a validated qualifier index.\n * @public\n */\nexport type QualifierIndex = Brand<number, 'QualifierIndex'>;\n\n/**\n * Branded string representing a validated qualifier type name.\n * @public\n */\nexport type QualifierTypeName = Brand<string, 'QualifierTypeName'>;\n\n/**\n * Branded number representing a validated qualifier type index.\n * @public\n */\nexport type QualifierTypeIndex = Brand<number, 'QualifierTypeIndex'>;\n\n/**\n * Branded type for a validated qualifier condition value - i.e. a value\n * that has been determined to be valid for use in a condition attached\n * to some resource.\n *\n * @example\n * For a language qualifier type, it is likely that a single language\n * tag can be used for either a condition or a context value. However,\n * a list of languages would likely only be valid as a context value.\n * @public\n */\nexport type QualifierConditionValue = Brand<string, 'QualifierConditionValue'>;\n\n/**\n * Branded type for a validated qualifier context value - i.e. a value\n * that has been determined to be valid for use in some runtime context.\n * @example\n * For a language qualifier type, it is likely that a single language\n * tag can be used for either a condition or a context value. However,\n * a list of languages would likely only be valid as a context value.\n * @public\n */\nexport type QualifierContextValue = Brand<string, 'QualifierContextValue'>;\n\n/**\n * Branded number representing a score in the range 0.0 (no match) .. 1.0 (perfect match)\n * which results from evaluating some condition.\n * @public\n */\nexport type QualifierMatchScore = Brand<number, 'QualifierMatchScore'>;\n\n/**\n * {@link QualifierMatchScore | Match score} indicating no match.\n * @public\n */\nexport const NoMatch: QualifierMatchScore = 0.0 as QualifierMatchScore;\n\n/**\n * {@link QualifierMatchScore | Match score} indicating a perfect match.\n * @public\n */\nexport const PerfectMatch: QualifierMatchScore = 1.0 as QualifierMatchScore;\n\n/**\n * Branded number representing a validated condition priority.\n * @public\n */\nexport type ConditionPriority = Brand<number, 'ConditionPriority'>;\n\n/**\n * Minimum valid priority for a condition.\n * @public\n */\nexport const MinConditionPriority: ConditionPriority = 0 as ConditionPriority;\n\n/**\n * Maximum valid priority for a condition.\n * @public\n */\nexport const MaxConditionPriority: ConditionPriority = 1000 as ConditionPriority;\n\n/**\n * Condition operators for use in conditions.\n * @public\n */\nexport type ConditionOperator = 'always' | 'never' | 'matches';\n\n/**\n * Array of all valid condition operators.\n * @public\n */\nexport const allConditionOperators: ConditionOperator[] = ['always', 'never', 'matches'];\n\n/**\n * Branded number representing a validated condition index.\n * @public\n */\nexport type ConditionIndex = Brand<number, 'ConditionIndex'>;\n\n/**\n * A branded string representing a validated condition key.  A condition key is a\n * string value which fully describes the condition apart from index.  The condition\n * key can be used to quickly determine if two conditions are identical apart from\n * index, or for inspection.\n * @public\n */\nexport type ConditionKey = Brand<string, 'ConditionKey'>;\n\n/**\n * A string representing a validated condition token.  Condition tokens are\n * typically extracted from the name of some resource (e.g. file or folder)\n * being imported.   A condition token has the form `<qualifierName>=<value>`\n * or `<value>`.\n * @public\n */\nexport type ConditionToken = Brand<string, 'ConditionToken'>;\n\n/**\n * Branded number representing a validated condition set index.\n * @public\n */\nexport type ConditionSetIndex = Brand<number, 'ConditionSetIndex'>;\n\n/**\n * Branded string representing a validated condition set key. A condition set key\n * is a string value which fully describes the condition set apart from index. The\n * condition set key can be used to quickly determine if two condition sets are\n * identical apart from index, or for inspection.\n * @public\n */\nexport type ConditionSetKey = Brand<string, 'ConditionSetKey'>;\n\n/**\n * A string representing a validated condition set token.  Condition set tokens are\n * typically extracted from the name of some resource (e.g. file or folder) being\n * imported.  A condition set token is a comma-separated list of one or more\n * {@link ConditionToken | condition tokens}, where a condition token has either\n * the form `<qualifierName>=<value>` or `<value>`.\n * @public\n */\nexport type ConditionSetToken = Brand<string, 'ConditionSetToken'>;\n\n/**\n * Branded string representing a hash value for a condition set. The hash value\n * is an 8-character string derived from the crc32 hash of the condition set key\n * and is used to quickly and compactly identify a condition set or compare for\n * equality.\n * @public\n */\nexport type ConditionSetHash = Brand<string, 'ConditionSetHash'>;\n\n/**\n * Branded string representing a validated decision key. A decision key is a string\n * value which fully describes the decision apart from index. The decision key can\n * be used to quickly determine if two decisions are identical apart from index.\n * @public\n */\nexport type DecisionKey = Brand<string, 'DecisionKey'>;\n\n/**\n * Branded number representing a validated decision index.\n * @public\n */\nexport type DecisionIndex = Brand<number, 'DecisionIndex'>;\n\n/**\n * A string representing a validated context qualifier token. Context qualifier tokens are used\n * for filtering resources by context criteria. A context qualifier token has the form\n * `<qualifierName>=<value>` or `<value>`.\n * @public\n */\nexport type ContextQualifierToken = Brand<string, 'ContextQualifierToken'>;\n\n/**\n * A string representing a validated context token. Context tokens are\n * pipe-separated lists of one or more context qualifier tokens. Uses \"|\" as separator\n * to avoid conflicts with comma-separated values within context values.\n * Example: \"language=en-US,de-DE|territory=US|role=admin\"\n * @public\n */\nexport type ContextToken = Brand<string, 'ContextToken'>;\n\n/**\n * A string representing a single qualifier default value assignment.\n * Format: \"qualifierName=defaultValue\" or \"qualifierName=\" (to remove default)\n * Example: \"language=en-US,en-CA\" or \"territory=US\"\n * @public\n */\nexport type QualifierDefaultValueToken = Brand<string, 'QualifierDefaultValueToken'>;\n\n/**\n * A string representing a validated qualifier default values token. Default value tokens are\n * pipe-separated lists of one or more qualifier default value tokens. Uses \"|\" as separator\n * to avoid conflicts with comma-separated values within default values.\n * Example: \"language=en-US,en-CA|territory=US|device=desktop,tablet\"\n * @public\n */\nexport type QualifierDefaultValuesToken = Brand<string, 'QualifierDefaultValuesToken'>;\n"]}

package/dist/packlets/common/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/common/convert.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 { Converters } from '@fgv/ts-utils';\nimport * as Validate from './validate';\nimport { allConditionOperators } from './conditions';\nimport { allResourceValueMergeMethods } from './resources';\n\n/* eslint-disable @rushstack/typedef-var */\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierName | QualifierName}.\n * @public\n */\nexport const qualifierName = Converters.string.map(Validate.toQualifierName);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierIndex | QualifierIndex}.\n * @public\n */\nexport const qualifierIndex = Converters.number.map(Validate.toQualifierIndex);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierTypeName | QualifierTypeName}.\n * @public\n */\nexport const qualifierTypeName = Converters.string.map(Validate.toQualifierTypeName);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierTypeIndex | QualifierTypeIndex}.\n * @public\n */\nexport const qualifierTypeIndex = Converters.number.map(Validate.toQualifierTypeIndex);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierContextValue | QualifierContextValue}.\n * @public\n */\nexport const qualifierContextValue = Converters.string.map(Validate.toQualifierContextValue);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierConditionValue | QualifierConditionValue}.\n * @public\n */\nexport const qualifierMatchScore = Converters.number.map(Validate.toQualifierMatchScore);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionPriority | ConditionPriority}.\n * @public\n */\nexport const conditionPriority = Converters.number.map(Validate.toConditionPriority);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionOperator | ConditionOperator}.\n * @public\n */\nexport const conditionOperator = Converters.enumeratedValue(allConditionOperators);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionIndex | ConditionIndex}.\n * @public\n */\nexport const conditionIndex = Converters.number.map(Validate.toConditionIndex);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionKey | ConditionKey}.\n * @public\n */\nexport const conditionKey = Converters.string.map(Validate.toConditionKey);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionToken | ConditionToken}.\n * @public\n */\nexport const conditionToken = Converters.string.map(Validate.toConditionToken);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionSetIndex | ConditionSetIndex}.\n * @public\n */\nexport const conditionSetIndex = Converters.number.map(Validate.toConditionSetIndex);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionSetKey | ConditionSetKey}.\n * @public\n */\nexport const conditionSetKey = Converters.string.map(Validate.toConditionSetKey);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionSetToken | ConditionSetToken}.\n * @public\n */\nexport const conditionSetToken = Converters.string.map(Validate.toConditionSetToken);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ConditionSetHash | ConditionSetHash}.\n * @public\n */\nexport const conditionSetHash = Converters.string.map(Validate.toConditionSetHash);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link DecisionIndex | DecisionIndex}.\n * @public\n */\nexport const decisionIndex = Converters.number.map(Validate.toDecisionIndex);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link DecisionKey | DecisionKey}.\n * @public\n */\nexport const decisionKey = Converters.string.map(Validate.toDecisionKey);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ResourceId | ResourceId}.\n * @public\n */\nexport const resourceId = Converters.string.map(Validate.toResourceId);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ResourceName | ResourceName}.\n * @public\n */\nexport const resourceName = Converters.string.map(Validate.toResourceName);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ResourceIndex | ResourceIndex}.\n * @public\n */\nexport const resourceIndex = Converters.number.map(Validate.toResourceIndex);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ResourceTypeName | ResourceTypeName}.\n * @public\n */\nexport const resourceTypeName = Converters.string.map(Validate.toResourceTypeName);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ResourceTypeIndex | ResourceTypeIndex}.\n * @public\n */\nexport const resourceTypeIndex = Converters.number.map(Validate.toResourceTypeIndex);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link CandidateValueKey | CandidateValueKey}.\n * @public\n */\nexport const candidateValueKey = Converters.string.map(Validate.toCandidateValueKey);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link CandidateValueIndex | CandidateValueIndex}.\n * @public\n */\nexport const candidateValueIndex = Converters.number.map(Validate.toCandidateValueIndex);\n\n/**\n * `Converter` for a resource value merge method.\n * @public\n */\nexport const resourceValueMergeMethod = Converters.enumeratedValue(allResourceValueMergeMethods);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ContextQualifierToken | ContextQualifierToken}.\n * @public\n */\nexport const contextQualifierToken = Converters.string.map(Validate.toContextQualifierToken);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link ContextToken | ContextToken}.\n * @public\n */\nexport const contextToken = Converters.string.map(Validate.toContextToken);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierDefaultValueToken | QualifierDefaultValueToken}.\n * @public\n */\nexport const qualifierDefaultValueToken = Converters.string.map(Validate.toQualifierDefaultValueToken);\n\n/**\n * `Converter` which validates an `unknown` value as a {@link QualifierDefaultValuesToken | QualifierDefaultValuesToken}.\n * @public\n */\nexport const qualifierDefaultValuesToken = Converters.string.map(Validate.toQualifierDefaultValuesToken);\n"]}

package/dist/packlets/common/helpers/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAC;AAYxC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAwB;IAC5E,OAAO,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA0C;IAE1C,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CACrE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;AACpE,CAAC","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 { mapResults, Result, succeed } from '@fgv/ts-utils';\nimport * as Validate from '../validate';\nimport { ConditionSetToken, ConditionToken } from '../conditions';\n\n/**\n * The values needed to create a {@link ConditionToken | condition token}.\n * @public\n */\nexport interface IConditionTokenParts {\n  qualifier?: string;\n  value: string;\n}\n\n/**\n * Converts a {@link Helpers.IConditionTokenParts | the parts that make up a condition token} into\n * a syntactically validated {@link ConditionToken | condition token}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildConditionToken({ qualifier, value }: IConditionTokenParts): Result<ConditionToken> {\n  return Validate.toConditionToken(qualifier ? `${qualifier}=${value}` : value);\n}\n\n/**\n * Converts an array of {@link Helpers.IConditionTokenParts | condition token parts} into an array of\n * syntactically validated {@link ConditionToken | condition tokens}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildConditionSetToken(\n  parts: ReadonlyArray<IConditionTokenParts>\n): Result<ConditionSetToken> {\n  return mapResults(parts.map(buildConditionToken)).onSuccess((tokens) =>\n    Validate.toConditionSetToken(tokens.join(','))\n  );\n}\n\n/**\n * Parses a condition token string into its {@link Helpers.IConditionTokenParts | parts}.\n * @param token - the token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseConditionTokenParts(token: string): Result<IConditionTokenParts> {\n  return Validate.toConditionToken(token).onSuccess((t) => {\n    const parts = t.split('=');\n    if (parts.length === 1) {\n      return succeed({ value: parts[0] });\n    }\n    return succeed({ qualifier: parts[0], value: parts[1] });\n  });\n}\n\n/**\n * Parses a condition set token string into an array of {@link Helpers.IConditionTokenParts | condition token parts}.\n * @param token - the conditions set token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseConditionSetTokenParts(token: string): Result<IConditionTokenParts[]> {\n  return mapResults(token.split(',').map(parseConditionTokenParts));\n}\n"]}

package/dist/packlets/common/helpers/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAC;AAYxC;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,SAAS,EACT,KAAK,EACc;IACnB,kFAAkF;IAClF,OAAO,QAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAwC;IACxE,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAC5E,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAAa;IAC3D,OAAO,QAAQ,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC","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 { mapResults, Result, succeed } from '@fgv/ts-utils';\nimport * as Validate from '../validate';\nimport { ContextToken, ContextQualifierToken } from '../conditions';\n\n/**\n * The values needed to create a {@link ContextQualifierToken | context qualifier token}.\n * @public\n */\nexport interface IContextTokenParts {\n  qualifier?: string;\n  value: string;\n}\n\n/**\n * Converts a {@link Helpers.IContextTokenParts | the parts that make up a context qualifier token} into\n * a syntactically validated {@link ContextQualifierToken | context qualifier token}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildContextQualifierToken({\n  qualifier,\n  value\n}: IContextTokenParts): Result<ContextQualifierToken> {\n  /* c8 ignore next 1 - edge case: ternary expression alternate branch rarely hit */\n  return Validate.toContextQualifierToken(qualifier ? `${qualifier}=${value}` : value);\n}\n\n/**\n * Converts an array of {@link Helpers.IContextTokenParts | context qualifier token parts} into a\n * syntactically validated {@link ContextToken | context token}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildContextToken(parts: ReadonlyArray<IContextTokenParts>): Result<ContextToken> {\n  return mapResults(parts.map(buildContextQualifierToken)).onSuccess((tokens) =>\n    Validate.toContextToken(tokens.join('|'))\n  );\n}\n\n/**\n * Parses a context qualifier token string into its {@link Helpers.IContextTokenParts | parts}.\n * @param token - the token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseContextQualifierTokenParts(token: string): Result<IContextTokenParts> {\n  return Validate.toContextQualifierToken(token).onSuccess((t) => {\n    const parts = t.split('=');\n    if (parts.length === 1) {\n      return succeed({ value: parts[0] });\n    }\n    return succeed({ qualifier: parts[0], value: parts[1] });\n  });\n}\n\n/**\n * Parses a context token string into an array of {@link Helpers.IContextTokenParts | context qualifier token parts}.\n * @param token - the context token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseContextTokenParts(token: string): Result<IContextTokenParts[]> {\n  if (token === '') {\n    return succeed([]);\n  }\n  return mapResults(token.split('|').map((part) => parseContextQualifierTokenParts(part.trim())));\n}\n"]}

package/dist/packlets/common/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './conditions';\nexport * from './context';\nexport * from './qualifierDefaultValues';\nexport * from './resources';\n"]}

package/dist/packlets/common/helpers/qualifierDefaultValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierDefaultValues.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/qualifierDefaultValues.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAC;AAYxC;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,EAC9C,SAAS,EACT,KAAK,EAC4B;IACjC,OAAO,QAAQ,CAAC,4BAA4B,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAAsD;IAEtD,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CACjF,QAAQ,CAAC,6BAA6B,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACzD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oCAAoC,CAClD,KAAa;IAEb,OAAO,QAAQ,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;QAClE,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAa;IAEb,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oCAAoC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACvG,CAAC","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 { mapResults, Result, succeed } from '@fgv/ts-utils';\nimport * as Validate from '../validate';\nimport { QualifierDefaultValueToken, QualifierDefaultValuesToken } from '../conditions';\n\n/**\n * The values needed to create a {@link QualifierDefaultValueToken | qualifier default value token}.\n * @public\n */\nexport interface IQualifierDefaultValueTokenParts {\n  qualifier: string;\n  value: string;\n}\n\n/**\n * Converts a {@link Helpers.IQualifierDefaultValueTokenParts | the parts that make up a qualifier default value token} into\n * a syntactically validated {@link QualifierDefaultValueToken | qualifier default value token}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildQualifierDefaultValueToken({\n  qualifier,\n  value\n}: IQualifierDefaultValueTokenParts): Result<QualifierDefaultValueToken> {\n  return Validate.toQualifierDefaultValueToken(`${qualifier}=${value}`);\n}\n\n/**\n * Converts an array of {@link Helpers.IQualifierDefaultValueTokenParts | qualifier default value token parts} into a\n * syntactically validated {@link QualifierDefaultValuesToken | qualifier default values token}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildQualifierDefaultValuesToken(\n  parts: ReadonlyArray<IQualifierDefaultValueTokenParts>\n): Result<QualifierDefaultValuesToken> {\n  return mapResults(parts.map(buildQualifierDefaultValueToken)).onSuccess((tokens) =>\n    Validate.toQualifierDefaultValuesToken(tokens.join('|'))\n  );\n}\n\n/**\n * Parses a qualifier default value token string into its {@link Helpers.IQualifierDefaultValueTokenParts | parts}.\n * @param token - the token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseQualifierDefaultValueTokenParts(\n  token: string\n): Result<IQualifierDefaultValueTokenParts> {\n  return Validate.toQualifierDefaultValueToken(token).onSuccess((t) => {\n    const [qualifier, value] = t.split('=');\n    return succeed({ qualifier, value });\n  });\n}\n\n/**\n * Parses a qualifier default values token string into an array of {@link Helpers.IQualifierDefaultValueTokenParts | qualifier default value token parts}.\n * @param token - the qualifier default values token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseQualifierDefaultValuesTokenParts(\n  token: string\n): Result<IQualifierDefaultValueTokenParts[]> {\n  if (token === '') {\n    return succeed([]);\n  }\n  return mapResults(token.split('|').map((part) => parseQualifierDefaultValueTokenParts(part.trim())));\n}\n"]}

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

@@ -40,8 +40,7 @@ export function splitResourceId(id) {
  * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
  * to create a new {@link ResourceId | resource ID}. Fails if resulting ID is invalid or empty.
  *
- * @param base - The base name or ID to join.
- * @param names - Additional names to join.
+ * @param ids - The names or IDs to join.
  * @returns `Success` with the new ID if the base and names are valid, or `Failure` with an error message
  * if not.
  * @public
@@ -61,8 +60,7 @@ export function joinResourceIds(...ids) {
  * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
  * to create a new {@link ResourceId | resource ID}. Returns `undefined` if no names are defined.
  *
- * @param base - The base name or ID to join.
- * @param names - Additional names to join.
+ * @param ids - The names or IDs to join.
  * @returns `Success` with the new ID if the base and names are valid, `Success` with `undefined`
  * if names were present, or `Failure` with an error message if the resulting id is invalid.
  * @public

package/dist/packlets/common/helpers/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,iBAAiB,EAAU,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,EAAsB;IACpD,8FAA8F;IAC9F,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,GAAG,GAA2B;IAC5D,MAAM,MAAM,GAAsB,IAAI,iBAAiB,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,GAAG;SACA,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;SACzB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QACd,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACL,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAG,GAA2B;IACpE,MAAM,MAAM,GAAsB,IAAI,iBAAiB,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,GAAG;SACA,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;SACzB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QACd,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACL,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAsB;IACzD,OAAO,eAAe,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7C,0DAA0D;QAC1D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC","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 { MessageAggregator, Result, mapResults, succeed } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName } from '../resources';\nimport { toResourceId, toResourceName } from '../validate/resources';\n\n/**\n * Splits a {@link ResourceId | resource id} into its component {@link ResourceName | resource names}.\n *\n * @param id - The ID to split.\n * @returns `Success`with an array of {@link ResourceName | ResourceName} objects if the ID is valid, or\n * `Failure` with an error message if not.\n * @public\n */\nexport function splitResourceId(id: string | undefined): Result<ResourceName[]> {\n  /* c8 ignore next 3 - edge case: undefined resource ID should not occur in normal operation */\n  if (id === undefined) {\n    return succeed([]);\n  }\n  return mapResults(id.split('.').map(toResourceName));\n}\n\n/**\n * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with\n * to create a new {@link ResourceId | resource ID}. Fails if resulting ID is invalid or empty.\n *\n * @param ids - The names or IDs to join.\n * @returns `Success` with the new ID if the base and names are valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function joinResourceIds(...ids: (string | undefined)[]): Result<ResourceId> {\n  const errors: MessageAggregator = new MessageAggregator();\n  const parts: ResourceName[] = [];\n  ids\n    .filter((id) => id !== '')\n    .forEach((id) => {\n      parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));\n    });\n  const id = parts.join('.');\n  return errors.returnOrReport(toResourceId(id));\n}\n\n/**\n * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with\n * to create a new {@link ResourceId | resource ID}. Returns `undefined` if no names are defined.\n *\n * @param ids - The names or IDs to join.\n * @returns `Success` with the new ID if the base and names are valid, `Success` with `undefined`\n * if names were present, or `Failure` with an error message if the resulting id is invalid.\n * @public\n */\nexport function joinOptionalResourceIds(...ids: (string | undefined)[]): Result<ResourceId | undefined> {\n  const errors: MessageAggregator = new MessageAggregator();\n  const parts: ResourceName[] = [];\n  ids\n    .filter((id) => id !== '')\n    .forEach((id) => {\n      parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));\n    });\n  const id = parts.join('.');\n  return errors.returnOrReport(id ? toResourceId(id) : succeed(undefined));\n}\n\n/**\n * Gets the name for a resource ID.\n * @param id - The resource ID to get the name for.\n * @returns `Success` with the resource name if found, or `Failure` with an error message if not.\n * @public\n */\nexport function getNameForResourceId(id: string | undefined): Result<ResourceName> {\n  return splitResourceId(id).onSuccess((parts) => {\n    /* c8 ignore next 1 - tested but coverage having issues */\n    return parts.length > 0 ? succeed(parts[parts.length - 1]) : fail(`${id}: invalid resource id`);\n  });\n}\n"]}

package/dist/packlets/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Convert from './convert';\nimport * as Helpers from './helpers';\nimport * as Validate from './validate';\n\nexport * from './conditions';\nexport * from './resources';\n\nexport { Convert, Helpers, Validate };\n"]}

package/dist/packlets/common/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/packlets/common/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA6CH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA+B,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonValue } from '@fgv/ts-json-base';\nimport { Brand, Result } from '@fgv/ts-utils';\n\n/**\n * Branded string representing a validated resource id.  A resource ID\n * is a dot-separated sequence of resource names.\n * @public\n */\nexport type ResourceId = Brand<string, 'ResourceId'>;\n\n/**\n * Branded string representing a validated resource name.\n * @public\n */\nexport type ResourceName = Brand<string, 'ResourceName'>;\n\n/**\n * Branded number representing a validated resource index.\n * @public\n */\nexport type ResourceIndex = Brand<number, 'ResourceIndex'>;\n\n/**\n * Branded string representing a validated resource type name.\n * @public\n */\nexport type ResourceTypeName = Brand<string, 'ResourceTypeName'>;\n\n/**\n * Branded number representing a validated resource type index.\n * @public\n */\nexport type ResourceTypeIndex = Brand<number, 'ResourceTypeIndex'>;\n\n/**\n * Type representing the possible ways that a resource value can be merged into an existing resource.\n * - 'augment' means that the new value should be merged into the existing value, with new properties added and existing properties updated.\n * - 'delete' means that the existing values should be deleted.\n * - 'replace' means that the new value should replace the existing value.\n * @public\n */\nexport type ResourceValueMergeMethod = 'augment' | 'delete' | 'replace';\n\n/**\n * Array of all possible {@link ResourceValueMergeMethod | resource merge type} values.\n * @public\n */\nexport const allResourceValueMergeMethods: ResourceValueMergeMethod[] = ['augment', 'delete', 'replace'];\n\n/**\n * The completeness of a resource candidate value.  A full value is one that\n * contains all of the required properties for the resource type.  A partial\n * value is one that contains some of the required properties for the resource\n * type.\n * @public\n */\nexport type CandidateCompleteness = 'full' | 'partial';\n\n/**\n * Branded number representing a validated candidate value index.\n * Candidate value indices are used to identify candidate values\n * within a resource set and to enable sharing of like values.\n * @public\n */\nexport type CandidateValueIndex = Brand<number, 'CandidateValueIndex'>;\n\n/**\n * Branded string representing a validated candidate value key.\n * Candidate value keys are used to identify candidate values\n * within a resource set and to enable sharing of like values.\n * @public\n */\nexport type CandidateValueKey = Brand<string, 'CandidateValueKey'>;\n\n/**\n * Minimal resource resolver\n * @public\n */\nexport interface IResourceResolver {\n  /**\n   * The resource IDs that this resolver can resolve.\n   */\n  readonly resourceIds: ReadonlyArray<ResourceId>;\n\n  /**\n   * Resolves a resource to a composed value by merging matching candidates according to their merge methods.\n   * Starting from the highest priority candidates, finds the first \"full\" candidate and merges all higher\n   * priority \"partial\" candidates into it in ascending order of priority.\n   * @param resource - The string id of the resource to resolve.\n   * @returns `Success` with the composed JsonValue if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  resolveComposedResourceValue(resource: string): Result<JsonValue>;\n\n  /**\n   * Creates a new {@link IResourceResolver | resource resolver} with the given context.\n   * @param context - The context to use for the new resource resolver.\n   * @returns `Success` with the new resource resolver if successful,\n   * or `Failure` with an error message if the context is invalid.\n   * @public\n   */\n  withContext(context: Record<string, string>): Result<IResourceResolver>;\n}\n"]}

package/dist/packlets/common/validate/conditions.js

@@ -389,7 +389,7 @@ export function toConditionSetToken(token) {
 }
 /**
  * Converts a string to a {@link ConditionSetHash} if it is a valid condition set hash.
- * @param key - the string to convert
+ * @param hash - the string to convert
  * @returns `Success` with the converted {@link ConditionSetHash} if successful, or `Failure` with an
  * error message if not.
  * @public
@@ -401,9 +401,9 @@ export function toConditionSetHash(hash) {
     return succeed(hash);
 }
 /**
- * Converts a number to a {@link DecisionIndex} if it is a valid decision index.
- * @param index - the number to convert
- * @returns `Success` with the converted {@link DecisionIndex} if successful, or `Failure` with an
+ * Converts a string to a {@link DecisionKey} if it is a valid decision key.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link DecisionKey} if successful, or `Failure` with an
  * error message if not.
  * @public
  */

package/dist/packlets/common/validate/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../../../src/packlets/common/validate/conditions.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 { Result, fail, succeed } from '@fgv/ts-utils';\nimport {\n  ConditionPriority,\n  QualifierName,\n  QualifierTypeName,\n  QualifierIndex,\n  QualifierTypeIndex,\n  ConditionIndex,\n  ConditionSetIndex,\n  QualifierMatchScore,\n  QualifierContextValue,\n  ConditionKey,\n  ConditionSetKey,\n  DecisionKey,\n  DecisionIndex,\n  ConditionSetHash,\n  NoMatch,\n  PerfectMatch,\n  MinConditionPriority,\n  MaxConditionPriority,\n  ConditionOperator,\n  allConditionOperators,\n  ConditionToken,\n  ConditionSetToken,\n  ContextQualifierToken,\n  ContextToken,\n  QualifierDefaultValueToken,\n  QualifierDefaultValuesToken\n} from '../conditions';\nimport {\n  conditionKey,\n  conditionSetHash,\n  conditionToken,\n  contextToken,\n  decisionKey,\n  identifier,\n  qualifierDefaultValueToken,\n  qualifierDefaultValuesToken\n} from './regularExpressions';\n\n/**\n * Determines whether a string is a valid qualifier name.\n * @param name - the string to validate\n * @returns true if the string is a valid qualifier name, false otherwise.\n * @public\n */\nexport function isValidQualifierName(name: string): name is QualifierName {\n  return identifier.test(name);\n}\n\n/***\n * Determines whether a string is a valid qualifier type name.\n * @param name - the string to validate\n * @returns true if the string is a valid qualifier type name, false otherwise.\n * @public\n */\nexport function isValidQualifierTypeName(name: string): name is QualifierTypeName {\n  return identifier.test(name);\n}\n\n/**\n * Determines whether a number is a valid priority.\n * @param priority - the number to validate\n * @returns true if the number is a valid priority, false otherwise.\n * @public\n */\nexport function isValidConditionPriority(priority: number): priority is ConditionPriority {\n  return priority >= MinConditionPriority && priority <= MaxConditionPriority;\n}\n\n/**\n * Determines whether a number is a valid qualifier index.\n * @param index - the number to validate\n * @returns true if the number is a valid qualifier index, false otherwise.\n * @public\n */\nexport function isValidQualifierIndex(index: number): index is QualifierIndex {\n  return index >= 0;\n}\n\n/**\n * Determines whether a number is a valid qualifier type index.\n * @param index - the number to validate\n * @returns true if the number is a valid qualifier type index, false otherwise.\n * @public\n */\nexport function isValidQualifierTypeIndex(index: number): index is QualifierTypeIndex {\n  return index >= 0;\n}\n\n/**\n * Determines whether a supplied value is a valid {@link QualifierMatchScore | match score}.\n * @param value - The value to validate.\n * @returns - `true` if the value is a valid match score, `false` otherwise.\n * @public\n */\nexport function isValidQualifierMatchScore(value: number): value is QualifierMatchScore {\n  return value >= NoMatch && value <= PerfectMatch;\n}\n\n/**\n * Determines whether a number is a valid condition index.\n * @param index - the number to validate\n * @returns true if the number is a valid condition index, false otherwise.\n * @public\n */\nexport function isValidConditionIndex(index: number): index is ConditionIndex {\n  return index >= 0;\n}\n\n/**\n * Determines whether a string is a valid condition operator.\n * @param operator - the string to validate\n * @returns true if the string is a valid condition operator, false otherwise.\n * @public\n */\nexport function isValidConditionOperator(operator: string): operator is ConditionOperator {\n  return allConditionOperators.includes(operator as ConditionOperator);\n}\n\n/**\n * Determines whether a string is a valid condition key.  A condition key has\n * the format:\n * `<qualifierName>(-<operator>)?-[<value>]@<priority>`\n * where operator is omitted for the default 'matches' operator.\n * @param key - the string to validate\n * @returns `true` if the string is a valid condition key, `false` otherwise.\n * @public\n */\nexport function isValidConditionKey(key: string): key is ConditionKey {\n  return conditionKey.test(key);\n}\n\n/**\n * Determines whether a string is a valid {@link ConditionToken | condition token}.\n * A condition token has the format:\n * `<qualifierName>=<value>` or `<value>`\n * @param token -\n * @returns `true` if the string is a valid condition token, `false` otherwise.\n * @public\n */\nexport function isValidConditionToken(token: string): token is ConditionToken {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (token === '') {\n    return true;\n  }\n  return conditionToken.test(token);\n}\n\n/**\n * Determines whether a number is a valid condition set index.\n * @param index - the number to validate\n * @returns true if the number is a valid condition set index, false otherwise.\n * @public\n */\nexport function isValidConditionSetIndex(index: number): index is ConditionSetIndex {\n  return index >= 0;\n}\n\n/**\n * Determines whether a string is a valid condition set key.\n * @param key - the string to validate.\n * @returns `true` if the string is a valid condition set key, `false` otherwise.\n * @public\n */\nexport function isValidConditionSetKey(key: string): key is ConditionSetKey {\n  if (key === '') {\n    return true;\n  }\n  /* c8 ignore next 2 - edge case: condition set key validation rarely fails */\n  // a condition set key is a `+` separated list of condition keys\n  return key.split('+').every(isValidConditionKey);\n}\n\n/**\n * Determines whether a string is a valid condition set token.\n * @param token - the string to validate.\n * @returns `true` if the string is a valid condition set token, `false` otherwise.\n * @public\n */\nexport function isValidConditionSetToken(token: string): token is ConditionSetToken {\n  return token.split(',').every(isValidConditionToken);\n}\n\n/**\n * Determines whether a string is a valid condition set hash.\n * @param hash - the string to validate.\n * @returns `true` if the string is a valid condition set hash, `false` otherwise.\n * @public\n */\nexport function isValidConditionSetHash(hash: string): hash is ConditionSetHash {\n  return conditionSetHash.test(hash);\n}\n\n/**\n * Determines whether a string is a valid decision key.\n * @param key - the string to validate\n * @returns `true` if the string is a valid decision key, `false` otherwise.\n * @public\n */\nexport function isValidDecisionKey(key: string): key is DecisionKey {\n  if (key === '') {\n    return true;\n  }\n  return decisionKey.test(key);\n}\n\n/**\n * Determines whether a number is a valid decision index.\n * @param index - the number to validate\n * @returns `true` if the number is a valid decision index, `false` otherwise.\n * @public\n */\nexport function isValidDecisionIndex(index: number): index is DecisionIndex {\n  return index >= 0;\n}\n\n/**\n * Determines whether a string is a valid qualifier context value.\n * For now, any non-empty string is considered a valid context value.\n * @param value - the string to validate\n * @returns true if the string is a valid qualifier context value, false otherwise.\n * @public\n */\nexport function isValidQualifierContextValue(value: string): value is QualifierContextValue {\n  return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * Converts a string to a {@link QualifierName} if it is a valid qualifier name.\n * @param name - the string to convert\n * @returns `Success` with the converted {@link QualifierName} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toQualifierName(name: string): Result<QualifierName> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidQualifierName(name)) {\n    return fail(`${name}: invalid qualifier name`);\n  }\n  return succeed(name);\n}\n\n/**\n * Converts a string to a {@link QualifierContextValue} if it is a valid qualifier context value.\n * @param value - the string to convert\n * @returns `Success` with the converted {@link QualifierContextValue} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toQualifierContextValue(value: string): Result<QualifierContextValue> {\n  if (!isValidQualifierContextValue(value)) {\n    return fail(`${value}: invalid qualifier context value`);\n  }\n  return succeed(value);\n}\n\n/**\n * Converts a number to a {@link QualifierIndex} if it is a valid qualifier index.\n * @param index - the number to convert\n * @returns `Success` with the converted {@link QualifierIndex} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toQualifierIndex(index: number): Result<QualifierIndex> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidQualifierIndex(index)) {\n    return fail(`${index}: invalid qualifier index`);\n  }\n  return succeed(index as QualifierIndex);\n}\n\n/**\n * Converts a string to a {@link QualifierTypeName} if it is a valid qualifier type name.\n * @param name - the string to convert\n * @returns `Success` with the converted {@link QualifierTypeName} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toQualifierTypeName(name: string): Result<QualifierTypeName> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidQualifierTypeName(name)) {\n    return fail(`${name}: invalid qualifier type name`);\n  }\n  return succeed(name);\n}\n\n/**\n * Converts a number to a {@link QualifierTypeIndex} if it is a valid qualifier type index.\n * @param index - the number to convert\n * @returns `Success` with the converted {@link QualifierTypeIndex} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toQualifierTypeIndex(index: number): Result<QualifierTypeIndex> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidQualifierTypeIndex(index)) {\n    return fail(`${index}: invalid qualifier type index`);\n  }\n  return succeed(index);\n}\n\n/**\n * Converts a number to a {@link QualifierMatchScore | match score} if it is a valid score.\n * @param value - The number to convert.\n * @returns `Success` with the converted score if successful, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toQualifierMatchScore(value: number): Result<QualifierMatchScore> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidQualifierMatchScore(value)) {\n    return fail(`${value}: invalid match score`);\n  }\n  return succeed(value as QualifierMatchScore);\n}\n\n/**\n * Converts a number to a {@link ConditionPriority} if it is a valid priority.\n * @param priority - the number to convert\n * @returns `Success` with the converted {@link ConditionPriority} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionPriority(priority: number): Result<ConditionPriority> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidConditionPriority(priority)) {\n    return fail(`${priority}: invalid priority`);\n  }\n  return succeed(priority);\n}\n\n/**\n * Converts a number to a {@link ConditionIndex} if it is a valid condition index.\n * @param index - the number to convert\n * @returns `Success` with the converted {@link ConditionIndex} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionIndex(index: number): Result<ConditionIndex> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidConditionIndex(index)) {\n    return fail(`${index}: invalid condition index`);\n  }\n  return succeed(index);\n}\n\n/**\n * Converts a string to a {@link ConditionOperator} if it is a valid condition operator.\n * @param operator - the string to convert\n * @returns `Success` with the converted {@link ConditionOperator} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionOperator(operator: string): Result<ConditionOperator> {\n  if (!isValidConditionOperator(operator)) {\n    return fail(`${operator}: invalid condition operator`);\n  }\n  return succeed(operator as ConditionOperator);\n}\n\n/**\n * Converts a string to a {@link ConditionKey} if it is a valid condition key.\n * @param key - the string to convert\n * @returns `Success` with the converted {@link ConditionKey} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionKey(key: string): Result<ConditionKey> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidConditionKey(key)) {\n    return fail(`${key}: invalid condition key`);\n  }\n  return succeed(key);\n}\n\n/**\n * Converts a string to a {@link ConditionToken} if it is a valid condition token.\n * @param token - the string to convert\n * @returns `Success` with the converted {@link ConditionToken} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionToken(token: string): Result<ConditionToken> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidConditionToken(token)) {\n    return fail(`${token}: invalid condition token`);\n  }\n  return succeed(token);\n}\n\n/**\n * Converts a number to a {@link ConditionSetIndex} if it is a valid condition set index.\n * @param index - the number to convert\n * @returns `Success` with the converted {@link ConditionSetIndex} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionSetIndex(index: number): Result<ConditionSetIndex> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidConditionSetIndex(index)) {\n    return fail(`${index}: invalid condition set index`);\n  }\n  return succeed(index);\n}\n\n/**\n * Converts a string to a {@link ConditionSetKey} if it is a valid condition set key.\n * @param key - the string to convert\n * @returns `Success` with the converted {@link ConditionSetKey} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionSetKey(key: string): Result<ConditionSetKey> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidConditionSetKey(key)) {\n    return fail(`${key}: invalid condition set key`);\n  }\n  return succeed(key);\n}\n\n/**\n * Converts a string to a {@link ConditionSetToken} if it is a valid condition set token.\n * @param token - the string to convert\n * @returns `Success` with the converted {@link ConditionSetToken} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionSetToken(token: string): Result<ConditionSetToken> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidConditionSetToken(token)) {\n    return fail(`${token}: invalid condition set token`);\n  }\n  return succeed(token);\n}\n\n/**\n * Converts a string to a {@link ConditionSetHash} if it is a valid condition set hash.\n * @param hash - the string to convert\n * @returns `Success` with the converted {@link ConditionSetHash} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toConditionSetHash(hash: string): Result<ConditionSetHash> {\n  if (!isValidConditionSetHash(hash)) {\n    return fail(`${hash}: invalid condition set hash`);\n  }\n  return succeed(hash);\n}\n\n/**\n * Converts a string to a {@link DecisionKey} if it is a valid decision key.\n * @param key - the string to convert\n * @returns `Success` with the converted {@link DecisionKey} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toDecisionKey(key: string): Result<DecisionKey> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidDecisionKey(key)) {\n    return fail(`${key}: invalid decision key`);\n  }\n  return succeed(key);\n}\n\n/**\n * Converts a number to a {@link DecisionIndex} if it is a valid decision index.\n * @param index - the number to convert\n * @returns `Success` with the converted {@link DecisionIndex} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toDecisionIndex(index: number): Result<DecisionIndex> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!isValidDecisionIndex(index)) {\n    return fail(`${index}: invalid decision index`);\n  }\n  return succeed(index);\n}\n\n/**\n * Determines whether a string is a valid {@link ContextQualifierToken | context qualifier token}.\n * A context qualifier token has the format:\n * `<qualifierName>=<value>` or `<value>`\n * Context qualifier tokens allow broader character set including commas for comma-separated values.\n * @param token - the string to validate\n * @returns `true` if the string is a valid context qualifier token, `false` otherwise.\n * @public\n */\nexport function isValidContextQualifierToken(token: string): token is ContextQualifierToken {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (token === '') {\n    return true;\n  }\n  return contextToken.test(token);\n}\n\n/**\n * Determines whether a string is a valid context token.\n * Context tokens are pipe-separated lists of context qualifier tokens.\n * @param token - the string to validate.\n * @returns `true` if the string is a valid context token, `false` otherwise.\n * @public\n */\nexport function isValidContextToken(token: string): token is ContextToken {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (token === '') {\n    return true;\n  }\n  const parts = token.split('|').map((part) => part.trim());\n  return parts.every((part) => part !== '' && isValidContextQualifierToken(part));\n}\n\n/**\n * Converts a string to a {@link ContextQualifierToken} if it is a valid context qualifier token.\n * @param token - the string to convert\n * @returns `Success` with the converted {@link ContextQualifierToken} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toContextQualifierToken(token: string): Result<ContextQualifierToken> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidContextQualifierToken(token)) {\n    return fail(`${token}: invalid context qualifier token`);\n  }\n  return succeed(token);\n}\n\n/**\n * Converts a string to a {@link ContextToken} if it is a valid context token.\n * @param token - the string to convert\n * @returns `Success` with the converted {@link ContextToken} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toContextToken(token: string): Result<ContextToken> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidContextToken(token)) {\n    return fail(`${token}: invalid context token`);\n  }\n  return succeed(token);\n}\n\n/**\n * Determines whether a string is a valid {@link QualifierDefaultValueToken | qualifier default value token}.\n * A qualifier default value token has the format:\n * `<qualifierName>=<value>` or `<qualifierName>=` (to remove default)\n * Default values allow broader character set including commas for comma-separated values.\n * @param token - the string to validate\n * @returns `true` if the string is a valid qualifier default value token, `false` otherwise.\n * @public\n */\nexport function isValidQualifierDefaultValueToken(token: string): token is QualifierDefaultValueToken {\n  return qualifierDefaultValueToken.test(token);\n}\n\n/**\n * Determines whether a string is a valid qualifier default values token.\n * Qualifier default values tokens are pipe-separated lists of qualifier default value tokens.\n * @param token - the string to validate.\n * @returns `true` if the string is a valid qualifier default values token, `false` otherwise.\n * @public\n */\nexport function isValidQualifierDefaultValuesToken(token: string): token is QualifierDefaultValuesToken {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (token === '') {\n    return true;\n  }\n  return qualifierDefaultValuesToken.test(token);\n}\n\n/**\n * Converts a string to a {@link QualifierDefaultValueToken} if it is a valid qualifier default value token.\n * @param token - the string to convert\n * @returns `Success` with the converted {@link QualifierDefaultValueToken} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toQualifierDefaultValueToken(token: string): Result<QualifierDefaultValueToken> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidQualifierDefaultValueToken(token)) {\n    return fail(`${token}: invalid qualifier default value token`);\n  }\n  return succeed(token);\n}\n\n/**\n * Converts a string to a {@link QualifierDefaultValuesToken} if it is a valid qualifier default values token.\n * @param token - the string to convert\n * @returns `Success` with the converted {@link QualifierDefaultValuesToken} if successful, or `Failure` with an\n * error message if not.\n * @public\n */\nexport function toQualifierDefaultValuesToken(token: string): Result<QualifierDefaultValuesToken> {\n  /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n  if (!isValidQualifierDefaultValuesToken(token)) {\n    return fail(`${token}: invalid qualifier default values token`);\n  }\n  return succeed(token);\n}\n"]}

package/dist/packlets/common/validate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/common/validate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,KAAK,kBAAkB,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './conditions';\nexport * from './resources';\n\nimport * as RegularExpressions from './regularExpressions';\nexport { RegularExpressions };\n"]}

package/dist/packlets/common/validate/regularExpressions.js

@@ -33,8 +33,8 @@ export const segmentedIdentifier = /^[a-zA-Z_][a-zA-Z0-9_\-]*(\.[a-zA-Z_][a-zA-Z
 export const identifierList = /^[a-zA-Z_][a-zA-Z0-9_\-]*(,[a-zA-Z_][a-zA-Z0-9_\-]*)*$/;
 /**
  * The format of a {@link ConditionKey | condition key} is:
- * <qualifierName>-[<value>][\@<priority>](<scoreAsDefault>) where operator is `matches`, or
- * <qualifierName>-<operator>-[<value>][\@<priority>](<scoreAsDefault>)
+ * \<qualifierName\>-\[<value>\]\[\@<priority>\]\(\<scoreAsDefault\>\) where operator is `matches`, or
+ * \<qualifierName\>-\<operator\>-\[<value>\]\[\@<priority>\]\(\<scoreAsDefault\>\)
  * @internal
  */
 export const conditionKey = /^[a-zA-Z_][a-zA-Z0-9_\-]*(-matches)?-\[.*\](?:@[0-9]{1,4})?(?:\([01](?:\.[0-9]+)?\))?$/;

package/dist/packlets/common/validate/regularExpressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regularExpressions.js","sourceRoot":"","sources":["../../../../src/packlets/common/validate/regularExpressions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAW,4BAA4B,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,yDAAyD,CAAC;AAErG;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW,wDAAwD,CAAC;AAE/F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GACvB,wFAAwF,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW,iDAAiD,CAAC;AAExF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW,oDAAoD,CAAC;AAEzF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAW,kBAAkB,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAW,4DAA4D,CAAC;AAEhG;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAW,gBAAgB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAW,oDAAoD,CAAC;AAEvG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,2GAA2G,CAAC;AAE9G;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW,eAAe,CAAC","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 * @internal\n */\nexport const identifier: RegExp = /^[a-zA-Z_][a-zA-Z0-9_\\-]*$/;\n\n/**\n * @internal\n */\nexport const segmentedIdentifier: RegExp = /^[a-zA-Z_][a-zA-Z0-9_\\-]*(\\.[a-zA-Z_][a-zA-Z0-9_\\-]*)*$/;\n\n/**\n * @internal\n */\nexport const identifierList: RegExp = /^[a-zA-Z_][a-zA-Z0-9_\\-]*(,[a-zA-Z_][a-zA-Z0-9_\\-]*)*$/;\n\n/**\n * The format of a {@link ConditionKey | condition key} is:\n * \\<qualifierName\\>-\\[<value>\\]\\[\\@<priority>\\]\\(\\<scoreAsDefault\\>\\) where operator is `matches`, or\n * \\<qualifierName\\>-\\<operator\\>-\\[<value>\\]\\[\\@<priority>\\]\\(\\<scoreAsDefault\\>\\)\n * @internal\n */\nexport const conditionKey: RegExp =\n  /^[a-zA-Z_][a-zA-Z0-9_\\-]*(-matches)?-\\[.*\\](?:@[0-9]{1,4})?(?:\\([01](?:\\.[0-9]+)?\\))?$/;\n\n/**\n * A {@link ConditionToken | condition token} is a comma-separated list of one or more\n * condition specifiers, where a condition specifier has either the form\n * `<qualifierName>=<value>` or `<value>`.\n * @internal\n */\nexport const conditionToken: RegExp = /^[a-zA-Z_][a-zA-Z0-9_\\-]*(?:=[a-zA-Z0-9_\\-]+)?$/;\n\n/**\n * A {@link ContextToken | context token} has the form `<qualifierName>=<value>` or `<value>`.\n * Context tokens allow broader character set including commas for comma-separated values.\n * @internal\n */\nexport const contextToken: RegExp = /^[a-zA-Z_][a-zA-Z0-9_\\-]*(?:=[a-zA-Z0-9_\\-,\\s]+)?$/;\n\n/**\n * @internal\n */\nexport const conditionSetHash: RegExp = /^[a-zA-Z0-9]{8}$/;\n\n/**\n * @internal\n */\nexport const decisionKey: RegExp = /^[a-zA-Z0-9]{8}(?:\\+[a-zA-Z0-9]{8})*(?:\\|[a-zA-Z0-9]{8})?$/;\n\n/**\n * @internal\n */\nexport const candidateValueKey: RegExp = /^[a-zA-Z0-9]+$/;\n\n/**\n * A {@link QualifierDefaultValueToken | qualifier default value token} has the form\n * `<qualifierName>=<value>` or `<qualifierName>=` (to remove default).\n * Default values allow broader character set including commas for comma-separated values.\n * @internal\n */\nexport const qualifierDefaultValueToken: RegExp = /^[a-zA-Z_][a-zA-Z0-9_\\-]*=(?:[a-zA-Z0-9_\\-,\\s]*)?$/;\n\n/**\n * A {@link QualifierDefaultValuesToken | qualifier default values token} is a\n * pipe-separated list of one or more qualifier default value tokens.\n * Uses \"|\" as separator to avoid conflicts with comma-separated values within defaults.\n * @internal\n */\nexport const qualifierDefaultValuesToken: RegExp =\n  /^[a-zA-Z_][a-zA-Z0-9_\\-]*=(?:[a-zA-Z0-9_\\-,\\s]*)?(?:\\|[a-zA-Z_][a-zA-Z0-9_\\-]*=(?:[a-zA-Z0-9_\\-,\\s]*)?)*$/;\n\n/**\n * @internal\n */\nexport const territoryCode: RegExp = /^[a-zA-Z]{2}$/;\n"]}

package/dist/packlets/common/validate/resources.js

@@ -94,7 +94,7 @@ export function isValidCandidateValueKey(key) {
 /**
  * Converts a string to a {@link ResourceName | resource name}.
  *
- * @param id - The string to convert.
+ * @param name - The string to convert.
  * @returns `Success` with the converted name if valid, or `Failure` with an error message
  * if not.
  * @public

package/dist/packlets/common/validate/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../../src/packlets/common/validate/resources.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 { fail, succeed, Result } from '@fgv/ts-utils';\nimport { candidateValueKey, identifier, segmentedIdentifier } from './regularExpressions';\nimport {\n  CandidateValueIndex,\n  CandidateValueKey,\n  ResourceId,\n  ResourceIndex,\n  ResourceName,\n  ResourceTypeIndex,\n  ResourceTypeName\n} from '../resources';\n\n/**\n * Checks if the given name is a valid resource name.\n *\n * @param name - The name to validate.\n * @returns `true` if the name is a valid resource name, otherwise `false`.\n * @public\n */\nexport function isValidResourceName(name: string): name is ResourceName {\n  return identifier.test(name);\n}\n\n/**\n * Checks if the given ID is a valid resource ID.\n *\n * @param id - The ID to validate.\n * @returns `true` if the ID is a valid resource ID, otherwise `false`.\n * @public\n */\nexport function isValidResourceId(id: string): id is ResourceId {\n  return segmentedIdentifier.test(id);\n}\n\n/**\n * Checks if the given index is a valid resource index.\n *\n * @param index - The index to validate.\n * @returns `true` if the index is a valid resource index, otherwise `false`.\n * @public\n */\nexport function isValidResourceIndex(index: number): index is ResourceIndex {\n  return index >= 0;\n}\n\n/**\n * Checks if the given name is a valid resource type name.\n *\n * @param name - The name to validate.\n * @returns `true` if the name is a valid resource type name, otherwise `false`.\n * @public\n */\nexport function isValidResourceTypeName(name: string): name is ResourceTypeName {\n  return identifier.test(name);\n}\n\n/**\n * Checks if the given index is a valid resource type index.\n *\n * @param index - The index to validate.\n * @returns `true` if the index is a valid resource type index, otherwise `false`.\n * @public\n */\nexport function isValidResourceTypeIndex(index: number): index is ResourceTypeIndex {\n  return index >= 0;\n}\n\n/**\n * Checks if the given index is a valid candidate value index.\n *\n * @param index - The index to validate.\n * @returns `true` if the index is a valid candidate value index, otherwise `false`.\n * @public\n */\nexport function isValidCandidateValueIndex(index: number): index is CandidateValueIndex {\n  return index >= 0;\n}\n\n/**\n * Checks if the given key is a valid candidate value key.\n *\n * @param key - The key to validate.\n * @returns `true` if the key is a valid candidate value key, otherwise `false`.\n * @public\n */\nexport function isValidCandidateValueKey(key: string): key is CandidateValueKey {\n  return candidateValueKey.test(key);\n}\n\n/**\n * Converts a string to a {@link ResourceName | resource name}.\n *\n * @param name - The string to convert.\n * @returns `Success` with the converted name if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toResourceName(name: string): Result<ResourceName> {\n  /* c8 ignore next 3 - coverage having issues */\n  if (!isValidResourceName(name)) {\n    return fail(`${name}: invalid resource name.`);\n  }\n  return succeed(name);\n}\n\n/**\n * Converts a string to a {@link ResourceId | resource ID}.\n *\n * @param id - The string to convert.\n * @returns `Success` with the converted ID if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toResourceId(id: string): Result<ResourceId> {\n  /* c8 ignore next 3 - defensive coding: resource ID validation should prevent invalid IDs */\n  if (!isValidResourceId(id)) {\n    return fail(`${id}: invalid resource ID.`);\n  }\n  return succeed(id);\n}\n\n/**\n * Converts an optional string to an optional {@link ResourceId | resource ID}.\n *\n * @param id - The string to convert.\n * @returns `Success` with the converted ID if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toOptionalResourceId(id?: string): Result<ResourceId | undefined> {\n  return id ? toResourceId(id) : succeed(undefined);\n}\n\n/**\n * Converts a number to a {@link ResourceIndex | resource index}.\n *\n * @param index - The number to convert.\n * @returns `Success` with the converted index if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toResourceIndex(index: number): Result<ResourceIndex> {\n  if (!isValidResourceIndex(index)) {\n    return fail(`${index}: invalid resource index.`);\n  }\n  return succeed(index);\n}\n\n/**\n * Converts a string to a {@link ResourceTypeName | resource type name}.\n *\n * @param name - The string to convert.\n * @returns `Success` with the converted name if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toResourceTypeName(name: string): Result<ResourceTypeName> {\n  /* c8 ignore next 3 - coverage having issues */\n  if (!isValidResourceTypeName(name)) {\n    return fail(`${name}: invalid resource type name.`);\n  }\n  return succeed(name);\n}\n\n/**\n * Converts a number to a {@link ResourceTypeIndex | resource type index}.\n *\n * @param index - The number to convert.\n * @returns `Success` with the converted index if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toResourceTypeIndex(index: number): Result<ResourceTypeIndex> {\n  /* c8 ignore next 3 - coverage having issues */\n  if (!isValidResourceTypeIndex(index)) {\n    return fail(`${index}: invalid resource type index.`);\n  }\n  return succeed(index);\n}\n\n/**\n * Converts a string to a {@link CandidateValueKey | candidate value key}.\n *\n * @param key - The key to convert.\n * @returns `Success` with the converted key if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toCandidateValueKey(key: string): Result<CandidateValueKey> {\n  /* c8 ignore next 3 - coverage having issues */\n  if (!isValidCandidateValueKey(key)) {\n    return fail(`${key}: invalid candidate value key.`);\n  }\n  return succeed(key);\n}\n\n/**\n * Converts a number to a {@link CandidateValueIndex | candidate value index}.\n *\n * @param index - The number to convert.\n * @returns `Success` with the converted index if valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function toCandidateValueIndex(index: number): Result<CandidateValueIndex> {\n  /* c8 ignore next 3 - coverage having issues */\n  if (!isValidCandidateValueIndex(index)) {\n    return fail(`${index}: invalid candidate value index.`);\n  }\n  return succeed(index);\n}\n"]}

package/dist/packlets/conditions/condition.js

@@ -30,12 +30,8 @@ const scoreFormatter = new Intl.NumberFormat('en-US', { minimumFractionDigits: 0
 export class Condition {
     /**
      * Constructs a new {@link Conditions.Condition | Condition} object.
-     * @param qualifier - The {@link Qualifiers.Qualifier | qualifier} used in this condition.
-     * @param value - The value to be matched in this condition.
-     * @param operator - The {@link ConditionOperator | operator} used when matching context value to condition value.
-     * @param priority - The {@link ConditionPriority | relative priority} of this condition.
-     * @param scoreAsDefault - The {@link QualifierMatchScore | score} to be used when this condition is the default.
-     * @param index - The index of this condition.
+     * @param params - The {@link Conditions.IValidatedConditionDecl | validated condition declaration}
+     * used to construct this condition.
      * @public
      */
     constructor({ qualifier, value, operator, priority, scoreAsDefault, index }) {
@@ -85,7 +81,7 @@ export class Condition {
      * @returns A {@link QualifierMatchScore | match score} indicating match quality if the condition is present
      * in the context to be matched, `undefined` otherwise.
      * @remarks
-     * If {@link Context.IContextMatchOptions.partialContextMatch | `options.partialContextMatch``} is `true`, then
+     * If {@link Context.IContextMatchOptions.partialContextMatch | `options.partialContextMatch`} is `true`, then
      * the method will return `undefined` if the corresponding qualifier is not present in the context.
      */
     getContextMatch(context, options) {

package/dist/packlets/conditions/condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../../src/packlets/conditions/condition.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 { captureResult, Collections, Result, fail } from '@fgv/ts-utils';\nimport {\n  Convert as CommonConvert,\n  ConditionIndex,\n  ConditionKey,\n  ConditionOperator,\n  ConditionPriority,\n  ConditionToken,\n  NoMatch,\n  QualifierConditionValue,\n  QualifierMatchScore,\n  Validate\n} from '../common';\nimport { Qualifier } from '../qualifiers';\nimport { IValidatedConditionDecl } from './conditionDecls';\nimport * as ResourceJson from '../resource-json';\nimport * as Context from '../context';\n\n// eslint-disable-next-line @rushstack/typedef-var\nconst scoreFormatter = new Intl.NumberFormat('en-US', { minimumFractionDigits: 0, maximumFractionDigits: 3 });\n\n/**\n * Represents a single condition applied to some resource instance.\n * @public\n */\nexport class Condition implements IValidatedConditionDecl {\n  /**\n   * The {@link Qualifiers.Qualifier | qualifier} used in this condition.\n   */\n  public readonly qualifier: Qualifier;\n\n  /**\n   * The value to be matched in this condition.\n   */\n  public readonly value: QualifierConditionValue;\n\n  /**\n   * The {@link ConditionOperator | operator} used when matching context value to condition value.\n   */\n  public readonly operator: ConditionOperator;\n\n  /**\n   * The {@link ConditionPriority | relative priority} of this condition.\n   */\n  public readonly priority: ConditionPriority;\n\n  /**\n   * The {@link QualifierMatchScore | score} to be used when this condition is the default.\n   */\n  public readonly scoreAsDefault?: QualifierMatchScore;\n\n  protected _collectible: Collections.Collectible<ConditionKey, ConditionIndex>;\n\n  /**\n   * Constructs a new {@link Conditions.Condition | Condition} object.\n   * @param params - The {@link Conditions.IValidatedConditionDecl | validated condition declaration}\n   * used to construct this condition.\n   * @public\n   */\n  protected constructor({\n    qualifier,\n    value,\n    operator,\n    priority,\n    scoreAsDefault,\n    index\n  }: IValidatedConditionDecl) {\n    if (scoreAsDefault === undefined && qualifier.defaultValue !== undefined) {\n      /* c8 ignore next 4 - edge case: default value matching logic rarely triggered */\n      const defaultMatch = qualifier.type.matches(value, qualifier.defaultValue, 'matches');\n      if (defaultMatch !== NoMatch) {\n        scoreAsDefault = defaultMatch;\n      }\n    }\n    this.qualifier = qualifier;\n    this.operator = operator;\n    this.value = qualifier.validateCondition(value, operator).orThrow();\n    this.priority = priority;\n    this.scoreAsDefault = scoreAsDefault;\n    this._collectible = new Collections.Collectible({\n      key: this.toKey(),\n      index,\n      indexConverter: CommonConvert.conditionIndex\n    });\n  }\n\n  public get key(): ConditionKey {\n    return this._collectible.key;\n  }\n\n  public get index(): ConditionIndex | undefined {\n    return this._collectible.index;\n  }\n\n  public setIndex(index: ConditionIndex): Result<ConditionIndex> {\n    return this._collectible.setIndex(index);\n  }\n\n  /**\n   * Creates a new {@link Conditions.Condition | Condition} object from the supplied\n   * {@link Conditions.IValidatedConditionDecl | validated condition declaration}.\n   * @param decl - The {@link Conditions.IValidatedConditionDecl | validated condition declaration}\n   * describing the condition to create.\n   * @returns `Success` with the new {@link Conditions.Condition | Condition} if successful,\n   * `Failure` otherwise.\n   * @public\n   */\n  public static create(decl: IValidatedConditionDecl): Result<Condition> {\n    return captureResult(() => new Condition(decl));\n  }\n\n  /**\n   * Determines if this condition matches the supplied {@link Context.IValidatedContextDecl | validated context}.\n   * @param context - The {@link Context.IValidatedContextDecl | context} to match against.\n   * @param options - The {@link Context.IContextMatchOptions | options} to use when matching the context.\n   * @returns A {@link QualifierMatchScore | match score} indicating match quality if the condition is present\n   * in the context to be matched, `undefined` otherwise.\n   * @remarks\n   * If {@link Context.IContextMatchOptions.partialContextMatch | `options.partialContextMatch`} is `true`, then\n   * the method will return `undefined` if the corresponding qualifier is not present in the context.\n   */\n  public getContextMatch(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): QualifierMatchScore | undefined {\n    options = options ?? {};\n    if (this.qualifier.name in context) {\n      const contextValue = context[this.qualifier.name];\n      const match = this.qualifier.type.matches(this.value, contextValue, this.operator);\n      if (match === NoMatch && options.acceptDefaultScore === true && this.scoreAsDefault !== undefined) {\n        return this.scoreAsDefault;\n      }\n      return match;\n    }\n    return options.partialContextMatch === true ? undefined : NoMatch;\n  }\n\n  /**\n   * Determines if this condition can match the supplied context, even if the context is partial.\n   *\n   * Returns true if:\n   * - The qualifier specified in the condition is not present in the context\n   * - The qualifier is present and matches the condition\n   *\n   * Returns false if:\n   * - The qualifier is present in the context and does not match the condition\n   *\n   * @param context - The context to match against.\n   * @param options - Options to use when matching the context.\n   * @returns `true` if the condition can match the (possibly partial) context, `false` otherwise.\n   * @public\n   */\n  public canMatchPartialContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): boolean {\n    /* c8 ignore next 1 - defense in depth */\n    const scoreAsDefault = this.scoreAsDefault ?? NoMatch;\n    if (!(this.qualifier.name in context) || scoreAsDefault > NoMatch) {\n      return true;\n    }\n    return this.qualifier.type.isPotentialMatch(this.value, context[this.qualifier.name]);\n  }\n\n  /**\n   * Compares two conditions for sorting purposes.\n   * @param c1 - The first {@link Conditions.Condition | condition} to compare.\n   * @param c2 - The second {@link Conditions.Condition | condition} to compare.\n   * @returns A negative number if c1 should come before c2, a positive number\n   * if c2 should come before c1, or zero if they are equivalent.\n   * @public\n   */\n  public static compare(c1: Condition, c2: Condition): number {\n    let diff = c1.priority - c2.priority;\n    diff = diff === 0 ? (c1.scoreAsDefault ?? 0) - (c2.scoreAsDefault ?? 0) : diff;\n    diff = diff === 0 ? c1.qualifier.name.localeCompare(c2.qualifier.name) : diff;\n    diff = diff === 0 ? c1.value.localeCompare(c2.value) : diff;\n    return diff;\n  }\n\n  /**\n   * Gets a {@link ConditionToken | condition token} for this condition, if possible.\n   * It is not possible to get a token for a condition with an operator other than `matches`,\n   * with other-than-default priority, or with a name or value that contains other than alphanumeric\n   * characters, underscore or non-leading hyphen.\n   * @param terse - if `true` and if the qualifier token is optional, the token will be omitted\n   * from the generated {@link ConditionToken | condition token}.\n   * @returns\n   */\n  public toToken(terse?: boolean): Result<ConditionToken> {\n    /* c8 ignore next 3 - defense in depth very difficult to induce */\n    if (this.operator !== 'matches') {\n      return fail(`${this.operator}: cannot create condition token for operator other than 'matches'`);\n    }\n    if (this.priority !== this.qualifier.defaultPriority) {\n      return fail(`${this.priority}: cannot create condition token for non-default priority`);\n    }\n    if (terse && this.qualifier.tokenIsOptional) {\n      return Validate.toConditionToken(this.value);\n    }\n    /* c8 ignore next 1 - coverage having a bad day */\n    const name = this.qualifier.token ?? this.qualifier.name;\n    return Validate.toConditionToken(`${name}=${this.value}`);\n  }\n\n  /**\n   * Gets the {@link ConditionKey | key} for this condition.\n   * @returns -\n   */\n  public toKey(): ConditionKey {\n    return Condition.getKeyForDecl(this).orThrow();\n  }\n\n  /**\n   * Get a human-readable string representation of the condition.\n   * @returns A string representation of the condition.\n   * @public\n   */\n  public toString(): string {\n    return this.toKey();\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.IChildConditionDecl | child condition declaration} for this condition.\n   * @param options - The {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the child\n   * condition declaration.\n   * @returns The {@link ResourceJson.Json.IChildConditionDecl | child condition declaration} for this condition.\n   * @public\n   */\n  public toChildConditionDecl(\n    options?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.IChildConditionDecl {\n    const showDefaults = options?.showDefaults === true;\n    return {\n      value: this.value,\n      /* c8 ignore next 1 - not really possible to reproduce right now */\n      ...(showDefaults || this.operator !== 'matches' ? { operator: this.operator } : {}),\n      ...(showDefaults || this.priority !== this.qualifier.defaultPriority\n        ? { priority: this.priority }\n        : {}),\n      ...(this.scoreAsDefault ? { scoreAsDefault: this.scoreAsDefault } : {})\n    };\n  }\n\n  /**\n   * Gets the value for this condition, or the {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}\n   * if the condition has non-default operator, priority or a score as default.\n   * @param options - The {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the child\n   * condition declaration.\n   * @returns A string value for this condition, or the {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}\n   * if the condition has non-default operator, priority or a score as default.\n   */\n  public toValueOrChildConditionDecl(\n    options?: ResourceJson.Helpers.IDeclarationOptions\n  ): string | ResourceJson.Json.IChildConditionDecl {\n    if (\n      options?.showDefaults !== true &&\n      this.operator === 'matches' &&\n      this.priority === this.qualifier.defaultPriority &&\n      this.scoreAsDefault === undefined\n    ) {\n      return this.value;\n    }\n    /* c8 ignore next 2 - unreachable: matches is the only real operator in practice */\n    return this.toChildConditionDecl(options);\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration} for this condition.\n   * @param options - The {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the loose\n   * condition declaration.\n   * @returns The {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration} for this condition.\n   * @public\n   */\n  public toLooseConditionDecl(\n    options?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.ILooseConditionDecl {\n    const showDefaults = options?.showDefaults === true;\n    return {\n      qualifierName: this.qualifier.name,\n      value: this.value,\n      /* c8 ignore next 1 - not really possible to reproduce right now */\n      ...(showDefaults || this.operator !== 'matches' ? { operator: this.operator } : {}),\n      ...(showDefaults || this.priority !== this.qualifier.defaultPriority\n        ? { priority: this.priority }\n        : {}),\n      ...(this.scoreAsDefault ? { scoreAsDefault: this.scoreAsDefault } : {})\n    };\n  }\n\n  /**\n   * Converts this condition to a compiled condition representation.\n   * @param options - Optional compilation options controlling the output format.\n   * @returns A compiled condition object that can be used for serialization or runtime processing.\n   * @public\n   */\n  public toCompiled(\n    options?: ResourceJson.Compiled.ICompiledResourceOptions\n  ): ResourceJson.Compiled.ICompiledCondition {\n    /* c8 ignore next 1 - defense in depth */\n    const operator = this.operator === 'matches' ? undefined : this.operator;\n    return {\n      qualifierIndex: this.qualifier.index!,\n      operator,\n      value: this.value,\n      priority: this.priority,\n      scoreAsDefault: this.scoreAsDefault,\n      ...(options?.includeMetadata === true ? { metadata: { key: this.key } } : {})\n    };\n  }\n\n  /**\n   * Gets the {@link ConditionKey | condition key} for a supplied {@link Conditions.IValidatedConditionDecl | condition declaration}.\n   * @param decl - The {@link Conditions.IValidatedConditionDecl | condition declaration} for which to get the key.\n   * @returns `Success` with the condition key if successful, `Failure` otherwise.\n   * @public\n   */\n  public static getKeyForDecl(decl: IValidatedConditionDecl): Result<ConditionKey> {\n    const scoreAsDefault = decl.scoreAsDefault ? `(${scoreFormatter.format(decl.scoreAsDefault)})` : '';\n    const key =\n      decl.operator === 'matches'\n        ? `${decl.qualifier.name}-[${decl.value}]@${decl.priority}${scoreAsDefault}`\n        : `${decl.qualifier.name}-${decl.operator}-[${decl.value}]@${decl.priority}${scoreAsDefault}`;\n    return Validate.toConditionKey(key);\n  }\n}\n"]}