@mrclrchtr/supi-code-intelligence 12.0.0 → 14.0.0

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 (307) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/README.md +7 -5
  3. package/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  4. package/node_modules/@mrclrchtr/supi-code-runtime/src/query-result.ts +10 -0
  5. package/node_modules/@mrclrchtr/supi-core/package.json +3 -1
  6. package/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
  7. package/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
  8. package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +78 -13
  9. package/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +41 -9
  10. package/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
  11. package/node_modules/@mrclrchtr/supi-core/src/session.ts +3 -0
  12. package/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
  13. package/node_modules/@mrclrchtr/supi-core/src/side-run.ts +46 -0
  14. package/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
  15. package/node_modules/@mrclrchtr/supi-lsp/README.md +6 -2
  16. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  17. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/query-result.ts +10 -0
  18. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +3 -1
  19. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
  20. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
  21. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +78 -13
  22. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +41 -9
  23. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
  24. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/session.ts +3 -0
  25. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
  26. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/side-run.ts +46 -0
  27. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
  28. package/node_modules/@mrclrchtr/supi-lsp/package.json +8 -8
  29. package/node_modules/@mrclrchtr/supi-lsp/src/api.ts +1 -0
  30. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +102 -47
  31. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +8 -0
  32. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +20 -1
  33. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +4 -1
  34. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-timing.ts +14 -1
  35. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-typescript.ts +8 -1
  36. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +50 -4
  37. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-disk-stamp.ts +60 -0
  38. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +3 -0
  39. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +21 -1
  40. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-file-state.ts +17 -3
  41. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-input-admission.ts +7 -1
  42. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-barrier.ts +53 -4
  43. package/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +12 -3
  44. package/node_modules/@mrclrchtr/supi-lsp/src/client/transport.ts +24 -8
  45. package/node_modules/@mrclrchtr/supi-lsp/src/config/server-config.ts +5 -0
  46. package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-extends.ts +2 -1
  47. package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-path.ts +2 -2
  48. package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-scope.ts +17 -5
  49. package/node_modules/@mrclrchtr/supi-lsp/src/config/typescript-module.ts +17 -0
  50. package/node_modules/@mrclrchtr/supi-lsp/src/debug-telemetry.ts +64 -0
  51. package/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +42 -0
  52. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-client-state.ts +2 -17
  53. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-project-info.ts +3 -0
  54. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-removal-ledger.ts +52 -0
  55. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-typescript-coverage.ts +27 -2
  56. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-symbol.ts +16 -112
  57. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +561 -103
  58. package/node_modules/@mrclrchtr/supi-lsp/src/manager/typescript-file-local.ts +6 -1
  59. package/node_modules/@mrclrchtr/supi-lsp/src/manager/workspace-symbol-collection.ts +163 -0
  60. package/node_modules/@mrclrchtr/supi-lsp/src/manager/workspace-symbol-row-limit.ts +72 -0
  61. package/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts +6 -1
  62. package/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-symbol-mapper.ts +13 -3
  63. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +11 -0
  64. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +11 -0
  65. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +1 -0
  66. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +53 -9
  67. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-transition-debug.ts +11 -1
  68. package/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +2 -0
  69. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  70. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/query-result.ts +10 -0
  71. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +3 -1
  72. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
  73. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
  74. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +78 -13
  75. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +41 -9
  76. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
  77. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/session.ts +3 -0
  78. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
  79. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/side-run.ts +46 -0
  80. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
  81. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs +50 -75
  82. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs.map +2 -2
  83. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js +50 -75
  84. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js.map +2 -2
  85. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm +0 -0
  86. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm.map +6 -6
  87. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/package.json +1 -1
  88. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs +50 -75
  89. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs.map +2 -2
  90. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts +7 -7
  91. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts.map +1 -1
  92. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts +7 -7
  93. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts.map +1 -1
  94. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js +50 -75
  95. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js.map +2 -2
  96. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm +0 -0
  97. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm.map +5 -5
  98. package/node_modules/@mrclrchtr/supi-tree-sitter/package.json +5 -5
  99. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/kotlin/tree-sitter-kotlin.wasm.json +1 -1
  100. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/latex/tree-sitter-latex.wasm.json +1 -1
  101. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/sql/tree-sitter-sql.wasm +0 -0
  102. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/sql/tree-sitter-sql.wasm.json +3 -3
  103. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/tree-sitter-tsx.wasm.json +1 -1
  104. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/tree-sitter-typescript.wasm.json +1 -1
  105. package/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +1 -1
  106. package/node_modules/fast-xml-parser/CHANGELOG.md +886 -0
  107. package/node_modules/fast-xml-parser/LICENSE +21 -0
  108. package/node_modules/fast-xml-parser/README.md +204 -0
  109. package/node_modules/fast-xml-parser/lib/fxbuilder.min.js +2 -0
  110. package/node_modules/fast-xml-parser/lib/fxbuilder.min.js.map +1 -0
  111. package/node_modules/fast-xml-parser/lib/fxp.cjs +1 -0
  112. package/node_modules/fast-xml-parser/lib/fxp.d.cts +774 -0
  113. package/node_modules/fast-xml-parser/lib/fxp.min.js +2 -0
  114. package/node_modules/fast-xml-parser/lib/fxp.min.js.map +1 -0
  115. package/node_modules/fast-xml-parser/lib/fxparser.min.js +2 -0
  116. package/node_modules/fast-xml-parser/lib/fxparser.min.js.map +1 -0
  117. package/node_modules/fast-xml-parser/lib/fxvalidator.min.js +2 -0
  118. package/node_modules/fast-xml-parser/lib/fxvalidator.min.js.map +1 -0
  119. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/README.md +92 -0
  120. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/package.json +57 -0
  121. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/EntityDecoder.js +644 -0
  122. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/EntityEncoder.js +239 -0
  123. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/all-entities.js +53 -0
  124. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/entities.js +1139 -0
  125. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/entityTries.js +60 -0
  126. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/index.d.ts +358 -0
  127. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/index.js +29 -0
  128. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/CHANGELOG.md +52 -0
  129. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/LICENSE +21 -0
  130. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/README.md +77 -0
  131. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.cjs +1 -0
  132. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.d.cts +270 -0
  133. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.min.js +2 -0
  134. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.min.js.map +1 -0
  135. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/package.json +77 -0
  136. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/fxb.d.ts +270 -0
  137. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/fxb.js +609 -0
  138. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/ignoreAttributes.js +18 -0
  139. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/orderedJs2Xml.js +360 -0
  140. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/prettifyJs2Xml.js +0 -0
  141. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/util.js +23 -0
  142. package/node_modules/fast-xml-parser/node_modules/is-unsafe/LICENSE +21 -0
  143. package/node_modules/fast-xml-parser/node_modules/is-unsafe/README.md +632 -0
  144. package/node_modules/fast-xml-parser/node_modules/is-unsafe/package.json +56 -0
  145. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/html.js +102 -0
  146. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/log.js +98 -0
  147. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/nosql.js +114 -0
  148. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/redos.js +60 -0
  149. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/shell.js +105 -0
  150. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/sql-strict.js +47 -0
  151. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/sql.js +95 -0
  152. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/svg.js +81 -0
  153. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/xml.js +79 -0
  154. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.cjs +27 -0
  155. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.d.ts +103 -0
  156. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.js +292 -0
  157. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/util/decode-entities.js +48 -0
  158. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/LICENSE +21 -0
  159. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/README.md +947 -0
  160. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.cjs +1 -0
  161. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.d.cts +725 -0
  162. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.min.js +2 -0
  163. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.min.js.map +1 -0
  164. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/package.json +79 -0
  165. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/Expression.js +232 -0
  166. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/ExpressionSet.js +225 -0
  167. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/Matcher.js +663 -0
  168. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/index.d.ts +589 -0
  169. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/index.js +30 -0
  170. package/node_modules/fast-xml-parser/node_modules/strnum/CHANGELOG.md +63 -0
  171. package/node_modules/fast-xml-parser/node_modules/strnum/LICENSE +21 -0
  172. package/node_modules/fast-xml-parser/node_modules/strnum/README.md +113 -0
  173. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/LICENSE +21 -0
  174. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/README.md +142 -0
  175. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/anynum.js +135 -0
  176. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/digitTable.js +116 -0
  177. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/package.json +42 -0
  178. package/node_modules/fast-xml-parser/node_modules/strnum/package.json +36 -0
  179. package/node_modules/fast-xml-parser/node_modules/strnum/strnum.js +176 -0
  180. package/node_modules/fast-xml-parser/node_modules/xml-naming/LICENSE +21 -0
  181. package/node_modules/fast-xml-parser/node_modules/xml-naming/README.md +287 -0
  182. package/node_modules/fast-xml-parser/node_modules/xml-naming/package.json +56 -0
  183. package/node_modules/fast-xml-parser/node_modules/xml-naming/src/index.d.ts +108 -0
  184. package/node_modules/fast-xml-parser/node_modules/xml-naming/src/index.js +382 -0
  185. package/node_modules/fast-xml-parser/package.json +93 -0
  186. package/node_modules/fast-xml-parser/src/cli/cli.js +97 -0
  187. package/node_modules/fast-xml-parser/src/cli/man.js +17 -0
  188. package/node_modules/fast-xml-parser/src/cli/read.js +43 -0
  189. package/node_modules/fast-xml-parser/src/fxp.d.ts +754 -0
  190. package/node_modules/fast-xml-parser/src/fxp.js +14 -0
  191. package/node_modules/fast-xml-parser/src/ignoreAttributes.js +18 -0
  192. package/node_modules/fast-xml-parser/src/util.js +61 -0
  193. package/node_modules/fast-xml-parser/src/v6/CharsSymbol.js +16 -0
  194. package/node_modules/fast-xml-parser/src/v6/EntitiesParser.js +106 -0
  195. package/node_modules/fast-xml-parser/src/v6/OptionsBuilder.js +61 -0
  196. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/BaseOutputBuilder.js +69 -0
  197. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsArrBuilder.js +103 -0
  198. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsMinArrBuilder.js +100 -0
  199. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsObjBuilder.js +154 -0
  200. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/ParserOptionsBuilder.js +94 -0
  201. package/node_modules/fast-xml-parser/src/v6/Report.js +0 -0
  202. package/node_modules/fast-xml-parser/src/v6/TagPath.js +81 -0
  203. package/node_modules/fast-xml-parser/src/v6/TagPathMatcher.js +13 -0
  204. package/node_modules/fast-xml-parser/src/v6/XMLParser.js +83 -0
  205. package/node_modules/fast-xml-parser/src/v6/Xml2JsParser.js +235 -0
  206. package/node_modules/fast-xml-parser/src/v6/XmlPartReader.js +210 -0
  207. package/node_modules/fast-xml-parser/src/v6/XmlSpecialTagsReader.js +111 -0
  208. package/node_modules/fast-xml-parser/src/v6/inputSource/BufferSource.js +116 -0
  209. package/node_modules/fast-xml-parser/src/v6/inputSource/StringSource.js +121 -0
  210. package/node_modules/fast-xml-parser/src/v6/valueParsers/EntitiesParser.js +105 -0
  211. package/node_modules/fast-xml-parser/src/v6/valueParsers/booleanParser.js +22 -0
  212. package/node_modules/fast-xml-parser/src/v6/valueParsers/booleanParserExt.js +19 -0
  213. package/node_modules/fast-xml-parser/src/v6/valueParsers/currency.js +38 -0
  214. package/node_modules/fast-xml-parser/src/v6/valueParsers/join.js +13 -0
  215. package/node_modules/fast-xml-parser/src/v6/valueParsers/number.js +14 -0
  216. package/node_modules/fast-xml-parser/src/v6/valueParsers/trim.js +6 -0
  217. package/node_modules/fast-xml-parser/src/validator.js +518 -0
  218. package/node_modules/fast-xml-parser/src/xmlbuilder/json2xml.js +6 -0
  219. package/node_modules/fast-xml-parser/src/xmlparser/DocTypeReader.js +426 -0
  220. package/node_modules/fast-xml-parser/src/xmlparser/OptionsBuilder.js +164 -0
  221. package/node_modules/fast-xml-parser/src/xmlparser/OrderedObjParser.js +907 -0
  222. package/node_modules/fast-xml-parser/src/xmlparser/XMLParser.js +77 -0
  223. package/node_modules/fast-xml-parser/src/xmlparser/node2json.js +177 -0
  224. package/node_modules/fast-xml-parser/src/xmlparser/xmlNode.js +54 -0
  225. package/package.json +10 -8
  226. package/src/analysis/evidence.ts +331 -73
  227. package/src/analysis/health/diagnostics.ts +66 -18
  228. package/src/analysis/health/evidence-reason.ts +44 -0
  229. package/src/analysis/health/server-status.ts +32 -9
  230. package/src/analysis/health/signals.ts +1 -0
  231. package/src/analysis/instruction-files.ts +11 -7
  232. package/src/analysis/search/exclusions.ts +18 -4
  233. package/src/analysis/search/pattern.ts +3 -3
  234. package/src/analysis/target/anchored.ts +3 -6
  235. package/src/analysis/target/file-outline-omissions.ts +17 -2
  236. package/src/analysis/target/symbol-selection.ts +100 -0
  237. package/src/analysis/target/symbol.ts +83 -49
  238. package/src/analysis/target/types.ts +12 -10
  239. package/src/analysis/workspace/cmake-parser.ts +207 -0
  240. package/src/analysis/workspace/cmake.ts +141 -0
  241. package/src/analysis/workspace/maven.ts +310 -0
  242. package/src/analysis/workspace/membership.ts +100 -26
  243. package/src/analysis/workspace/metadata.ts +6 -1
  244. package/src/analysis/workspace/observe.ts +6 -0
  245. package/src/analysis/workspace/types.ts +11 -3
  246. package/src/app/app.ts +37 -21
  247. package/src/diagnostics/coverage.ts +49 -0
  248. package/src/diagnostics/evidence.ts +10 -2
  249. package/src/extension.ts +1 -2
  250. package/src/headless.ts +4 -2
  251. package/src/session/health-types.ts +2 -0
  252. package/src/session/health-workflow.ts +6 -0
  253. package/src/session/input/common.ts +1 -1
  254. package/src/session/orientation/collect.ts +42 -7
  255. package/src/session/orientation/context-facts.ts +3 -3
  256. package/src/session/orientation/context-sections.ts +13 -15
  257. package/src/session/orientation/facts.ts +5 -8
  258. package/src/session/orientation-types.ts +5 -0
  259. package/src/session/orientation-workflow.ts +12 -17
  260. package/src/session/target-workflow.ts +38 -25
  261. package/src/tool/code_find/render.ts +10 -11
  262. package/src/tool/code_find/result.ts +11 -8
  263. package/src/tool/code_graph/display.ts +5 -6
  264. package/src/tool/code_graph/format.ts +8 -24
  265. package/src/tool/code_graph/result.ts +16 -75
  266. package/src/tool/code_graph/section.ts +21 -33
  267. package/src/tool/code_graph/structured.ts +3 -0
  268. package/src/tool/code_graph/tui.ts +10 -5
  269. package/src/tool/code_health/diagnostic-tui.ts +49 -0
  270. package/src/tool/code_health/guidance.ts +27 -0
  271. package/src/tool/code_health/markdown.ts +63 -9
  272. package/src/tool/code_health/result.ts +20 -9
  273. package/src/tool/code_health/structured-schema.ts +15 -0
  274. package/src/tool/code_health/structured.ts +9 -1
  275. package/src/tool/code_health/tui.ts +33 -40
  276. package/src/tool/code_inspect/result.ts +23 -18
  277. package/src/tool/code_inspect/structured.ts +2 -19
  278. package/src/tool/code_orientation/markdown.ts +6 -1
  279. package/src/tool/code_orientation/result.ts +53 -100
  280. package/src/tool/code_orientation/structured-schema.ts +16 -12
  281. package/src/tool/code_orientation/structured-workspace.ts +13 -7
  282. package/src/tool/code_orientation/structured.ts +31 -39
  283. package/src/tool/code_orientation/workspace-format.ts +4 -10
  284. package/src/tool/code_orientation/workspace-instructions.ts +4 -5
  285. package/src/tool/code_orientation/workspace-observations.ts +2 -2
  286. package/src/tool/code_orientation/workspace-output.ts +16 -7
  287. package/src/tool/code_orientation/workspace-projects.ts +7 -10
  288. package/src/tool/code_orientation/workspace-sections.ts +13 -19
  289. package/src/tool/code_resolve/markdown.ts +4 -46
  290. package/src/tool/code_resolve/result.ts +45 -73
  291. package/src/tool/code_resolve/structured.ts +6 -1
  292. package/src/tool/infra/truncate.ts +2 -16
  293. package/src/tool/result/candidate-selection.ts +157 -0
  294. package/src/tool/result/display.ts +41 -45
  295. package/src/tool/result/errors.ts +1 -0
  296. package/src/tool/result/model-budget.ts +26 -1
  297. package/src/tool/result/refactor.ts +11 -8
  298. package/src/tool/result/structured.ts +2 -1
  299. package/src/tool/result/types.ts +9 -8
  300. package/src/tool/schemas.ts +15 -20
  301. package/src/ui/footer.ts +147 -44
  302. package/src/ui/status-overlay.ts +13 -8
  303. package/src/ui/status-presentation.ts +4 -7
  304. package/src/ui/tui/candidate-selection.ts +40 -95
  305. package/src/ui/tui/common.ts +16 -70
  306. package/src/ui/tui/display.ts +6 -24
  307. package/src/tool/result/candidate-row.ts +0 -49
