@alloy-js/core 0.23.0-dev.9 → 0.23.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 (943) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/api-extractor.json +1 -8
  3. package/api-extractor.testing.json +19 -0
  4. package/dist/dev/src/binder.js +595 -0
  5. package/dist/dev/src/binder.js.map +1 -0
  6. package/dist/dev/src/code.js +181 -0
  7. package/dist/dev/src/code.js.map +1 -0
  8. package/dist/dev/src/components/AccessExpression.js +230 -0
  9. package/dist/dev/src/components/AccessExpression.js.map +1 -0
  10. package/dist/dev/src/components/AccessExpression.test.js +237 -0
  11. package/dist/dev/src/components/AccessExpression.test.js.map +1 -0
  12. package/dist/dev/src/components/AppendFile.js +246 -0
  13. package/dist/dev/src/components/AppendFile.js.map +1 -0
  14. package/dist/dev/src/components/Block.js +78 -0
  15. package/dist/dev/src/components/Block.js.map +1 -0
  16. package/dist/dev/src/components/CopyFile.js +16 -0
  17. package/dist/dev/src/components/CopyFile.js.map +1 -0
  18. package/dist/dev/src/components/Declaration.js +70 -0
  19. package/dist/dev/src/components/Declaration.js.map +1 -0
  20. package/dist/dev/src/components/For.js +40 -0
  21. package/dist/dev/src/components/For.js.map +1 -0
  22. package/dist/dev/src/components/Indent.js +37 -0
  23. package/dist/dev/src/components/Indent.js.map +1 -0
  24. package/dist/dev/src/components/List.js +29 -0
  25. package/dist/dev/src/components/List.js.map +1 -0
  26. package/dist/dev/src/components/MemberDeclaration.js +70 -0
  27. package/dist/dev/src/components/MemberDeclaration.js.map +1 -0
  28. package/dist/dev/src/components/MemberName.js +18 -0
  29. package/dist/dev/src/components/MemberName.js.map +1 -0
  30. package/dist/dev/src/components/MemberScope.js +62 -0
  31. package/dist/dev/src/components/MemberScope.js.map +1 -0
  32. package/dist/dev/src/components/Name.js +11 -0
  33. package/dist/dev/src/components/Name.js.map +1 -0
  34. package/dist/dev/src/components/Output.js +72 -0
  35. package/dist/dev/src/components/Output.js.map +1 -0
  36. package/dist/dev/src/components/Prose.js +32 -0
  37. package/dist/dev/src/components/Prose.js.map +1 -0
  38. package/dist/dev/src/components/ReferenceOrContent.js +12 -0
  39. package/dist/dev/src/components/ReferenceOrContent.js.map +1 -0
  40. package/dist/dev/src/components/Scope.js +56 -0
  41. package/dist/dev/src/components/Scope.js.map +1 -0
  42. package/dist/dev/src/components/Show.js +4 -0
  43. package/dist/dev/src/components/Show.js.map +1 -0
  44. package/dist/dev/src/components/SourceDirectory.js +41 -0
  45. package/dist/dev/src/components/SourceDirectory.js.map +1 -0
  46. package/dist/dev/src/components/SourceFile.js +52 -0
  47. package/dist/dev/src/components/SourceFile.js.map +1 -0
  48. package/dist/dev/src/components/StatementList.js +20 -0
  49. package/dist/dev/src/components/StatementList.js.map +1 -0
  50. package/dist/dev/src/components/Switch.js +42 -0
  51. package/dist/dev/src/components/Switch.js.map +1 -0
  52. package/dist/dev/src/components/TemplateFile.js +153 -0
  53. package/dist/dev/src/components/TemplateFile.js.map +1 -0
  54. package/dist/dev/src/components/UpdateFile.js +71 -0
  55. package/dist/dev/src/components/UpdateFile.js.map +1 -0
  56. package/dist/dev/src/components/Wrap.js +18 -0
  57. package/dist/dev/src/components/Wrap.js.map +1 -0
  58. package/dist/dev/src/components/index.js +25 -0
  59. package/dist/dev/src/components/index.js.map +1 -0
  60. package/dist/dev/src/components/stc/index.js +27 -0
  61. package/dist/dev/src/components/stc/index.js.map +1 -0
  62. package/dist/dev/src/components/stc/sti.js +10 -0
  63. package/dist/dev/src/components/stc/sti.js.map +1 -0
  64. package/dist/dev/src/content-slot.js +78 -0
  65. package/dist/dev/src/content-slot.js.map +1 -0
  66. package/dist/dev/src/content-slot.test.js +89 -0
  67. package/dist/dev/src/content-slot.test.js.map +1 -0
  68. package/dist/dev/src/context/assignment.js +46 -0
  69. package/dist/dev/src/context/assignment.js.map +1 -0
  70. package/dist/dev/src/context/binder.js +17 -0
  71. package/dist/dev/src/context/binder.js.map +1 -0
  72. package/dist/dev/src/context/declaration.js +3 -0
  73. package/dist/dev/src/context/declaration.js.map +1 -0
  74. package/dist/dev/src/context/format-options.js +45 -0
  75. package/dist/dev/src/context/format-options.js.map +1 -0
  76. package/dist/dev/src/context/index.js +11 -0
  77. package/dist/dev/src/context/index.js.map +1 -0
  78. package/dist/dev/src/context/member-declaration.js +11 -0
  79. package/dist/dev/src/context/member-declaration.js.map +1 -0
  80. package/dist/dev/src/context/member-scope.js +12 -0
  81. package/dist/dev/src/context/member-scope.js.map +1 -0
  82. package/dist/dev/src/context/name-policy.js +13 -0
  83. package/dist/dev/src/context/name-policy.js.map +1 -0
  84. package/dist/dev/src/context/scope.js +18 -0
  85. package/dist/dev/src/context/scope.js.map +1 -0
  86. package/dist/dev/src/context/source-directory.js +12 -0
  87. package/dist/dev/src/context/source-directory.js.map +1 -0
  88. package/dist/dev/src/context/source-file.js +3 -0
  89. package/dist/dev/src/context/source-file.js.map +1 -0
  90. package/dist/dev/src/context.js +47 -0
  91. package/dist/dev/src/context.js.map +1 -0
  92. package/dist/dev/src/debug/cli.js +164 -0
  93. package/dist/dev/src/debug/cli.js.map +1 -0
  94. package/dist/dev/src/debug/diagnostics-broadcast.test.js +100 -0
  95. package/dist/dev/src/debug/diagnostics-broadcast.test.js.map +1 -0
  96. package/dist/dev/src/debug/diagnostics.test.js +50 -0
  97. package/dist/dev/src/debug/diagnostics.test.js.map +1 -0
  98. package/dist/dev/src/debug/effects.js +293 -0
  99. package/dist/dev/src/debug/effects.js.map +1 -0
  100. package/dist/dev/src/debug/effects.test.js +280 -0
  101. package/dist/dev/src/debug/effects.test.js.map +1 -0
  102. package/dist/dev/src/debug/files.js +29 -0
  103. package/dist/dev/src/debug/files.js.map +1 -0
  104. package/dist/dev/src/debug/files.test.js +78 -0
  105. package/dist/dev/src/debug/files.test.js.map +1 -0
  106. package/dist/dev/src/debug/index.js +71 -0
  107. package/dist/dev/src/debug/index.js.map +1 -0
  108. package/dist/dev/src/debug/message-format.test.js +836 -0
  109. package/dist/dev/src/debug/message-format.test.js.map +1 -0
  110. package/dist/dev/src/debug/render-tree-orphans.test.js +365 -0
  111. package/dist/dev/src/debug/render-tree-orphans.test.js.map +1 -0
  112. package/dist/dev/src/debug/render.js +479 -0
  113. package/dist/dev/src/debug/render.js.map +1 -0
  114. package/dist/dev/src/debug/render.test.js +363 -0
  115. package/dist/dev/src/debug/render.test.js.map +1 -0
  116. package/dist/dev/src/debug/serialize.js +70 -0
  117. package/dist/dev/src/debug/serialize.js.map +1 -0
  118. package/dist/dev/src/debug/source-map.browser.js +24 -0
  119. package/dist/dev/src/debug/source-map.browser.js.map +1 -0
  120. package/dist/dev/src/debug/source-map.js +111 -0
  121. package/dist/dev/src/debug/source-map.js.map +1 -0
  122. package/dist/dev/src/debug/symbols.js +196 -0
  123. package/dist/dev/src/debug/symbols.js.map +1 -0
  124. package/dist/dev/src/debug/symbols.test.js +93 -0
  125. package/dist/dev/src/debug/symbols.test.js.map +1 -0
  126. package/dist/dev/src/debug/trace-writer.js +674 -0
  127. package/dist/dev/src/debug/trace-writer.js.map +1 -0
  128. package/dist/dev/src/debug/trace.js +460 -0
  129. package/dist/dev/src/debug/trace.js.map +1 -0
  130. package/dist/dev/src/devtools/devtools-protocol.js +2 -0
  131. package/dist/dev/src/devtools/devtools-protocol.js.map +1 -0
  132. package/dist/dev/src/devtools/devtools-server.browser.js +36 -0
  133. package/dist/dev/src/devtools/devtools-server.browser.js.map +1 -0
  134. package/dist/dev/src/devtools/devtools-server.js +458 -0
  135. package/dist/dev/src/devtools/devtools-server.js.map +1 -0
  136. package/dist/dev/src/devtools/devtools-transport.js +114 -0
  137. package/dist/dev/src/devtools/devtools-transport.js.map +1 -0
  138. package/dist/dev/src/devtools-entry.browser.js +2 -0
  139. package/dist/dev/src/devtools-entry.browser.js.map +1 -0
  140. package/dist/dev/src/devtools-entry.js +2 -0
  141. package/dist/dev/src/devtools-entry.js.map +1 -0
  142. package/dist/dev/src/diagnostics.js +97 -0
  143. package/dist/dev/src/diagnostics.js.map +1 -0
  144. package/dist/dev/src/host/alloy-host.browser.js +32 -0
  145. package/dist/dev/src/host/alloy-host.browser.js.map +1 -0
  146. package/dist/dev/src/host/alloy-host.js +144 -0
  147. package/dist/dev/src/host/alloy-host.js.map +1 -0
  148. package/dist/dev/src/host/interface.js +2 -0
  149. package/dist/dev/src/host/interface.js.map +1 -0
  150. package/dist/dev/src/host/node-host.browser.js +21 -0
  151. package/dist/dev/src/host/node-host.browser.js.map +1 -0
  152. package/dist/dev/src/host/node-host.js +20 -0
  153. package/dist/dev/src/host/node-host.js.map +1 -0
  154. package/dist/dev/src/index.browser.js +3 -0
  155. package/dist/dev/src/index.browser.js.map +1 -0
  156. package/dist/dev/src/index.js +27 -0
  157. package/dist/dev/src/index.js.map +1 -0
  158. package/dist/dev/src/inspect.browser.js +6 -0
  159. package/dist/dev/src/inspect.browser.js.map +1 -0
  160. package/dist/dev/src/inspect.js +2 -0
  161. package/dist/dev/src/inspect.js.map +1 -0
  162. package/dist/dev/src/jsx-runtime.js +17 -0
  163. package/dist/dev/src/jsx-runtime.js.map +1 -0
  164. package/dist/dev/src/library-symbol-reference.js +59 -0
  165. package/dist/dev/src/library-symbol-reference.js.map +1 -0
  166. package/dist/dev/src/name-policy.js +51 -0
  167. package/dist/dev/src/name-policy.js.map +1 -0
  168. package/dist/dev/src/pretty-string/pretty-string.js +100 -0
  169. package/dist/dev/src/pretty-string/pretty-string.js.map +1 -0
  170. package/dist/dev/src/pretty-string/pretty-string.test.js +38 -0
  171. package/dist/dev/src/pretty-string/pretty-string.test.js.map +1 -0
  172. package/dist/dev/src/print-hook.js +10 -0
  173. package/dist/dev/src/print-hook.js.map +1 -0
  174. package/dist/dev/src/props-combinators.js +109 -0
  175. package/dist/dev/src/props-combinators.js.map +1 -0
  176. package/dist/dev/src/reactive-union-set.js +213 -0
  177. package/dist/dev/src/reactive-union-set.js.map +1 -0
  178. package/dist/dev/src/reactivity.js +452 -0
  179. package/dist/dev/src/reactivity.js.map +1 -0
  180. package/dist/dev/src/refkey.js +167 -0
  181. package/dist/dev/src/refkey.js.map +1 -0
  182. package/dist/dev/src/render-stack.js +252 -0
  183. package/dist/dev/src/render-stack.js.map +1 -0
  184. package/dist/dev/src/render.js +872 -0
  185. package/dist/dev/src/render.js.map +1 -0
  186. package/dist/dev/src/resource.js +124 -0
  187. package/dist/dev/src/resource.js.map +1 -0
  188. package/dist/dev/src/runtime/component.js +41 -0
  189. package/dist/dev/src/runtime/component.js.map +1 -0
  190. package/dist/dev/src/runtime/intrinsic.js +12 -0
  191. package/dist/dev/src/runtime/intrinsic.js.map +1 -0
  192. package/dist/dev/src/scheduler.js +217 -0
  193. package/dist/dev/src/scheduler.js.map +1 -0
  194. package/dist/dev/src/stc.js +40 -0
  195. package/dist/dev/src/stc.js.map +1 -0
  196. package/dist/dev/src/sti.js +31 -0
  197. package/dist/dev/src/sti.js.map +1 -0
  198. package/dist/dev/src/symbols/basic-scope.js +21 -0
  199. package/dist/dev/src/symbols/basic-scope.js.map +1 -0
  200. package/dist/dev/src/symbols/basic-symbol.js +34 -0
  201. package/dist/dev/src/symbols/basic-symbol.js.map +1 -0
  202. package/dist/dev/src/symbols/decl.js +26 -0
  203. package/dist/dev/src/symbols/decl.js.map +1 -0
  204. package/dist/dev/src/symbols/index.js +10 -0
  205. package/dist/dev/src/symbols/index.js.map +1 -0
  206. package/dist/dev/src/symbols/output-scope.js +235 -0
  207. package/dist/dev/src/symbols/output-scope.js.map +1 -0
  208. package/dist/dev/src/symbols/output-space.js +51 -0
  209. package/dist/dev/src/symbols/output-space.js.map +1 -0
  210. package/dist/dev/src/symbols/output-symbol.js +644 -0
  211. package/dist/dev/src/symbols/output-symbol.js.map +1 -0
  212. package/dist/dev/src/symbols/symbol-flow.js +106 -0
  213. package/dist/dev/src/symbols/symbol-flow.js.map +1 -0
  214. package/dist/dev/src/symbols/symbol-slot.js +75 -0
  215. package/dist/dev/src/symbols/symbol-slot.js.map +1 -0
  216. package/dist/dev/src/symbols/symbol-slot.test.js +68 -0
  217. package/dist/dev/src/symbols/symbol-slot.test.js.map +1 -0
  218. package/dist/dev/src/symbols/symbol-table.js +103 -0
  219. package/dist/dev/src/symbols/symbol-table.js.map +1 -0
  220. package/dist/dev/src/tap.js +109 -0
  221. package/dist/dev/src/tap.js.map +1 -0
  222. package/dist/dev/src/trace.js +2 -0
  223. package/dist/dev/src/trace.js.map +1 -0
  224. package/dist/dev/src/tracer.js +180 -0
  225. package/dist/dev/src/tracer.js.map +1 -0
  226. package/dist/dev/src/utils.js +487 -0
  227. package/dist/dev/src/utils.js.map +1 -0
  228. package/dist/dev/src/write-output.js +48 -0
  229. package/dist/dev/src/write-output.js.map +1 -0
  230. package/dist/dev/test/browser-build.test.js +85 -0
  231. package/dist/dev/test/browser-build.test.js.map +1 -0
  232. package/dist/dev/test/children.test.js +44 -0
  233. package/dist/dev/test/children.test.js.map +1 -0
  234. package/dist/dev/test/components/append-file.test.js +394 -0
  235. package/dist/dev/test/components/append-file.test.js.map +1 -0
  236. package/dist/dev/test/components/block.test.js +83 -0
  237. package/dist/dev/test/components/block.test.js.map +1 -0
  238. package/dist/dev/test/components/copy-file.test.js +119 -0
  239. package/dist/dev/test/components/copy-file.test.js.map +1 -0
  240. package/dist/dev/test/components/declaration.test.js +40 -0
  241. package/dist/dev/test/components/declaration.test.js.map +1 -0
  242. package/dist/dev/test/components/list.test.js +250 -0
  243. package/dist/dev/test/components/list.test.js.map +1 -0
  244. package/dist/dev/test/components/prose.test.js +42 -0
  245. package/dist/dev/test/components/prose.test.js.map +1 -0
  246. package/dist/dev/test/components/reference-or-content.test.js +246 -0
  247. package/dist/dev/test/components/reference-or-content.test.js.map +1 -0
  248. package/dist/dev/test/components/source-file.test.js +271 -0
  249. package/dist/dev/test/components/source-file.test.js.map +1 -0
  250. package/dist/dev/test/components/template-file.test.js +200 -0
  251. package/dist/dev/test/components/template-file.test.js.map +1 -0
  252. package/dist/dev/test/components/update-file.test.js +210 -0
  253. package/dist/dev/test/components/update-file.test.js.map +1 -0
  254. package/dist/dev/test/components/wrap.test.js +48 -0
  255. package/dist/dev/test/components/wrap.test.js.map +1 -0
  256. package/dist/dev/test/control-flow/for.test.js +318 -0
  257. package/dist/dev/test/control-flow/for.test.js.map +1 -0
  258. package/dist/dev/test/control-flow/match.test.js +112 -0
  259. package/dist/dev/test/control-flow/match.test.js.map +1 -0
  260. package/dist/dev/test/control-flow/show.test.js +38 -0
  261. package/dist/dev/test/control-flow/show.test.js.map +1 -0
  262. package/dist/dev/test/lazy-isempty.test.js +121 -0
  263. package/dist/dev/test/lazy-isempty.test.js.map +1 -0
  264. package/dist/dev/test/name-policy.test.js +28 -0
  265. package/dist/dev/test/name-policy.test.js.map +1 -0
  266. package/dist/dev/test/props-with-defaults.test.js +94 -0
  267. package/dist/dev/test/props-with-defaults.test.js.map +1 -0
  268. package/dist/dev/test/reactive-union-set-disposers.test.js +98 -0
  269. package/dist/dev/test/reactive-union-set-disposers.test.js.map +1 -0
  270. package/dist/dev/test/reactive-union-set.test.js +171 -0
  271. package/dist/dev/test/reactive-union-set.test.js.map +1 -0
  272. package/dist/dev/test/reactivity/circular-reactives.test.js +62 -0
  273. package/dist/dev/test/reactivity/circular-reactives.test.js.map +1 -0
  274. package/dist/dev/test/reactivity/cleanup.test.js +96 -0
  275. package/dist/dev/test/reactivity/cleanup.test.js.map +1 -0
  276. package/dist/dev/test/reactivity/memo.test.js +17 -0
  277. package/dist/dev/test/reactivity/memo.test.js.map +1 -0
  278. package/dist/dev/test/reactivity/ref-rendering.test.js +38 -0
  279. package/dist/dev/test/reactivity/ref-rendering.test.js.map +1 -0
  280. package/dist/dev/test/reactivity/shallow-reactive.test.js +56 -0
  281. package/dist/dev/test/reactivity/shallow-reactive.test.js.map +1 -0
  282. package/dist/dev/test/reactivity/test.test.js +74 -0
  283. package/dist/dev/test/reactivity/test.test.js.map +1 -0
  284. package/dist/dev/test/reactivity/untrack.test.js +27 -0
  285. package/dist/dev/test/reactivity/untrack.test.js.map +1 -0
  286. package/dist/dev/test/refkey.test.js +36 -0
  287. package/dist/dev/test/refkey.test.js.map +1 -0
  288. package/dist/dev/test/rendering/basic.test.js +194 -0
  289. package/dist/dev/test/rendering/basic.test.js.map +1 -0
  290. package/dist/dev/test/rendering/code.test.js +64 -0
  291. package/dist/dev/test/rendering/code.test.js.map +1 -0
  292. package/dist/dev/test/rendering/formatting.test.js +797 -0
  293. package/dist/dev/test/rendering/formatting.test.js.map +1 -0
  294. package/dist/dev/test/rendering/indent.test.js +183 -0
  295. package/dist/dev/test/rendering/indent.test.js.map +1 -0
  296. package/dist/dev/test/rendering/memoization.test.js +37 -0
  297. package/dist/dev/test/rendering/memoization.test.js.map +1 -0
  298. package/dist/dev/test/rendering/print-render-stack.test.js +287 -0
  299. package/dist/dev/test/rendering/print-render-stack.test.js.map +1 -0
  300. package/dist/dev/test/rendering/refkeys.test.js +37 -0
  301. package/dist/dev/test/rendering/refkeys.test.js.map +1 -0
  302. package/dist/dev/test/scheduler-extended.test.js +96 -0
  303. package/dist/dev/test/scheduler-extended.test.js.map +1 -0
  304. package/dist/dev/test/scheduler.test.js +46 -0
  305. package/dist/dev/test/scheduler.test.js.map +1 -0
  306. package/dist/dev/test/split-props.test.js +78 -0
  307. package/dist/dev/test/split-props.test.js.map +1 -0
  308. package/dist/dev/test/stc.test.js +35 -0
  309. package/dist/dev/test/stc.test.js.map +1 -0
  310. package/dist/dev/test/symbols/deconflicted-name.test.js +120 -0
  311. package/dist/dev/test/symbols/deconflicted-name.test.js.map +1 -0
  312. package/dist/dev/test/symbols/output-scope.test.js +221 -0
  313. package/dist/dev/test/symbols/output-scope.test.js.map +1 -0
  314. package/dist/dev/test/symbols/output-symbol.test.js +202 -0
  315. package/dist/dev/test/symbols/output-symbol.test.js.map +1 -0
  316. package/dist/dev/test/symbols/resolution.test.js +487 -0
  317. package/dist/dev/test/symbols/resolution.test.js.map +1 -0
  318. package/dist/dev/test/symbols/symbol-table.test.js +15 -0
  319. package/dist/dev/test/symbols/symbol-table.test.js.map +1 -0
  320. package/dist/dev/test/symbols/utils.js +26 -0
  321. package/dist/dev/test/symbols/utils.js.map +1 -0
  322. package/dist/dev/test/utils.test.js +317 -0
  323. package/dist/dev/test/utils.test.js.map +1 -0
  324. package/dist/dev/testing/create-test-wrapper.js +130 -0
  325. package/dist/dev/testing/create-test-wrapper.js.map +1 -0
  326. package/dist/dev/testing/devtools-utils.js +162 -0
  327. package/dist/dev/testing/devtools-utils.js.map +1 -0
  328. package/dist/dev/testing/extend-expect.js +187 -0
  329. package/dist/dev/testing/extend-expect.js.map +1 -0
  330. package/dist/dev/testing/extend-expect.test.js +234 -0
  331. package/dist/dev/testing/extend-expect.test.js.map +1 -0
  332. package/dist/dev/testing/index.js +4 -0
  333. package/dist/dev/testing/index.js.map +1 -0
  334. package/dist/dev/testing/render.js +34 -0
  335. package/dist/dev/testing/render.js.map +1 -0
  336. package/dist/dev/testing/vitest.d.js +14 -0
  337. package/dist/dev/testing/vitest.d.js.map +1 -0
  338. package/dist/devtools/index.html +29 -17
  339. package/dist/src/binder.d.ts +107 -3
  340. package/dist/src/binder.d.ts.map +1 -1
  341. package/dist/src/binder.js +113 -1
  342. package/dist/src/binder.js.map +1 -1
  343. package/dist/src/components/AccessExpression.d.ts +78 -0
  344. package/dist/src/components/AccessExpression.d.ts.map +1 -0
  345. package/dist/src/components/AccessExpression.js +218 -0
  346. package/dist/src/components/AccessExpression.js.map +1 -0
  347. package/dist/src/components/AccessExpression.test.d.ts +2 -0
  348. package/dist/src/components/AccessExpression.test.d.ts.map +1 -0
  349. package/dist/src/components/AccessExpression.test.js +137 -0
  350. package/dist/src/components/AccessExpression.test.js.map +1 -0
  351. package/dist/src/components/Block.d.ts +12 -0
  352. package/dist/src/components/Block.d.ts.map +1 -1
  353. package/dist/src/components/Block.js +12 -0
  354. package/dist/src/components/Block.js.map +1 -1
  355. package/dist/src/components/For.d.ts.map +1 -1
  356. package/dist/src/components/For.js +1 -1
  357. package/dist/src/components/For.js.map +1 -1
  358. package/dist/src/components/List.d.ts +11 -1
  359. package/dist/src/components/List.d.ts.map +1 -1
  360. package/dist/src/components/List.js +1 -1
  361. package/dist/src/components/List.js.map +1 -1
  362. package/dist/src/components/MemberDeclaration.d.ts +6 -6
  363. package/dist/src/components/MemberDeclaration.js +6 -6
  364. package/dist/src/components/MemberName.d.ts +6 -0
  365. package/dist/src/components/MemberName.d.ts.map +1 -1
  366. package/dist/src/components/MemberName.js +7 -0
  367. package/dist/src/components/MemberName.js.map +1 -1
  368. package/dist/src/components/MemberScope.d.ts +5 -0
  369. package/dist/src/components/MemberScope.d.ts.map +1 -1
  370. package/dist/src/components/MemberScope.js +5 -0
  371. package/dist/src/components/MemberScope.js.map +1 -1
  372. package/dist/src/components/Output.d.ts +4 -2
  373. package/dist/src/components/Output.d.ts.map +1 -1
  374. package/dist/src/components/Output.js.map +1 -1
  375. package/dist/src/components/Scope.d.ts +6 -0
  376. package/dist/src/components/Scope.d.ts.map +1 -1
  377. package/dist/src/components/Scope.js +6 -0
  378. package/dist/src/components/Scope.js.map +1 -1
  379. package/dist/src/components/SourceFile.d.ts +22 -2
  380. package/dist/src/components/SourceFile.d.ts.map +1 -1
  381. package/dist/src/components/SourceFile.js.map +1 -1
  382. package/dist/src/components/Switch.d.ts.map +1 -1
  383. package/dist/src/components/Switch.js +1 -1
  384. package/dist/src/components/Switch.js.map +1 -1
  385. package/dist/src/components/index.d.ts +1 -0
  386. package/dist/src/components/index.d.ts.map +1 -1
  387. package/dist/src/components/index.js +1 -0
  388. package/dist/src/components/index.js.map +1 -1
  389. package/dist/src/context/binder.d.ts +4 -0
  390. package/dist/src/context/binder.d.ts.map +1 -1
  391. package/dist/src/context/binder.js +5 -0
  392. package/dist/src/context/binder.js.map +1 -1
  393. package/dist/src/context/format-options.d.ts +14 -1
  394. package/dist/src/context/format-options.d.ts.map +1 -1
  395. package/dist/src/context/format-options.js +14 -1
  396. package/dist/src/context/format-options.js.map +1 -1
  397. package/dist/src/context/scope.d.ts +4 -0
  398. package/dist/src/context/scope.d.ts.map +1 -1
  399. package/dist/src/context/scope.js +5 -0
  400. package/dist/src/context/scope.js.map +1 -1
  401. package/dist/src/context/source-directory.d.ts +9 -0
  402. package/dist/src/context/source-directory.d.ts.map +1 -1
  403. package/dist/src/context/source-directory.js +9 -0
  404. package/dist/src/context/source-directory.js.map +1 -1
  405. package/dist/src/debug/cli.d.ts.map +1 -1
  406. package/dist/src/debug/cli.js +3 -2
  407. package/dist/src/debug/cli.js.map +1 -1
  408. package/dist/src/debug/diagnostics-broadcast.test.d.ts +2 -0
  409. package/dist/src/debug/diagnostics-broadcast.test.d.ts.map +1 -0
  410. package/dist/src/debug/diagnostics-broadcast.test.js +100 -0
  411. package/dist/src/debug/diagnostics-broadcast.test.js.map +1 -0
  412. package/dist/src/debug/diagnostics.test.js +3 -2
  413. package/dist/src/debug/diagnostics.test.js.map +1 -1
  414. package/dist/src/debug/effects.d.ts +12 -4
  415. package/dist/src/debug/effects.d.ts.map +1 -1
  416. package/dist/src/debug/effects.js +119 -54
  417. package/dist/src/debug/effects.js.map +1 -1
  418. package/dist/src/debug/effects.test.js +213 -41
  419. package/dist/src/debug/effects.test.js.map +1 -1
  420. package/dist/src/debug/files.d.ts.map +1 -1
  421. package/dist/src/debug/files.js +7 -18
  422. package/dist/src/debug/files.js.map +1 -1
  423. package/dist/src/debug/files.test.js +13 -36
  424. package/dist/src/debug/files.test.js.map +1 -1
  425. package/dist/src/debug/index.d.ts +4 -2
  426. package/dist/src/debug/index.d.ts.map +1 -1
  427. package/dist/src/debug/index.js +4 -2
  428. package/dist/src/debug/index.js.map +1 -1
  429. package/dist/src/debug/message-format.test.d.ts +2 -0
  430. package/dist/src/debug/message-format.test.d.ts.map +1 -0
  431. package/dist/src/debug/message-format.test.js +700 -0
  432. package/dist/src/debug/message-format.test.js.map +1 -0
  433. package/dist/src/debug/render-tree-orphans.test.d.ts +2 -0
  434. package/dist/src/debug/render-tree-orphans.test.d.ts.map +1 -0
  435. package/dist/src/debug/render-tree-orphans.test.js +297 -0
  436. package/dist/src/debug/render-tree-orphans.test.js.map +1 -0
  437. package/dist/src/debug/render.d.ts.map +1 -1
  438. package/dist/src/debug/render.js +91 -131
  439. package/dist/src/debug/render.js.map +1 -1
  440. package/dist/src/debug/render.test.js +91 -128
  441. package/dist/src/debug/render.test.js.map +1 -1
  442. package/dist/src/debug/source-map.browser.d.ts +16 -0
  443. package/dist/src/debug/source-map.browser.d.ts.map +1 -0
  444. package/dist/src/debug/source-map.browser.js +24 -0
  445. package/dist/src/debug/source-map.browser.js.map +1 -0
  446. package/dist/src/debug/source-map.d.ts +22 -0
  447. package/dist/src/debug/source-map.d.ts.map +1 -0
  448. package/dist/src/debug/source-map.js +111 -0
  449. package/dist/src/debug/source-map.js.map +1 -0
  450. package/dist/src/debug/symbols.d.ts +6 -5
  451. package/dist/src/debug/symbols.d.ts.map +1 -1
  452. package/dist/src/debug/symbols.js +46 -23
  453. package/dist/src/debug/symbols.js.map +1 -1
  454. package/dist/src/debug/symbols.test.js +15 -26
  455. package/dist/src/debug/symbols.test.js.map +1 -1
  456. package/dist/src/debug/trace-writer.d.ts +56 -0
  457. package/dist/src/debug/trace-writer.d.ts.map +1 -0
  458. package/dist/src/debug/trace-writer.js +674 -0
  459. package/dist/src/debug/trace-writer.js.map +1 -0
  460. package/dist/src/debug/trace.d.ts +10 -10
  461. package/dist/src/debug/trace.d.ts.map +1 -1
  462. package/dist/src/debug/trace.js +41 -24
  463. package/dist/src/debug/trace.js.map +1 -1
  464. package/dist/src/devtools/devtools-protocol.d.ts +318 -161
  465. package/dist/src/devtools/devtools-protocol.d.ts.map +1 -1
  466. package/dist/src/devtools/devtools-server.browser.d.ts +1 -5
  467. package/dist/src/devtools/devtools-server.browser.d.ts.map +1 -1
  468. package/dist/src/devtools/devtools-server.browser.js +3 -3
  469. package/dist/src/devtools/devtools-server.browser.js.map +1 -1
  470. package/dist/src/devtools/devtools-server.d.ts +5 -6
  471. package/dist/src/devtools/devtools-server.d.ts.map +1 -1
  472. package/dist/src/devtools/devtools-server.js +227 -25
  473. package/dist/src/devtools/devtools-server.js.map +1 -1
  474. package/dist/src/devtools/devtools-transport.d.ts +2 -2
  475. package/dist/src/devtools/devtools-transport.d.ts.map +1 -1
  476. package/dist/src/devtools/devtools-transport.js +2 -2
  477. package/dist/src/devtools/devtools-transport.js.map +1 -1
  478. package/dist/src/devtools-entry.browser.d.ts +1 -1
  479. package/dist/src/devtools-entry.browser.d.ts.map +1 -1
  480. package/dist/src/devtools-entry.browser.js.map +1 -1
  481. package/dist/src/devtools-entry.d.ts +1 -1
  482. package/dist/src/devtools-entry.d.ts.map +1 -1
  483. package/dist/src/devtools-entry.js.map +1 -1
  484. package/dist/src/diagnostics.d.ts +1 -1
  485. package/dist/src/diagnostics.d.ts.map +1 -1
  486. package/dist/src/diagnostics.js +27 -19
  487. package/dist/src/diagnostics.js.map +1 -1
  488. package/dist/src/host/node-host.browser.d.ts +11 -0
  489. package/dist/src/host/node-host.browser.d.ts.map +1 -0
  490. package/dist/src/host/node-host.browser.js +21 -0
  491. package/dist/src/host/node-host.browser.js.map +1 -0
  492. package/dist/src/host/node-host.d.ts +11 -0
  493. package/dist/src/host/node-host.d.ts.map +1 -0
  494. package/dist/src/host/node-host.js +20 -0
  495. package/dist/src/host/node-host.js.map +1 -0
  496. package/dist/src/library-symbol-reference.d.ts +52 -0
  497. package/dist/src/library-symbol-reference.d.ts.map +1 -1
  498. package/dist/src/library-symbol-reference.js +54 -0
  499. package/dist/src/library-symbol-reference.js.map +1 -1
  500. package/dist/src/name-policy.d.ts +30 -3
  501. package/dist/src/name-policy.d.ts.map +1 -1
  502. package/dist/src/name-policy.js +27 -0
  503. package/dist/src/name-policy.js.map +1 -1
  504. package/dist/src/reactivity.d.ts +28 -2
  505. package/dist/src/reactivity.d.ts.map +1 -1
  506. package/dist/src/reactivity.js +154 -45
  507. package/dist/src/reactivity.js.map +1 -1
  508. package/dist/src/render-stack.d.ts.map +1 -1
  509. package/dist/src/render-stack.js +4 -3
  510. package/dist/src/render-stack.js.map +1 -1
  511. package/dist/src/render.d.ts +2 -0
  512. package/dist/src/render.d.ts.map +1 -1
  513. package/dist/src/render.js +84 -30
  514. package/dist/src/render.js.map +1 -1
  515. package/dist/src/scheduler.d.ts +5 -0
  516. package/dist/src/scheduler.d.ts.map +1 -1
  517. package/dist/src/scheduler.js +94 -23
  518. package/dist/src/scheduler.js.map +1 -1
  519. package/dist/src/symbols/output-scope.d.ts +33 -1
  520. package/dist/src/symbols/output-scope.d.ts.map +1 -1
  521. package/dist/src/symbols/output-scope.js +34 -1
  522. package/dist/src/symbols/output-scope.js.map +1 -1
  523. package/dist/src/symbols/output-space.d.ts +12 -0
  524. package/dist/src/symbols/output-space.d.ts.map +1 -1
  525. package/dist/src/symbols/output-space.js +15 -0
  526. package/dist/src/symbols/output-space.js.map +1 -1
  527. package/dist/src/symbols/output-symbol.d.ts +128 -12
  528. package/dist/src/symbols/output-symbol.d.ts.map +1 -1
  529. package/dist/src/symbols/output-symbol.js +158 -18
  530. package/dist/src/symbols/output-symbol.js.map +1 -1
  531. package/dist/src/symbols/symbol-slot.d.ts.map +1 -1
  532. package/dist/src/symbols/symbol-slot.js +7 -0
  533. package/dist/src/symbols/symbol-slot.js.map +1 -1
  534. package/dist/src/symbols/symbol-slot.test.js +18 -1
  535. package/dist/src/symbols/symbol-slot.test.js.map +1 -1
  536. package/dist/src/symbols/symbol-table.d.ts.map +1 -1
  537. package/dist/src/symbols/symbol-table.js +13 -3
  538. package/dist/src/symbols/symbol-table.js.map +1 -1
  539. package/dist/src/utils.d.ts.map +1 -1
  540. package/dist/src/utils.js +11 -5
  541. package/dist/src/utils.js.map +1 -1
  542. package/dist/src/write-output.d.ts.map +1 -1
  543. package/dist/src/write-output.js +6 -5
  544. package/dist/src/write-output.js.map +1 -1
  545. package/dist/test/browser-build.test.js +66 -67
  546. package/dist/test/browser-build.test.js.map +1 -1
  547. package/dist/test/reactivity/shallow-reactive.test.js +4 -0
  548. package/dist/test/reactivity/shallow-reactive.test.js.map +1 -1
  549. package/dist/test/symbols/deconflicted-name.test.d.ts +2 -0
  550. package/dist/test/symbols/deconflicted-name.test.d.ts.map +1 -0
  551. package/dist/test/symbols/deconflicted-name.test.js +120 -0
  552. package/dist/test/symbols/deconflicted-name.test.js.map +1 -0
  553. package/dist/test/symbols/output-scope.test.js +41 -0
  554. package/dist/test/symbols/output-scope.test.js.map +1 -1
  555. package/dist/testing/create-test-wrapper.d.ts +75 -2
  556. package/dist/testing/create-test-wrapper.d.ts.map +1 -1
  557. package/dist/testing/create-test-wrapper.js +55 -1
  558. package/dist/testing/create-test-wrapper.js.map +1 -1
  559. package/dist/testing/devtools-utils.d.ts +12 -3
  560. package/dist/testing/devtools-utils.d.ts.map +1 -1
  561. package/dist/testing/devtools-utils.js +26 -4
  562. package/dist/testing/devtools-utils.js.map +1 -1
  563. package/dist/testing/extend-expect.d.ts +26 -0
  564. package/dist/testing/extend-expect.d.ts.map +1 -1
  565. package/dist/testing/extend-expect.js +20 -0
  566. package/dist/testing/extend-expect.js.map +1 -1
  567. package/dist/testing/index.d.ts +1 -1
  568. package/dist/testing/index.d.ts.map +1 -1
  569. package/dist/testing/index.js +1 -1
  570. package/dist/testing/index.js.map +1 -1
  571. package/dist/testing/render.d.ts +9 -0
  572. package/dist/testing/render.d.ts.map +1 -1
  573. package/dist/testing/render.js +11 -0
  574. package/dist/testing/render.js.map +1 -1
  575. package/dist/testing/vitest.d.js +12 -0
  576. package/dist/testing/vitest.d.js.map +1 -1
  577. package/dist/tsconfig.tsbuildinfo +1 -1
  578. package/docs/api/components/AppendRegion.md +83 -0
  579. package/docs/api/components/Block.md +49 -0
  580. package/docs/api/components/CopyFile.md +26 -0
  581. package/docs/api/components/Declaration.md +85 -0
  582. package/docs/api/components/For.md +91 -0
  583. package/docs/api/components/Indent.md +40 -0
  584. package/docs/api/components/List.md +68 -0
  585. package/docs/api/components/MemberDeclaration.md +89 -0
  586. package/docs/api/components/MemberName.md +21 -0
  587. package/docs/api/components/MemberScope.md +81 -0
  588. package/docs/api/components/Name.md +19 -0
  589. package/docs/api/components/Output.md +62 -0
  590. package/docs/api/components/Prose.md +29 -0
  591. package/docs/api/components/ReferenceOrContent.md +28 -0
  592. package/docs/api/components/Scope.md +83 -0
  593. package/docs/api/components/Show.md +32 -0
  594. package/docs/api/components/SourceDirectory.md +28 -0
  595. package/docs/api/components/SourceFile.md +60 -0
  596. package/docs/api/components/StatementList.md +29 -0
  597. package/docs/api/components/Switch.md +42 -0
  598. package/docs/api/components/TemplateFile.md +71 -0
  599. package/docs/api/components/TemplateVariable.md +57 -0
  600. package/docs/api/components/UpdateFile.md +56 -0
  601. package/docs/api/components/Wrap.md +40 -0
  602. package/docs/api/components/createAccessExpression.md +55 -0
  603. package/docs/api/components/index.md +27 -0
  604. package/docs/api/contexts/Assignment-context.md +43 -0
  605. package/docs/api/contexts/Binder-context.md +22 -0
  606. package/docs/api/contexts/Declaration-context.md +15 -0
  607. package/docs/api/contexts/Member-context.md +17 -0
  608. package/docs/api/contexts/MemberDeclaration-context.md +24 -0
  609. package/docs/api/contexts/NamePolicy-context.md +18 -0
  610. package/docs/api/contexts/Scope-context.md +20 -0
  611. package/docs/api/contexts/SourceDirectory-context.md +26 -0
  612. package/docs/api/contexts/SourceFile-context.md +19 -0
  613. package/docs/api/contexts/index.md +11 -0
  614. package/docs/api/functions/attachDiagnosticsCollector.md +18 -0
  615. package/docs/api/functions/baseListPropsToMapJoinArgs.md +20 -0
  616. package/docs/api/functions/children.md +27 -0
  617. package/docs/api/functions/childrenArray.md +25 -0
  618. package/docs/api/functions/code.md +25 -0
  619. package/docs/api/functions/computed.md +18 -0
  620. package/docs/api/functions/createComponent.md +20 -0
  621. package/docs/api/functions/createContentSlot.md +33 -0
  622. package/docs/api/functions/createContext.md +19 -0
  623. package/docs/api/functions/createCustomContext.md +18 -0
  624. package/docs/api/functions/createDeclarationTap.md +20 -0
  625. package/docs/api/functions/createFileResource.md +35 -0
  626. package/docs/api/functions/createFormatOptionsContextFor.md +28 -0
  627. package/docs/api/functions/createIntrinsic.md +19 -0
  628. package/docs/api/functions/createMemberTap.md +20 -0
  629. package/docs/api/functions/createNamePolicy.md +37 -0
  630. package/docs/api/functions/createNamedContext.md +19 -0
  631. package/docs/api/functions/createOutputBinder.md +24 -0
  632. package/docs/api/functions/createRenderTreeHook.md +19 -0
  633. package/docs/api/functions/createResource.md +77 -0
  634. package/docs/api/functions/createScope.md +35 -0
  635. package/docs/api/functions/createScopeTap.md +20 -0
  636. package/docs/api/functions/createSourceFileTap.md +20 -0
  637. package/docs/api/functions/createSymbol.md +25 -0
  638. package/docs/api/functions/createSymbolSlot.md +19 -0
  639. package/docs/api/functions/createTap.md +55 -0
  640. package/docs/api/functions/decl.md +20 -0
  641. package/docs/api/functions/defaultProps.md +21 -0
  642. package/docs/api/functions/effect.md +26 -0
  643. package/docs/api/functions/emitDiagnostic.md +18 -0
  644. package/docs/api/functions/emitSymbol.md +18 -0
  645. package/docs/api/functions/ensureIsEmpty.md +20 -0
  646. package/docs/api/functions/findCurrentEffectId.md +19 -0
  647. package/docs/api/functions/findKeyedChild.md +19 -0
  648. package/docs/api/functions/findKeyedChildren.md +19 -0
  649. package/docs/api/functions/findUnkeyedChildren.md +18 -0
  650. package/docs/api/functions/formatReactivePropertyLabel.md +21 -0
  651. package/docs/api/functions/getAssignmentSymbol.md +19 -0
  652. package/docs/api/functions/getContext.md +17 -0
  653. package/docs/api/functions/getContextForRenderNode.md +18 -0
  654. package/docs/api/functions/getDiagnosticsForTree.md +18 -0
  655. package/docs/api/functions/getEffectDebugId.md +18 -0
  656. package/docs/api/functions/getElementCache.md +17 -0
  657. package/docs/api/functions/getReactiveCreationLocation.md +18 -0
  658. package/docs/api/functions/getSymbolCreator.md +18 -0
  659. package/docs/api/functions/getSymbolCreatorSymbol.md +17 -0
  660. package/docs/api/functions/index.md +105 -0
  661. package/docs/api/functions/inspectRefkey.md +18 -0
  662. package/docs/api/functions/instantiateTakenMembersTo.md +20 -0
  663. package/docs/api/functions/isComponentCreator.md +19 -0
  664. package/docs/api/functions/isCustomContext.md +18 -0
  665. package/docs/api/functions/isIntrinsicElement.md +18 -0
  666. package/docs/api/functions/isKeyedChild.md +18 -0
  667. package/docs/api/functions/isLibrarySymbolReference.md +18 -0
  668. package/docs/api/functions/isMemberRefkey.md +18 -0
  669. package/docs/api/functions/isNamekey.md +18 -0
  670. package/docs/api/functions/isPrintHook.md +18 -0
  671. package/docs/api/functions/isRefkey.md +18 -0
  672. package/docs/api/functions/isRefkeyable.md +18 -0
  673. package/docs/api/functions/isRenderableObject.md +20 -0
  674. package/docs/api/functions/isSymbolRefkey.md +18 -0
  675. package/docs/api/functions/join.md +33 -0
  676. package/docs/api/functions/mapJoin.md +106 -0
  677. package/docs/api/functions/memberRefkey.md +27 -0
  678. package/docs/api/functions/memo.md +29 -0
  679. package/docs/api/functions/mergeProps.md +64 -0
  680. package/docs/api/functions/moveTakenMembersTo.md +18 -0
  681. package/docs/api/functions/namekey.md +41 -0
  682. package/docs/api/functions/nextReactiveId.md +19 -0
  683. package/docs/api/functions/notifyContentState.md +17 -0
  684. package/docs/api/functions/onCleanup.md +26 -0
  685. package/docs/api/functions/printTree.md +31 -0
  686. package/docs/api/functions/reactivePropertyRefId.md +21 -0
  687. package/docs/api/functions/ref.md +21 -0
  688. package/docs/api/functions/refId.md +18 -0
  689. package/docs/api/functions/refkey.md +24 -0
  690. package/docs/api/functions/render.md +31 -0
  691. package/docs/api/functions/renderAsync.md +31 -0
  692. package/docs/api/functions/renderTree.md +18 -0
  693. package/docs/api/functions/reportDiagnostics.md +18 -0
  694. package/docs/api/functions/resetRefIdCounter.md +17 -0
  695. package/docs/api/functions/resolve.md +31 -0
  696. package/docs/api/functions/root.md +25 -0
  697. package/docs/api/functions/shallowReactive.md +18 -0
  698. package/docs/api/functions/shallowRef.md +21 -0
  699. package/docs/api/functions/sourceFilesForTree.md +31 -0
  700. package/docs/api/functions/splitProps.md +19 -0
  701. package/docs/api/functions/stc.md +18 -0
  702. package/docs/api/functions/sti.md +18 -0
  703. package/docs/api/functions/symbolForRefkey.md +24 -0
  704. package/docs/api/functions/taggedComponent.md +19 -0
  705. package/docs/api/functions/takeSymbols.md +18 -0
  706. package/docs/api/functions/text.md +19 -0
  707. package/docs/api/functions/toRef.md +20 -0
  708. package/docs/api/functions/toRefkey.md +18 -0
  709. package/docs/api/functions/toRefs.md +20 -0
  710. package/docs/api/functions/traverseOutput.md +21 -0
  711. package/docs/api/functions/unresolvedRefkey.md +18 -0
  712. package/docs/api/functions/untrack.md +18 -0
  713. package/docs/api/functions/useContext.md +18 -0
  714. package/docs/api/functions/useFormatOptions.md +18 -0
  715. package/docs/api/functions/useMemberContext.md +17 -0
  716. package/docs/api/functions/useMemberScope.md +17 -0
  717. package/docs/api/functions/writeOutput.md +21 -0
  718. package/docs/api/index.md +9 -0
  719. package/docs/api/testing/functions/createTestWrapper.md +70 -0
  720. package/docs/api/testing/functions/d.md +21 -0
  721. package/docs/api/testing/functions/dedent.md +18 -0
  722. package/docs/api/testing/functions/index.md +6 -0
  723. package/docs/api/testing/functions/renderToString.md +20 -0
  724. package/docs/api/testing/index.md +4 -0
  725. package/docs/api/testing/types/TestWrapper.md +10 -0
  726. package/docs/api/testing/types/ToRenderToOptions.md +24 -0
  727. package/docs/api/testing/types/index.md +4 -0
  728. package/docs/api/types/AlignIntrinsicElement.md +5 -0
  729. package/docs/api/types/AppendRegionProps.md +5 -0
  730. package/docs/api/types/BaseListProps.md +21 -0
  731. package/docs/api/types/BasePartProps.md +10 -0
  732. package/docs/api/types/BasicScope.md +15 -0
  733. package/docs/api/types/BasicSymbol.md +18 -0
  734. package/docs/api/types/Binder.md +18 -0
  735. package/docs/api/types/BinderOptions.md +7 -0
  736. package/docs/api/types/BrIntrinsicElement.md +5 -0
  737. package/docs/api/types/BreakParentIntrinsicElement.md +5 -0
  738. package/docs/api/types/Child.md +5 -0
  739. package/docs/api/types/Children.md +5 -0
  740. package/docs/api/types/ChildrenOptions.md +7 -0
  741. package/docs/api/types/CommonFormatOptions.md +8 -0
  742. package/docs/api/types/Component.md +8 -0
  743. package/docs/api/types/ComponentContext.md +11 -0
  744. package/docs/api/types/ComponentCreator.md +11 -0
  745. package/docs/api/types/ComponentDefinition.md +7 -0
  746. package/docs/api/types/ContentOutputFile.md +10 -0
  747. package/docs/api/types/ContentSlot.md +12 -0
  748. package/docs/api/types/Context.md +19 -0
  749. package/docs/api/types/ContextProviderProps.md +8 -0
  750. package/docs/api/types/CopyFileContext.md +8 -0
  751. package/docs/api/types/CopyOutputFile.md +9 -0
  752. package/docs/api/types/CustomContext.md +10 -0
  753. package/docs/api/types/CustomContextChildrenCallback.md +5 -0
  754. package/docs/api/types/DeclarationProps.md +5 -0
  755. package/docs/api/types/DedentIntrinsicElement.md +5 -0
  756. package/docs/api/types/DedentToRootIntrinsicElement.md +5 -0
  757. package/docs/api/types/Diagnostic.md +11 -0
  758. package/docs/api/types/DiagnosticHandle.md +7 -0
  759. package/docs/api/types/DiagnosticInput.md +10 -0
  760. package/docs/api/types/DiagnosticSeverity.md +5 -0
  761. package/docs/api/types/DiagnosticStackEntry.md +9 -0
  762. package/docs/api/types/DiagnosticsCollector.md +8 -0
  763. package/docs/api/types/Disposable_2.md +7 -0
  764. package/docs/api/types/EffectDebugOptions.md +8 -0
  765. package/docs/api/types/EffectOptions.md +7 -0
  766. package/docs/api/types/ElementCache.md +5 -0
  767. package/docs/api/types/ElementCacheKey.md +5 -0
  768. package/docs/api/types/FillIntrinsicElement.md +5 -0
  769. package/docs/api/types/ForCallbackArgs.md +5 -0
  770. package/docs/api/types/ForSupportedCollections.md +5 -0
  771. package/docs/api/types/GroupIntrinsicElement.md +5 -0
  772. package/docs/api/types/HardlineIntrinsicElement.md +5 -0
  773. package/docs/api/types/HbrIntrinsicElement.md +5 -0
  774. package/docs/api/types/IfBreakIntrinsicElement.md +5 -0
  775. package/docs/api/types/IndentIfBreakIntrinsicElement.md +5 -0
  776. package/docs/api/types/IndentIntrinsicElement.md +5 -0
  777. package/docs/api/types/IntrinsicElement.md +5 -0
  778. package/docs/api/types/IntrinsicElementBase.md +9 -0
  779. package/docs/api/types/IntrinsicElements.md +26 -0
  780. package/docs/api/types/JoinOptions.md +9 -0
  781. package/docs/api/types/LbrIntrinsicElement.md +5 -0
  782. package/docs/api/types/LibrarySymbolReference.md +13 -0
  783. package/docs/api/types/LineIntrinsicElement.md +5 -0
  784. package/docs/api/types/LineSuffixBoundaryIntrinsicElement.md +5 -0
  785. package/docs/api/types/LineSuffixIntrinsicElement.md +5 -0
  786. package/docs/api/types/LiterallineIntrinsicElement.md +5 -0
  787. package/docs/api/types/MakeChildrenOptional.md +7 -0
  788. package/docs/api/types/MarkAsRootIntrinsicElement.md +5 -0
  789. package/docs/api/types/MatchProps.md +9 -0
  790. package/docs/api/types/MemberDeclarationProps.md +5 -0
  791. package/docs/api/types/MemberDescriptor.md +10 -0
  792. package/docs/api/types/MemberRefkey.md +10 -0
  793. package/docs/api/types/MemberResolutionContext.md +10 -0
  794. package/docs/api/types/MemberResolver.md +32 -0
  795. package/docs/api/types/MemberScopeProps.md +5 -0
  796. package/docs/api/types/Metadata.md +5 -0
  797. package/docs/api/types/NameConflictResolver.md +27 -0
  798. package/docs/api/types/NamePolicy.md +8 -0
  799. package/docs/api/types/NamePolicyGetter.md +9 -0
  800. package/docs/api/types/Namekey.md +10 -0
  801. package/docs/api/types/NamekeyOptions.md +8 -0
  802. package/docs/api/types/OnReactiveSetAddCallback.md +5 -0
  803. package/docs/api/types/OnReactiveSetDeleteCallback.md +5 -0
  804. package/docs/api/types/OutputDeclarationSpace.md +13 -0
  805. package/docs/api/types/OutputDirectory.md +59 -0
  806. package/docs/api/types/OutputFile.md +5 -0
  807. package/docs/api/types/OutputFileBase.md +8 -0
  808. package/docs/api/types/OutputMemberSpace.md +13 -0
  809. package/docs/api/types/OutputScope.md +33 -0
  810. package/docs/api/types/OutputScopeOptions.md +9 -0
  811. package/docs/api/types/OutputSpace.md +7 -0
  812. package/docs/api/types/OutputSymbol.md +78 -0
  813. package/docs/api/types/OutputSymbolOptions.md +16 -0
  814. package/docs/api/types/OutputVisitor.md +10 -0
  815. package/docs/api/types/PrintHook.md +10 -0
  816. package/docs/api/types/PrintTreeOptions.md +11 -0
  817. package/docs/api/types/Props.md +5 -0
  818. package/docs/api/types/ReactiveUnionSet.md +20 -0
  819. package/docs/api/types/ReactiveUnionSetOptions.md +8 -0
  820. package/docs/api/types/Refkey.md +5 -0
  821. package/docs/api/types/Refkeyable.md +5 -0
  822. package/docs/api/types/RefkeyableObject.md +7 -0
  823. package/docs/api/types/RenderableObject.md +9 -0
  824. package/docs/api/types/RenderedTextTree.md +5 -0
  825. package/docs/api/types/ResolutionResult.md +39 -0
  826. package/docs/api/types/ResolveDeclarationByKeyOptions.md +7 -0
  827. package/docs/api/types/Resource.md +11 -0
  828. package/docs/api/types/RootOptions.md +7 -0
  829. package/docs/api/types/SbrIntrinsicElement.md +5 -0
  830. package/docs/api/types/ScopeProps.md +5 -0
  831. package/docs/api/types/SoftlineIntrinsicElement.md +5 -0
  832. package/docs/api/types/SourceLocation.md +9 -0
  833. package/docs/api/types/SplitProps.md +12 -0
  834. package/docs/api/types/StcComponentCreator.md +9 -0
  835. package/docs/api/types/StcSignature.md +5 -0
  836. package/docs/api/types/StiComponentCreator.md +9 -0
  837. package/docs/api/types/StiSignature.md +7 -0
  838. package/docs/api/types/SymbolCreator.md +15 -0
  839. package/docs/api/types/SymbolRefkey.md +9 -0
  840. package/docs/api/types/SymbolSlot.md +12 -0
  841. package/docs/api/types/SymbolTable.md +15 -0
  842. package/docs/api/types/TakeSymbolCallback.md +7 -0
  843. package/docs/api/types/TakeSymbolsCallback.md +7 -0
  844. package/docs/api/types/Tap.md +11 -0
  845. package/docs/api/types/TapHandler.md +9 -0
  846. package/docs/api/types/Tapper.md +9 -0
  847. package/docs/api/types/TemplateVariableProps.md +5 -0
  848. package/docs/api/types/index.md +122 -0
  849. package/docs/api/variables/FormatOptions.md +5 -0
  850. package/docs/api/variables/Match.md +7 -0
  851. package/docs/api/variables/REFKEYABLE.md +5 -0
  852. package/docs/api/variables/RENDERABLE.md +5 -0
  853. package/docs/api/variables/TO_SYMBOL.md +39 -0
  854. package/docs/api/variables/contextsByKey.md +5 -0
  855. package/docs/api/variables/index.md +11 -0
  856. package/docs/api/variables/intrinsicElementKey.md +5 -0
  857. package/docs/api/variables/matchTag.md +5 -0
  858. package/docs/api/variables/printHookTag.md +7 -0
  859. package/docs/components.md +97 -0
  860. package/docs/context.md +67 -0
  861. package/docs/control-flow.md +5 -0
  862. package/docs/debugging.md +105 -0
  863. package/docs/formatting.md +99 -0
  864. package/docs/guides/language-package-guide.md +593 -0
  865. package/docs/guides/references-and-refkeys.md +210 -0
  866. package/docs/guides/style-guide.md +244 -0
  867. package/docs/index.md +22 -0
  868. package/docs/reactivity.md +68 -0
  869. package/docs/rendering.md +41 -0
  870. package/docs/symbols-and-scopes.md +180 -0
  871. package/package.json +16 -6
  872. package/src/binder.ts +154 -41
  873. package/src/components/AccessExpression.test.tsx +132 -0
  874. package/src/components/AccessExpression.tsx +344 -0
  875. package/src/components/Block.tsx +12 -0
  876. package/src/components/For.tsx +14 -10
  877. package/src/components/List.tsx +18 -5
  878. package/src/components/MemberDeclaration.tsx +6 -6
  879. package/src/components/MemberName.tsx +6 -0
  880. package/src/components/MemberScope.tsx +5 -0
  881. package/src/components/Output.tsx +4 -1
  882. package/src/components/Scope.tsx +6 -0
  883. package/src/components/SourceFile.tsx +22 -2
  884. package/src/components/Switch.tsx +11 -7
  885. package/src/components/index.tsx +1 -0
  886. package/src/context/binder.ts +4 -0
  887. package/src/context/format-options.ts +14 -1
  888. package/src/context/scope.ts +4 -0
  889. package/src/context/source-directory.ts +9 -0
  890. package/src/debug/cli.ts +3 -2
  891. package/src/debug/diagnostics-broadcast.test.tsx +98 -0
  892. package/src/debug/diagnostics.test.tsx +3 -2
  893. package/src/debug/effects.test.tsx +248 -36
  894. package/src/debug/effects.ts +198 -64
  895. package/src/debug/files.test.tsx +15 -35
  896. package/src/debug/files.ts +11 -11
  897. package/src/debug/index.ts +4 -0
  898. package/src/debug/message-format.test.tsx +759 -0
  899. package/src/debug/render-tree-orphans.test.tsx +344 -0
  900. package/src/debug/render.test.tsx +96 -118
  901. package/src/debug/render.ts +196 -125
  902. package/src/debug/source-map.browser.ts +30 -0
  903. package/src/debug/source-map.ts +135 -0
  904. package/src/debug/symbols.test.tsx +19 -20
  905. package/src/debug/symbols.ts +106 -23
  906. package/src/debug/trace-writer.ts +984 -0
  907. package/src/debug/trace.ts +46 -32
  908. package/src/devtools/devtools-protocol.ts +361 -176
  909. package/src/devtools/devtools-server.browser.ts +4 -9
  910. package/src/devtools/devtools-server.ts +226 -33
  911. package/src/devtools/devtools-transport.ts +4 -4
  912. package/src/devtools-entry.browser.ts +11 -15
  913. package/src/devtools-entry.ts +9 -15
  914. package/src/diagnostics.ts +44 -22
  915. package/src/host/node-host.browser.ts +23 -0
  916. package/src/host/node-host.ts +22 -0
  917. package/src/library-symbol-reference.ts +52 -0
  918. package/src/name-policy.ts +30 -3
  919. package/src/reactivity.ts +179 -55
  920. package/src/render-stack.ts +4 -3
  921. package/src/render.ts +106 -30
  922. package/src/scheduler.ts +145 -26
  923. package/src/symbols/output-scope.ts +33 -1
  924. package/src/symbols/output-space.ts +13 -0
  925. package/src/symbols/output-symbol.ts +185 -22
  926. package/src/symbols/symbol-slot.test.tsx +28 -1
  927. package/src/symbols/symbol-slot.tsx +8 -0
  928. package/src/symbols/symbol-table.ts +13 -3
  929. package/src/utils.tsx +7 -4
  930. package/src/write-output.ts +6 -5
  931. package/temp/api-testing.json +673 -0
  932. package/temp/api.json +895 -73
  933. package/test/browser-build.test.ts +71 -78
  934. package/test/reactivity/shallow-reactive.test.tsx +4 -0
  935. package/test/symbols/deconflicted-name.test.ts +120 -0
  936. package/test/symbols/output-scope.test.ts +38 -0
  937. package/testing/create-test-wrapper.tsx +81 -2
  938. package/testing/devtools-utils.ts +46 -4
  939. package/testing/extend-expect.ts +22 -1
  940. package/testing/index.ts +1 -1
  941. package/testing/render.ts +9 -0
  942. package/testing/vitest.d.ts +18 -3
  943. package/vitest.config.ts +8 -0
