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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/CHANGELOG.json +26 -0
  2. package/CHANGELOG.md +14 -0
  3. package/CLAUDE.md +186 -0
  4. package/EXAMPLE_INIT_PARAMS.md +88 -0
  5. package/PROGRESS_SUMMARY.md +48 -0
  6. package/README.md +535 -14
  7. package/dist/ts-res.d.ts +4241 -318
  8. package/dist/tsdoc-metadata.json +1 -1
  9. package/lib/index.d.ts +4 -1
  10. package/lib/index.d.ts.map +1 -1
  11. package/lib/index.js +7 -1
  12. package/lib/index.js.map +1 -1
  13. package/lib/packlets/common/conditions.d.ts +30 -0
  14. package/lib/packlets/common/conditions.d.ts.map +1 -1
  15. package/lib/packlets/common/conditions.js.map +1 -1
  16. package/lib/packlets/common/convert.d.ts +22 -2
  17. package/lib/packlets/common/convert.d.ts.map +1 -1
  18. package/lib/packlets/common/convert.js +21 -1
  19. package/lib/packlets/common/convert.js.map +1 -1
  20. package/lib/packlets/common/helpers/context.d.ts +39 -0
  21. package/lib/packlets/common/helpers/context.d.ts.map +1 -0
  22. package/lib/packlets/common/helpers/context.js +108 -0
  23. package/lib/packlets/common/helpers/context.js.map +1 -0
  24. package/lib/packlets/common/helpers/index.d.ts +2 -0
  25. package/lib/packlets/common/helpers/index.d.ts.map +1 -1
  26. package/lib/packlets/common/helpers/index.js +2 -0
  27. package/lib/packlets/common/helpers/index.js.map +1 -1
  28. package/lib/packlets/common/helpers/qualifierDefaultValues.d.ts +39 -0
  29. package/lib/packlets/common/helpers/qualifierDefaultValues.d.ts.map +1 -0
  30. package/lib/packlets/common/helpers/qualifierDefaultValues.js +105 -0
  31. package/lib/packlets/common/helpers/qualifierDefaultValues.js.map +1 -0
  32. package/lib/packlets/common/helpers/resources.d.ts.map +1 -1
  33. package/lib/packlets/common/helpers/resources.js +6 -2
  34. package/lib/packlets/common/helpers/resources.js.map +1 -1
  35. package/lib/packlets/common/validate/conditions.d.ts +69 -1
  36. package/lib/packlets/common/validate/conditions.d.ts.map +1 -1
  37. package/lib/packlets/common/validate/conditions.js +126 -0
  38. package/lib/packlets/common/validate/conditions.js.map +1 -1
  39. package/lib/packlets/common/validate/regularExpressions.d.ts +20 -0
  40. package/lib/packlets/common/validate/regularExpressions.d.ts.map +1 -1
  41. package/lib/packlets/common/validate/regularExpressions.js +21 -1
  42. package/lib/packlets/common/validate/regularExpressions.js.map +1 -1
  43. package/lib/packlets/conditions/condition.d.ts +37 -0
  44. package/lib/packlets/conditions/condition.d.ts.map +1 -1
  45. package/lib/packlets/conditions/condition.js +67 -1
  46. package/lib/packlets/conditions/condition.js.map +1 -1
  47. package/lib/packlets/conditions/conditionCollector.d.ts.map +1 -1
  48. package/lib/packlets/conditions/conditionCollector.js +1 -0
  49. package/lib/packlets/conditions/conditionCollector.js.map +1 -1
  50. package/lib/packlets/conditions/conditionSet.d.ts +34 -3
  51. package/lib/packlets/conditions/conditionSet.d.ts.map +1 -1
  52. package/lib/packlets/conditions/conditionSet.js +31 -3
  53. package/lib/packlets/conditions/conditionSet.js.map +1 -1
  54. package/lib/packlets/conditions/conditionSetCollector.d.ts.map +1 -1
  55. package/lib/packlets/conditions/conditionSetCollector.js +3 -0
  56. package/lib/packlets/conditions/conditionSetCollector.js.map +1 -1
  57. package/lib/packlets/conditions/conditionToken.d.ts.map +1 -1
  58. package/lib/packlets/conditions/conditionToken.js +2 -1
  59. package/lib/packlets/conditions/conditionToken.js.map +1 -1
  60. package/lib/packlets/conditions/convert/decls.js +1 -1
  61. package/lib/packlets/conditions/convert/decls.js.map +1 -1
  62. package/lib/packlets/config/common.d.ts +35 -0
  63. package/lib/packlets/config/common.d.ts.map +1 -0
  64. package/lib/packlets/config/common.js +96 -0
  65. package/lib/packlets/config/common.js.map +1 -0
  66. package/lib/packlets/config/convert.d.ts +14 -0
  67. package/lib/packlets/config/convert.d.ts.map +1 -0
  68. package/lib/packlets/config/convert.js +82 -0
  69. package/lib/packlets/config/convert.js.map +1 -0
  70. package/lib/packlets/config/index.d.ts +6 -0
  71. package/lib/packlets/config/index.d.ts.map +1 -0
  72. package/lib/packlets/config/index.js +67 -0
  73. package/lib/packlets/config/index.js.map +1 -0
  74. package/lib/packlets/config/json.d.ts +20 -0
  75. package/lib/packlets/config/json.d.ts.map +1 -0
  76. package/lib/packlets/config/json.js +24 -0
  77. package/lib/packlets/config/json.js.map +1 -0
  78. package/lib/packlets/config/predefined/default.d.ts +57 -0
  79. package/lib/packlets/config/predefined/default.d.ts.map +1 -0
  80. package/lib/packlets/config/predefined/default.js +141 -0
  81. package/lib/packlets/config/predefined/default.js.map +1 -0
  82. package/lib/packlets/config/predefined/extended.d.ts +25 -0
  83. package/lib/packlets/config/predefined/extended.d.ts.map +1 -0
  84. package/lib/packlets/config/predefined/extended.js +193 -0
  85. package/lib/packlets/config/predefined/extended.js.map +1 -0
  86. package/lib/packlets/config/predefined/index.d.ts +4 -0
  87. package/lib/packlets/config/predefined/index.d.ts.map +1 -0
  88. package/lib/packlets/config/predefined/index.js +62 -0
  89. package/lib/packlets/config/predefined/index.js.map +1 -0
  90. package/lib/packlets/config/systemConfiguration.d.ts +81 -0
  91. package/lib/packlets/config/systemConfiguration.d.ts.map +1 -0
  92. package/lib/packlets/config/systemConfiguration.js +172 -0
  93. package/lib/packlets/config/systemConfiguration.js.map +1 -0
  94. package/lib/packlets/context/contextDecls.d.ts +49 -0
  95. package/lib/packlets/context/contextDecls.d.ts.map +1 -0
  96. package/lib/packlets/context/contextDecls.js +24 -0
  97. package/lib/packlets/context/contextDecls.js.map +1 -0
  98. package/lib/packlets/context/contextToken.d.ts +111 -0
  99. package/lib/packlets/context/contextToken.d.ts.map +1 -0
  100. package/lib/packlets/context/contextToken.js +206 -0
  101. package/lib/packlets/context/contextToken.js.map +1 -0
  102. package/lib/packlets/context/convert/decls.d.ts +37 -0
  103. package/lib/packlets/context/convert/decls.d.ts.map +1 -0
  104. package/lib/packlets/context/convert/decls.js +94 -0
  105. package/lib/packlets/context/convert/decls.js.map +1 -0
  106. package/lib/packlets/context/convert/index.d.ts +2 -0
  107. package/lib/packlets/context/convert/index.d.ts.map +1 -0
  108. package/lib/packlets/context/convert/index.js +39 -0
  109. package/lib/packlets/context/convert/index.js.map +1 -0
  110. package/lib/packlets/context/index.d.ts +5 -0
  111. package/lib/packlets/context/index.d.ts.map +1 -0
  112. package/lib/packlets/context/index.js +65 -0
  113. package/lib/packlets/context/index.js.map +1 -0
  114. package/lib/packlets/decisions/abstractDecision.d.ts +8 -0
  115. package/lib/packlets/decisions/abstractDecision.d.ts.map +1 -1
  116. package/lib/packlets/decisions/abstractDecision.js +9 -0
  117. package/lib/packlets/decisions/abstractDecision.js.map +1 -1
  118. package/lib/packlets/decisions/abstractDecisionCollector.d.ts.map +1 -1
  119. package/lib/packlets/decisions/abstractDecisionCollector.js +2 -0
  120. package/lib/packlets/decisions/abstractDecisionCollector.js.map +1 -1
  121. package/lib/packlets/decisions/concreteDecision.d.ts.map +1 -1
  122. package/lib/packlets/decisions/concreteDecision.js +1 -0
  123. package/lib/packlets/decisions/concreteDecision.js.map +1 -1
  124. package/lib/packlets/decisions/decision.d.ts.map +1 -1
  125. package/lib/packlets/decisions/decision.js +4 -0
  126. package/lib/packlets/decisions/decision.js.map +1 -1
  127. package/lib/packlets/import/fsItem.d.ts.map +1 -1
  128. package/lib/packlets/import/fsItem.js +1 -0
  129. package/lib/packlets/import/fsItem.js.map +1 -1
  130. package/lib/packlets/import/importContext.d.ts +19 -0
  131. package/lib/packlets/import/importContext.d.ts.map +1 -1
  132. package/lib/packlets/import/importContext.js +39 -0
  133. package/lib/packlets/import/importContext.js.map +1 -1
  134. package/lib/packlets/import/importManager.d.ts +5 -5
  135. package/lib/packlets/import/importManager.d.ts.map +1 -1
  136. package/lib/packlets/import/importManager.js.map +1 -1
  137. package/lib/packlets/import/importers/collectionImporter.d.ts +11 -13
  138. package/lib/packlets/import/importers/collectionImporter.d.ts.map +1 -1
  139. package/lib/packlets/import/importers/collectionImporter.js +29 -20
  140. package/lib/packlets/import/importers/collectionImporter.js.map +1 -1
  141. package/lib/packlets/import/importers/fsItemImporter.d.ts +2 -2
  142. package/lib/packlets/import/importers/fsItemImporter.d.ts.map +1 -1
  143. package/lib/packlets/import/importers/fsItemImporter.js +2 -2
  144. package/lib/packlets/import/importers/fsItemImporter.js.map +1 -1
  145. package/lib/packlets/import/importers/importer.d.ts +3 -3
  146. package/lib/packlets/import/importers/importer.d.ts.map +1 -1
  147. package/lib/packlets/import/importers/importer.js.map +1 -1
  148. package/lib/packlets/import/importers/jsonImporter.d.ts +2 -3
  149. package/lib/packlets/import/importers/jsonImporter.d.ts.map +1 -1
  150. package/lib/packlets/import/importers/jsonImporter.js +10 -20
  151. package/lib/packlets/import/importers/jsonImporter.js.map +1 -1
  152. package/lib/packlets/import/importers/pathImporter.d.ts +2 -2
  153. package/lib/packlets/import/importers/pathImporter.d.ts.map +1 -1
  154. package/lib/packlets/import/importers/pathImporter.js.map +1 -1
  155. package/lib/packlets/qualifier-types/config/convert.d.ts +44 -0
  156. package/lib/packlets/qualifier-types/config/convert.d.ts.map +1 -0
  157. package/lib/packlets/qualifier-types/config/convert.js +96 -0
  158. package/lib/packlets/qualifier-types/config/convert.js.map +1 -0
  159. package/lib/packlets/qualifier-types/config/index.d.ts +4 -0
  160. package/lib/packlets/qualifier-types/config/index.d.ts.map +1 -0
  161. package/lib/packlets/qualifier-types/config/index.js +64 -0
  162. package/lib/packlets/qualifier-types/config/index.js.map +1 -0
  163. package/lib/packlets/qualifier-types/config/json.d.ts +69 -0
  164. package/lib/packlets/qualifier-types/config/json.d.ts.map +1 -0
  165. package/lib/packlets/qualifier-types/config/json.js +24 -0
  166. package/lib/packlets/qualifier-types/config/json.js.map +1 -0
  167. package/lib/packlets/qualifier-types/convert.d.ts +10 -2
  168. package/lib/packlets/qualifier-types/convert.d.ts.map +1 -1
  169. package/lib/packlets/qualifier-types/convert.js +15 -0
  170. package/lib/packlets/qualifier-types/convert.js.map +1 -1
  171. package/lib/packlets/qualifier-types/helpers.d.ts +27 -0
  172. package/lib/packlets/qualifier-types/helpers.d.ts.map +1 -0
  173. package/lib/packlets/qualifier-types/helpers.js +118 -0
  174. package/lib/packlets/qualifier-types/helpers.js.map +1 -0
  175. package/lib/packlets/qualifier-types/index.d.ts +4 -1
  176. package/lib/packlets/qualifier-types/index.d.ts.map +1 -1
  177. package/lib/packlets/qualifier-types/index.js +5 -1
  178. package/lib/packlets/qualifier-types/index.js.map +1 -1
  179. package/lib/packlets/qualifier-types/languageQualifierType.d.ts +19 -8
  180. package/lib/packlets/qualifier-types/languageQualifierType.d.ts.map +1 -1
  181. package/lib/packlets/qualifier-types/languageQualifierType.js +28 -9
  182. package/lib/packlets/qualifier-types/languageQualifierType.js.map +1 -1
  183. package/lib/packlets/qualifier-types/literalQualifierType.d.ts +42 -13
  184. package/lib/packlets/qualifier-types/literalQualifierType.d.ts.map +1 -1
  185. package/lib/packlets/qualifier-types/literalQualifierType.js +58 -10
  186. package/lib/packlets/qualifier-types/literalQualifierType.js.map +1 -1
  187. package/lib/packlets/qualifier-types/literalValueHierarchy.d.ts +114 -0
  188. package/lib/packlets/qualifier-types/literalValueHierarchy.d.ts.map +1 -0
  189. package/lib/packlets/qualifier-types/literalValueHierarchy.js +228 -0
  190. package/lib/packlets/qualifier-types/literalValueHierarchy.js.map +1 -0
  191. package/lib/packlets/qualifier-types/qualifierType.d.ts +33 -18
  192. package/lib/packlets/qualifier-types/qualifierType.d.ts.map +1 -1
  193. package/lib/packlets/qualifier-types/qualifierType.js +18 -4
  194. package/lib/packlets/qualifier-types/qualifierType.js.map +1 -1
  195. package/lib/packlets/qualifier-types/qualifierTypeCollector.d.ts +4 -2
  196. package/lib/packlets/qualifier-types/qualifierTypeCollector.d.ts.map +1 -1
  197. package/lib/packlets/qualifier-types/qualifierTypeCollector.js +2 -1
  198. package/lib/packlets/qualifier-types/qualifierTypeCollector.js.map +1 -1
  199. package/lib/packlets/qualifier-types/territoryQualifierType.d.ts +47 -11
  200. package/lib/packlets/qualifier-types/territoryQualifierType.d.ts.map +1 -1
  201. package/lib/packlets/qualifier-types/territoryQualifierType.js +61 -17
  202. package/lib/packlets/qualifier-types/territoryQualifierType.js.map +1 -1
  203. package/lib/packlets/qualifiers/convert/decls.d.ts.map +1 -1
  204. package/lib/packlets/qualifiers/convert/decls.js +17 -15
  205. package/lib/packlets/qualifiers/convert/decls.js.map +1 -1
  206. package/lib/packlets/qualifiers/index.d.ts +2 -0
  207. package/lib/packlets/qualifiers/index.d.ts.map +1 -1
  208. package/lib/packlets/qualifiers/index.js +2 -0
  209. package/lib/packlets/qualifiers/index.js.map +1 -1
  210. package/lib/packlets/qualifiers/qualifier.d.ts +22 -2
  211. package/lib/packlets/qualifiers/qualifier.d.ts.map +1 -1
  212. package/lib/packlets/qualifiers/qualifier.js +26 -1
  213. package/lib/packlets/qualifiers/qualifier.js.map +1 -1
  214. package/lib/packlets/qualifiers/qualifierCollector.d.ts.map +1 -1
  215. package/lib/packlets/qualifiers/qualifierCollector.js +4 -0
  216. package/lib/packlets/qualifiers/qualifierCollector.js.map +1 -1
  217. package/lib/packlets/qualifiers/qualifierDecl.d.ts +6 -1
  218. package/lib/packlets/qualifiers/qualifierDecl.d.ts.map +1 -1
  219. package/lib/packlets/qualifiers/qualifierDecl.js.map +1 -1
  220. package/lib/packlets/qualifiers/qualifierDefaultValueDecls.d.ts +32 -0
  221. package/lib/packlets/qualifiers/qualifierDefaultValueDecls.d.ts.map +1 -0
  222. package/lib/packlets/qualifiers/qualifierDefaultValueDecls.js +24 -0
  223. package/lib/packlets/qualifiers/qualifierDefaultValueDecls.js.map +1 -0
  224. package/lib/packlets/qualifiers/qualifierDefaultValueToken.d.ts +96 -0
  225. package/lib/packlets/qualifiers/qualifierDefaultValueToken.d.ts.map +1 -0
  226. package/lib/packlets/qualifiers/qualifierDefaultValueToken.js +179 -0
  227. package/lib/packlets/qualifiers/qualifierDefaultValueToken.js.map +1 -0
  228. package/lib/packlets/resource-json/compiled/common.d.ts +14 -0
  229. package/lib/packlets/resource-json/compiled/common.d.ts.map +1 -0
  230. package/lib/packlets/resource-json/compiled/common.js +24 -0
  231. package/lib/packlets/resource-json/compiled/common.js.map +1 -0
  232. package/lib/packlets/resource-json/compiled/convert.d.ts +63 -0
  233. package/lib/packlets/resource-json/compiled/convert.d.ts.map +1 -0
  234. package/lib/packlets/resource-json/compiled/convert.js +167 -0
  235. package/lib/packlets/resource-json/compiled/convert.js.map +1 -0
  236. package/lib/packlets/resource-json/compiled/index.d.ts +5 -0
  237. package/lib/packlets/resource-json/compiled/index.d.ts.map +1 -0
  238. package/lib/packlets/resource-json/compiled/index.js +65 -0
  239. package/lib/packlets/resource-json/compiled/index.js.map +1 -0
  240. package/lib/packlets/resource-json/compiled/json.d.ts +204 -0
  241. package/lib/packlets/resource-json/compiled/json.d.ts.map +1 -0
  242. package/lib/packlets/resource-json/compiled/json.js +3 -0
  243. package/lib/packlets/resource-json/compiled/json.js.map +1 -0
  244. package/lib/packlets/resource-json/convert.d.ts +16 -0
  245. package/lib/packlets/resource-json/convert.d.ts.map +1 -1
  246. package/lib/packlets/resource-json/convert.js +41 -6
  247. package/lib/packlets/resource-json/convert.js.map +1 -1
  248. package/lib/packlets/resource-json/helpers.d.ts +82 -3
  249. package/lib/packlets/resource-json/helpers.d.ts.map +1 -1
  250. package/lib/packlets/resource-json/helpers.js +185 -2
  251. package/lib/packlets/resource-json/helpers.js.map +1 -1
  252. package/lib/packlets/resource-json/index.d.ts +2 -1
  253. package/lib/packlets/resource-json/index.d.ts.map +1 -1
  254. package/lib/packlets/resource-json/index.js +3 -1
  255. package/lib/packlets/resource-json/index.js.map +1 -1
  256. package/lib/packlets/resource-json/json.d.ts +55 -3
  257. package/lib/packlets/resource-json/json.d.ts.map +1 -1
  258. package/lib/packlets/resource-json/json.js +16 -0
  259. package/lib/packlets/resource-json/json.js.map +1 -1
  260. package/lib/packlets/resource-json/normalized.d.ts +46 -3
  261. package/lib/packlets/resource-json/normalized.d.ts.map +1 -1
  262. package/lib/packlets/resource-json/normalized.js.map +1 -1
  263. package/lib/packlets/resource-json/resourceDeclCollection.d.ts +14 -10
  264. package/lib/packlets/resource-json/resourceDeclCollection.d.ts.map +1 -1
  265. package/lib/packlets/resource-json/resourceDeclCollection.js +18 -14
  266. package/lib/packlets/resource-json/resourceDeclCollection.js.map +1 -1
  267. package/lib/packlets/resource-json/resourceDeclContainer.d.ts +15 -2
  268. package/lib/packlets/resource-json/resourceDeclContainer.d.ts.map +1 -1
  269. package/lib/packlets/resource-json/resourceDeclContainer.js.map +1 -1
  270. package/lib/packlets/resource-json/resourceDeclTree.d.ts +6 -2
  271. package/lib/packlets/resource-json/resourceDeclTree.d.ts.map +1 -1
  272. package/lib/packlets/resource-json/resourceDeclTree.js +12 -3
  273. package/lib/packlets/resource-json/resourceDeclTree.js.map +1 -1
  274. package/lib/packlets/resource-types/config/convert.d.ts +8 -0
  275. package/lib/packlets/resource-types/config/convert.d.ts.map +1 -0
  276. package/lib/packlets/resource-types/config/convert.js +36 -0
  277. package/lib/packlets/resource-types/config/convert.js.map +1 -0
  278. package/lib/packlets/resource-types/config/index.d.ts +4 -0
  279. package/lib/packlets/resource-types/config/index.d.ts.map +1 -0
  280. package/lib/packlets/resource-types/config/index.js +64 -0
  281. package/lib/packlets/resource-types/config/index.js.map +1 -0
  282. package/lib/packlets/resource-types/config/json.d.ts +9 -0
  283. package/lib/packlets/resource-types/config/json.d.ts.map +1 -0
  284. package/lib/packlets/resource-types/config/json.js +24 -0
  285. package/lib/packlets/resource-types/config/json.js.map +1 -0
  286. package/lib/packlets/resource-types/helpers.d.ts +13 -0
  287. package/lib/packlets/resource-types/helpers.d.ts.map +1 -0
  288. package/lib/packlets/resource-types/helpers.js +44 -0
  289. package/lib/packlets/resource-types/helpers.js.map +1 -0
  290. package/lib/packlets/resource-types/index.d.ts +3 -0
  291. package/lib/packlets/resource-types/index.d.ts.map +1 -1
  292. package/lib/packlets/resource-types/index.js +26 -0
  293. package/lib/packlets/resource-types/index.js.map +1 -1
  294. package/lib/packlets/resource-types/jsonResourceType.d.ts +5 -13
  295. package/lib/packlets/resource-types/jsonResourceType.d.ts.map +1 -1
  296. package/lib/packlets/resource-types/jsonResourceType.js +5 -2
  297. package/lib/packlets/resource-types/jsonResourceType.js.map +1 -1
  298. package/lib/packlets/resource-types/resourceType.d.ts +31 -30
  299. package/lib/packlets/resource-types/resourceType.d.ts.map +1 -1
  300. package/lib/packlets/resource-types/resourceType.js.map +1 -1
  301. package/lib/packlets/resources/candidateReducer.d.ts +98 -0
  302. package/lib/packlets/resources/candidateReducer.d.ts.map +1 -0
  303. package/lib/packlets/resources/candidateReducer.js +247 -0
  304. package/lib/packlets/resources/candidateReducer.js.map +1 -0
  305. package/lib/packlets/resources/common.d.ts +60 -0
  306. package/lib/packlets/resources/common.d.ts.map +1 -0
  307. package/lib/packlets/resources/common.js +24 -0
  308. package/lib/packlets/resources/common.js.map +1 -0
  309. package/lib/packlets/resources/index.d.ts +3 -1
  310. package/lib/packlets/resources/index.d.ts.map +1 -1
  311. package/lib/packlets/resources/index.js +3 -1
  312. package/lib/packlets/resources/index.js.map +1 -1
  313. package/lib/packlets/resources/resource.d.ts +57 -5
  314. package/lib/packlets/resources/resource.d.ts.map +1 -1
  315. package/lib/packlets/resources/resource.js +96 -6
  316. package/lib/packlets/resources/resource.js.map +1 -1
  317. package/lib/packlets/resources/resourceBuilder.d.ts +14 -0
  318. package/lib/packlets/resources/resourceBuilder.d.ts.map +1 -1
  319. package/lib/packlets/resources/resourceBuilder.js +19 -1
  320. package/lib/packlets/resources/resourceBuilder.js.map +1 -1
  321. package/lib/packlets/resources/resourceCandidate.d.ts +42 -6
  322. package/lib/packlets/resources/resourceCandidate.d.ts.map +1 -1
  323. package/lib/packlets/resources/resourceCandidate.js +40 -1
  324. package/lib/packlets/resources/resourceCandidate.js.map +1 -1
  325. package/lib/packlets/resources/resourceManagerBuilder.d.ts +220 -0
  326. package/lib/packlets/resources/resourceManagerBuilder.d.ts.map +1 -0
  327. package/lib/packlets/resources/resourceManagerBuilder.js +451 -0
  328. package/lib/packlets/resources/resourceManagerBuilder.js.map +1 -0
  329. package/lib/packlets/runtime/cacheListener.d.ts +62 -0
  330. package/lib/packlets/runtime/cacheListener.d.ts.map +1 -0
  331. package/lib/packlets/runtime/cacheListener.js +56 -0
  332. package/lib/packlets/runtime/cacheListener.js.map +1 -0
  333. package/lib/packlets/runtime/cacheMetrics.d.ts +82 -0
  334. package/lib/packlets/runtime/cacheMetrics.d.ts.map +1 -0
  335. package/lib/packlets/runtime/cacheMetrics.js +143 -0
  336. package/lib/packlets/runtime/cacheMetrics.js.map +1 -0
  337. package/lib/packlets/runtime/compiledResourceCollection.d.ts +167 -0
  338. package/lib/packlets/runtime/compiledResourceCollection.d.ts.map +1 -0
  339. package/lib/packlets/runtime/compiledResourceCollection.js +466 -0
  340. package/lib/packlets/runtime/compiledResourceCollection.js.map +1 -0
  341. package/lib/packlets/runtime/conditionSetResolutionResult.d.ts +70 -0
  342. package/lib/packlets/runtime/conditionSetResolutionResult.d.ts.map +1 -0
  343. package/lib/packlets/runtime/conditionSetResolutionResult.js +135 -0
  344. package/lib/packlets/runtime/conditionSetResolutionResult.js.map +1 -0
  345. package/lib/packlets/runtime/context/contextQualifierProvider.d.ts +80 -0
  346. package/lib/packlets/runtime/context/contextQualifierProvider.d.ts.map +1 -0
  347. package/lib/packlets/runtime/context/contextQualifierProvider.js +33 -0
  348. package/lib/packlets/runtime/context/contextQualifierProvider.js.map +1 -0
  349. package/lib/packlets/runtime/context/contextQualifierProviderValidator.d.ts +165 -0
  350. package/lib/packlets/runtime/context/contextQualifierProviderValidator.d.ts.map +1 -0
  351. package/lib/packlets/runtime/context/contextQualifierProviderValidator.js +179 -0
  352. package/lib/packlets/runtime/context/contextQualifierProviderValidator.js.map +1 -0
  353. package/lib/packlets/runtime/context/index.d.ts +5 -0
  354. package/lib/packlets/runtime/context/index.d.ts.map +1 -0
  355. package/lib/packlets/runtime/context/index.js +42 -0
  356. package/lib/packlets/runtime/context/index.js.map +1 -0
  357. package/lib/packlets/runtime/context/simpleContextQualifierProvider.d.ts +111 -0
  358. package/lib/packlets/runtime/context/simpleContextQualifierProvider.d.ts.map +1 -0
  359. package/lib/packlets/runtime/context/simpleContextQualifierProvider.js +177 -0
  360. package/lib/packlets/runtime/context/simpleContextQualifierProvider.js.map +1 -0
  361. package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.d.ts +47 -0
  362. package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.d.ts.map +1 -0
  363. package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.js +64 -0
  364. package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.js.map +1 -0
  365. package/lib/packlets/runtime/iResourceManager.d.ts +88 -0
  366. package/lib/packlets/runtime/iResourceManager.d.ts.map +1 -0
  367. package/lib/packlets/runtime/iResourceManager.js +24 -0
  368. package/lib/packlets/runtime/iResourceManager.js.map +1 -0
  369. package/lib/packlets/runtime/index.d.ts +12 -0
  370. package/lib/packlets/runtime/index.d.ts.map +1 -0
  371. package/lib/packlets/runtime/index.js +73 -0
  372. package/lib/packlets/runtime/index.js.map +1 -0
  373. package/lib/packlets/runtime/resource-tree/common.d.ts +91 -0
  374. package/lib/packlets/runtime/resource-tree/common.d.ts.map +1 -0
  375. package/lib/packlets/runtime/resource-tree/common.js +24 -0
  376. package/lib/packlets/runtime/resource-tree/common.js.map +1 -0
  377. package/lib/packlets/runtime/resource-tree/index.d.ts +5 -0
  378. package/lib/packlets/runtime/resource-tree/index.d.ts.map +1 -0
  379. package/lib/packlets/runtime/resource-tree/index.js +42 -0
  380. package/lib/packlets/runtime/resource-tree/index.js.map +1 -0
  381. package/lib/packlets/runtime/resource-tree/readOnlyResourceTree.d.ts +141 -0
  382. package/lib/packlets/runtime/resource-tree/readOnlyResourceTree.d.ts.map +1 -0
  383. package/lib/packlets/runtime/resource-tree/readOnlyResourceTree.js +224 -0
  384. package/lib/packlets/runtime/resource-tree/readOnlyResourceTree.js.map +1 -0
  385. package/lib/packlets/runtime/resource-tree/resourceTreeChildren.d.ts +24 -0
  386. package/lib/packlets/runtime/resource-tree/resourceTreeChildren.d.ts.map +1 -0
  387. package/lib/packlets/runtime/resource-tree/resourceTreeChildren.js +98 -0
  388. package/lib/packlets/runtime/resource-tree/resourceTreeChildren.js.map +1 -0
  389. package/lib/packlets/runtime/resource-tree/resourceTreeChildrenValidator.d.ts +99 -0
  390. package/lib/packlets/runtime/resource-tree/resourceTreeChildrenValidator.d.ts.map +1 -0
  391. package/lib/packlets/runtime/resource-tree/resourceTreeChildrenValidator.js +165 -0
  392. package/lib/packlets/runtime/resource-tree/resourceTreeChildrenValidator.js.map +1 -0
  393. package/lib/packlets/runtime/resourceResolver.d.ts +196 -0
  394. package/lib/packlets/runtime/resourceResolver.d.ts.map +1 -0
  395. package/lib/packlets/runtime/resourceResolver.js +437 -0
  396. package/lib/packlets/runtime/resourceResolver.js.map +1 -0
  397. package/lib/packlets/runtime/validate.d.ts +13 -0
  398. package/lib/packlets/runtime/validate.d.ts.map +1 -0
  399. package/lib/packlets/runtime/validate.js +49 -0
  400. package/lib/packlets/runtime/validate.js.map +1 -0
  401. package/package.json +76 -75
  402. package/lib/packlets/resources/resourceManager.d.ts +0 -104
  403. package/lib/packlets/resources/resourceManager.d.ts.map +0 -1
  404. package/lib/packlets/resources/resourceManager.js +0 -201
  405. package/lib/packlets/resources/resourceManager.js.map +0 -1