@@ -0,0 +1,207 @@
1
+ /**
2
+ * Minimal CMake language tokenizer for static `project()` observation.
3
+ *
4
+ * It follows the CMake language grammar for comments, bracket arguments,
5
+ * quoted arguments, unquoted arguments, and nested parentheses, and records
6
+ * command invocations with their block nesting. It never evaluates variables,
7
+ * conditions, functions, macros, or included files.
8
+ */
9
+
10
+ /** One command argument exactly as written. */
11
+ export interface CMakeArgument {
12
+ readonly form: "bracket" | "quoted" | "unquoted" | "paren";
13
+ /** Raw argument text without bracket or quote delimiters. */
14
+ readonly text: string;
15
+ }
16
+
17
+ /** One command invocation in source order. */
18
+ export interface CMakeCommand {
19
+ /** Lower-case command name; CMake command names are case-insensitive. */
20
+ readonly name: string;
21
+ /** One-based line of the command name. */
22
+ readonly line: number;
23
+ readonly args: readonly CMakeArgument[];
24
+ /** Number of enclosing control, function, macro, or block commands. */
25
+ readonly depth: number;
26
+ }
27
+
28
+ /** One syntax problem that stopped parsing. */
29
+ export interface CMakeParseIssue {
30
+ readonly line: number;
31
+ readonly reason: string;
32
+ }
33
+
34
+ /** Parsed commands, or the first syntax issue. */
35
+ export interface CMakeParseResult {
36
+ readonly commands: readonly CMakeCommand[];
37
+ readonly issue: CMakeParseIssue | null;
38
+ }
39
+
40
+ const OPENERS = new Set(["if", "foreach", "while", "function", "macro", "block"]);
41
+ const CLOSERS = new Set(["endif", "endforeach", "endwhile", "endfunction", "endmacro", "endblock"]);
42
+
43
+ class ParseError extends Error {
44
+ constructor(
45
+ readonly line: number,
46
+ message: string,
47
+ ) {
48
+ super(message);
49
+ }
50
+ }
51
+
52
+ /** Parse CMake source into command invocations. */
53
+ export function parseCMakeFile(text: string): CMakeParseResult {
54
+ const commands: CMakeCommand[] = [];
55
+ try {
56
+ new Scanner(text, commands).run();
57
+ return { commands, issue: null };
58
+ } catch (error) {
59
+ if (error instanceof ParseError)
60
+ return { commands: [], issue: { line: error.line, reason: error.message } };
61
+ throw error;
62
+ }
63
+ }
64
+
65
+ class Scanner {
66
+ private index = 0;
67
+ private line = 1;
68
+ private depth = 0;
69
+
70
+ constructor(
71
+ private readonly text: string,
72
+ private readonly commands: CMakeCommand[],
73
+ ) {}
74
+
75
+ run(): void {
76
+ while (this.index < this.text.length) {
77
+ const char = this.peek();
78
+ if (char === "\n" || char === " " || char === "\t" || char === "\r") this.advance();
79
+ else if (char === "#") this.skipComment();
80
+ else if (/[A-Za-z_]/.test(char)) this.readCommand();
81
+ else throw new ParseError(this.line, `Unexpected character ${JSON.stringify(char)}.`);
82
+ }
83
+ if (this.depth > 0)
84
+ throw new ParseError(this.line, "Unterminated control or definition block.");
85
+ }
86
+
87
+ private readCommand(): void {
88
+ const line = this.line;
89
+ const start = this.index;
90
+ while (/[A-Za-z0-9_]/.test(this.peek())) this.advance();
91
+ const name = this.text.slice(start, this.index).toLowerCase();
92
+ while (this.peek() === " " || this.peek() === "\t") this.advance();
93
+ if (this.peek() !== "(") throw new ParseError(line, `Command ${name} is missing "(".`);
94
+ this.advance();
95
+ const args = this.readArguments(line);
96
+ if (CLOSERS.has(name)) this.depth = Math.max(0, this.depth - 1);
97
+ this.commands.push({ name, line, args, depth: this.depth });
98
+ if (OPENERS.has(name)) this.depth += 1;
99
+ }
100
+
101
+ private readArguments(commandLine: number): CMakeArgument[] {
102
+ const args: CMakeArgument[] = [];
103
+ let nesting = 0;
104
+ for (;;) {
105
+ if (this.index >= this.text.length)
106
+ throw new ParseError(commandLine, "Unterminated command arguments.");
107
+ const char = this.peek();
108
+ if (char === ")" && nesting === 0) {
109
+ this.advance();
110
+ return args;
111
+ }
112
+ if (char === "(" || char === ")") {
113
+ this.advance();
114
+ nesting += char === "(" ? 1 : -1;
115
+ args.push({ form: "paren", text: char });
116
+ continue;
117
+ }
118
+ const argument = this.readArgument(char);
119
+ if (argument) args.push(argument);
120
+ }
121
+ }
122
+
123
+ /** Read one argument, or skip whitespace and comments and return null. */
124
+ private readArgument(char: string): CMakeArgument | null {
125
+ if (/\s/.test(char)) {
126
+ this.advance();
127
+ return null;
128
+ }
129
+ if (char === "#") {
130
+ this.skipComment();
131
+ return null;
132
+ }
133
+ if (char === "[" && this.bracketLevel() !== null)
134
+ return { form: "bracket", text: this.readBracket() };
135
+ if (char === '"') return { form: "quoted", text: this.readQuoted() };
136
+ return { form: "unquoted", text: this.readUnquoted() };
137
+ }
138
+
139
+ private skipComment(): void {
140
+ this.advance();
141
+ if (this.peek() === "[" && this.bracketLevel() !== null) {
142
+ this.readBracket();
143
+ return;
144
+ }
145
+ while (this.index < this.text.length && this.peek() !== "\n") this.advance();
146
+ }
147
+
148
+ /** Return the `=` count when a bracket opening starts at the cursor. */
149
+ private bracketLevel(): number | null {
150
+ const match = /^\[(=*)\[/.exec(this.text.slice(this.index, this.index + 256));
151
+ return match ? (match[1]?.length ?? 0) : null;
152
+ }
153
+
154
+ private readBracket(): string {
155
+ const line = this.line;
156
+ const level = this.bracketLevel() ?? 0;
157
+ this.advanceBy(level + 2);
158
+ const close = `]${"=".repeat(level)}]`;
159
+ const end = this.text.indexOf(close, this.index);
160
+ if (end < 0) throw new ParseError(line, "Unterminated bracket argument or comment.");
161
+ let content = this.text.slice(this.index, end);
162
+ this.advanceBy(end + close.length - this.index);
163
+ if (content.startsWith("\r\n")) content = content.slice(2);
164
+ else if (content.startsWith("\n")) content = content.slice(1);
165
+ return content;
166
+ }
167
+
168
+ private readQuoted(): string {
169
+ const line = this.line;
170
+ this.advance();
171
+ const start = this.index;
172
+ while (this.index < this.text.length) {
173
+ const char = this.peek();
174
+ if (char === "\\") this.advanceBy(2);
175
+ else if (char === '"') {
176
+ const content = this.text.slice(start, this.index);
177
+ this.advance();
178
+ return content;
179
+ } else this.advance();
180
+ }
181
+ throw new ParseError(line, "Unterminated quoted argument.");
182
+ }
183
+
184
+ private readUnquoted(): string {
185
+ const start = this.index;
186
+ while (this.index < this.text.length) {
187
+ const char = this.peek();
188
+ if (char === "\\") this.advanceBy(2);
189
+ else if (/[\s()#"]/.test(char)) break;
190
+ else this.advance();
191
+ }
192
+ return this.text.slice(start, this.index);
193
+ }
194
+
195
+ private peek(): string {
196
+ return this.text[this.index] ?? "";
197
+ }
198
+
199
+ private advance(): void {
200
+ if (this.text[this.index] === "\n") this.line += 1;
201
+ this.index += 1;
202
+ }
203
+
204
+ private advanceBy(count: number): void {
205
+ for (let step = 0; step < count && this.index < this.text.length; step += 1) this.advance();
206
+ }
207
+ }
@@ -0,0 +1,141 @@
1
+ /**
2
+ * Static `CMakeLists.txt` reader for explicit `project()` declarations.
3
+ *
4
+ * A project is reported only for exactly one top-level `project()` call with
5
+ * a literal name. Repeated, conditional, function/macro-body, and
6
+ * variable-dependent calls are disclosed instead of guessed. Targets,
7
+ * `add_subdirectory()`, included files, presets, and configured build trees
8
+ * are not observed, and CMake is never run.
9
+ */
10
+
11
+ import type { CMakeArgument, CMakeCommand } from "./cmake-parser.ts";
12
+ import { parseCMakeFile } from "./cmake-parser.ts";
13
+ import type { DocumentContribution, ParsedDocument } from "./metadata-types.ts";
14
+ import { baseProject, issue } from "./metadata-utils.ts";
15
+ import type { MetadataIssue } from "./types.ts";
16
+
17
+ const DYNAMIC_REFERENCE = /\$(?:\{|ENV\{|CACHE\{|<)/;
18
+
19
+ /** Read one `CMakeLists.txt` document. */
20
+ export function readCMakeDocument(document: ParsedDocument): DocumentContribution {
21
+ if (document.kind !== "cmake-lists") return { project: null, workspace: null, issues: [] };
22
+ if (typeof document.data !== "string") {
23
+ return {
24
+ project: null,
25
+ workspace: null,
26
+ issues: [issue(document.path, null, "malformed", "CMakeLists.txt must be text.")],
27
+ };
28
+ }
29
+ const parsed = parseCMakeFile(document.data);
30
+ if (parsed.issue) {
31
+ return {
32
+ project: null,
33
+ workspace: null,
34
+ issues: [issue(document.path, `line ${parsed.issue.line}`, "malformed", parsed.issue.reason)],
35
+ };
36
+ }
37
+ const calls = parsed.commands.filter((command) => command.name === "project");
38
+ if (calls.length === 0) return { project: null, workspace: null, issues: [] };
39
+ const issues: MetadataIssue[] = [];
40
+ const nested = calls.filter((call) => call.depth > 0);
41
+ for (const call of nested) {
42
+ issues.push(
43
+ issue(
44
+ document.path,
45
+ `project line ${call.line}`,
46
+ "dynamic",
47
+ "project() inside a control block, function, macro, or block() depends on evaluation.",
48
+ ),
49
+ );
50
+ }
51
+ if (calls.length > 1) {
52
+ issues.push(
53
+ issue(
54
+ document.path,
55
+ "project",
56
+ "unresolved",
57
+ `Multiple project() calls (lines ${calls.map((call) => call.line).join(", ")}); none is selected.`,
58
+ ),
59
+ );
60
+ }
61
+ const call = calls[0];
62
+ if (calls.length !== 1 || nested.length > 0 || !call) {
63
+ return { project: null, workspace: null, issues };
64
+ }
65
+ return readProjectCall(document, call, issues);
66
+ }
67
+
68
+ function readProjectCall(
69
+ document: ParsedDocument,
70
+ call: CMakeCommand,
71
+ issues: MetadataIssue[],
72
+ ): DocumentContribution {
73
+ const field = `project line ${call.line}`;
74
+ const nameArgument = call.args[0];
75
+ const name = nameArgument ? literalValue(nameArgument) : null;
76
+ if (!nameArgument || name === null) {
77
+ issues.push(
78
+ issue(
79
+ document.path,
80
+ field,
81
+ nameArgument && DYNAMIC_REFERENCE.test(nameArgument.text) ? "dynamic" : "unsupported",
82
+ nameArgument
83
+ ? "project() name is not a single literal value."
84
+ : "project() declares no name.",
85
+ ),
86
+ );
87
+ return { project: null, workspace: null, issues };
88
+ }
89
+ const description = readDescription(document.path, call, issues);
90
+ return {
91
+ project: baseProject({
92
+ manifestPath: document.path,
93
+ kind: "cmake-project",
94
+ directory: document.directory,
95
+ name,
96
+ nameField: "project",
97
+ description,
98
+ descriptionField: description === null ? null : "project.DESCRIPTION",
99
+ }),
100
+ workspace: null,
101
+ issues,
102
+ };
103
+ }
104
+
105
+ function readDescription(path: string, call: CMakeCommand, issues: MetadataIssue[]): string | null {
106
+ const keyword = call.args.findIndex(
107
+ (argument, index) =>
108
+ index > 0 && argument.form === "unquoted" && argument.text === "DESCRIPTION",
109
+ );
110
+ if (keyword < 0) return null;
111
+ const argument = call.args[keyword + 1];
112
+ const value = argument ? literalValue(argument) : null;
113
+ if (value === null) {
114
+ issues.push(
115
+ issue(
116
+ path,
117
+ "project.DESCRIPTION",
118
+ argument && DYNAMIC_REFERENCE.test(argument.text) ? "dynamic" : "unsupported",
119
+ "project() DESCRIPTION is not a single-line literal value.",
120
+ ),
121
+ );
122
+ return null;
123
+ }
124
+ return value;
125
+ }
126
+
127
+ /**
128
+ * Return a literal argument value, or null when evaluation would be required.
129
+ *
130
+ * Multi-line values are rejected. Bracket arguments are otherwise literal. Quoted and unquoted arguments are
131
+ * literal only without variable or generator-expression references, escapes,
132
+ * or list separators.
133
+ */
134
+ function literalValue(argument: CMakeArgument): string | null {
135
+ if (argument.form === "paren") return null;
136
+ const text = argument.text;
137
+ if (text.length === 0 || /[\r\n]/.test(text)) return null;
138
+ if (argument.form === "bracket") return text;
139
+ if (DYNAMIC_REFERENCE.test(text) || text.includes("\\") || text.includes(";")) return null;
140
+ return text;
141
+ }
@@ -0,0 +1,310 @@
1
+ /**
2
+ * Static Maven `pom.xml` reader.
3
+ *
4
+ * Reads only literal project identity (`artifactId`), description, and explicit
5
+ * aggregation (`modules` / `subprojects`). It never runs Maven, resolves parents,
6
+ * interpolates properties, or activates profiles. Parent inheritance is not
7
+ * module membership.
8
+ */
9
+
10
+ import { XMLParser, XMLValidator } from "fast-xml-parser";
11
+ import type { DocumentContribution, ParsedDocument, WorkspaceConfig } from "./metadata-types.ts";
12
+ import { baseProject, isRecord, issue } from "./metadata-utils.ts";
13
+ import type { MetadataIssue } from "./types.ts";
14
+
15
+ const SUPPORTED_MODEL_VERSIONS = new Set(["4.0.0", "4.1.0"]);
16
+ const NAMESPACE_PREFIX = "http://maven.apache.org/POM/";
17
+ const TEXT = "#text";
18
+ const CDATA = "#cdata";
19
+ const XMLNS = "@_xmlns";
20
+
21
+ const parser = new XMLParser({
22
+ // Custom DOCTYPE entities are never expanded; predefined entities are decoded below.
23
+ processEntities: false,
24
+ ignoreAttributes: false,
25
+ attributeNamePrefix: "@_",
26
+ parseTagValue: false,
27
+ parseAttributeValue: false,
28
+ trimValues: true,
29
+ ignoreDeclaration: true,
30
+ ignorePiTags: true,
31
+ textNodeName: TEXT,
32
+ // Keep CDATA separate so its literal text is never entity-decoded.
33
+ cdataPropName: CDATA,
34
+ isArray: (_name, _path, _leaf, isAttribute) => !isAttribute,
35
+ });
36
+
37
+ /** Parse POM text into the shared parsed-document payload, or throw a readable error. */
38
+ export function parsePom(text: string): unknown {
39
+ const validation = XMLValidator.validate(text);
40
+ if (validation !== true) {
41
+ const { msg, line } = validation.err;
42
+ throw new Error(`Invalid XML at line ${line}: ${msg}`);
43
+ }
44
+ return parser.parse(text);
45
+ }
46
+
47
+ /** Read one parsed `pom.xml` without resolving inherited or build-time behavior. */
48
+ export function readMavenDocument(document: ParsedDocument): DocumentContribution {
49
+ const issues: MetadataIssue[] = [];
50
+ const project = rootProject(document, issues);
51
+ if (!project) return { project: null, workspace: null, issues };
52
+ const modelVersion = readModelVersion(document.path, project, issues);
53
+ if (modelVersion === null) return { project: null, workspace: null, issues };
54
+ const name = readText(document.path, project, "artifactId", issues);
55
+ if (name === null && !issues.some((entry) => entry.field === "project.artifactId")) {
56
+ issues.push(
57
+ issue(document.path, "project.artifactId", "malformed", "POM declares no artifactId."),
58
+ );
59
+ }
60
+ const description = readText(document.path, project, "description", issues);
61
+ discloseProfileModules(document.path, project, issues);
62
+ return {
63
+ project: baseProject({
64
+ manifestPath: document.path,
65
+ kind: "maven-project",
66
+ directory: document.directory,
67
+ name,
68
+ nameField: name === null ? null : "project.artifactId",
69
+ description,
70
+ descriptionField: description === null ? null : "project.description",
71
+ }),
72
+ workspace: readAggregation(document, project, modelVersion, issues),
73
+ issues,
74
+ };
75
+ }
76
+
77
+ function rootProject(
78
+ document: ParsedDocument,
79
+ issues: MetadataIssue[],
80
+ ): Record<string, unknown> | null {
81
+ const data = document.data;
82
+ const roots = isRecord(data) ? Object.keys(data) : [];
83
+ const project = isRecord(data) && Array.isArray(data.project) ? data.project : null;
84
+ if (roots.length !== 1 || project?.length !== 1 || !isRecord(project[0])) {
85
+ issues.push(
86
+ issue(document.path, null, "malformed", "pom.xml must have one <project> root element."),
87
+ );
88
+ return null;
89
+ }
90
+ return project[0];
91
+ }
92
+
93
+ function readModelVersion(
94
+ path: string,
95
+ project: Record<string, unknown>,
96
+ issues: MetadataIssue[],
97
+ ): string | null {
98
+ const declared = readText(path, project, "modelVersion", issues);
99
+ const namespace = typeof project[XMLNS] === "string" ? project[XMLNS] : null;
100
+ const fromNamespace = namespace?.startsWith(NAMESPACE_PREFIX)
101
+ ? namespace.slice(NAMESPACE_PREFIX.length)
102
+ : null;
103
+ const version = declared ?? fromNamespace;
104
+ if (version !== null && SUPPORTED_MODEL_VERSIONS.has(version)) return version;
105
+ issues.push(
106
+ issue(
107
+ path,
108
+ "project.modelVersion",
109
+ "unsupported",
110
+ version === null
111
+ ? "POM model version is not declared; only 4.0.0 and 4.1.0 are read."
112
+ : `Unsupported POM model version \`${version}\`; only 4.0.0 and 4.1.0 are read.`,
113
+ ),
114
+ );
115
+ return null;
116
+ }
117
+
118
+ function readAggregation(
119
+ document: ParsedDocument,
120
+ project: Record<string, unknown>,
121
+ modelVersion: string,
122
+ issues: MetadataIssue[],
123
+ ): WorkspaceConfig | null {
124
+ const hasModules = Object.hasOwn(project, "modules");
125
+ const hasSubprojects = Object.hasOwn(project, "subprojects");
126
+ if (hasSubprojects && modelVersion === "4.0.0") {
127
+ issues.push(
128
+ issue(
129
+ document.path,
130
+ "project.subprojects",
131
+ "unsupported",
132
+ "subprojects requires POM model version 4.1.0.",
133
+ ),
134
+ );
135
+ }
136
+ const useSubprojects = hasSubprojects && modelVersion !== "4.0.0";
137
+ if (useSubprojects && hasModules) {
138
+ issues.push(
139
+ issue(
140
+ document.path,
141
+ "project.modules",
142
+ "unsupported",
143
+ "modules is not combined with subprojects; only subprojects is read.",
144
+ ),
145
+ );
146
+ }
147
+ const [container, child] = useSubprojects
148
+ ? ["subprojects", "subproject"]
149
+ : hasModules
150
+ ? ["modules", "module"]
151
+ : [null, null];
152
+ if (container === null || child === null) return null;
153
+ const field = `project.${container}.${child}`;
154
+ const values = readList(document.path, project[container], { container, child }, issues);
155
+ if (values === null) return null;
156
+ return {
157
+ kind: "maven-modules",
158
+ manifestPath: document.path,
159
+ directory: document.directory,
160
+ field,
161
+ patterns: values,
162
+ excludeField: null,
163
+ excludes: [],
164
+ };
165
+ }
166
+
167
+ function readList(
168
+ path: string,
169
+ nodes: unknown,
170
+ { container, child }: { container: string; child: string },
171
+ issues: MetadataIssue[],
172
+ ): string[] | null {
173
+ const field = `project.${container}`;
174
+ if (!Array.isArray(nodes) || nodes.length !== 1) {
175
+ issues.push(issue(path, field, "malformed", `${field} must appear once.`));
176
+ return null;
177
+ }
178
+ const node = nodes[0];
179
+ // An empty container element parses as an empty string.
180
+ if (node === "") return [];
181
+ if (!isRecord(node)) {
182
+ issues.push(issue(path, field, "malformed", `${field} must contain <${child}> elements.`));
183
+ return null;
184
+ }
185
+ const values: string[] = [];
186
+ const entries = Array.isArray(node[child]) ? node[child] : [];
187
+ for (const [index, entry] of entries.entries()) {
188
+ const value = elementText(entry);
189
+ if (value === null || value === "") {
190
+ issues.push(
191
+ issue(
192
+ path,
193
+ `${field}.${child}[${index}]`,
194
+ "malformed",
195
+ `${child} must be a non-empty path.`,
196
+ ),
197
+ );
198
+ continue;
199
+ }
200
+ values.push(value);
201
+ }
202
+ return values;
203
+ }
204
+
205
+ function discloseProfileModules(
206
+ path: string,
207
+ project: Record<string, unknown>,
208
+ issues: MetadataIssue[],
209
+ ): void {
210
+ const profiles = Array.isArray(project.profiles) ? project.profiles[0] : null;
211
+ const entries = isRecord(profiles) && Array.isArray(profiles.profile) ? profiles.profile : [];
212
+ for (const [index, profile] of entries.entries()) {
213
+ if (!isRecord(profile)) continue;
214
+ for (const container of ["modules", "subprojects"]) {
215
+ if (!Object.hasOwn(profile, container)) continue;
216
+ issues.push(
217
+ issue(
218
+ path,
219
+ `project.profiles.profile[${index}].${container}`,
220
+ "unsupported",
221
+ "Profile-scoped aggregation is not read; profile activation is not evaluated.",
222
+ ),
223
+ );
224
+ }
225
+ }
226
+ }
227
+
228
+ /** Read one optional single text element, disclosing unsupported shapes. */
229
+ function readText(
230
+ path: string,
231
+ project: Record<string, unknown>,
232
+ key: string,
233
+ issues: MetadataIssue[],
234
+ ): string | null {
235
+ if (!Object.hasOwn(project, key)) return null;
236
+ const field = `project.${key}`;
237
+ const nodes = project[key];
238
+ if (!Array.isArray(nodes) || nodes.length !== 1) {
239
+ issues.push(issue(path, field, "malformed", `${field} must appear once.`));
240
+ return null;
241
+ }
242
+ const value = elementText(nodes[0]);
243
+ if (value === null) {
244
+ issues.push(
245
+ issue(
246
+ path,
247
+ field,
248
+ "unsupported",
249
+ `${field} must be plain text without nested elements or custom entities.`,
250
+ ),
251
+ );
252
+ return null;
253
+ }
254
+ if (value === "") return null;
255
+ if (value.includes("${")) {
256
+ issues.push(
257
+ issue(path, field, "dynamic", `${field} uses property interpolation; it is not resolved.`),
258
+ );
259
+ return null;
260
+ }
261
+ return value;
262
+ }
263
+
264
+ /**
265
+ * Read one element's text. Plain text is entity-decoded; a single CDATA section
266
+ * is literal. Nested elements and text mixed with CDATA are unsupported (null).
267
+ */
268
+ function elementText(node: unknown): string | null {
269
+ if (typeof node === "string") return decodeText(node);
270
+ if (!isRecord(node)) return null;
271
+ const keys = Object.keys(node).filter((key) => !key.startsWith("@_"));
272
+ if (keys.length === 0) return "";
273
+ if (keys.length !== 1) return null;
274
+ const value = node[keys[0] ?? ""];
275
+ if (keys[0] === TEXT && typeof value === "string") return decodeText(value);
276
+ if (keys[0] === CDATA && Array.isArray(value) && value.length === 1) {
277
+ return typeof value[0] === "string" ? value[0] : null;
278
+ }
279
+ return null;
280
+ }
281
+
282
+ const PREDEFINED_ENTITIES: Readonly<Record<string, string>> = {
283
+ amp: "&",
284
+ lt: "<",
285
+ gt: ">",
286
+ quot: '"',
287
+ apos: "'",
288
+ };
289
+
290
+ /** Decode predefined and numeric character references; custom entities return null. */
291
+ function decodeText(value: string): string | null {
292
+ let unsupported = false;
293
+ const decoded = value.replaceAll(
294
+ /&(#x[0-9A-Fa-f]+|#[0-9]+|[A-Za-z_][\w.-]*);/g,
295
+ (_match, ref) => {
296
+ if (ref.startsWith("#x")) return safeCodePoint(Number.parseInt(ref.slice(2), 16));
297
+ if (ref.startsWith("#")) return safeCodePoint(Number.parseInt(ref.slice(1), 10));
298
+ const entity = PREDEFINED_ENTITIES[ref];
299
+ if (entity === undefined) unsupported = true;
300
+ return entity ?? "";
301
+ },
302
+ );
303
+ return unsupported ? null : decoded;
304
+
305
+ function safeCodePoint(code: number): string {
306
+ if (code > 0 && code <= 0x10ffff) return String.fromCodePoint(code);
307
+ unsupported = true;
308
+ return "";
309
+ }
310
+ }