@@ -0,0 +1,458 @@
1
+ /**
2
+ * Devtools session manager.
3
+ *
4
+ * Manages the lifecycle of a devtools session: enable, connect, broadcast
5
+ * messages, and reset. Transport details (HTTP/WebSocket) are delegated
6
+ * to devtools-transport.ts.
7
+ */
8
+
9
+ import { ALL_CHANNELS, closeTrace, initTrace, isTraceEnabled, queryChannel, setChangeListener } from "../debug/trace-writer.js";
10
+ import { createTransport, getAlloyVersion } from "./devtools-transport.js";
11
+
12
+ // ─────────────────────────────────────────────────────────────────────────────
13
+ // Public types
14
+ // ─────────────────────────────────────────────────────────────────────────────
15
+
16
+ // ─────────────────────────────────────────────────────────────────────────────
17
+ // Session state
18
+ // ─────────────────────────────────────────────────────────────────────────────
19
+
20
+ let transportState = null;
21
+ let transportPromise = null;
22
+ const messageHandlers = new Set();
23
+ let devtoolsExplicitlyEnabled = false;
24
+ let devtoolsInitialized = false;
25
+ let loggedDevtoolsLinks = false;
26
+ let waitingForConnection = false;
27
+ let configuredPort;
28
+ let tempDbPath = null;
29
+ let subscribedPromise = null;
30
+ let resolveSubscribed = null;
31
+
32
+ // ─────────────────────────────────────────────────────────────────────────────
33
+ // Per-client subscription state
34
+ // ─────────────────────────────────────────────────────────────────────────────
35
+
36
+ const clientStates = new Map();
37
+ function eventToMessageType(event) {
38
+ const map = {
39
+ render: {
40
+ added: "render:node_added",
41
+ updated: "render:node_updated",
42
+ removed: "render:node_removed",
43
+ reset: "render:reset"
44
+ },
45
+ effects: {
46
+ added: "effect:added",
47
+ updated: "effect:updated"
48
+ },
49
+ refs: {
50
+ added: "ref:added"
51
+ },
52
+ edges: {
53
+ added: `edge:${event.data.edge_type ?? "track"}`
54
+ },
55
+ symbols: {
56
+ added: "symbol:added",
57
+ updated: "symbol:updated",
58
+ removed: "symbol:removed"
59
+ },
60
+ scopes: {
61
+ added: "scope:added",
62
+ updated: "scope:updated",
63
+ removed: "scope:removed"
64
+ },
65
+ files: {
66
+ added: "file:added",
67
+ updated: "file:updated",
68
+ removed: "file:removed"
69
+ },
70
+ directories: {
71
+ added: "directory:added",
72
+ removed: "directory:removed"
73
+ },
74
+ diagnostics: {
75
+ added: "diagnostics:report"
76
+ },
77
+ errors: {
78
+ added: "render:error"
79
+ },
80
+ lifecycle: {
81
+ added: "effect:lifecycle"
82
+ },
83
+ scheduler: {
84
+ added: "scheduler:job"
85
+ }
86
+ };
87
+ return map[event.channel]?.[event.action] ?? `${event.channel}:${event.action}`;
88
+ }
89
+ function channelToInitialMessageType(channel, row) {
90
+ const map = {
91
+ render: "render:node_added",
92
+ effects: "effect:added",
93
+ refs: "ref:added",
94
+ symbols: "symbol:added",
95
+ scopes: "scope:added",
96
+ files: "file:added",
97
+ directories: "directory:added",
98
+ diagnostics: "diagnostics:report",
99
+ errors: "render:error",
100
+ lifecycle: "effect:lifecycle",
101
+ scheduler: "scheduler:job"
102
+ };
103
+ if (channel === "edges") {
104
+ return `edge:${row.type ?? "track"}`;
105
+ }
106
+ return map[channel] ?? `${channel}:added`;
107
+ }
108
+ function sendInitialState(socket, channels) {
109
+ if (!isTraceEnabled()) return;
110
+ for (const channel of channels) {
111
+ const rows = queryChannel(channel);
112
+ for (const row of rows) {
113
+ const msgType = channelToInitialMessageType(channel, row);
114
+ // Remap SQLite column names that collide with the message `type` field
115
+ if (channel === "effects" && row.type !== undefined) {
116
+ row.effect_type = row.type;
117
+ }
118
+ const msg = {
119
+ ...row,
120
+ type: msgType
121
+ };
122
+ socket.send(JSON.stringify(msg));
123
+ }
124
+ }
125
+ }
126
+
127
+ // ─────────────────────────────────────────────────────────────────────────────
128
+ // Environment helpers
129
+ // ─────────────────────────────────────────────────────────────────────────────
130
+
131
+ function isNodeEnvironment() {
132
+ return typeof process !== "undefined" && typeof process.versions === "object" && Boolean(process.versions?.node);
133
+ }
134
+
135
+ // Cached once at module load. Stable for production runs. Tests that modify
136
+ // process.env.ALLOY_DEBUG dynamically must call refreshDebugState() afterward.
137
+ let _envDebugEnabled = isNodeEnvironment() && Boolean(process.env.ALLOY_DEBUG);
138
+
139
+ /**
140
+ * Invalidates the cached env-var result for isDevtoolsEnabled(). Call this in
141
+ * test beforeEach hooks after modifying process.env.ALLOY_DEBUG.
142
+ */
143
+ export function refreshDebugState() {
144
+ _envDebugEnabled = isNodeEnvironment() && Boolean(process.env.ALLOY_DEBUG);
145
+ }
146
+ function getCwd() {
147
+ if (!isNodeEnvironment()) return undefined;
148
+ try {
149
+ return process.cwd();
150
+ } catch {
151
+ return undefined;
152
+ }
153
+ }
154
+ function resolveDebugPort() {
155
+ const raw = process.env.ALLOY_DEBUG_PORT;
156
+ if (!raw) return 8123;
157
+ const parsed = Number.parseInt(raw, 10);
158
+ if (Number.isNaN(parsed)) return 8123;
159
+ return parsed;
160
+ }
161
+
162
+ // ─────────────────────────────────────────────────────────────────────────────
163
+ // Query functions
164
+ // ─────────────────────────────────────────────────────────────────────────────
165
+
166
+ /** Returns true when devtools are enabled (via env var or explicit call). */
167
+ export function isDevtoolsEnabled() {
168
+ if (!isNodeEnvironment()) return false;
169
+ return devtoolsExplicitlyEnabled || _envDebugEnabled;
170
+ }
171
+
172
+ /** Returns true when a devtools client is currently connected. */
173
+ export function isDevtoolsConnected() {
174
+ return Boolean(transportState?.connected);
175
+ }
176
+
177
+ /** Get the current server info, or null if not running. */
178
+ export function getDevtoolsServerInfo() {
179
+ if (!transportState) return null;
180
+ return {
181
+ port: transportState.port,
182
+ connected: transportState.connected
183
+ };
184
+ }
185
+
186
+ // ─────────────────────────────────────────────────────────────────────────────
187
+ // Temp SQLite for devtools
188
+ // ─────────────────────────────────────────────────────────────────────────────
189
+
190
+ async function ensureSqliteForDevtools() {
191
+ if (isTraceEnabled()) return;
192
+ const os = await import("node:os");
193
+ const path = await import("node:path");
194
+ tempDbPath = path.join(os.tmpdir(), `alloy-debug-${process.pid}.db`);
195
+ await initTrace(tempDbPath);
196
+ process.on("exit", () => {
197
+ if (!tempDbPath) return;
198
+ try {
199
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
200
+ const fs = require("node:fs");
201
+ fs.unlinkSync(tempDbPath);
202
+ try {
203
+ fs.unlinkSync(tempDbPath + "-wal");
204
+ } catch {
205
+ /* ignore */
206
+ }
207
+ try {
208
+ fs.unlinkSync(tempDbPath + "-shm");
209
+ } catch {
210
+ /* ignore */
211
+ }
212
+ } catch {
213
+ /* ignore cleanup failures */
214
+ }
215
+ });
216
+ }
217
+
218
+ // ─────────────────────────────────────────────────────────────────────────────
219
+ // Server lifecycle
220
+ // ─────────────────────────────────────────────────────────────────────────────
221
+
222
+ async function ensureServer() {
223
+ if (transportState) return transportState;
224
+ if (!transportPromise) {
225
+ transportPromise = createTransport({
226
+ port: configuredPort ?? resolveDebugPort(),
227
+ onConnection(socket) {
228
+ // Start with no subscriptions — client must subscribe explicitly.
229
+ clientStates.set(socket, {
230
+ subscriptions: new Set()
231
+ });
232
+ if (!subscribedPromise) {
233
+ subscribedPromise = new Promise(resolve => {
234
+ resolveSubscribed = resolve;
235
+ });
236
+ }
237
+ if (waitingForConnection) {
238
+ waitingForConnection = false;
239
+ process.stdout.write(" Connected!\n");
240
+ }
241
+ socket.send(JSON.stringify({
242
+ type: "debugger:info",
243
+ version: getAlloyVersion(),
244
+ cwd: getCwd(),
245
+ sourceMapEnabled: process.execArgv.includes("--enable-source-maps")
246
+ }));
247
+ },
248
+ onMessage(raw, socket) {
249
+ const message = raw;
250
+ if (!message || !message.type) return;
251
+ if (message.type === "subscribe") {
252
+ const channels = message.channels;
253
+ const state = clientStates.get(socket);
254
+ if (state && channels && Array.isArray(channels)) {
255
+ const validChannels = channels.filter(ch => ALL_CHANNELS.includes(ch));
256
+ state.subscriptions = new Set(validChannels);
257
+ sendInitialState(socket, validChannels);
258
+ }
259
+ resolveSubscribed?.();
260
+ return;
261
+ }
262
+ if (message.type === "unsubscribe") {
263
+ const channels = message.channels;
264
+ const state = clientStates.get(socket);
265
+ if (state && channels) {
266
+ for (const ch of channels) state.subscriptions.delete(ch);
267
+ }
268
+ return;
269
+ }
270
+ for (const handler of messageHandlers) {
271
+ handler(message);
272
+ }
273
+ },
274
+ onDisconnect(socket) {
275
+ clientStates.delete(socket);
276
+ }
277
+ }).then(state => {
278
+ transportState = state;
279
+
280
+ // Wire up the change notification bus to forward events to subscribed clients
281
+ setChangeListener(event => {
282
+ if (!transportState) return;
283
+
284
+ // Lifecycle signals are broadcast to ALL connected clients
285
+ const signalType = event.data?._signal;
286
+ if (signalType) {
287
+ const payload = JSON.stringify({
288
+ type: signalType
289
+ });
290
+ for (const client of transportState.clients) {
291
+ if (client.readyState === client.OPEN) {
292
+ client.send(payload);
293
+ }
294
+ }
295
+ return;
296
+ }
297
+ const msgType = eventToMessageType(event);
298
+ const message = {
299
+ ...event.data,
300
+ type: msgType
301
+ };
302
+ const payload = JSON.stringify(message);
303
+ for (const [client, clientState] of clientStates) {
304
+ if (client.readyState !== client.OPEN) continue;
305
+ if (clientState.subscriptions.has(event.channel)) {
306
+ client.send(payload);
307
+ }
308
+ }
309
+ });
310
+ if (!loggedDevtoolsLinks) {
311
+ loggedDevtoolsLinks = true;
312
+ // eslint-disable-next-line no-console
313
+ console.log(`Alloy ${getAlloyVersion()}`);
314
+ // eslint-disable-next-line no-console
315
+ console.log(`➜ Debug UI: http://localhost:${state.port}/`);
316
+ // eslint-disable-next-line no-console
317
+ console.log(`➜ Websocket: ws://localhost:${state.port}/`);
318
+ // eslint-disable-next-line no-console
319
+ console.log("");
320
+ waitingForConnection = true;
321
+ process.stdout.write("Waiting for connection...");
322
+ }
323
+ return state;
324
+ });
325
+ }
326
+ return transportPromise;
327
+ }
328
+
329
+ // ─────────────────────────────────────────────────────────────────────────────
330
+ // Public API
331
+ // ─────────────────────────────────────────────────────────────────────────────
332
+
333
+ /**
334
+ * Wait for a devtools client to connect before proceeding.
335
+ *
336
+ * Starts the devtools server if not already running, and blocks until a
337
+ * devtools client connects via WebSocket.
338
+ *
339
+ * @example
340
+ * ```ts
341
+ * import { waitForDevtoolsConnection } from "@alloy-js/core/devtools";
342
+ * import { render } from "@alloy-js/core";
343
+ *
344
+ * await waitForDevtoolsConnection();
345
+ * const tree = render(<MyComponent />);
346
+ * ```
347
+ */
348
+ export async function waitForDevtoolsConnection() {
349
+ devtoolsExplicitlyEnabled = true;
350
+ const server = await ensureServer();
351
+ if (!server.connected) {
352
+ await server.ready;
353
+ }
354
+ // Wait for the client to send its initial subscribe message so that
355
+ // messages emitted during a synchronous render are not dropped.
356
+ if (subscribedPromise) {
357
+ await subscribedPromise;
358
+ }
359
+ }
360
+
361
+ /**
362
+ * Enable devtools and start the server, returning when the server is ready.
363
+ * Use this in tests to enable devtools before connecting a client.
364
+ *
365
+ * @returns Server info with port number
366
+ */
367
+ export async function enableDevtools(options) {
368
+ devtoolsExplicitlyEnabled = true;
369
+ devtoolsInitialized = true;
370
+ if (options?.port !== undefined) {
371
+ configuredPort = options.port;
372
+ }
373
+ await ensureSqliteForDevtools();
374
+ const server = await ensureServer();
375
+ return {
376
+ port: server.port,
377
+ connected: server.connected
378
+ };
379
+ }
380
+
381
+ /**
382
+ * Initialize devtools if ALLOY_DEBUG is set. Called lazily by render functions.
383
+ * Returns immediately if devtools are not enabled or already initialized.
384
+ */
385
+ export async function initDevtoolsIfEnabled() {
386
+ if (devtoolsInitialized) return;
387
+ if (!isDevtoolsEnabled()) return;
388
+ devtoolsInitialized = true;
389
+ await ensureSqliteForDevtools();
390
+ await waitForDevtoolsConnection();
391
+ }
392
+
393
+ /**
394
+ * Start the devtools server and wait for a client connection.
395
+ *
396
+ * @example
397
+ * ```ts
398
+ * const serverInfo = await enableDevtoolsAndConnect({ port: 0 });
399
+ * // ... run your test ...
400
+ * await resetDevtoolsServerForTests();
401
+ * ```
402
+ *
403
+ * @returns Server info once a client has connected
404
+ */
405
+ export async function enableDevtoolsAndConnect(options) {
406
+ const info = await enableDevtools(options);
407
+ if (!info.connected) {
408
+ await transportState.ready;
409
+ }
410
+ return {
411
+ port: transportState.port,
412
+ connected: true
413
+ };
414
+ }
415
+
416
+ // ─────────────────────────────────────────────────────────────────────────────
417
+ // Messaging
418
+ // ─────────────────────────────────────────────────────────────────────────────
419
+
420
+ /** Register a handler for incoming devtools messages. Returns an unsubscribe function. */
421
+ export function registerDevtoolsMessageHandler(handler) {
422
+ messageHandlers.add(handler);
423
+ return () => messageHandlers.delete(handler);
424
+ }
425
+
426
+ /** Throw if devtools are enabled but no client is connected (for sync render). */
427
+ export function assertDevtoolsConnectedForSyncRender() {
428
+ if (!isDevtoolsEnabled()) return;
429
+ if (!transportState || !transportState.connected) {
430
+ throw new Error("ALLOY_DEBUG is set but devtools are not connected. Use renderAsync or wait for the devtools client before rendering.");
431
+ }
432
+ }
433
+
434
+ // ─────────────────────────────────────────────────────────────────────────────
435
+ // Test utilities
436
+ // ─────────────────────────────────────────────────────────────────────────────
437
+
438
+ /** Reset all devtools state. For use in tests only. */
439
+ export async function resetDevtoolsServerForTests() {
440
+ setChangeListener(null);
441
+ clientStates.clear();
442
+ if (transportState) {
443
+ await transportState.close();
444
+ }
445
+ transportState = null;
446
+ transportPromise = null;
447
+ devtoolsExplicitlyEnabled = false;
448
+ devtoolsInitialized = false;
449
+ configuredPort = undefined;
450
+ loggedDevtoolsLinks = false;
451
+ subscribedPromise = null;
452
+ resolveSubscribed = null;
453
+ // Re-read the env var in case tests modified process.env.ALLOY_DEBUG
454
+ refreshDebugState();
455
+ // Close the trace DB so each test starts fresh
456
+ closeTrace();
457
+ }
458
+ //# sourceMappingURL=devtools-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["ALL_CHANNELS","closeTrace","initTrace","isTraceEnabled","queryChannel","setChangeListener","createTransport","getAlloyVersion","transportState","transportPromise","messageHandlers","Set","devtoolsExplicitlyEnabled","devtoolsInitialized","loggedDevtoolsLinks","waitingForConnection","configuredPort","tempDbPath","subscribedPromise","resolveSubscribed","clientStates","Map","eventToMessageType","event","map","render","added","updated","removed","reset","effects","refs","edges","data","edge_type","symbols","scopes","files","directories","diagnostics","errors","lifecycle","scheduler","channel","action","channelToInitialMessageType","row","type","sendInitialState","socket","channels","rows","msgType","undefined","effect_type","msg","send","JSON","stringify","isNodeEnvironment","process","versions","Boolean","node","_envDebugEnabled","env","ALLOY_DEBUG","refreshDebugState","getCwd","cwd","resolveDebugPort","raw","ALLOY_DEBUG_PORT","parsed","Number","parseInt","isNaN","isDevtoolsEnabled","isDevtoolsConnected","connected","getDevtoolsServerInfo","port","ensureSqliteForDevtools","os","path","join","tmpdir","pid","on","fs","require","unlinkSync","ensureServer","onConnection","set","subscriptions","Promise","resolve","stdout","write","version","sourceMapEnabled","execArgv","includes","onMessage","message","state","get","Array","isArray","validChannels","filter","ch","delete","handler","onDisconnect","then","signalType","_signal","payload","client","clients","readyState","OPEN","clientState","has","console","log","waitForDevtoolsConnection","server","ready","enableDevtools","options","initDevtoolsIfEnabled","enableDevtoolsAndConnect","info","registerDevtoolsMessageHandler","add","assertDevtoolsConnectedForSyncRender","Error","resetDevtoolsServerForTests","clear","close"],"sources":["../../../../src/devtools/devtools-server.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
@@ -0,0 +1,114 @@
1
+ /**
2
+ * WebSocket transport for the Alloy devtools server.
3
+ *
4
+ * Handles HTTP serving of the devtools UI and WebSocket connection management.
5
+ * This module is concerned only with the transport layer — session lifecycle
6
+ * is managed by devtools-server.ts.
7
+ */
8
+ import { readFileSync } from "node:fs";
9
+ import { createServer as createHttpServer } from "node:http";
10
+ let cachedAlloyVersion = null;
11
+
12
+ /** Read the @alloy-js/core package version, cached after first call. */
13
+ export function getAlloyVersion() {
14
+ if (cachedAlloyVersion) return cachedAlloyVersion;
15
+ try {
16
+ const pkgUrl = new URL("../../../package.json", import.meta.url);
17
+ const pkg = JSON.parse(readFileSync(pkgUrl, "utf-8"));
18
+ cachedAlloyVersion = pkg.version ?? "0.0.0";
19
+ } catch {
20
+ cachedAlloyVersion = "0.0.0";
21
+ }
22
+ return cachedAlloyVersion;
23
+ }
24
+
25
+ /** Attempt to load the devtools UI HTML from known candidate paths. */
26
+ function loadDevtoolsUiHtml() {
27
+ const candidates = [new URL("../../dist/devtools/index.html", import.meta.url), new URL("../../devtools/index.html", import.meta.url), new URL("../../../devtools/dist/index.html", import.meta.url)];
28
+ for (const candidate of candidates) {
29
+ try {
30
+ return readFileSync(candidate, "utf-8");
31
+ } catch {
32
+ // try next
33
+ }
34
+ }
35
+ return null;
36
+ }
37
+ /**
38
+ * Create the HTTP + WebSocket transport. Returns when the server is listening.
39
+ * Only accepts one concurrent WebSocket connection.
40
+ */
41
+ export async function createTransport(options) {
42
+ const {
43
+ WebSocketServer
44
+ } = await import("ws");
45
+ const devtoolsUiHtml = loadDevtoolsUiHtml();
46
+ const httpServer = createHttpServer((req, res) => {
47
+ const url = req.url ?? "/";
48
+ if (url !== "/" && url !== "/index.html") {
49
+ res.statusCode = 404;
50
+ res.end("Not Found");
51
+ return;
52
+ }
53
+ if (!devtoolsUiHtml) {
54
+ res.statusCode = 404;
55
+ res.end("Not Found");
56
+ return;
57
+ }
58
+ res.statusCode = 200;
59
+ res.setHeader("Content-Type", "text/html; charset=utf-8");
60
+ res.end(devtoolsUiHtml);
61
+ });
62
+ const wss = new WebSocketServer({
63
+ server: httpServer
64
+ });
65
+ await new Promise((resolve, reject) => {
66
+ httpServer.once("listening", resolve);
67
+ httpServer.once("error", reject);
68
+ httpServer.listen(options.port);
69
+ });
70
+ const address = httpServer.address();
71
+ const actualPort = typeof address === "object" && address !== null ? address.port : options.port;
72
+ let resolveReady;
73
+ const ready = new Promise(resolve => {
74
+ resolveReady = resolve;
75
+ });
76
+ const clients = new Set();
77
+ const state = {
78
+ port: actualPort,
79
+ connected: false,
80
+ clients,
81
+ httpServer,
82
+ ready,
83
+ close: async () => {
84
+ await new Promise(resolve => wss.close(() => resolve()));
85
+ await new Promise(resolve => httpServer.close(() => resolve()));
86
+ clients.clear();
87
+ state.connected = false;
88
+ }
89
+ };
90
+ wss.on("connection", socket => {
91
+ if (state.connected) {
92
+ socket.close(1000, "Another devtools client is already connected");
93
+ return;
94
+ }
95
+ clients.add(socket);
96
+ state.connected = true;
97
+ resolveReady?.();
98
+ options.onConnection(socket);
99
+ socket.on("message", data => {
100
+ try {
101
+ options.onMessage(JSON.parse(String(data)), socket);
102
+ } catch {
103
+ // ignore malformed messages
104
+ }
105
+ });
106
+ socket.on("close", () => {
107
+ clients.delete(socket);
108
+ state.connected = clients.size > 0;
109
+ options.onDisconnect(socket);
110
+ });
111
+ });
112
+ return state;
113
+ }
114
+ //# sourceMappingURL=devtools-transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["readFileSync","createServer","createHttpServer","cachedAlloyVersion","getAlloyVersion","pkgUrl","URL","import","meta","url","pkg","JSON","parse","version","loadDevtoolsUiHtml","candidates","candidate","createTransport","options","WebSocketServer","devtoolsUiHtml","httpServer","req","res","statusCode","end","setHeader","wss","server","Promise","resolve","reject","once","listen","port","address","actualPort","resolveReady","ready","clients","Set","state","connected","close","clear","on","socket","add","onConnection","data","onMessage","String","delete","size","onDisconnect"],"sources":["../../../../src/devtools/devtools-transport.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
@@ -0,0 +1,2 @@
1
+ export { enableDevtools, enableDevtoolsAndConnect, resetDevtoolsServerForTests, waitForDevtoolsConnection } from "./devtools/devtools-server.browser.js";
2
+ //# sourceMappingURL=devtools-entry.browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["enableDevtools","enableDevtoolsAndConnect","resetDevtoolsServerForTests","waitForDevtoolsConnection"],"sources":["../../../src/devtools-entry.browser.ts"],"sourcesContent":[null],"mappings":"AAsCA,SACEA,cAAc,EACdC,wBAAwB,EACxBC,2BAA2B,EAC3BC,yBAAyB,QACpB,uCAAuC","ignoreList":[]}
@@ -0,0 +1,2 @@
1
+ export { enableDevtools, enableDevtoolsAndConnect, resetDevtoolsServerForTests, waitForDevtoolsConnection } from "./devtools/devtools-server.js";
2
+ //# sourceMappingURL=devtools-entry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["enableDevtools","enableDevtoolsAndConnect","resetDevtoolsServerForTests","waitForDevtoolsConnection"],"sources":["../../../src/devtools-entry.ts"],"sourcesContent":[null],"mappings":"AAsCA,SACEA,cAAc,EACdC,wBAAwB,EACxBC,2BAA2B,EAC3BC,yBAAyB,QACpB,+BAA+B","ignoreList":[]}