@@ -0,0 +1,466 @@
1
+ "use strict";
2
+ /*
3
+ * Copyright (c) 2025 Erik Fortune
4
+ *
5
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ * of this software and associated documentation files (the "Software"), to deal
7
+ * in the Software without restriction, including without limitation the rights
8
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ * copies of the Software, and to permit persons to whom the Software is
10
+ * furnished to do so, subject to the following conditions:
11
+ *
12
+ * The above copyright notice and this permission notice shall be included in all
13
+ * copies or substantial portions of the Software.
14
+ *
15
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ * SOFTWARE.
22
+ */
23
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
24
+ if (k2 === undefined) k2 = k;
25
+ var desc = Object.getOwnPropertyDescriptor(m, k);
26
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
27
+ desc = { enumerable: true, get: function() { return m[k]; } };
28
+ }
29
+ Object.defineProperty(o, k2, desc);
30
+ }) : (function(o, m, k, k2) {
31
+ if (k2 === undefined) k2 = k;
32
+ o[k2] = m[k];
33
+ }));
34
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
35
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
36
+ }) : function(o, v) {
37
+ o["default"] = v;
38
+ });
39
+ var __importStar = (this && this.__importStar) || (function () {
40
+ var ownKeys = function(o) {
41
+ ownKeys = Object.getOwnPropertyNames || function (o) {
42
+ var ar = [];
43
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
44
+ return ar;
45
+ };
46
+ return ownKeys(o);
47
+ };
48
+ return function (mod) {
49
+ if (mod && mod.__esModule) return mod;
50
+ var result = {};
51
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
52
+ __setModuleDefault(result, mod);
53
+ return result;
54
+ };
55
+ })();
56
+ Object.defineProperty(exports, "__esModule", { value: true });
57
+ exports.CompiledResourceCollection = void 0;
58
+ const ts_utils_1 = require("@fgv/ts-utils");
59
+ const conditions_1 = require("../conditions");
60
+ const decisions_1 = require("../decisions");
61
+ const qualifiers_1 = require("../qualifiers");
62
+ const resource_types_1 = require("../resource-types");
63
+ const qualifier_types_1 = require("../qualifier-types");
64
+ const common_1 = require("../common");
65
+ const ts_json_base_1 = require("@fgv/ts-json-base");
66
+ const decisions_2 = require("../decisions");
67
+ const Validate = __importStar(require("./validate"));
68
+ const resource_tree_1 = require("./resource-tree");
69
+ const Context = __importStar(require("../context"));
70
+ /**
71
+ * A compiled resource collection implements {@link Runtime.IResourceManager | IResourceManager}
72
+ * by reconstructing runtime objects from compiled data. This provides an efficient way to load
73
+ * and use pre-compiled resource collections without rebuilding them from scratch.
74
+ * @public
75
+ */
76
+ class CompiledResourceCollection {
77
+ /**
78
+ * A {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector} which
79
+ * contains the {@link QualifierTypes.QualifierType | qualifier types} used in this collection.
80
+ */
81
+ get qualifierTypes() {
82
+ return this._qualifierTypes;
83
+ }
84
+ /**
85
+ * A {@link Qualifiers.QualifierCollector | QualifierCollector} which
86
+ * contains the {@link Qualifiers.Qualifier | qualifiers} used in this collection.
87
+ */
88
+ get qualifiers() {
89
+ return this._qualifiers;
90
+ }
91
+ /**
92
+ * A {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector} which
93
+ * contains the {@link ResourceTypes.ResourceType | resource types} used in this collection.
94
+ */
95
+ get resourceTypes() {
96
+ return this._resourceTypes;
97
+ }
98
+ /**
99
+ * {@inheritdoc Runtime.IResourceManager.builtResources}
100
+ */
101
+ get builtResources() {
102
+ return this._builtResources;
103
+ }
104
+ /**
105
+ * {@inheritdoc Runtime.IResourceManager.numResources}
106
+ */
107
+ get numResources() {
108
+ return this._builtResources.size;
109
+ }
110
+ /**
111
+ * {@inheritdoc Runtime.IResourceManager.numCandidates}
112
+ */
113
+ get numCandidates() {
114
+ if (this._numCandidates === undefined) {
115
+ this._numCandidates = [...this._builtResources.values()].reduce((acc, resource) => acc + resource.candidates.length, 0);
116
+ }
117
+ return this._numCandidates;
118
+ }
119
+ /**
120
+ * Constructor for a {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.
121
+ * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.
122
+ * @internal
123
+ */
124
+ constructor(params) {
125
+ // Reconstruct collectors from compiled data
126
+ this._qualifierTypes = this._buildQualifierTypes(params.compiledCollection, params.qualifierTypes).orThrow();
127
+ this._qualifiers = this._buildQualifiers(params.compiledCollection, this._qualifierTypes).orThrow();
128
+ this._resourceTypes = this._buildResourceTypes(params.compiledCollection, params.resourceTypes).orThrow();
129
+ // Build collectors from compiled data
130
+ const conditionCollector = this._buildConditions(params.compiledCollection, this._qualifiers).orThrow();
131
+ const conditionSetCollector = this._buildConditionSets(params.compiledCollection, conditionCollector).orThrow();
132
+ const decisionCollector = this._buildDecisions(params.compiledCollection, conditionSetCollector).orThrow();
133
+ this.conditions = conditionCollector;
134
+ this.conditionSets = conditionSetCollector;
135
+ this.decisions = decisionCollector;
136
+ // Build resources from compiled data
137
+ this._builtResources = this._buildResources(params.compiledCollection, this._resourceTypes, decisionCollector).orThrow();
138
+ }
139
+ /**
140
+ * Creates a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.
141
+ * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.
142
+ * @returns `Success` with the new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object if successful,
143
+ * or `Failure` with an error message if not.
144
+ * @public
145
+ */
146
+ static create(params) {
147
+ return (0, ts_utils_1.captureResult)(() => new CompiledResourceCollection(params));
148
+ }
149
+ /**
150
+ * {@inheritdoc Runtime.IResourceManager.getBuiltResource}
151
+ */
152
+ getBuiltResource(id) {
153
+ return this._builtResources.validating.get(id);
154
+ }
155
+ /**
156
+ * {@inheritdoc Runtime.IResourceManager.validateContext}
157
+ */
158
+ validateContext(context) {
159
+ return Context.Convert.validatedContextDecl.convert(context, {
160
+ qualifiers: this._qualifiers
161
+ });
162
+ }
163
+ /**
164
+ * Gets a resource tree built from the resources in this collection.
165
+ * The tree provides hierarchical access to resources based on their ResourceId structure.
166
+ * For example, resources with IDs like "app.messages.welcome" create a tree structure
167
+ * where "app" and "messages" are branch nodes, and "welcome" is a leaf containing the resource.
168
+ *
169
+ * String-based validation is available through the `children.validating` property,
170
+ * allowing callers to use `tree.children.validating.getById(stringId)` for validated access.
171
+ *
172
+ * Uses lazy initialization with caching for performance.
173
+ * @returns Result containing the resource tree root, or failure if tree construction fails
174
+ * @public
175
+ */
176
+ getBuiltResourceTree() {
177
+ if (this._cachedResourceTree) {
178
+ return (0, ts_utils_1.succeed)(this._cachedResourceTree);
179
+ }
180
+ // Convert all built resources to [ResourceId, IResource] pairs
181
+ const resources = [];
182
+ for (const [id, resource] of this._builtResources.entries()) {
183
+ resources.push([id, resource]);
184
+ }
185
+ // Create the resource tree with lazy initialization
186
+ return resource_tree_1.ReadOnlyResourceTreeRoot.create(resources).onSuccess((tree) => {
187
+ this._cachedResourceTree = tree;
188
+ return (0, ts_utils_1.succeed)(tree);
189
+ });
190
+ }
191
+ /**
192
+ * Reconstructs a QualifierTypeCollector from compiled data.
193
+ * @param compiled - The compiled resource collection
194
+ * @param qualifierTypes - Map of qualifier type names to qualifier type objects
195
+ * @returns The reconstructed QualifierTypeCollector
196
+ * @internal
197
+ */
198
+ _buildQualifierTypes(compiled, qualifierTypes) {
199
+ return (0, ts_utils_1.mapResults)(compiled.qualifierTypes.map((compiledQualifierType) => qualifierTypes.get(compiledQualifierType.name))).onSuccess((referencedQualifierTypes) => {
200
+ return qualifier_types_1.QualifierTypeCollector.create({
201
+ qualifierTypes: referencedQualifierTypes
202
+ });
203
+ });
204
+ }
205
+ /**
206
+ * Reconstructs a QualifierCollector from compiled data.
207
+ * @param compiled - The compiled resource collection
208
+ * @param qualifierTypes - The reconstructed QualifierTypeCollector
209
+ * @returns The reconstructed QualifierCollector
210
+ * @internal
211
+ */
212
+ _buildQualifiers(compiled, qualifierTypes) {
213
+ return (0, ts_utils_1.mapResults)(compiled.qualifiers.map((compiledQualifier) => {
214
+ return qualifierTypes.getAt(compiledQualifier.type).onSuccess((qualifierType) => {
215
+ return (0, ts_utils_1.succeed)({
216
+ name: compiledQualifier.name,
217
+ typeName: qualifierType.name,
218
+ defaultPriority: compiledQualifier.defaultPriority
219
+ });
220
+ });
221
+ })).onSuccess((qualifierDecls) => {
222
+ return qualifiers_1.QualifierCollector.create({
223
+ qualifierTypes,
224
+ qualifiers: qualifierDecls
225
+ });
226
+ });
227
+ }
228
+ /**
229
+ * Reconstructs a ResourceTypeCollector from compiled data.
230
+ * @param compiled - The compiled resource collection
231
+ * @param resourceTypes - Map of resource type names to resource type objects
232
+ * @returns The reconstructed ResourceTypeCollector
233
+ * @internal
234
+ */
235
+ _buildResourceTypes(compiled, resourceTypes) {
236
+ return (0, ts_utils_1.mapResults)(compiled.resourceTypes.map((compiledResourceType) => resourceTypes.get(compiledResourceType.name))).onSuccess((referencedResourceTypes) => {
237
+ return resource_types_1.ResourceTypeCollector.create({
238
+ resourceTypes: referencedResourceTypes
239
+ });
240
+ });
241
+ }
242
+ /**
243
+ * Reconstructs a ConditionCollector from compiled data.
244
+ * @param compiled - The compiled resource collection
245
+ * @param qualifiers - The reconstructed QualifierCollector
246
+ * @returns The reconstructed ConditionCollector
247
+ * @internal
248
+ */
249
+ _buildConditions(compiled, qualifiers) {
250
+ var _a;
251
+ const errors = new ts_utils_1.MessageAggregator();
252
+ const conditionCollectorResult = conditions_1.ConditionCollector.create({ qualifiers });
253
+ /* c8 ignore next 3 - defensive coding for ConditionCollector creation failure */
254
+ if (conditionCollectorResult.isFailure()) {
255
+ return conditionCollectorResult;
256
+ }
257
+ const conditionCollector = conditionCollectorResult.value;
258
+ for (const [index, compiledCondition] of compiled.conditions.entries()) {
259
+ const qualifierResult = qualifiers.getAt(compiledCondition.qualifierIndex);
260
+ if (qualifierResult.isFailure()) {
261
+ errors.addMessage(`Invalid qualifier index ${compiledCondition.qualifierIndex} at condition ${index}: ${qualifierResult.message}`);
262
+ continue;
263
+ }
264
+ const qualifier = qualifierResult.value;
265
+ /* c8 ignore next 1 - not really testable atm as "matches" is the only supported operator */
266
+ const operator = (_a = compiledCondition.operator) !== null && _a !== void 0 ? _a : 'matches'; // Default to 'matches' if not provided
267
+ const conditionDecl = {
268
+ qualifierName: qualifier.name,
269
+ value: compiledCondition.value,
270
+ operator,
271
+ priority: compiledCondition.priority,
272
+ scoreAsDefault: compiledCondition.scoreAsDefault
273
+ };
274
+ const conditionResult = conditionCollector.validating.add(conditionDecl);
275
+ /* c8 ignore next 4 - defensive coding for condition addition failure */
276
+ if (conditionResult.isFailure()) {
277
+ errors.addMessage(`Failed to add condition at index ${index}: ${conditionResult.message}`);
278
+ continue;
279
+ }
280
+ const condition = conditionResult.value;
281
+ // Validate that the assigned index matches our expected index
282
+ const expectedIndexResult = common_1.Convert.conditionIndex.convert(index);
283
+ /* c8 ignore next 4 - defensive coding for invalid condition index conversion */
284
+ if (expectedIndexResult.isFailure()) {
285
+ errors.addMessage(`Invalid condition index ${index}: ${expectedIndexResult.message}`);
286
+ continue;
287
+ }
288
+ const expectedIndex = expectedIndexResult.value;
289
+ /* c8 ignore next 5 - defensive coding for condition index mismatch */
290
+ if (condition.index !== expectedIndex) {
291
+ errors.addMessage(`Index mismatch at condition ${index}: expected ${expectedIndex}, got ${condition.index}`);
292
+ }
293
+ }
294
+ return errors.hasMessages ? (0, ts_utils_1.fail)(errors.toString()) : (0, ts_utils_1.succeed)(conditionCollector);
295
+ }
296
+ /**
297
+ * Reconstructs a ConditionSetCollector from compiled data.
298
+ * @param compiled - The compiled resource collection
299
+ * @param conditions - The reconstructed ConditionCollector
300
+ * @returns The reconstructed ConditionSetCollector
301
+ * @internal
302
+ */
303
+ _buildConditionSets(compiled, conditions) {
304
+ const errors = new ts_utils_1.MessageAggregator();
305
+ const conditionSetCollectorResult = conditions_1.ConditionSetCollector.create({ conditions });
306
+ /* c8 ignore next 3 - defensive coding for ConditionSetCollector creation failure */
307
+ if (conditionSetCollectorResult.isFailure()) {
308
+ return conditionSetCollectorResult;
309
+ }
310
+ const conditionSetCollector = conditionSetCollectorResult.value;
311
+ for (const [index, compiledConditionSet] of compiled.conditionSets.entries()) {
312
+ const referencedConditionsResult = (0, ts_utils_1.mapResults)(compiledConditionSet.conditions.map((conditionIndex) => conditions.getAt(conditionIndex)));
313
+ if (referencedConditionsResult.isFailure()) {
314
+ errors.addMessage(`Failed to resolve conditions for condition set ${index}: ${referencedConditionsResult.message}`);
315
+ continue;
316
+ }
317
+ const referencedConditions = referencedConditionsResult.value;
318
+ const conditionSetResult = conditionSetCollector.validating.getOrAdd(referencedConditions);
319
+ /* c8 ignore next 4 - defensive coding for condition set addition failure */
320
+ if (conditionSetResult.isFailure()) {
321
+ errors.addMessage(`Failed to add condition set at index ${index}: ${conditionSetResult.message}`);
322
+ continue;
323
+ }
324
+ const conditionSet = conditionSetResult.value;
325
+ // Validate that the assigned index matches our expected index
326
+ const expectedIndexResult = common_1.Convert.conditionSetIndex.convert(index);
327
+ /* c8 ignore next 4 - defensive coding for invalid condition set index conversion */
328
+ if (expectedIndexResult.isFailure()) {
329
+ errors.addMessage(`Invalid condition set index ${index}: ${expectedIndexResult.message}`);
330
+ continue;
331
+ }
332
+ const expectedIndex = expectedIndexResult.value;
333
+ /* c8 ignore next 5 - defensive coding for condition set index mismatch */
334
+ if (conditionSet.index !== expectedIndex) {
335
+ errors.addMessage(`Index mismatch at condition set ${index}: expected ${expectedIndex}, got ${conditionSet.index}`);
336
+ }
337
+ }
338
+ return errors.hasMessages ? (0, ts_utils_1.fail)(errors.toString()) : (0, ts_utils_1.succeed)(conditionSetCollector);
339
+ }
340
+ /**
341
+ * Reconstructs an AbstractDecisionCollector from compiled data.
342
+ * @param compiled - The compiled resource collection
343
+ * @param conditionSets - The reconstructed ConditionSetCollector
344
+ * @returns The reconstructed AbstractDecisionCollector
345
+ * @internal
346
+ */
347
+ _buildDecisions(compiled, conditionSets) {
348
+ const errors = new ts_utils_1.MessageAggregator();
349
+ const decisionCollectorResult = decisions_1.AbstractDecisionCollector.create({ conditionSets });
350
+ /* c8 ignore next 3 - defensive coding for AbstractDecisionCollector creation failure */
351
+ if (decisionCollectorResult.isFailure()) {
352
+ return decisionCollectorResult;
353
+ }
354
+ const decisionCollector = decisionCollectorResult.value;
355
+ for (const [index, compiledDecision] of compiled.decisions.entries()) {
356
+ const referencedConditionSetsResult = (0, ts_utils_1.mapResults)(compiledDecision.conditionSets.map((conditionSetIndex) => conditionSets.getAt(conditionSetIndex)));
357
+ if (referencedConditionSetsResult.isFailure()) {
358
+ errors.addMessage(`Failed to resolve condition sets for decision ${index}: ${referencedConditionSetsResult.message}`);
359
+ continue;
360
+ }
361
+ const referencedConditionSets = referencedConditionSetsResult.value;
362
+ const decisionResult = decisionCollector.validating.getOrAdd(referencedConditionSets);
363
+ /* c8 ignore next 4 - defensive coding for decision addition failure */
364
+ if (decisionResult.isFailure()) {
365
+ errors.addMessage(`Failed to add decision at index ${index}: ${decisionResult.message}`);
366
+ continue;
367
+ }
368
+ const decision = decisionResult.value;
369
+ // Validate that the assigned index matches our expected index
370
+ const expectedIndexResult = common_1.Convert.decisionIndex.convert(index);
371
+ /* c8 ignore next 4 - defensive coding for invalid decision index conversion */
372
+ if (expectedIndexResult.isFailure()) {
373
+ errors.addMessage(`Invalid decision index ${index}: ${expectedIndexResult.message}`);
374
+ continue;
375
+ }
376
+ const expectedIndex = expectedIndexResult.value;
377
+ /* c8 ignore next 5 - defensive coding for decision index mismatch */
378
+ if (decision.index !== expectedIndex) {
379
+ errors.addMessage(`Index mismatch at decision ${index}: expected ${expectedIndex}, got ${decision.index}`);
380
+ }
381
+ }
382
+ return errors.hasMessages ? (0, ts_utils_1.fail)(errors.toString()) : (0, ts_utils_1.succeed)(decisionCollector);
383
+ }
384
+ /**
385
+ * Reconstructs a ValidatingResultMap of resources from compiled data.
386
+ * @param compiled - The compiled resource collection
387
+ * @param resourceTypes - The reconstructed ResourceTypeCollector
388
+ * @param decisions - The reconstructed AbstractDecisionCollector
389
+ * @returns The reconstructed ValidatingResultMap of resources
390
+ * @internal
391
+ */
392
+ _buildResources(compiled, resourceTypes, decisions) {
393
+ const errors = new ts_utils_1.MessageAggregator();
394
+ const resourceMap = new ts_utils_1.ValidatingResultMap({
395
+ converters: new ts_utils_1.Collections.KeyValueConverters({
396
+ key: common_1.Convert.resourceId,
397
+ value: (from) => {
398
+ return Validate.resource.validate(from);
399
+ }
400
+ })
401
+ });
402
+ for (const compiledResource of compiled.resources) {
403
+ const resourceTypeResult = resourceTypes.getAt(compiledResource.type);
404
+ if (resourceTypeResult.isFailure()) {
405
+ errors.addMessage(`Invalid resource type index ${compiledResource.type} for resource ${compiledResource.id}: ${resourceTypeResult.message}`);
406
+ continue;
407
+ }
408
+ const resourceType = resourceTypeResult.value;
409
+ const decisionResult = decisions.getAt(compiledResource.decision);
410
+ if (decisionResult.isFailure()) {
411
+ errors.addMessage(`Invalid decision index ${compiledResource.decision} for resource ${compiledResource.id}: ${decisionResult.message}`);
412
+ continue;
413
+ }
414
+ const decision = decisionResult.value;
415
+ // Build candidates from compiled data
416
+ const candidateDeclsResult = (0, ts_utils_1.mapResults)(compiledResource.candidates.map((compiledCandidate) => ts_json_base_1.Converters.jsonObject.convert(compiledCandidate.json).onSuccess((json) => {
417
+ return (0, ts_utils_1.succeed)({
418
+ json,
419
+ isPartial: compiledCandidate.isPartial,
420
+ mergeMethod: compiledCandidate.mergeMethod
421
+ });
422
+ })));
423
+ if (candidateDeclsResult.isFailure()) {
424
+ errors.addMessage(`Failed to convert candidate JSON for resource ${compiledResource.id}: ${candidateDeclsResult.message}`);
425
+ continue;
426
+ }
427
+ const candidateDecls = candidateDeclsResult.value;
428
+ // Create minimal candidates that implement IResourceCandidate
429
+ const candidates = candidateDecls.map((candidateDecl) => ({
430
+ json: candidateDecl.json,
431
+ isPartial: candidateDecl.isPartial,
432
+ mergeMethod: candidateDecl.mergeMethod
433
+ }));
434
+ // Create a ConcreteDecision from the abstract decision and candidate values
435
+ const candidatesWithConditionSets = decision.candidates.map((baseCandidate, idx) => ({
436
+ conditionSet: baseCandidate.conditionSet,
437
+ value: candidates[idx].json
438
+ }));
439
+ const concreteDecisionResult = decisions_2.ConcreteDecision.create({
440
+ decisions,
441
+ candidates: candidatesWithConditionSets
442
+ });
443
+ /* c8 ignore next 6 - defensive coding for ConcreteDecision creation failure */
444
+ if (concreteDecisionResult.isFailure()) {
445
+ errors.addMessage(`Failed to create concrete decision for resource ${compiledResource.id}: ${concreteDecisionResult.message}`);
446
+ continue;
447
+ }
448
+ const concreteDecision = concreteDecisionResult.value;
449
+ // Create minimal resource that implements IResource
450
+ const resource = {
451
+ id: compiledResource.id,
452
+ resourceType,
453
+ decision: concreteDecision,
454
+ candidates
455
+ };
456
+ const setResult = resourceMap.set(compiledResource.id, resource);
457
+ /* c8 ignore next 3 - defensive coding for resource map set failure */
458
+ if (setResult.isFailure()) {
459
+ errors.addMessage(`Failed to add resource ${compiledResource.id}: ${setResult.message}`);
460
+ }
461
+ }
462
+ return errors.hasMessages ? (0, ts_utils_1.fail)(errors.toString()) : (0, ts_utils_1.succeed)(resourceMap);
463
+ }
464
+ }
465
+ exports.CompiledResourceCollection = CompiledResourceCollection;
466
+ //# sourceMappingURL=compiledResourceCollection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiledResourceCollection.js","sourceRoot":"","sources":["../../../src/packlets/runtime/compiledResourceCollection.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 {\n captureResult,\n Collections,\n fail,\n mapResults,\n MessageAggregator,\n Result,\n succeed,\n ValidatingResultMap\n} from '@fgv/ts-utils';\nimport {\n ConditionCollector,\n ConditionSetCollector,\n ReadOnlyConditionCollector,\n ReadOnlyConditionSetCollector\n} from '../conditions';\nimport { AbstractDecisionCollector, ReadOnlyAbstractDecisionCollector } from '../decisions';\nimport { QualifierCollector } from '../qualifiers';\nimport { ResourceType, ResourceTypeCollector } from '../resource-types';\nimport { QualifierType, QualifierTypeCollector } from '../qualifier-types';\nimport { Convert, ResourceId } from '../common';\nimport { Converters } from '@fgv/ts-json-base';\nimport { IResourceManager, IResource, IResourceCandidate } from './iResourceManager';\nimport { ConcreteDecision } from '../decisions';\nimport * as Validate from './validate';\nimport * as ResourceJson from '../resource-json';\nimport { ReadOnlyResourceTreeRoot, IReadOnlyResourceTreeRoot } from './resource-tree';\nimport * as Context from '../context';\n\n/**\n * Interface for parameters to create a {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.\n * @public\n */\nexport interface ICompiledResourceCollectionCreateParams {\n /**\n * The compiled resource collection data.\n */\n compiledCollection: ResourceJson.Compiled.ICompiledResourceCollection;\n /**\n * Map of qualifier type names to qualifier type objects.\n */\n qualifierTypes: Collections.IReadOnlyResultMap<string, QualifierType>;\n /**\n * Map of resource type names to resource type objects.\n */\n resourceTypes: Collections.IReadOnlyResultMap<string, ResourceType>;\n}\n\n/**\n * A compiled resource collection implements {@link Runtime.IResourceManager | IResourceManager}\n * by reconstructing runtime objects from compiled data. This provides an efficient way to load\n * and use pre-compiled resource collections without rebuilding them from scratch.\n * @public\n */\nexport class CompiledResourceCollection implements IResourceManager {\n public readonly conditions: ReadOnlyConditionCollector;\n public readonly conditionSets: ReadOnlyConditionSetCollector;\n public readonly decisions: ReadOnlyAbstractDecisionCollector;\n\n private readonly _qualifierTypes: QualifierTypeCollector;\n private readonly _qualifiers: QualifierCollector;\n private readonly _resourceTypes: ResourceTypeCollector;\n private readonly _builtResources: ValidatingResultMap<ResourceId, IResource>;\n private _cachedResourceTree?: ReadOnlyResourceTreeRoot<IResource>;\n\n /**\n * A {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector} which\n * contains the {@link QualifierTypes.QualifierType | qualifier types} used in this collection.\n */\n public get qualifierTypes(): QualifierTypeCollector {\n return this._qualifierTypes;\n }\n\n /**\n * A {@link Qualifiers.QualifierCollector | QualifierCollector} which\n * contains the {@link Qualifiers.Qualifier | qualifiers} used in this collection.\n */\n public get qualifiers(): QualifierCollector {\n return this._qualifiers;\n }\n\n /**\n * A {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector} which\n * contains the {@link ResourceTypes.ResourceType | resource types} used in this collection.\n */\n public get resourceTypes(): ResourceTypeCollector {\n return this._resourceTypes;\n }\n\n /**\n * {@inheritdoc Runtime.IResourceManager.builtResources}\n */\n public get builtResources(): Collections.IReadOnlyValidatingResultMap<ResourceId, IResource> {\n return this._builtResources;\n }\n\n /**\n * {@inheritdoc Runtime.IResourceManager.numResources}\n */\n public get numResources(): number {\n return this._builtResources.size;\n }\n\n protected _numCandidates?: number;\n\n /**\n * {@inheritdoc Runtime.IResourceManager.numCandidates}\n */\n public get numCandidates(): number {\n if (this._numCandidates === undefined) {\n this._numCandidates = [...this._builtResources.values()].reduce(\n (acc, resource) => acc + resource.candidates.length,\n 0\n );\n }\n return this._numCandidates;\n }\n\n /**\n * Constructor for a {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.\n * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.\n * @internal\n */\n protected constructor(params: ICompiledResourceCollectionCreateParams) {\n // Reconstruct collectors from compiled data\n this._qualifierTypes = this._buildQualifierTypes(\n params.compiledCollection,\n params.qualifierTypes\n ).orThrow();\n this._qualifiers = this._buildQualifiers(params.compiledCollection, this._qualifierTypes).orThrow();\n this._resourceTypes = this._buildResourceTypes(params.compiledCollection, params.resourceTypes).orThrow();\n\n // Build collectors from compiled data\n const conditionCollector = this._buildConditions(params.compiledCollection, this._qualifiers).orThrow();\n const conditionSetCollector = this._buildConditionSets(\n params.compiledCollection,\n conditionCollector\n ).orThrow();\n const decisionCollector = this._buildDecisions(\n params.compiledCollection,\n conditionSetCollector\n ).orThrow();\n\n this.conditions = conditionCollector;\n this.conditionSets = conditionSetCollector;\n this.decisions = decisionCollector;\n\n // Build resources from compiled data\n this._builtResources = this._buildResources(\n params.compiledCollection,\n this._resourceTypes,\n decisionCollector\n ).orThrow();\n }\n\n /**\n * Creates a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.\n * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.\n * @returns `Success` with the new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object if successful,\n * or `Failure` with an error message if not.\n * @public\n */\n public static create(params: ICompiledResourceCollectionCreateParams): Result<CompiledResourceCollection> {\n return captureResult(() => new CompiledResourceCollection(params));\n }\n\n /**\n * {@inheritdoc Runtime.IResourceManager.getBuiltResource}\n */\n public getBuiltResource(id: string): Result<IResource> {\n return this._builtResources.validating.get(id);\n }\n\n /**\n * {@inheritdoc Runtime.IResourceManager.validateContext}\n */\n public validateContext(context: Context.IContextDecl): Result<Context.IValidatedContextDecl> {\n return Context.Convert.validatedContextDecl.convert(context, {\n qualifiers: this._qualifiers\n });\n }\n\n /**\n * Gets a resource tree built from the resources in this collection.\n * The tree provides hierarchical access to resources based on their ResourceId structure.\n * For example, resources with IDs like \"app.messages.welcome\" create a tree structure\n * where \"app\" and \"messages\" are branch nodes, and \"welcome\" is a leaf containing the resource.\n *\n * String-based validation is available through the `children.validating` property,\n * allowing callers to use `tree.children.validating.getById(stringId)` for validated access.\n *\n * Uses lazy initialization with caching for performance.\n * @returns Result containing the resource tree root, or failure if tree construction fails\n * @public\n */\n public getBuiltResourceTree(): Result<IReadOnlyResourceTreeRoot<IResource>> {\n if (this._cachedResourceTree) {\n return succeed(this._cachedResourceTree);\n }\n\n // Convert all built resources to [ResourceId, IResource] pairs\n const resources: [ResourceId, IResource][] = [];\n for (const [id, resource] of this._builtResources.entries()) {\n resources.push([id, resource]);\n }\n\n // Create the resource tree with lazy initialization\n return ReadOnlyResourceTreeRoot.create(resources).onSuccess((tree) => {\n this._cachedResourceTree = tree;\n return succeed(tree);\n });\n }\n\n /**\n * Reconstructs a QualifierTypeCollector from compiled data.\n * @param compiled - The compiled resource collection\n * @param qualifierTypes - Map of qualifier type names to qualifier type objects\n * @returns The reconstructed QualifierTypeCollector\n * @internal\n */\n private _buildQualifierTypes(\n compiled: ResourceJson.Compiled.ICompiledResourceCollection,\n qualifierTypes: Collections.IReadOnlyResultMap<string, QualifierType>\n ): Result<QualifierTypeCollector> {\n return mapResults(\n compiled.qualifierTypes.map((compiledQualifierType) => qualifierTypes.get(compiledQualifierType.name))\n ).onSuccess((referencedQualifierTypes) => {\n return QualifierTypeCollector.create({\n qualifierTypes: referencedQualifierTypes\n });\n });\n }\n\n /**\n * Reconstructs a QualifierCollector from compiled data.\n * @param compiled - The compiled resource collection\n * @param qualifierTypes - The reconstructed QualifierTypeCollector\n * @returns The reconstructed QualifierCollector\n * @internal\n */\n private _buildQualifiers(\n compiled: ResourceJson.Compiled.ICompiledResourceCollection,\n qualifierTypes: QualifierTypeCollector\n ): Result<QualifierCollector> {\n return mapResults(\n compiled.qualifiers.map((compiledQualifier) => {\n return qualifierTypes.getAt(compiledQualifier.type).onSuccess((qualifierType) => {\n return succeed({\n name: compiledQualifier.name,\n typeName: qualifierType.name,\n defaultPriority: compiledQualifier.defaultPriority\n });\n });\n })\n ).onSuccess((qualifierDecls) => {\n return QualifierCollector.create({\n qualifierTypes,\n qualifiers: qualifierDecls\n });\n });\n }\n\n /**\n * Reconstructs a ResourceTypeCollector from compiled data.\n * @param compiled - The compiled resource collection\n * @param resourceTypes - Map of resource type names to resource type objects\n * @returns The reconstructed ResourceTypeCollector\n * @internal\n */\n private _buildResourceTypes(\n compiled: ResourceJson.Compiled.ICompiledResourceCollection,\n resourceTypes: Collections.IReadOnlyResultMap<string, ResourceType>\n ): Result<ResourceTypeCollector> {\n return mapResults(\n compiled.resourceTypes.map((compiledResourceType) => resourceTypes.get(compiledResourceType.name))\n ).onSuccess((referencedResourceTypes) => {\n return ResourceTypeCollector.create({\n resourceTypes: referencedResourceTypes\n });\n });\n }\n\n /**\n * Reconstructs a ConditionCollector from compiled data.\n * @param compiled - The compiled resource collection\n * @param qualifiers - The reconstructed QualifierCollector\n * @returns The reconstructed ConditionCollector\n * @internal\n */\n private _buildConditions(\n compiled: ResourceJson.Compiled.ICompiledResourceCollection,\n qualifiers: QualifierCollector\n ): Result<ConditionCollector> {\n const errors = new MessageAggregator();\n\n const conditionCollectorResult = ConditionCollector.create({ qualifiers });\n /* c8 ignore next 3 - defensive coding for ConditionCollector creation failure */\n if (conditionCollectorResult.isFailure()) {\n return conditionCollectorResult;\n }\n const conditionCollector = conditionCollectorResult.value;\n\n for (const [index, compiledCondition] of compiled.conditions.entries()) {\n const qualifierResult = qualifiers.getAt(compiledCondition.qualifierIndex);\n if (qualifierResult.isFailure()) {\n errors.addMessage(\n `Invalid qualifier index ${compiledCondition.qualifierIndex} at condition ${index}: ${qualifierResult.message}`\n );\n continue;\n }\n const qualifier = qualifierResult.value;\n\n /* c8 ignore next 1 - not really testable atm as \"matches\" is the only supported operator */\n const operator = compiledCondition.operator ?? 'matches'; // Default to 'matches' if not provided\n const conditionDecl = {\n qualifierName: qualifier.name,\n value: compiledCondition.value,\n operator,\n priority: compiledCondition.priority,\n scoreAsDefault: compiledCondition.scoreAsDefault\n };\n\n const conditionResult = conditionCollector.validating.add(conditionDecl);\n /* c8 ignore next 4 - defensive coding for condition addition failure */\n if (conditionResult.isFailure()) {\n errors.addMessage(`Failed to add condition at index ${index}: ${conditionResult.message}`);\n continue;\n }\n const condition = conditionResult.value;\n\n // Validate that the assigned index matches our expected index\n const expectedIndexResult = Convert.conditionIndex.convert(index);\n /* c8 ignore next 4 - defensive coding for invalid condition index conversion */\n if (expectedIndexResult.isFailure()) {\n errors.addMessage(`Invalid condition index ${index}: ${expectedIndexResult.message}`);\n continue;\n }\n const expectedIndex = expectedIndexResult.value;\n\n /* c8 ignore next 5 - defensive coding for condition index mismatch */\n if (condition.index !== expectedIndex) {\n errors.addMessage(\n `Index mismatch at condition ${index}: expected ${expectedIndex}, got ${condition.index}`\n );\n }\n }\n\n return errors.hasMessages ? fail(errors.toString()) : succeed(conditionCollector);\n }\n\n /**\n * Reconstructs a ConditionSetCollector from compiled data.\n * @param compiled - The compiled resource collection\n * @param conditions - The reconstructed ConditionCollector\n * @returns The reconstructed ConditionSetCollector\n * @internal\n */\n private _buildConditionSets(\n compiled: ResourceJson.Compiled.ICompiledResourceCollection,\n conditions: ConditionCollector\n ): Result<ConditionSetCollector> {\n const errors = new MessageAggregator();\n\n const conditionSetCollectorResult = ConditionSetCollector.create({ conditions });\n /* c8 ignore next 3 - defensive coding for ConditionSetCollector creation failure */\n if (conditionSetCollectorResult.isFailure()) {\n return conditionSetCollectorResult;\n }\n const conditionSetCollector = conditionSetCollectorResult.value;\n\n for (const [index, compiledConditionSet] of compiled.conditionSets.entries()) {\n const referencedConditionsResult = mapResults(\n compiledConditionSet.conditions.map((conditionIndex) => conditions.getAt(conditionIndex))\n );\n if (referencedConditionsResult.isFailure()) {\n errors.addMessage(\n `Failed to resolve conditions for condition set ${index}: ${referencedConditionsResult.message}`\n );\n continue;\n }\n const referencedConditions = referencedConditionsResult.value;\n\n const conditionSetResult = conditionSetCollector.validating.getOrAdd(referencedConditions);\n /* c8 ignore next 4 - defensive coding for condition set addition failure */\n if (conditionSetResult.isFailure()) {\n errors.addMessage(`Failed to add condition set at index ${index}: ${conditionSetResult.message}`);\n continue;\n }\n const conditionSet = conditionSetResult.value;\n\n // Validate that the assigned index matches our expected index\n const expectedIndexResult = Convert.conditionSetIndex.convert(index);\n /* c8 ignore next 4 - defensive coding for invalid condition set index conversion */\n if (expectedIndexResult.isFailure()) {\n errors.addMessage(`Invalid condition set index ${index}: ${expectedIndexResult.message}`);\n continue;\n }\n const expectedIndex = expectedIndexResult.value;\n\n /* c8 ignore next 5 - defensive coding for condition set index mismatch */\n if (conditionSet.index !== expectedIndex) {\n errors.addMessage(\n `Index mismatch at condition set ${index}: expected ${expectedIndex}, got ${conditionSet.index}`\n );\n }\n }\n\n return errors.hasMessages ? fail(errors.toString()) : succeed(conditionSetCollector);\n }\n\n /**\n * Reconstructs an AbstractDecisionCollector from compiled data.\n * @param compiled - The compiled resource collection\n * @param conditionSets - The reconstructed ConditionSetCollector\n * @returns The reconstructed AbstractDecisionCollector\n * @internal\n */\n private _buildDecisions(\n compiled: ResourceJson.Compiled.ICompiledResourceCollection,\n conditionSets: ConditionSetCollector\n ): Result<AbstractDecisionCollector> {\n const errors = new MessageAggregator();\n\n const decisionCollectorResult = AbstractDecisionCollector.create({ conditionSets });\n /* c8 ignore next 3 - defensive coding for AbstractDecisionCollector creation failure */\n if (decisionCollectorResult.isFailure()) {\n return decisionCollectorResult;\n }\n const decisionCollector = decisionCollectorResult.value;\n\n for (const [index, compiledDecision] of compiled.decisions.entries()) {\n const referencedConditionSetsResult = mapResults(\n compiledDecision.conditionSets.map((conditionSetIndex) => conditionSets.getAt(conditionSetIndex))\n );\n if (referencedConditionSetsResult.isFailure()) {\n errors.addMessage(\n `Failed to resolve condition sets for decision ${index}: ${referencedConditionSetsResult.message}`\n );\n continue;\n }\n const referencedConditionSets = referencedConditionSetsResult.value;\n\n const decisionResult = decisionCollector.validating.getOrAdd(referencedConditionSets);\n /* c8 ignore next 4 - defensive coding for decision addition failure */\n if (decisionResult.isFailure()) {\n errors.addMessage(`Failed to add decision at index ${index}: ${decisionResult.message}`);\n continue;\n }\n const decision = decisionResult.value;\n\n // Validate that the assigned index matches our expected index\n const expectedIndexResult = Convert.decisionIndex.convert(index);\n /* c8 ignore next 4 - defensive coding for invalid decision index conversion */\n if (expectedIndexResult.isFailure()) {\n errors.addMessage(`Invalid decision index ${index}: ${expectedIndexResult.message}`);\n continue;\n }\n const expectedIndex = expectedIndexResult.value;\n\n /* c8 ignore next 5 - defensive coding for decision index mismatch */\n if (decision.index !== expectedIndex) {\n errors.addMessage(\n `Index mismatch at decision ${index}: expected ${expectedIndex}, got ${decision.index}`\n );\n }\n }\n\n return errors.hasMessages ? fail(errors.toString()) : succeed(decisionCollector);\n }\n\n /**\n * Reconstructs a ValidatingResultMap of resources from compiled data.\n * @param compiled - The compiled resource collection\n * @param resourceTypes - The reconstructed ResourceTypeCollector\n * @param decisions - The reconstructed AbstractDecisionCollector\n * @returns The reconstructed ValidatingResultMap of resources\n * @internal\n */\n private _buildResources(\n compiled: ResourceJson.Compiled.ICompiledResourceCollection,\n resourceTypes: ResourceTypeCollector,\n decisions: AbstractDecisionCollector\n ): Result<ValidatingResultMap<ResourceId, IResource>> {\n const errors = new MessageAggregator();\n\n const resourceMap = new ValidatingResultMap<ResourceId, IResource>({\n converters: new Collections.KeyValueConverters<ResourceId, IResource>({\n key: Convert.resourceId,\n value: (from: unknown): Result<IResource> => {\n return Validate.resource.validate(from);\n }\n })\n });\n\n for (const compiledResource of compiled.resources) {\n const resourceTypeResult = resourceTypes.getAt(compiledResource.type);\n if (resourceTypeResult.isFailure()) {\n errors.addMessage(\n `Invalid resource type index ${compiledResource.type} for resource ${compiledResource.id}: ${resourceTypeResult.message}`\n );\n continue;\n }\n const resourceType = resourceTypeResult.value;\n\n const decisionResult = decisions.getAt(compiledResource.decision);\n if (decisionResult.isFailure()) {\n errors.addMessage(\n `Invalid decision index ${compiledResource.decision} for resource ${compiledResource.id}: ${decisionResult.message}`\n );\n continue;\n }\n const decision = decisionResult.value;\n\n // Build candidates from compiled data\n const candidateDeclsResult = mapResults(\n compiledResource.candidates.map((compiledCandidate) =>\n Converters.jsonObject.convert(compiledCandidate.json).onSuccess((json) => {\n return succeed({\n json,\n isPartial: compiledCandidate.isPartial,\n mergeMethod: compiledCandidate.mergeMethod\n });\n })\n )\n );\n if (candidateDeclsResult.isFailure()) {\n errors.addMessage(\n `Failed to convert candidate JSON for resource ${compiledResource.id}: ${candidateDeclsResult.message}`\n );\n continue;\n }\n const candidateDecls = candidateDeclsResult.value;\n\n // Create minimal candidates that implement IResourceCandidate\n const candidates: IResourceCandidate[] = candidateDecls.map((candidateDecl) => ({\n json: candidateDecl.json,\n isPartial: candidateDecl.isPartial,\n mergeMethod: candidateDecl.mergeMethod\n }));\n\n // Create a ConcreteDecision from the abstract decision and candidate values\n const candidatesWithConditionSets = decision.candidates.map((baseCandidate, idx) => ({\n conditionSet: baseCandidate.conditionSet,\n value: candidates[idx].json\n }));\n\n const concreteDecisionResult = ConcreteDecision.create({\n decisions,\n candidates: candidatesWithConditionSets\n });\n /* c8 ignore next 6 - defensive coding for ConcreteDecision creation failure */\n if (concreteDecisionResult.isFailure()) {\n errors.addMessage(\n `Failed to create concrete decision for resource ${compiledResource.id}: ${concreteDecisionResult.message}`\n );\n continue;\n }\n const concreteDecision = concreteDecisionResult.value;\n\n // Create minimal resource that implements IResource\n const resource: IResource = {\n id: compiledResource.id,\n resourceType,\n decision: concreteDecision,\n candidates\n };\n\n const setResult = resourceMap.set(compiledResource.id, resource);\n /* c8 ignore next 3 - defensive coding for resource map set failure */\n if (setResult.isFailure()) {\n errors.addMessage(`Failed to add resource ${compiledResource.id}: ${setResult.message}`);\n }\n }\n\n return errors.hasMessages ? fail(errors.toString()) : succeed(resourceMap);\n }\n}\n"]}
@@ -0,0 +1,70 @@
1
+ import { Result } from '@fgv/ts-utils';
2
+ import { QualifierMatchScore, ConditionPriority } from '../common';
3
+ /**
4
+ * The outcome of a condition match.
5
+ * @public
6
+ */
7
+ export type ConditionMatchType = 'match' | 'matchAsDefault' | 'noMatch';
8
+ /**
9
+ * Represents a single condition match result with priority and outcome.
10
+ * @public
11
+ */
12
+ export interface IConditionMatchResult {
13
+ readonly priority: ConditionPriority;
14
+ readonly matchType: ConditionMatchType;
15
+ readonly score: QualifierMatchScore;
16
+ }
17
+ /**
18
+ * Represents the result of resolving a condition set.
19
+ * Contains either a failure indicator or a list of condition priority/score tuples sorted by priority then score.
20
+ * @public
21
+ */
22
+ export declare class ConditionSetResolutionResult {
23
+ readonly matchType: ConditionMatchType;
24
+ readonly matches: ReadonlyArray<IConditionMatchResult>;
25
+ /**
26
+ * Constructor for a {@link Runtime.ConditionSetResolutionResult | ConditionSetResolutionResult}.
27
+ * @param success - Whether the condition set resolution was successful.
28
+ * @param matches - Array of condition match results, if successful.
29
+ */
30
+ private constructor();
31
+ /**
32
+ * Creates a new condition set resolution result.
33
+ * @param matchType - The type of match.
34
+ * @param matches - Array of condition match results.
35
+ * @returns A new {@link Runtime.ConditionSetResolutionResult | ConditionSetResolutionResult}.
36
+ * @public
37
+ */
38
+ static create(matchType: ConditionMatchType, matches: ReadonlyArray<IConditionMatchResult>): Result<ConditionSetResolutionResult>;
39
+ /**
40
+ * Compares two condition set resolution results for sorting purposes.
41
+ * The priority of a condition set result cannot be boiled down to a single number -
42
+ * we have to examine each condition result in turn.
43
+ *
44
+ * Comparison logic:
45
+ * - If priority differs, return the higher priority
46
+ * - If priority matches but score is different, return the higher score
47
+ * - If priority and score both match, proceed to the next condition
48
+ * - Failed results are considered lower priority than successful results
49
+ *
50
+ * @param a - The first condition set resolution result to compare.
51
+ * @param b - The second condition set resolution result to compare.
52
+ * @returns A negative number if a should come before b, a positive number if a should
53
+ * come after b, or zero if they are equivalent.
54
+ * @public
55
+ */
56
+ static compare(a: ConditionSetResolutionResult, b: ConditionSetResolutionResult): number;
57
+ /**
58
+ * Gets the highest priority among all condition matches.
59
+ * @returns The highest priority, or 0 if no matches.
60
+ * @public
61
+ */
62
+ get maxPriority(): ConditionPriority;
63
+ /**
64
+ * Gets the total score by summing all condition match scores.
65
+ * @returns The total score, or 0 if no matches.
66
+ * @public
67
+ */
68
+ get totalScore(): QualifierMatchScore;
69
+ }
70
+ //# sourceMappingURL=conditionSetResolutionResult.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"conditionSetResolutionResult.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/conditionSetResolutionResult.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;GAIG;AACH,qBAAa,4BAA4B;IACvC,SAAgB,SAAS,EAAE,kBAAkB,CAAC;IAC9C,SAAgB,OAAO,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAE9D;;;;OAIG;IACH,OAAO;IAKP;;;;;;OAMG;WACW,MAAM,CAClB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAC5C,MAAM,CAAC,4BAA4B,CAAC;IAIvC;;;;;;;;;;;;;;;;OAgBG;WACW,OAAO,CAAC,CAAC,EAAE,4BAA4B,EAAE,CAAC,EAAE,4BAA4B,GAAG,MAAM;IA6C/F;;;;OAIG;IACH,IAAW,WAAW,IAAI,iBAAiB,CAK1C;IAED;;;;OAIG;IACH,IAAW,UAAU,IAAI,mBAAmB,CAK3C;CACF"}