@shadow-js/web 0.0.0-stage → 1.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 (611) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/LICENSE +21 -0
  3. package/README.md +190 -2
  4. package/dist/dev/attributes.d.ts +90 -0
  5. package/dist/dev/attributes.js +196 -0
  6. package/dist/dev/attributes.js.map +1 -0
  7. package/dist/dev/autofocus.d.ts +32 -0
  8. package/dist/dev/autofocus.js +45 -0
  9. package/dist/dev/autofocus.js.map +1 -0
  10. package/dist/dev/class-style.d.ts +89 -0
  11. package/dist/dev/class-style.js +197 -0
  12. package/dist/dev/class-style.js.map +1 -0
  13. package/dist/dev/component.d.ts +23 -0
  14. package/dist/dev/component.js +42 -0
  15. package/dist/dev/component.js.map +1 -0
  16. package/dist/dev/control-flow/activity.d.ts +58 -0
  17. package/dist/dev/control-flow/activity.js +136 -0
  18. package/dist/dev/control-flow/activity.js.map +1 -0
  19. package/dist/dev/control-flow/branch.js +104 -0
  20. package/dist/dev/control-flow/branch.js.map +1 -0
  21. package/dist/dev/control-flow/client-only.d.ts +48 -0
  22. package/dist/dev/control-flow/client-only.js +50 -0
  23. package/dist/dev/control-flow/client-only.js.map +1 -0
  24. package/dist/dev/control-flow/dynamic.d.ts +82 -0
  25. package/dist/dev/control-flow/dynamic.js +134 -0
  26. package/dist/dev/control-flow/dynamic.js.map +1 -0
  27. package/dist/dev/control-flow/error-boundary.d.ts +72 -0
  28. package/dist/dev/control-flow/error-boundary.js +115 -0
  29. package/dist/dev/control-flow/error-boundary.js.map +1 -0
  30. package/dist/dev/control-flow/for.d.ts +80 -0
  31. package/dist/dev/control-flow/for.js +23 -0
  32. package/dist/dev/control-flow/for.js.map +1 -0
  33. package/dist/dev/control-flow/fragment.d.ts +38 -0
  34. package/dist/dev/control-flow/fragment.js +31 -0
  35. package/dist/dev/control-flow/fragment.js.map +1 -0
  36. package/dist/dev/control-flow/hot-link.js +64 -0
  37. package/dist/dev/control-flow/hot-link.js.map +1 -0
  38. package/dist/dev/control-flow/index-list.d.ts +48 -0
  39. package/dist/dev/control-flow/index-list.js +31 -0
  40. package/dist/dev/control-flow/index-list.js.map +1 -0
  41. package/dist/dev/control-flow/index.d.ts +15 -0
  42. package/dist/dev/control-flow/lazy.d.ts +58 -0
  43. package/dist/dev/control-flow/lazy.js +64 -0
  44. package/dist/dev/control-flow/lazy.js.map +1 -0
  45. package/dist/dev/control-flow/no-hydration.d.ts +39 -0
  46. package/dist/dev/control-flow/no-hydration.js +58 -0
  47. package/dist/dev/control-flow/no-hydration.js.map +1 -0
  48. package/dist/dev/control-flow/portal.d.ts +69 -0
  49. package/dist/dev/control-flow/portal.js +134 -0
  50. package/dist/dev/control-flow/portal.js.map +1 -0
  51. package/dist/dev/control-flow/root-errors.d.ts +25 -0
  52. package/dist/dev/control-flow/root-errors.js +33 -0
  53. package/dist/dev/control-flow/root-errors.js.map +1 -0
  54. package/dist/dev/control-flow/show.d.ts +101 -0
  55. package/dist/dev/control-flow/show.js +18 -0
  56. package/dist/dev/control-flow/show.js.map +1 -0
  57. package/dist/dev/control-flow/suspense-list.d.ts +65 -0
  58. package/dist/dev/control-flow/suspense-list.js +105 -0
  59. package/dist/dev/control-flow/suspense-list.js.map +1 -0
  60. package/dist/dev/control-flow/suspense.d.ts +53 -0
  61. package/dist/dev/control-flow/suspense.js +102 -0
  62. package/dist/dev/control-flow/suspense.js.map +1 -0
  63. package/dist/dev/control-flow/switch.d.ts +85 -0
  64. package/dist/dev/control-flow/switch.js +90 -0
  65. package/dist/dev/control-flow/switch.js.map +1 -0
  66. package/dist/dev/derived.d.ts +52 -0
  67. package/dist/dev/derived.js +34 -0
  68. package/dist/dev/derived.js.map +1 -0
  69. package/dist/dev/element.d.ts +40 -0
  70. package/dist/dev/element.js +105 -0
  71. package/dist/dev/element.js.map +1 -0
  72. package/dist/dev/events.d.ts +87 -0
  73. package/dist/dev/events.js +265 -0
  74. package/dist/dev/events.js.map +1 -0
  75. package/dist/dev/extend.d.ts +12 -0
  76. package/dist/dev/extend.js +12 -0
  77. package/dist/dev/head/components.d.ts +137 -0
  78. package/dist/dev/head/components.js +170 -0
  79. package/dist/dev/head/components.js.map +1 -0
  80. package/dist/dev/head/registry.js +68 -0
  81. package/dist/dev/head/registry.js.map +1 -0
  82. package/dist/dev/head/server-head.d.ts +54 -0
  83. package/dist/dev/head/server-head.js +76 -0
  84. package/dist/dev/head/server-head.js.map +1 -0
  85. package/dist/dev/head/sink.js +96 -0
  86. package/dist/dev/head/sink.js.map +1 -0
  87. package/dist/dev/head/use-head.d.ts +35 -0
  88. package/dist/dev/head/use-head.js +84 -0
  89. package/dist/dev/head/use-head.js.map +1 -0
  90. package/dist/dev/head/validate.d.ts +85 -0
  91. package/dist/dev/head/validate.js +268 -0
  92. package/dist/dev/head/validate.js.map +1 -0
  93. package/dist/dev/hmr.d.ts +82 -0
  94. package/dist/dev/hmr.js +124 -0
  95. package/dist/dev/hmr.js.map +1 -0
  96. package/dist/dev/hydration.d.ts +61 -0
  97. package/dist/dev/hydration.js +120 -0
  98. package/dist/dev/hydration.js.map +1 -0
  99. package/dist/dev/index.d.ts +45 -0
  100. package/dist/dev/index.js +34 -0
  101. package/dist/dev/insert.d.ts +97 -0
  102. package/dist/dev/insert.js +357 -0
  103. package/dist/dev/insert.js.map +1 -0
  104. package/dist/dev/internal/claim.d.ts +106 -0
  105. package/dist/dev/internal/claim.js +357 -0
  106. package/dist/dev/internal/claim.js.map +1 -0
  107. package/dist/dev/internal/css-units.js +26 -0
  108. package/dist/dev/internal/css-units.js.map +1 -0
  109. package/dist/dev/internal/diagnostics.d.ts +30 -0
  110. package/dist/dev/internal/diagnostics.js +38 -0
  111. package/dist/dev/internal/diagnostics.js.map +1 -0
  112. package/dist/dev/internal/early-events.js +76 -0
  113. package/dist/dev/internal/early-events.js.map +1 -0
  114. package/dist/dev/internal/hydration-hooks.d.ts +43 -0
  115. package/dist/dev/internal/hydration-hooks.js +27 -0
  116. package/dist/dev/internal/hydration-hooks.js.map +1 -0
  117. package/dist/dev/internal/hydration-scope.d.ts +131 -0
  118. package/dist/dev/internal/hydration-scope.js +156 -0
  119. package/dist/dev/internal/hydration-scope.js.map +1 -0
  120. package/dist/dev/internal/names.d.ts +33 -0
  121. package/dist/dev/internal/names.js +35 -0
  122. package/dist/dev/internal/names.js.map +1 -0
  123. package/dist/dev/internal/portal-context.d.ts +39 -0
  124. package/dist/dev/internal/portal-context.js +28 -0
  125. package/dist/dev/internal/portal-context.js.map +1 -0
  126. package/dist/dev/internal/react-names.js +116 -0
  127. package/dist/dev/internal/react-names.js.map +1 -0
  128. package/dist/dev/internal/reconcile.d.ts +40 -0
  129. package/dist/dev/internal/reconcile.js +122 -0
  130. package/dist/dev/internal/reconcile.js.map +1 -0
  131. package/dist/dev/internal/stream-context.d.ts +47 -0
  132. package/dist/dev/internal/stream-context.js +23 -0
  133. package/dist/dev/internal/stream-context.js.map +1 -0
  134. package/dist/dev/jsx/aria.d.ts +72 -0
  135. package/dist/dev/jsx/component.d.ts +89 -0
  136. package/dist/dev/jsx/events.d.ts +364 -0
  137. package/dist/dev/jsx/global.d.ts +211 -0
  138. package/dist/dev/jsx/html.d.ts +879 -0
  139. package/dist/dev/jsx/intrinsic.d.ts +59 -0
  140. package/dist/dev/jsx/mathml.d.ts +186 -0
  141. package/dist/dev/jsx/svg.d.ts +607 -0
  142. package/dist/dev/jsx/types.d.ts +176 -0
  143. package/dist/dev/jsx-dev-runtime.d.ts +10 -0
  144. package/dist/dev/jsx-dev-runtime.js +0 -0
  145. package/dist/dev/jsx-runtime.d.ts +94 -0
  146. package/dist/dev/jsx-runtime.js +0 -0
  147. package/dist/dev/reactive.d.ts +110 -0
  148. package/dist/dev/reactive.js +85 -0
  149. package/dist/dev/reactive.js.map +1 -0
  150. package/dist/dev/render.d.ts +36 -0
  151. package/dist/dev/render.js +52 -0
  152. package/dist/dev/render.js.map +1 -0
  153. package/dist/dev/resource-hints.d.ts +145 -0
  154. package/dist/dev/resource-hints.js +200 -0
  155. package/dist/dev/resource-hints.js.map +1 -0
  156. package/dist/dev/select-value.d.ts +24 -0
  157. package/dist/dev/select-value.js +51 -0
  158. package/dist/dev/select-value.js.map +1 -0
  159. package/dist/dev/server/attributes.d.ts +33 -0
  160. package/dist/dev/server/attributes.js +155 -0
  161. package/dist/dev/server/attributes.js.map +1 -0
  162. package/dist/dev/server/class-style.d.ts +46 -0
  163. package/dist/dev/server/class-style.js +173 -0
  164. package/dist/dev/server/class-style.js.map +1 -0
  165. package/dist/dev/server/component.d.ts +42 -0
  166. package/dist/dev/server/component.js +72 -0
  167. package/dist/dev/server/component.js.map +1 -0
  168. package/dist/dev/server/derived.d.ts +41 -0
  169. package/dist/dev/server/derived.js +26 -0
  170. package/dist/dev/server/derived.js.map +1 -0
  171. package/dist/dev/server/element.d.ts +89 -0
  172. package/dist/dev/server/element.js +216 -0
  173. package/dist/dev/server/element.js.map +1 -0
  174. package/dist/dev/server/errors.js +26 -0
  175. package/dist/dev/server/errors.js.map +1 -0
  176. package/dist/dev/server/escape.d.ts +30 -0
  177. package/dist/dev/server/escape.js +119 -0
  178. package/dist/dev/server/escape.js.map +1 -0
  179. package/dist/dev/server/form-controls.d.ts +50 -0
  180. package/dist/dev/server/form-controls.js +193 -0
  181. package/dist/dev/server/form-controls.js.map +1 -0
  182. package/dist/dev/server/hydration-script.d.ts +65 -0
  183. package/dist/dev/server/hydration-script.js +59 -0
  184. package/dist/dev/server/hydration-script.js.map +1 -0
  185. package/dist/dev/server/index.d.ts +16 -0
  186. package/dist/dev/server/index.js +16 -0
  187. package/dist/dev/server/node.d.ts +13 -0
  188. package/dist/dev/server/node.js +21 -0
  189. package/dist/dev/server/node.js.map +1 -0
  190. package/dist/dev/server/portals.d.ts +46 -0
  191. package/dist/dev/server/portals.js +99 -0
  192. package/dist/dev/server/portals.js.map +1 -0
  193. package/dist/dev/server/render.d.ts +129 -0
  194. package/dist/dev/server/render.js +256 -0
  195. package/dist/dev/server/render.js.map +1 -0
  196. package/dist/dev/server/serialize.d.ts +45 -0
  197. package/dist/dev/server/serialize.js +315 -0
  198. package/dist/dev/server/serialize.js.map +1 -0
  199. package/dist/dev/server/stream.d.ts +94 -0
  200. package/dist/dev/server/stream.js +235 -0
  201. package/dist/dev/server/stream.js.map +1 -0
  202. package/dist/dev/server.d.ts +16 -0
  203. package/dist/dev/server.js +16 -0
  204. package/dist/dev/spread.d.ts +49 -0
  205. package/dist/dev/spread.js +296 -0
  206. package/dist/dev/spread.js.map +1 -0
  207. package/dist/dev/template.d.ts +26 -0
  208. package/dist/dev/template.js +120 -0
  209. package/dist/dev/template.js.map +1 -0
  210. package/dist/dev/view-transition.d.ts +97 -0
  211. package/dist/dev/view-transition.js +121 -0
  212. package/dist/dev/view-transition.js.map +1 -0
  213. package/dist/prod/attributes.js +2 -0
  214. package/dist/prod/attributes.js.map +1 -0
  215. package/dist/prod/autofocus.js +2 -0
  216. package/dist/prod/autofocus.js.map +1 -0
  217. package/dist/prod/class-style.js +2 -0
  218. package/dist/prod/class-style.js.map +1 -0
  219. package/dist/prod/component.js +2 -0
  220. package/dist/prod/component.js.map +1 -0
  221. package/dist/prod/control-flow/activity.js +2 -0
  222. package/dist/prod/control-flow/activity.js.map +1 -0
  223. package/dist/prod/control-flow/branch.js +2 -0
  224. package/dist/prod/control-flow/branch.js.map +1 -0
  225. package/dist/prod/control-flow/client-only.js +2 -0
  226. package/dist/prod/control-flow/client-only.js.map +1 -0
  227. package/dist/prod/control-flow/dynamic.js +2 -0
  228. package/dist/prod/control-flow/dynamic.js.map +1 -0
  229. package/dist/prod/control-flow/error-boundary.js +2 -0
  230. package/dist/prod/control-flow/error-boundary.js.map +1 -0
  231. package/dist/prod/control-flow/for.js +2 -0
  232. package/dist/prod/control-flow/for.js.map +1 -0
  233. package/dist/prod/control-flow/fragment.js +2 -0
  234. package/dist/prod/control-flow/fragment.js.map +1 -0
  235. package/dist/prod/control-flow/hot-link.js +2 -0
  236. package/dist/prod/control-flow/hot-link.js.map +1 -0
  237. package/dist/prod/control-flow/index-list.js +2 -0
  238. package/dist/prod/control-flow/index-list.js.map +1 -0
  239. package/dist/prod/control-flow/lazy.js +2 -0
  240. package/dist/prod/control-flow/lazy.js.map +1 -0
  241. package/dist/prod/control-flow/no-hydration.js +2 -0
  242. package/dist/prod/control-flow/no-hydration.js.map +1 -0
  243. package/dist/prod/control-flow/portal.js +2 -0
  244. package/dist/prod/control-flow/portal.js.map +1 -0
  245. package/dist/prod/control-flow/root-errors.js +2 -0
  246. package/dist/prod/control-flow/root-errors.js.map +1 -0
  247. package/dist/prod/control-flow/show.js +2 -0
  248. package/dist/prod/control-flow/show.js.map +1 -0
  249. package/dist/prod/control-flow/suspense-list.js +2 -0
  250. package/dist/prod/control-flow/suspense-list.js.map +1 -0
  251. package/dist/prod/control-flow/suspense.js +2 -0
  252. package/dist/prod/control-flow/suspense.js.map +1 -0
  253. package/dist/prod/control-flow/switch.js +2 -0
  254. package/dist/prod/control-flow/switch.js.map +1 -0
  255. package/dist/prod/derived.js +2 -0
  256. package/dist/prod/derived.js.map +1 -0
  257. package/dist/prod/element.js +2 -0
  258. package/dist/prod/element.js.map +1 -0
  259. package/dist/prod/events.js +2 -0
  260. package/dist/prod/events.js.map +1 -0
  261. package/dist/prod/extend.js +1 -0
  262. package/dist/prod/head/components.js +2 -0
  263. package/dist/prod/head/components.js.map +1 -0
  264. package/dist/prod/head/registry.js +2 -0
  265. package/dist/prod/head/registry.js.map +1 -0
  266. package/dist/prod/head/server-head.js +2 -0
  267. package/dist/prod/head/server-head.js.map +1 -0
  268. package/dist/prod/head/sink.js +2 -0
  269. package/dist/prod/head/sink.js.map +1 -0
  270. package/dist/prod/head/use-head.js +2 -0
  271. package/dist/prod/head/use-head.js.map +1 -0
  272. package/dist/prod/head/validate.js +2 -0
  273. package/dist/prod/head/validate.js.map +1 -0
  274. package/dist/prod/hmr.js +2 -0
  275. package/dist/prod/hmr.js.map +1 -0
  276. package/dist/prod/hydration.js +2 -0
  277. package/dist/prod/hydration.js.map +1 -0
  278. package/dist/prod/index.js +1 -0
  279. package/dist/prod/insert.js +2 -0
  280. package/dist/prod/insert.js.map +1 -0
  281. package/dist/prod/internal/claim.js +2 -0
  282. package/dist/prod/internal/claim.js.map +1 -0
  283. package/dist/prod/internal/css-units.js +2 -0
  284. package/dist/prod/internal/css-units.js.map +1 -0
  285. package/dist/prod/internal/diagnostics.js +2 -0
  286. package/dist/prod/internal/diagnostics.js.map +1 -0
  287. package/dist/prod/internal/early-events.js +2 -0
  288. package/dist/prod/internal/early-events.js.map +1 -0
  289. package/dist/prod/internal/hydration-hooks.js +2 -0
  290. package/dist/prod/internal/hydration-hooks.js.map +1 -0
  291. package/dist/prod/internal/hydration-scope.js +2 -0
  292. package/dist/prod/internal/hydration-scope.js.map +1 -0
  293. package/dist/prod/internal/names.js +2 -0
  294. package/dist/prod/internal/names.js.map +1 -0
  295. package/dist/prod/internal/portal-context.js +2 -0
  296. package/dist/prod/internal/portal-context.js.map +1 -0
  297. package/dist/prod/internal/react-names.js +2 -0
  298. package/dist/prod/internal/react-names.js.map +1 -0
  299. package/dist/prod/internal/reconcile.js +2 -0
  300. package/dist/prod/internal/reconcile.js.map +1 -0
  301. package/dist/prod/internal/stream-context.js +2 -0
  302. package/dist/prod/internal/stream-context.js.map +1 -0
  303. package/dist/prod/jsx-dev-runtime.js +0 -0
  304. package/dist/prod/jsx-runtime.js +0 -0
  305. package/dist/prod/reactive.js +2 -0
  306. package/dist/prod/reactive.js.map +1 -0
  307. package/dist/prod/render.js +2 -0
  308. package/dist/prod/render.js.map +1 -0
  309. package/dist/prod/resource-hints.js +2 -0
  310. package/dist/prod/resource-hints.js.map +1 -0
  311. package/dist/prod/select-value.js +2 -0
  312. package/dist/prod/select-value.js.map +1 -0
  313. package/dist/prod/server/attributes.js +2 -0
  314. package/dist/prod/server/attributes.js.map +1 -0
  315. package/dist/prod/server/class-style.js +2 -0
  316. package/dist/prod/server/class-style.js.map +1 -0
  317. package/dist/prod/server/component.js +2 -0
  318. package/dist/prod/server/component.js.map +1 -0
  319. package/dist/prod/server/derived.js +2 -0
  320. package/dist/prod/server/derived.js.map +1 -0
  321. package/dist/prod/server/element.js +2 -0
  322. package/dist/prod/server/element.js.map +1 -0
  323. package/dist/prod/server/errors.js +2 -0
  324. package/dist/prod/server/errors.js.map +1 -0
  325. package/dist/prod/server/escape.js +2 -0
  326. package/dist/prod/server/escape.js.map +1 -0
  327. package/dist/prod/server/form-controls.js +3 -0
  328. package/dist/prod/server/form-controls.js.map +1 -0
  329. package/dist/prod/server/hydration-script.js +2 -0
  330. package/dist/prod/server/hydration-script.js.map +1 -0
  331. package/dist/prod/server/index.js +1 -0
  332. package/dist/prod/server/node.js +2 -0
  333. package/dist/prod/server/node.js.map +1 -0
  334. package/dist/prod/server/portals.js +2 -0
  335. package/dist/prod/server/portals.js.map +1 -0
  336. package/dist/prod/server/render.js +2 -0
  337. package/dist/prod/server/render.js.map +1 -0
  338. package/dist/prod/server/serialize.js +2 -0
  339. package/dist/prod/server/serialize.js.map +1 -0
  340. package/dist/prod/server/stream.js +2 -0
  341. package/dist/prod/server/stream.js.map +1 -0
  342. package/dist/prod/server.js +1 -0
  343. package/dist/prod/spread.js +2 -0
  344. package/dist/prod/spread.js.map +1 -0
  345. package/dist/prod/template.js +2 -0
  346. package/dist/prod/template.js.map +1 -0
  347. package/dist/prod/view-transition.js +2 -0
  348. package/dist/prod/view-transition.js.map +1 -0
  349. package/dist/server/attributes.js +2 -0
  350. package/dist/server/attributes.js.map +1 -0
  351. package/dist/server/autofocus.js +2 -0
  352. package/dist/server/autofocus.js.map +1 -0
  353. package/dist/server/class-style.js +2 -0
  354. package/dist/server/class-style.js.map +1 -0
  355. package/dist/server/component.js +2 -0
  356. package/dist/server/component.js.map +1 -0
  357. package/dist/server/control-flow/activity.js +2 -0
  358. package/dist/server/control-flow/activity.js.map +1 -0
  359. package/dist/server/control-flow/branch.js +2 -0
  360. package/dist/server/control-flow/branch.js.map +1 -0
  361. package/dist/server/control-flow/client-only.js +2 -0
  362. package/dist/server/control-flow/client-only.js.map +1 -0
  363. package/dist/server/control-flow/dynamic.js +2 -0
  364. package/dist/server/control-flow/dynamic.js.map +1 -0
  365. package/dist/server/control-flow/error-boundary.js +2 -0
  366. package/dist/server/control-flow/error-boundary.js.map +1 -0
  367. package/dist/server/control-flow/for.js +2 -0
  368. package/dist/server/control-flow/for.js.map +1 -0
  369. package/dist/server/control-flow/fragment.js +2 -0
  370. package/dist/server/control-flow/fragment.js.map +1 -0
  371. package/dist/server/control-flow/index-list.js +2 -0
  372. package/dist/server/control-flow/index-list.js.map +1 -0
  373. package/dist/server/control-flow/lazy.js +2 -0
  374. package/dist/server/control-flow/lazy.js.map +1 -0
  375. package/dist/server/control-flow/no-hydration.js +2 -0
  376. package/dist/server/control-flow/no-hydration.js.map +1 -0
  377. package/dist/server/control-flow/portal.js +2 -0
  378. package/dist/server/control-flow/portal.js.map +1 -0
  379. package/dist/server/control-flow/root-errors.js +2 -0
  380. package/dist/server/control-flow/root-errors.js.map +1 -0
  381. package/dist/server/control-flow/show.js +2 -0
  382. package/dist/server/control-flow/show.js.map +1 -0
  383. package/dist/server/control-flow/suspense-list.js +2 -0
  384. package/dist/server/control-flow/suspense-list.js.map +1 -0
  385. package/dist/server/control-flow/suspense.js +2 -0
  386. package/dist/server/control-flow/suspense.js.map +1 -0
  387. package/dist/server/control-flow/switch.js +2 -0
  388. package/dist/server/control-flow/switch.js.map +1 -0
  389. package/dist/server/derived.js +2 -0
  390. package/dist/server/derived.js.map +1 -0
  391. package/dist/server/element.js +2 -0
  392. package/dist/server/element.js.map +1 -0
  393. package/dist/server/events.js +2 -0
  394. package/dist/server/events.js.map +1 -0
  395. package/dist/server/extend.js +1 -0
  396. package/dist/server/head/components.js +2 -0
  397. package/dist/server/head/components.js.map +1 -0
  398. package/dist/server/head/registry.js +2 -0
  399. package/dist/server/head/registry.js.map +1 -0
  400. package/dist/server/head/server-head.js +2 -0
  401. package/dist/server/head/server-head.js.map +1 -0
  402. package/dist/server/head/sink.js +2 -0
  403. package/dist/server/head/sink.js.map +1 -0
  404. package/dist/server/head/use-head.js +2 -0
  405. package/dist/server/head/use-head.js.map +1 -0
  406. package/dist/server/head/validate.js +2 -0
  407. package/dist/server/head/validate.js.map +1 -0
  408. package/dist/server/hydration.js +2 -0
  409. package/dist/server/hydration.js.map +1 -0
  410. package/dist/server/index.js +1 -0
  411. package/dist/server/insert.js +2 -0
  412. package/dist/server/insert.js.map +1 -0
  413. package/dist/server/internal/claim.js +2 -0
  414. package/dist/server/internal/claim.js.map +1 -0
  415. package/dist/server/internal/css-units.js +2 -0
  416. package/dist/server/internal/css-units.js.map +1 -0
  417. package/dist/server/internal/diagnostics.js +2 -0
  418. package/dist/server/internal/diagnostics.js.map +1 -0
  419. package/dist/server/internal/early-events.js +2 -0
  420. package/dist/server/internal/early-events.js.map +1 -0
  421. package/dist/server/internal/hydration-hooks.js +2 -0
  422. package/dist/server/internal/hydration-hooks.js.map +1 -0
  423. package/dist/server/internal/hydration-scope.js +2 -0
  424. package/dist/server/internal/hydration-scope.js.map +1 -0
  425. package/dist/server/internal/names.js +2 -0
  426. package/dist/server/internal/names.js.map +1 -0
  427. package/dist/server/internal/portal-context.js +2 -0
  428. package/dist/server/internal/portal-context.js.map +1 -0
  429. package/dist/server/internal/react-names.js +2 -0
  430. package/dist/server/internal/react-names.js.map +1 -0
  431. package/dist/server/internal/reconcile.js +2 -0
  432. package/dist/server/internal/reconcile.js.map +1 -0
  433. package/dist/server/internal/stream-context.js +2 -0
  434. package/dist/server/internal/stream-context.js.map +1 -0
  435. package/dist/server/reactive.js +2 -0
  436. package/dist/server/reactive.js.map +1 -0
  437. package/dist/server/render.js +2 -0
  438. package/dist/server/render.js.map +1 -0
  439. package/dist/server/resource-hints.js +2 -0
  440. package/dist/server/resource-hints.js.map +1 -0
  441. package/dist/server/select-value.js +2 -0
  442. package/dist/server/select-value.js.map +1 -0
  443. package/dist/server/server/attributes.js +2 -0
  444. package/dist/server/server/attributes.js.map +1 -0
  445. package/dist/server/server/class-style.js +2 -0
  446. package/dist/server/server/class-style.js.map +1 -0
  447. package/dist/server/server/component.js +2 -0
  448. package/dist/server/server/component.js.map +1 -0
  449. package/dist/server/server/derived.js +2 -0
  450. package/dist/server/server/derived.js.map +1 -0
  451. package/dist/server/server/element.js +2 -0
  452. package/dist/server/server/element.js.map +1 -0
  453. package/dist/server/server/errors.js +2 -0
  454. package/dist/server/server/errors.js.map +1 -0
  455. package/dist/server/server/escape.js +2 -0
  456. package/dist/server/server/escape.js.map +1 -0
  457. package/dist/server/server/form-controls.js +3 -0
  458. package/dist/server/server/form-controls.js.map +1 -0
  459. package/dist/server/server/hydration-script.js +2 -0
  460. package/dist/server/server/hydration-script.js.map +1 -0
  461. package/dist/server/server/index.js +1 -0
  462. package/dist/server/server/node.js +2 -0
  463. package/dist/server/server/node.js.map +1 -0
  464. package/dist/server/server/portals.js +2 -0
  465. package/dist/server/server/portals.js.map +1 -0
  466. package/dist/server/server/render.js +2 -0
  467. package/dist/server/server/render.js.map +1 -0
  468. package/dist/server/server/serialize.js +2 -0
  469. package/dist/server/server/serialize.js.map +1 -0
  470. package/dist/server/server/stream.js +2 -0
  471. package/dist/server/server/stream.js.map +1 -0
  472. package/dist/server/server.js +1 -0
  473. package/dist/server/spread.js +2 -0
  474. package/dist/server/spread.js.map +1 -0
  475. package/dist/server/template.js +2 -0
  476. package/dist/server/template.js.map +1 -0
  477. package/dist/server/view-transition.js +2 -0
  478. package/dist/server/view-transition.js.map +1 -0
  479. package/dist/server-dev/attributes.js +196 -0
  480. package/dist/server-dev/attributes.js.map +1 -0
  481. package/dist/server-dev/autofocus.js +45 -0
  482. package/dist/server-dev/autofocus.js.map +1 -0
  483. package/dist/server-dev/class-style.js +197 -0
  484. package/dist/server-dev/class-style.js.map +1 -0
  485. package/dist/server-dev/component.js +42 -0
  486. package/dist/server-dev/component.js.map +1 -0
  487. package/dist/server-dev/control-flow/activity.js +41 -0
  488. package/dist/server-dev/control-flow/activity.js.map +1 -0
  489. package/dist/server-dev/control-flow/branch.js +104 -0
  490. package/dist/server-dev/control-flow/branch.js.map +1 -0
  491. package/dist/server-dev/control-flow/client-only.js +50 -0
  492. package/dist/server-dev/control-flow/client-only.js.map +1 -0
  493. package/dist/server-dev/control-flow/dynamic.js +106 -0
  494. package/dist/server-dev/control-flow/dynamic.js.map +1 -0
  495. package/dist/server-dev/control-flow/error-boundary.js +115 -0
  496. package/dist/server-dev/control-flow/error-boundary.js.map +1 -0
  497. package/dist/server-dev/control-flow/for.js +23 -0
  498. package/dist/server-dev/control-flow/for.js.map +1 -0
  499. package/dist/server-dev/control-flow/fragment.js +31 -0
  500. package/dist/server-dev/control-flow/fragment.js.map +1 -0
  501. package/dist/server-dev/control-flow/hot-link.js +57 -0
  502. package/dist/server-dev/control-flow/hot-link.js.map +1 -0
  503. package/dist/server-dev/control-flow/index-list.js +31 -0
  504. package/dist/server-dev/control-flow/index-list.js.map +1 -0
  505. package/dist/server-dev/control-flow/lazy.js +64 -0
  506. package/dist/server-dev/control-flow/lazy.js.map +1 -0
  507. package/dist/server-dev/control-flow/no-hydration.js +40 -0
  508. package/dist/server-dev/control-flow/no-hydration.js.map +1 -0
  509. package/dist/server-dev/control-flow/portal.js +134 -0
  510. package/dist/server-dev/control-flow/portal.js.map +1 -0
  511. package/dist/server-dev/control-flow/root-errors.js +33 -0
  512. package/dist/server-dev/control-flow/root-errors.js.map +1 -0
  513. package/dist/server-dev/control-flow/show.js +18 -0
  514. package/dist/server-dev/control-flow/show.js.map +1 -0
  515. package/dist/server-dev/control-flow/suspense-list.js +100 -0
  516. package/dist/server-dev/control-flow/suspense-list.js.map +1 -0
  517. package/dist/server-dev/control-flow/suspense.js +119 -0
  518. package/dist/server-dev/control-flow/suspense.js.map +1 -0
  519. package/dist/server-dev/control-flow/switch.js +90 -0
  520. package/dist/server-dev/control-flow/switch.js.map +1 -0
  521. package/dist/server-dev/derived.js +34 -0
  522. package/dist/server-dev/derived.js.map +1 -0
  523. package/dist/server-dev/element.js +66 -0
  524. package/dist/server-dev/element.js.map +1 -0
  525. package/dist/server-dev/events.js +265 -0
  526. package/dist/server-dev/events.js.map +1 -0
  527. package/dist/server-dev/extend.js +12 -0
  528. package/dist/server-dev/head/components.js +170 -0
  529. package/dist/server-dev/head/components.js.map +1 -0
  530. package/dist/server-dev/head/registry.js +68 -0
  531. package/dist/server-dev/head/registry.js.map +1 -0
  532. package/dist/server-dev/head/server-head.js +76 -0
  533. package/dist/server-dev/head/server-head.js.map +1 -0
  534. package/dist/server-dev/head/sink.js +96 -0
  535. package/dist/server-dev/head/sink.js.map +1 -0
  536. package/dist/server-dev/head/use-head.js +84 -0
  537. package/dist/server-dev/head/use-head.js.map +1 -0
  538. package/dist/server-dev/head/validate.js +268 -0
  539. package/dist/server-dev/head/validate.js.map +1 -0
  540. package/dist/server-dev/hydration.js +120 -0
  541. package/dist/server-dev/hydration.js.map +1 -0
  542. package/dist/server-dev/index.js +34 -0
  543. package/dist/server-dev/insert.js +357 -0
  544. package/dist/server-dev/insert.js.map +1 -0
  545. package/dist/server-dev/internal/claim.js +357 -0
  546. package/dist/server-dev/internal/claim.js.map +1 -0
  547. package/dist/server-dev/internal/css-units.js +26 -0
  548. package/dist/server-dev/internal/css-units.js.map +1 -0
  549. package/dist/server-dev/internal/diagnostics.js +38 -0
  550. package/dist/server-dev/internal/diagnostics.js.map +1 -0
  551. package/dist/server-dev/internal/early-events.js +76 -0
  552. package/dist/server-dev/internal/early-events.js.map +1 -0
  553. package/dist/server-dev/internal/hydration-hooks.js +27 -0
  554. package/dist/server-dev/internal/hydration-hooks.js.map +1 -0
  555. package/dist/server-dev/internal/hydration-scope.js +156 -0
  556. package/dist/server-dev/internal/hydration-scope.js.map +1 -0
  557. package/dist/server-dev/internal/names.js +35 -0
  558. package/dist/server-dev/internal/names.js.map +1 -0
  559. package/dist/server-dev/internal/portal-context.js +28 -0
  560. package/dist/server-dev/internal/portal-context.js.map +1 -0
  561. package/dist/server-dev/internal/react-names.js +116 -0
  562. package/dist/server-dev/internal/react-names.js.map +1 -0
  563. package/dist/server-dev/internal/reconcile.js +122 -0
  564. package/dist/server-dev/internal/reconcile.js.map +1 -0
  565. package/dist/server-dev/internal/stream-context.js +23 -0
  566. package/dist/server-dev/internal/stream-context.js.map +1 -0
  567. package/dist/server-dev/reactive.js +85 -0
  568. package/dist/server-dev/reactive.js.map +1 -0
  569. package/dist/server-dev/render.js +52 -0
  570. package/dist/server-dev/render.js.map +1 -0
  571. package/dist/server-dev/resource-hints.js +200 -0
  572. package/dist/server-dev/resource-hints.js.map +1 -0
  573. package/dist/server-dev/select-value.js +51 -0
  574. package/dist/server-dev/select-value.js.map +1 -0
  575. package/dist/server-dev/server/attributes.js +155 -0
  576. package/dist/server-dev/server/attributes.js.map +1 -0
  577. package/dist/server-dev/server/class-style.js +173 -0
  578. package/dist/server-dev/server/class-style.js.map +1 -0
  579. package/dist/server-dev/server/component.js +72 -0
  580. package/dist/server-dev/server/component.js.map +1 -0
  581. package/dist/server-dev/server/derived.js +26 -0
  582. package/dist/server-dev/server/derived.js.map +1 -0
  583. package/dist/server-dev/server/element.js +216 -0
  584. package/dist/server-dev/server/element.js.map +1 -0
  585. package/dist/server-dev/server/errors.js +26 -0
  586. package/dist/server-dev/server/errors.js.map +1 -0
  587. package/dist/server-dev/server/escape.js +119 -0
  588. package/dist/server-dev/server/escape.js.map +1 -0
  589. package/dist/server-dev/server/form-controls.js +193 -0
  590. package/dist/server-dev/server/form-controls.js.map +1 -0
  591. package/dist/server-dev/server/hydration-script.js +59 -0
  592. package/dist/server-dev/server/hydration-script.js.map +1 -0
  593. package/dist/server-dev/server/index.js +16 -0
  594. package/dist/server-dev/server/node.js +21 -0
  595. package/dist/server-dev/server/node.js.map +1 -0
  596. package/dist/server-dev/server/portals.js +99 -0
  597. package/dist/server-dev/server/portals.js.map +1 -0
  598. package/dist/server-dev/server/render.js +256 -0
  599. package/dist/server-dev/server/render.js.map +1 -0
  600. package/dist/server-dev/server/serialize.js +315 -0
  601. package/dist/server-dev/server/serialize.js.map +1 -0
  602. package/dist/server-dev/server/stream.js +235 -0
  603. package/dist/server-dev/server/stream.js.map +1 -0
  604. package/dist/server-dev/server.js +16 -0
  605. package/dist/server-dev/spread.js +296 -0
  606. package/dist/server-dev/spread.js.map +1 -0
  607. package/dist/server-dev/template.js +120 -0
  608. package/dist/server-dev/template.js.map +1 -0
  609. package/dist/server-dev/view-transition.js +90 -0
  610. package/dist/server-dev/view-transition.js.map +1 -0
  611. package/package.json +136 -4
@@ -0,0 +1,104 @@
1
+ import { createRoot, getOwner, onCleanup, untrack, useMemo } from "@shadow-js/core";
2
+ import { transitionHooks } from "@shadow-js/core/extend";
3
+ /**
4
+ * Whether two selections describe the same rendered output. Non-keyed branches only care about
5
+ * which branch is chosen, which is the same as comparing truthiness of the condition. Keyed
6
+ * branches also rebuild when the condition's identity changes. The fallback never rebuilds.
7
+ */
8
+ function sameChoice(a, b) {
9
+ if (a.index !== b.index) return false;
10
+ return a.index === -1 || !a.keyed || a.when === b.when;
11
+ }
12
+ /**
13
+ * Builds the accessor behind `Show` and `Switch`. The selection memo decides which branch is chosen;
14
+ * the output memo commits it.
15
+ *
16
+ * Ordinary changes build the branch inside the output memo: the memo's teardown removes the previous
17
+ * branch first. A change made during a transition, while a branch is on screen, is handled by the
18
+ * transition layer (core's `slotSwap`, reached through `transitionHooks`), created by the first such change: it builds the
19
+ * new branch under a hold and commits it once its reads have settled. Until then the shown branch stays
20
+ * on screen, its DOM untouched, and nothing is built twice. Apps that never change a shown branch in a
21
+ * transition never create that layer.
22
+ *
23
+ * Teardown ordering: the owner of a branch is marked `disposing` before it is torn down, so a cleanup
24
+ * that reads the callback's accessor learns that the branch is going away and gets the last truthy
25
+ * value instead of a stale-accessor error.
26
+ *
27
+ * @param name Component name used in diagnostics.
28
+ * @param select Tracked selection; runs inside the selection memo.
29
+ * @param fallback Reads the fallback lazily, untracked, only when it is shown.
30
+ * @returns The output accessor.
31
+ * @throws TypeError (production message `SHADOW_STALE_ACCESSOR`) from the accessor handed to a
32
+ * callback child, when it is read after its branch was replaced.
33
+ * @internal
34
+ * @since 1.0.0
35
+ */
36
+ function createBranches(name, select, fallback) {
37
+ /** Selection computed most recently; its `read` is always current, unlike the held value. */
38
+ let latest;
39
+ /** The branch on screen, and what the output last returned. The transition layer reads and writes it. */
40
+ const state = { live: void 0 };
41
+ /** The transition layer, created by the first transition that replaces the branch on screen. */
42
+ let swap;
43
+ /** The slot's owner: the transition layer's holder for the branches it builds lives under it. */
44
+ const owner = getOwner();
45
+ const pick = () => {
46
+ const next = select();
47
+ latest = next;
48
+ const live = state.live;
49
+ if (live !== void 0 && next.index === live.owned.index) live.owned.value = next.when;
50
+ return next;
51
+ };
52
+ const selection = useMemo(pick, { equals: sameChoice });
53
+ const accessorFor = (owned) => {
54
+ return () => {
55
+ if (owned.disposing) return owned.value;
56
+ const current = untrack(selection);
57
+ if (current.index !== owned.index) throw new TypeError(`ShadowJS ${name}: stale accessor. The branch was replaced; read the accessor only while its condition is truthy.`);
58
+ return (latest ?? current).read();
59
+ };
60
+ };
61
+ /**
62
+ * The value a branch (or the fallback) produces. `eager` evaluates a zero-argument accessor now (a
63
+ * transition build needs to see whether a read was held); otherwise it is evaluated when rendered.
64
+ */
65
+ const produce = (choice, owned, eager) => {
66
+ if (choice.index === -1) return untrack(fallback);
67
+ const body = choice.body();
68
+ if (typeof body !== "function") return body;
69
+ if (body.length === 0) return useMemo(() => body(), {
70
+ allowWrites: true,
71
+ lazy: !eager
72
+ });
73
+ const callback = body;
74
+ return untrack(() => callback(choice.keyed ? choice.when : accessorFor(owned)));
75
+ };
76
+ return useMemo(() => {
77
+ const choice = selection();
78
+ if (swap === void 0 && state.live !== void 0) swap = transitionHooks()?.slotSwap(state, produce, sameChoice, owner);
79
+ if (swap?.step(choice)) return state.live?.result;
80
+ if (state.live !== void 0) state.live.owned.disposing = false;
81
+ state.live = void 0;
82
+ const owned = {
83
+ index: choice.index,
84
+ value: choice.when,
85
+ disposing: false
86
+ };
87
+ const result = produce(choice, owned, false);
88
+ createRoot(() => {
89
+ onCleanup(() => {
90
+ owned.disposing = true;
91
+ });
92
+ });
93
+ state.live = {
94
+ choice,
95
+ owned,
96
+ result
97
+ };
98
+ return result;
99
+ }, { allowWrites: true });
100
+ }
101
+ //#endregion
102
+ export { createBranches };
103
+
104
+ //# sourceMappingURL=branch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"branch.js","names":[],"sources":["../../../src/control-flow/branch.ts"],"sourcesContent":["import { type Accessor, createRoot, getOwner, onCleanup, untrack, useMemo } from \"@shadow-js/core\";\nimport {\n type SlotBranch,\n type SlotOwned,\n type SlotState,\n type SlotSwap,\n transitionHooks,\n} from \"@shadow-js/core/extend\";\n\n/**\n * Branch index meaning \"no branch is selected\": the fallback is shown.\n * @internal\n */\nexport const FALLBACK = -1;\n\n/**\n * One selection made by a control-flow component.\n *\n * - `index` names the chosen branch, or {@link FALLBACK}.\n * - `keyed` and `when` decide whether a change of selection rebuilds the branch.\n * - `read` reads the condition reactively; the callback child's accessor argument uses it.\n * - `body` reads the branch's children getter. It is read tracked: a compiled `children` getter\n * that is a plain reactive expression (`{count()}`) must update the output. Creating child JSX\n * reads nothing here, because components and bindings track inside their own computations.\n *\n * @internal\n * @since 1.0.0\n */\nexport interface Choice {\n /** The chosen branch: a zero-based position, or {@link FALLBACK} when no branch is chosen. */\n readonly index: number;\n /** True when a change of `when` (by identity) rebuilds the branch even if `index` is the same. */\n readonly keyed: boolean;\n /** The value of the condition at selection time; a keyed callback child receives it. */\n readonly when: unknown;\n /** Reads the current value of the condition, tracked; backs the callback child's accessor. */\n readonly read: () => unknown;\n /** Reads the chosen branch's children (content, an accessor, or a callback), tracked. */\n readonly body: () => unknown;\n}\n\n/** Bookkeeping for the branch that is on screen. */\ntype Rendered = SlotOwned;\n\n/** A branch on screen, or one a transition builds (see the transition layer in core's concurrency.ts). */\ntype Live = SlotBranch<Choice>;\n\n/**\n * Whether two selections describe the same rendered output. Non-keyed branches only care about\n * which branch is chosen, which is the same as comparing truthiness of the condition. Keyed\n * branches also rebuild when the condition's identity changes. The fallback never rebuilds.\n */\nfunction sameChoice(a: Choice, b: Choice): boolean {\n if (a.index !== b.index) return false;\n return a.index === FALLBACK || !a.keyed || a.when === b.when;\n}\n\n/**\n * Builds the accessor behind `Show` and `Switch`. The selection memo decides which branch is chosen;\n * the output memo commits it.\n *\n * Ordinary changes build the branch inside the output memo: the memo's teardown removes the previous\n * branch first. A change made during a transition, while a branch is on screen, is handled by the\n * transition layer (core's `slotSwap`, reached through `transitionHooks`), created by the first such change: it builds the\n * new branch under a hold and commits it once its reads have settled. Until then the shown branch stays\n * on screen, its DOM untouched, and nothing is built twice. Apps that never change a shown branch in a\n * transition never create that layer.\n *\n * Teardown ordering: the owner of a branch is marked `disposing` before it is torn down, so a cleanup\n * that reads the callback's accessor learns that the branch is going away and gets the last truthy\n * value instead of a stale-accessor error.\n *\n * @param name Component name used in diagnostics.\n * @param select Tracked selection; runs inside the selection memo.\n * @param fallback Reads the fallback lazily, untracked, only when it is shown.\n * @returns The output accessor.\n * @throws TypeError (production message `SHADOW_STALE_ACCESSOR`) from the accessor handed to a\n * callback child, when it is read after its branch was replaced.\n * @internal\n * @since 1.0.0\n */\nexport function createBranches(\n name: string,\n select: () => Choice,\n fallback: () => unknown,\n): Accessor<unknown> {\n /** Selection computed most recently; its `read` is always current, unlike the held value. */\n let latest: Choice | undefined;\n /** The branch on screen, and what the output last returned. The transition layer reads and writes it. */\n const state: SlotState<Choice> = { live: undefined };\n /** The transition layer, created by the first transition that replaces the branch on screen. */\n let swap: SlotSwap<Choice> | undefined;\n /** The slot's owner: the transition layer's holder for the branches it builds lives under it. */\n const owner = getOwner();\n\n const pick = (): Choice => {\n const next = select();\n latest = next;\n const live: Live | undefined = state.live;\n if (live !== undefined && next.index === live.owned.index) live.owned.value = next.when;\n return next;\n };\n const selection = useMemo<Choice>(pick, { equals: sameChoice });\n\n const accessorFor = (owned: Rendered): (() => unknown) => {\n return () => {\n if (owned.disposing) return owned.value;\n const current = untrack(selection);\n if (current.index !== owned.index) {\n throw new TypeError(\n __DEV__\n ? `ShadowJS ${name}: stale accessor. The branch was replaced; read the accessor only while its condition is truthy.`\n : \"SHADOW_STALE_ACCESSOR\",\n );\n }\n return (latest ?? current).read();\n };\n };\n\n /**\n * The value a branch (or the fallback) produces. `eager` evaluates a zero-argument accessor now (a\n * transition build needs to see whether a read was held); otherwise it is evaluated when rendered.\n */\n const produce = (choice: Choice, owned: Rendered, eager: boolean): unknown => {\n if (choice.index === FALLBACK) return untrack(fallback);\n const body = choice.body();\n if (typeof body !== \"function\") return body;\n // A zero-argument function is an accessor. Returned as it is, the renderer would call it in an\n // effect outside this branch, so an error it throws would escape the boundary around the Show\n // (STATUS: ErrorBoundary does not catch a Show function child). A memo owned here evaluates it\n // inside the branch, where the nearest error handler applies.\n if (body.length === 0) {\n // Lazy outside a transition: the parent evaluates it when it renders, so a deep chain of\n // branches is built in that render rather than inside this one.\n return useMemo<unknown>(() => (body as () => unknown)(), {\n allowWrites: true,\n lazy: !eager,\n });\n }\n const callback = body as (value: unknown) => unknown;\n return untrack(() => callback(choice.keyed ? choice.when : accessorFor(owned)));\n };\n\n return useMemo<unknown>(\n () => {\n const choice = selection();\n if (swap === undefined && state.live !== undefined) {\n swap = transitionHooks()?.slotSwap(state, produce, sameChoice, owner);\n }\n if (swap?.step(choice)) return state.live?.result;\n\n // The usual path: the previous branch was torn down by this memo (its teardown marked it disposing;\n // the flag is cleared again, so a stale accessor throws). Build the next one here.\n if (state.live !== undefined) state.live.owned.disposing = false;\n state.live = undefined;\n const owned: Rendered = { index: choice.index, value: choice.when, disposing: false };\n const result = produce(choice, owned, false);\n // Created last, so it is the newest child: the memo's teardown marks the branch first.\n createRoot(() => {\n onCleanup(() => {\n owned.disposing = true;\n });\n });\n state.live = { choice, owned, result };\n return result;\n },\n { allowWrites: true },\n );\n}\n"],"mappings":";;;;;;;AAoDA,SAAS,WAAW,GAAW,GAAoB;CACjD,IAAI,EAAE,UAAU,EAAE,OAAO,OAAO;CAChC,OAAO,EAAE,UAAA,MAAsB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE;AAC1D;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,eACd,MACA,QACA,UACmB;;CAEnB,IAAI;;CAEJ,MAAM,QAA2B,EAAE,MAAM,KAAA,EAAU;;CAEnD,IAAI;;CAEJ,MAAM,QAAQ,SAAS;CAEvB,MAAM,aAAqB;EACzB,MAAM,OAAO,OAAO;EACpB,SAAS;EACT,MAAM,OAAyB,MAAM;EACrC,IAAI,SAAS,KAAA,KAAa,KAAK,UAAU,KAAK,MAAM,OAAO,KAAK,MAAM,QAAQ,KAAK;EACnF,OAAO;CACT;CACA,MAAM,YAAY,QAAgB,MAAM,EAAE,QAAQ,WAAW,CAAC;CAE9D,MAAM,eAAe,UAAqC;EACxD,aAAa;GACX,IAAI,MAAM,WAAW,OAAO,MAAM;GAClC,MAAM,UAAU,QAAQ,SAAS;GACjC,IAAI,QAAQ,UAAU,MAAM,OAC1B,MAAM,IAAI,UAEJ,YAAY,KAAK,iGAEvB;GAEF,QAAQ,UAAU,QAAA,CAAS,KAAK;EAClC;CACF;;;;;CAMA,MAAM,WAAW,QAAgB,OAAiB,UAA4B;EAC5E,IAAI,OAAO,UAAA,IAAoB,OAAO,QAAQ,QAAQ;EACtD,MAAM,OAAO,OAAO,KAAK;EACzB,IAAI,OAAO,SAAS,YAAY,OAAO;EAKvC,IAAI,KAAK,WAAW,GAGlB,OAAO,cAAwB,KAAuB,GAAG;GACvD,aAAa;GACb,MAAM,CAAC;EACT,CAAC;EAEH,MAAM,WAAW;EACjB,OAAO,cAAc,SAAS,OAAO,QAAQ,OAAO,OAAO,YAAY,KAAK,CAAC,CAAC;CAChF;CAEA,OAAO,cACC;EACJ,MAAM,SAAS,UAAU;EACzB,IAAI,SAAS,KAAA,KAAa,MAAM,SAAS,KAAA,GACvC,OAAO,gBAAgB,CAAC,EAAE,SAAS,OAAO,SAAS,YAAY,KAAK;EAEtE,IAAI,MAAM,KAAK,MAAM,GAAG,OAAO,MAAM,MAAM;EAI3C,IAAI,MAAM,SAAS,KAAA,GAAW,MAAM,KAAK,MAAM,YAAY;EAC3D,MAAM,OAAO,KAAA;EACb,MAAM,QAAkB;GAAE,OAAO,OAAO;GAAO,OAAO,OAAO;GAAM,WAAW;EAAM;EACpF,MAAM,SAAS,QAAQ,QAAQ,OAAO,KAAK;EAE3C,iBAAiB;GACf,gBAAgB;IACd,MAAM,YAAY;GACpB,CAAC;EACH,CAAC;EACD,MAAM,OAAO;GAAE;GAAQ;GAAO;EAAO;EACrC,OAAO;CACT,GACA,EAAE,aAAa,KAAK,CACtB;AACF"}
@@ -0,0 +1,48 @@
1
+ import { JsxChild } from "../jsx/types.js";
2
+ import { Accessor } from "@shadow-js/core";
3
+ //#region src/control-flow/client-only.d.ts
4
+ /**
5
+ * Props of {@link ClientOnly}.
6
+ * @since 1.0.0
7
+ */
8
+ export interface ClientOnlyProps {
9
+ /**
10
+ * Rendered on the server and while the page hydrates, until the browser has mounted.
11
+ * @default undefined (nothing is rendered until mount)
12
+ */
13
+ readonly fallback?: JsxChild;
14
+ /**
15
+ * Rendered in the browser only, after mount.
16
+ * @default undefined (nothing is rendered after mount either)
17
+ */
18
+ readonly children?: JsxChild | (() => unknown);
19
+ }
20
+ /**
21
+ * Renders `children` in the browser only. The server (and the first client pass, which must match
22
+ * the server's markup) renders `fallback`; once mounted, the children replace it. Use it for
23
+ * content that depends on browser state: `window`, `localStorage`, media queries, charts.
24
+ *
25
+ * @param props See {@link ClientOnlyProps}.
26
+ * @returns An accessor of the current content: the fallback until mount, then the children.
27
+ * @example
28
+ * import { useSignal } from "@shadow-js/core";
29
+ * import { ClientOnly } from "@shadow-js/web";
30
+ *
31
+ * function Chart(props: { data: number[] }) {
32
+ * return <canvas data-points={props.data.length} />;
33
+ * }
34
+ *
35
+ * function Report() {
36
+ * const [rows] = useSignal([1, 2, 3]);
37
+ * return (
38
+ * <ClientOnly fallback={<p>Loading chart...</p>}>
39
+ * <Chart data={rows()} />
40
+ * </ClientOnly>
41
+ * );
42
+ * }
43
+ * @see Show
44
+ * @since 1.0.0
45
+ */
46
+ export declare function ClientOnly(props: ClientOnlyProps): Accessor<unknown>;
47
+ //#endregion
48
+ //# sourceMappingURL=client-only.d.ts.map
@@ -0,0 +1,50 @@
1
+ import { Show } from "./show.js";
2
+ import { onMount, useSignal } from "@shadow-js/core";
3
+ //#region src/control-flow/client-only.ts
4
+ /**
5
+ * Renders `children` in the browser only. The server (and the first client pass, which must match
6
+ * the server's markup) renders `fallback`; once mounted, the children replace it. Use it for
7
+ * content that depends on browser state: `window`, `localStorage`, media queries, charts.
8
+ *
9
+ * @param props See {@link ClientOnlyProps}.
10
+ * @returns An accessor of the current content: the fallback until mount, then the children.
11
+ * @example
12
+ * import { useSignal } from "@shadow-js/core";
13
+ * import { ClientOnly } from "@shadow-js/web";
14
+ *
15
+ * function Chart(props: { data: number[] }) {
16
+ * return <canvas data-points={props.data.length} />;
17
+ * }
18
+ *
19
+ * function Report() {
20
+ * const [rows] = useSignal([1, 2, 3]);
21
+ * return (
22
+ * <ClientOnly fallback={<p>Loading chart...</p>}>
23
+ * <Chart data={rows()} />
24
+ * </ClientOnly>
25
+ * );
26
+ * }
27
+ * @see Show
28
+ * @since 1.0.0
29
+ */
30
+ function ClientOnly(props) {
31
+ const [mounted, setMounted] = useSignal(false);
32
+ onMount(() => {
33
+ setMounted(true);
34
+ });
35
+ return Show({
36
+ get when() {
37
+ return mounted();
38
+ },
39
+ get fallback() {
40
+ return props.fallback;
41
+ },
42
+ get children() {
43
+ return props.children;
44
+ }
45
+ });
46
+ }
47
+ //#endregion
48
+ export { ClientOnly };
49
+
50
+ //# sourceMappingURL=client-only.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client-only.js","names":[],"sources":["../../../src/control-flow/client-only.ts"],"sourcesContent":["import { type Accessor, onMount, useSignal } from \"@shadow-js/core\";\nimport type { JsxChild } from \"../jsx/types\";\nimport { Show } from \"./show\";\n\n/**\n * Props of {@link ClientOnly}.\n * @since 1.0.0\n */\nexport interface ClientOnlyProps {\n /**\n * Rendered on the server and while the page hydrates, until the browser has mounted.\n * @default undefined (nothing is rendered until mount)\n */\n readonly fallback?: JsxChild;\n /**\n * Rendered in the browser only, after mount.\n * @default undefined (nothing is rendered after mount either)\n */\n readonly children?: JsxChild | (() => unknown);\n}\n\n/**\n * Renders `children` in the browser only. The server (and the first client pass, which must match\n * the server's markup) renders `fallback`; once mounted, the children replace it. Use it for\n * content that depends on browser state: `window`, `localStorage`, media queries, charts.\n *\n * @param props See {@link ClientOnlyProps}.\n * @returns An accessor of the current content: the fallback until mount, then the children.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { ClientOnly } from \"@shadow-js/web\";\n *\n * function Chart(props: { data: number[] }) {\n * return <canvas data-points={props.data.length} />;\n * }\n *\n * function Report() {\n * const [rows] = useSignal([1, 2, 3]);\n * return (\n * <ClientOnly fallback={<p>Loading chart...</p>}>\n * <Chart data={rows()} />\n * </ClientOnly>\n * );\n * }\n * @see Show\n * @since 1.0.0\n */\nexport function ClientOnly(props: ClientOnlyProps): Accessor<unknown> {\n const [mounted, setMounted] = useSignal(false);\n // Never runs on the server, so the server always renders the fallback.\n onMount(() => {\n setMounted(true);\n });\n return Show({\n get when() {\n return mounted();\n },\n get fallback() {\n return props.fallback;\n },\n get children() {\n return props.children;\n },\n });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,WAAW,OAA2C;CACpE,MAAM,CAAC,SAAS,cAAc,UAAU,KAAK;CAE7C,cAAc;EACZ,WAAW,IAAI;CACjB,CAAC;CACD,OAAO,KAAK;EACV,IAAI,OAAO;GACT,OAAO,QAAQ;EACjB;EACA,IAAI,WAAW;GACb,OAAO,MAAM;EACf;EACA,IAAI,WAAW;GACb,OAAO,MAAM;EACf;CACF,CAAC;AACH"}
@@ -0,0 +1,82 @@
1
+ //#region src/control-flow/dynamic.d.ts
2
+ /**
3
+ * A component function or a tag name, as {@link Dynamic} accepts it. The props of a function are
4
+ * checked by the caller.
5
+ * @since 1.0.0
6
+ */
7
+ export type DynamicComponent = string | ((props: never) => unknown);
8
+ /**
9
+ * Everything `component` may be: a component, a tag name, or `undefined`, `null` or `false`, which
10
+ * render nothing.
11
+ * @since 1.0.0
12
+ */
13
+ export type DynamicTarget = DynamicComponent | undefined | null | false;
14
+ /**
15
+ * Props of {@link Dynamic}: `component` plus the props of whatever it renders. Every other prop
16
+ * passes through, reactive getters included.
17
+ * @since 1.0.0
18
+ */
19
+ export interface DynamicProps<C extends DynamicTarget = DynamicTarget> {
20
+ /** The component to render, a tag name, or a falsy value for nothing. */
21
+ readonly component: C;
22
+ /** Any other prop is passed to the rendered component or set on the element, still reactive. */
23
+ readonly [prop: string]: unknown;
24
+ }
25
+ /**
26
+ * Renders a component function or an element chosen by a tag name, and re-renders when
27
+ * `component` changes. Only `component` is tracked: the rest of the props are passed through
28
+ * reactive, so changing them updates the rendered output without rebuilding it. Swapping
29
+ * `component` disposes the old subtree, cleanups included, and builds the new one once. A falsy
30
+ * `component` renders nothing.
31
+ *
32
+ * Tag names are checked against `^[a-z][a-z0-9-]*$` (case-insensitive) and `script` is refused, so
33
+ * data-driven tags cannot inject markup. SVG-only names (`circle`, `path`, `svg`, ...) are created
34
+ * in the SVG namespace.
35
+ *
36
+ * @param props `component` and the props of what it renders.
37
+ * @returns An accessor of the rendered output, to be inserted by the caller.
38
+ * @throws TypeError for an invalid tag name or a component that is neither a string nor a function
39
+ * (at read time, which is when the caller inserts it).
40
+ * @example
41
+ * import { createRoot, useSignal } from "@shadow-js/core";
42
+ * import { Dynamic, insert } from "@shadow-js/web";
43
+ *
44
+ * const parent = document.createElement("div");
45
+ * createRoot(() => {
46
+ * const [level] = useSignal(1);
47
+ * insert(
48
+ * parent,
49
+ * Dynamic({
50
+ * get component() {
51
+ * return level() === 1 ? "h1" : "h2";
52
+ * },
53
+ * children: "Title",
54
+ * }),
55
+ * );
56
+ * });
57
+ * @see createDynamic
58
+ * @since 1.0.0
59
+ */
60
+ export declare function Dynamic<C extends DynamicTarget>(props: DynamicProps<C>): () => unknown;
61
+ /**
62
+ * Function form of {@link Dynamic}, for code that is not JSX: renders what `component()` returns (a
63
+ * component, a tag name or a falsy value) with `props`, and follows it when it changes.
64
+ *
65
+ * @param component Accessor of the target.
66
+ * @param props The props of what it renders (reactive getters stay reactive).
67
+ * @returns An accessor of the rendered output.
68
+ * @example
69
+ * import { createRoot, useSignal } from "@shadow-js/core";
70
+ * import { createDynamic, insert } from "@shadow-js/web";
71
+ *
72
+ * const parent = document.createElement("div");
73
+ * createRoot(() => {
74
+ * const [level] = useSignal(1);
75
+ * insert(parent, createDynamic(() => (level() === 1 ? "h1" : "h2"), { children: "Title" }));
76
+ * });
77
+ * @see Dynamic
78
+ * @since 1.0.0
79
+ */
80
+ export declare function createDynamic<C extends DynamicTarget>(component: () => C, props?: object): () => unknown;
81
+ //#endregion
82
+ //# sourceMappingURL=dynamic.d.ts.map
@@ -0,0 +1,134 @@
1
+ import "../internal/names.js";
2
+ import { nextKey } from "../internal/hydration-scope.js";
3
+ import { createComponent } from "../component.js";
4
+ import { claims } from "../internal/hydration-hooks.js";
5
+ import { bindRegion, createRegion } from "../insert.js";
6
+ import { spread } from "../spread.js";
7
+ import { mergeProps, splitProps, untrack, useMemo } from "@shadow-js/core";
8
+ //#region src/control-flow/dynamic.ts
9
+ /** Tag names that take the SVG namespace. Anything else is HTML. */
10
+ const SVG_TAGS = /* @__PURE__ */ new Set([
11
+ "svg",
12
+ "g",
13
+ "path",
14
+ "circle",
15
+ "ellipse",
16
+ "line",
17
+ "polygon",
18
+ "polyline",
19
+ "rect",
20
+ "text",
21
+ "tspan",
22
+ "textpath",
23
+ "defs",
24
+ "use",
25
+ "symbol",
26
+ "marker",
27
+ "clippath",
28
+ "mask",
29
+ "pattern",
30
+ "lineargradient",
31
+ "radialgradient",
32
+ "stop",
33
+ "filter"
34
+ ]);
35
+ /** Shape of a tag name: a letter, then letters, digits or dashes. Anything else is refused. */
36
+ const TAG_PATTERN = /^[a-z][a-z0-9-]*$/i;
37
+ /** Tags refused in any letter case: a script would bypass CSP nonces and Trusted Types. */
38
+ const DENIED_TAGS = /* @__PURE__ */ new Set(["script"]);
39
+ /**
40
+ * Creates an element for a validated tag name and applies the props to it, children included.
41
+ * The namespace comes from the tag: SVG-only names get the SVG namespace, the rest are HTML.
42
+ * On the server it renders the element as markup (with the hydration key and the children region
43
+ * the client adopts); while hydrating it claims that element instead of creating one.
44
+ */
45
+ function buildElement(tag, props) {
46
+ const lower = tag.toLowerCase();
47
+ if (!TAG_PATTERN.test(tag) || DENIED_TAGS.has(lower)) throw new TypeError("ShadowJS Dynamic: invalid tag");
48
+ const svg = SVG_TAGS.has(lower);
49
+ const el = claims.current.claimElement(nextKey()) ?? (svg ? document.createElementNS("http://www.w3.org/2000/svg", tag) : document.createElement(tag));
50
+ spread(el, props, svg, true);
51
+ const region = createRegion(el, null, claims.current.takeRegion(el, null));
52
+ bindRegion(region, () => props.children);
53
+ return el;
54
+ }
55
+ /**
56
+ * Renders one value of `component`: nothing for a falsy value, an element for a tag name, the
57
+ * component's result for a function. Anything else is a TypeError.
58
+ */
59
+ function buildTarget(target, props) {
60
+ if (!target) return null;
61
+ if (typeof target === "string") return buildElement(target, props);
62
+ if (typeof target === "function") return createComponent(target, props);
63
+ throw new TypeError("ShadowJS Dynamic: component must be a string, a function, or a falsy value.");
64
+ }
65
+ /**
66
+ * Renders a component function or an element chosen by a tag name, and re-renders when
67
+ * `component` changes. Only `component` is tracked: the rest of the props are passed through
68
+ * reactive, so changing them updates the rendered output without rebuilding it. Swapping
69
+ * `component` disposes the old subtree, cleanups included, and builds the new one once. A falsy
70
+ * `component` renders nothing.
71
+ *
72
+ * Tag names are checked against `^[a-z][a-z0-9-]*$` (case-insensitive) and `script` is refused, so
73
+ * data-driven tags cannot inject markup. SVG-only names (`circle`, `path`, `svg`, ...) are created
74
+ * in the SVG namespace.
75
+ *
76
+ * @param props `component` and the props of what it renders.
77
+ * @returns An accessor of the rendered output, to be inserted by the caller.
78
+ * @throws TypeError for an invalid tag name or a component that is neither a string nor a function
79
+ * (at read time, which is when the caller inserts it).
80
+ * @example
81
+ * import { createRoot, useSignal } from "@shadow-js/core";
82
+ * import { Dynamic, insert } from "@shadow-js/web";
83
+ *
84
+ * const parent = document.createElement("div");
85
+ * createRoot(() => {
86
+ * const [level] = useSignal(1);
87
+ * insert(
88
+ * parent,
89
+ * Dynamic({
90
+ * get component() {
91
+ * return level() === 1 ? "h1" : "h2";
92
+ * },
93
+ * children: "Title",
94
+ * }),
95
+ * );
96
+ * });
97
+ * @see createDynamic
98
+ * @since 1.0.0
99
+ */
100
+ function Dynamic(props) {
101
+ const [, rest] = splitProps(props, ["component"]);
102
+ return useMemo(() => {
103
+ const target = props.component;
104
+ return untrack(() => buildTarget(target, rest));
105
+ }, { allowWrites: true });
106
+ }
107
+ /**
108
+ * Function form of {@link Dynamic}, for code that is not JSX: renders what `component()` returns (a
109
+ * component, a tag name or a falsy value) with `props`, and follows it when it changes.
110
+ *
111
+ * @param component Accessor of the target.
112
+ * @param props The props of what it renders (reactive getters stay reactive).
113
+ * @returns An accessor of the rendered output.
114
+ * @example
115
+ * import { createRoot, useSignal } from "@shadow-js/core";
116
+ * import { createDynamic, insert } from "@shadow-js/web";
117
+ *
118
+ * const parent = document.createElement("div");
119
+ * createRoot(() => {
120
+ * const [level] = useSignal(1);
121
+ * insert(parent, createDynamic(() => (level() === 1 ? "h1" : "h2"), { children: "Title" }));
122
+ * });
123
+ * @see Dynamic
124
+ * @since 1.0.0
125
+ */
126
+ function createDynamic(component, props = {}) {
127
+ return Dynamic(mergeProps({ get component() {
128
+ return component();
129
+ } }, props));
130
+ }
131
+ //#endregion
132
+ export { Dynamic, createDynamic };
133
+
134
+ //# sourceMappingURL=dynamic.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dynamic.js","names":[],"sources":["../../../src/control-flow/dynamic.ts"],"sourcesContent":["import { mergeProps, splitProps, untrack, useMemo } from \"@shadow-js/core\";\nimport { createComponent } from \"../component\";\nimport { bindRegion, claims, createRegion, nextKey, SVG_NS } from \"../extend\";\nimport { ssrElement, ssrRaw } from \"../server/element\";\nimport { spread } from \"../spread\";\n\n/**\n * A component function or a tag name, as {@link Dynamic} accepts it. The props of a function are\n * checked by the caller.\n * @since 1.0.0\n */\nexport type DynamicComponent = string | ((props: never) => unknown);\n\n/**\n * Everything `component` may be: a component, a tag name, or `undefined`, `null` or `false`, which\n * render nothing.\n * @since 1.0.0\n */\nexport type DynamicTarget = DynamicComponent | undefined | null | false;\n\n/**\n * Props of {@link Dynamic}: `component` plus the props of whatever it renders. Every other prop\n * passes through, reactive getters included.\n * @since 1.0.0\n */\nexport interface DynamicProps<C extends DynamicTarget = DynamicTarget> {\n /** The component to render, a tag name, or a falsy value for nothing. */\n readonly component: C;\n /** Any other prop is passed to the rendered component or set on the element, still reactive. */\n readonly [prop: string]: unknown;\n}\n\n/** Tag names that take the SVG namespace. Anything else is HTML. */\nconst SVG_TAGS: ReadonlySet<string> = new Set([\n \"svg\",\n \"g\",\n \"path\",\n \"circle\",\n \"ellipse\",\n \"line\",\n \"polygon\",\n \"polyline\",\n \"rect\",\n \"text\",\n \"tspan\",\n \"textpath\",\n \"defs\",\n \"use\",\n \"symbol\",\n \"marker\",\n \"clippath\",\n \"mask\",\n \"pattern\",\n \"lineargradient\",\n \"radialgradient\",\n \"stop\",\n \"filter\",\n]);\n\n/** Shape of a tag name: a letter, then letters, digits or dashes. Anything else is refused. */\nconst TAG_PATTERN = /^[a-z][a-z0-9-]*$/i;\n\n/** Tags refused in any letter case: a script would bypass CSP nonces and Trusted Types. */\nconst DENIED_TAGS: ReadonlySet<string> = new Set([\"script\"]);\n\n/**\n * Creates an element for a validated tag name and applies the props to it, children included.\n * The namespace comes from the tag: SVG-only names get the SVG namespace, the rest are HTML.\n * On the server it renders the element as markup (with the hydration key and the children region\n * the client adopts); while hydrating it claims that element instead of creating one.\n */\nfunction buildElement(tag: string, props: object): unknown {\n const lower = tag.toLowerCase();\n if (!TAG_PATTERN.test(tag) || DENIED_TAGS.has(lower)) {\n throw new TypeError(__DEV__ ? \"ShadowJS Dynamic: invalid tag\" : \"SHADOW_DYNAMIC_TAG\");\n }\n if (__SERVER__) {\n // The children are read lazily, after `ssrElement` took the element's hydration key: the client\n // claims the element first and builds its children second, so the keys must be drawn in that\n // order here too, or a component inside the element and every sibling after it would miss.\n return ssrElement(\n tag,\n props,\n () => {\n const { children } = props as { children?: unknown };\n return children === undefined\n ? undefined\n : [ssrRaw(\"<!--[-->\"), children, ssrRaw(\"<!--]-->\")];\n },\n true,\n );\n }\n const svg = SVG_TAGS.has(lower);\n const claimed = claims.current.claimElement(nextKey());\n const el = claimed ?? (svg ? document.createElementNS(SVG_NS, tag) : document.createElement(tag));\n // Attributes through spread; children through insert, which adopts the server's children region.\n spread(el, props, svg, true);\n const region = createRegion(el, null, claims.current.takeRegion(el, null));\n bindRegion(region, () => (props as { children?: unknown }).children);\n return el;\n}\n\n/**\n * Renders one value of `component`: nothing for a falsy value, an element for a tag name, the\n * component's result for a function. Anything else is a TypeError.\n */\nfunction buildTarget(target: unknown, props: object): unknown {\n if (!target) return null;\n if (typeof target === \"string\") return buildElement(target, props);\n if (typeof target === \"function\") {\n return createComponent(target as (props: object) => unknown, props);\n }\n throw new TypeError(\n __DEV__\n ? \"ShadowJS Dynamic: component must be a string, a function, or a falsy value.\"\n : \"SHADOW_DYNAMIC_COMPONENT\",\n );\n}\n\n/**\n * Renders a component function or an element chosen by a tag name, and re-renders when\n * `component` changes. Only `component` is tracked: the rest of the props are passed through\n * reactive, so changing them updates the rendered output without rebuilding it. Swapping\n * `component` disposes the old subtree, cleanups included, and builds the new one once. A falsy\n * `component` renders nothing.\n *\n * Tag names are checked against `^[a-z][a-z0-9-]*$` (case-insensitive) and `script` is refused, so\n * data-driven tags cannot inject markup. SVG-only names (`circle`, `path`, `svg`, ...) are created\n * in the SVG namespace.\n *\n * @param props `component` and the props of what it renders.\n * @returns An accessor of the rendered output, to be inserted by the caller.\n * @throws TypeError for an invalid tag name or a component that is neither a string nor a function\n * (at read time, which is when the caller inserts it).\n * @example\n * import { createRoot, useSignal } from \"@shadow-js/core\";\n * import { Dynamic, insert } from \"@shadow-js/web\";\n *\n * const parent = document.createElement(\"div\");\n * createRoot(() => {\n * const [level] = useSignal(1);\n * insert(\n * parent,\n * Dynamic({\n * get component() {\n * return level() === 1 ? \"h1\" : \"h2\";\n * },\n * children: \"Title\",\n * }),\n * );\n * });\n * @see createDynamic\n * @since 1.0.0\n */\nexport function Dynamic<C extends DynamicTarget>(props: DynamicProps<C>): () => unknown {\n const [, rest] = splitProps(props, [\"component\"]);\n // The component is built inside this memo, so its setup (or a ref, or a directive) may write signals.\n return useMemo(\n (): unknown => {\n const target: unknown = props.component;\n return untrack(() => buildTarget(target, rest));\n },\n { allowWrites: true },\n );\n}\n\n/**\n * Function form of {@link Dynamic}, for code that is not JSX: renders what `component()` returns (a\n * component, a tag name or a falsy value) with `props`, and follows it when it changes.\n *\n * @param component Accessor of the target.\n * @param props The props of what it renders (reactive getters stay reactive).\n * @returns An accessor of the rendered output.\n * @example\n * import { createRoot, useSignal } from \"@shadow-js/core\";\n * import { createDynamic, insert } from \"@shadow-js/web\";\n *\n * const parent = document.createElement(\"div\");\n * createRoot(() => {\n * const [level] = useSignal(1);\n * insert(parent, createDynamic(() => (level() === 1 ? \"h1\" : \"h2\"), { children: \"Title\" }));\n * });\n * @see Dynamic\n * @since 1.0.0\n */\nexport function createDynamic<C extends DynamicTarget>(\n component: () => C,\n props: object = {},\n): () => unknown {\n return Dynamic(\n mergeProps(\n {\n get component(): C {\n return component();\n },\n },\n props,\n ) as DynamicProps<C>,\n );\n}\n"],"mappings":";;;;;;;;;AAiCA,MAAM,2BAAgC,IAAI,IAAI;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,cAAc;;AAGpB,MAAM,8BAAmC,IAAI,IAAI,CAAC,QAAQ,CAAC;;;;;;;AAQ3D,SAAS,aAAa,KAAa,OAAwB;CACzD,MAAM,QAAQ,IAAI,YAAY;CAC9B,IAAI,CAAC,YAAY,KAAK,GAAG,KAAK,YAAY,IAAI,KAAK,GACjD,MAAM,IAAI,UAAoB,+BAAsD;CAkBtF,MAAM,MAAM,SAAS,IAAI,KAAK;CAE9B,MAAM,KADU,OAAO,QAAQ,aAAa,QAAQ,CACnC,MAAM,MAAM,SAAS,gBAAA,8BAAwB,GAAG,IAAI,SAAS,cAAc,GAAG;CAE/F,OAAO,IAAI,OAAO,KAAK,IAAI;CAC3B,MAAM,SAAS,aAAa,IAAI,MAAM,OAAO,QAAQ,WAAW,IAAI,IAAI,CAAC;CACzE,WAAW,cAAe,MAAiC,QAAQ;CACnE,OAAO;AACT;;;;;AAMA,SAAS,YAAY,QAAiB,OAAwB;CAC5D,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,WAAW,UAAU,OAAO,aAAa,QAAQ,KAAK;CACjE,IAAI,OAAO,WAAW,YACpB,OAAO,gBAAgB,QAAsC,KAAK;CAEpE,MAAM,IAAI,UAEJ,6EAEN;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,QAAiC,OAAuC;CACtF,MAAM,GAAG,QAAQ,WAAW,OAAO,CAAC,WAAW,CAAC;CAEhD,OAAO,cACU;EACb,MAAM,SAAkB,MAAM;EAC9B,OAAO,cAAc,YAAY,QAAQ,IAAI,CAAC;CAChD,GACA,EAAE,aAAa,KAAK,CACtB;AACF;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cACd,WACA,QAAgB,CAAC,GACF;CACf,OAAO,QACL,WACE,EACE,IAAI,YAAe;EACjB,OAAO,UAAU;CACnB,EACF,GACA,KACF,CACF;AACF"}
@@ -0,0 +1,72 @@
1
+ import { JsxChild } from "../jsx/types.js";
2
+ import { Accessor } from "@shadow-js/core";
3
+ //#region src/control-flow/error-boundary.d.ts
4
+ /**
5
+ * Props of {@link ErrorBoundary}.
6
+ * @since 1.0.0
7
+ */
8
+ export interface ErrorBoundaryProps {
9
+ /**
10
+ * Shown after an error. A function is called untracked as `(error, reset)`; any other value is
11
+ * shown as is.
12
+ */
13
+ readonly fallback: JsxChild | ((error: unknown, reset: () => void) => unknown);
14
+ /**
15
+ * The protected content, read untracked when the children are built.
16
+ * @default undefined (nothing is protected; the boundary renders nothing)
17
+ */
18
+ readonly children?: JsxChild | (() => unknown);
19
+ }
20
+ /**
21
+ * {@link ErrorBoundaryProps} with untyped members, for code that forwards a fallback or children it
22
+ * does not know the shape of.
23
+ * @since 1.0.0
24
+ */
25
+ export interface ErrorBoundaryLooseProps {
26
+ /** Shown after an error; the same contract as {@link ErrorBoundaryProps.fallback}. */
27
+ readonly fallback: unknown;
28
+ /**
29
+ * The protected content; the same contract as {@link ErrorBoundaryProps.children}.
30
+ * @default undefined (nothing is protected; the boundary renders nothing)
31
+ */
32
+ readonly children?: unknown;
33
+ }
34
+ /**
35
+ * Renders `children`. If they throw while being created, or any effect, memo or cleanup inside
36
+ * them throws later, the children are disposed and `fallback` is rendered instead. A function
37
+ * fallback receives the error and a `reset` that rebuilds the children from scratch.
38
+ *
39
+ * Errors raised while the boundary is building or tearing down its children are captured and
40
+ * never write a signal, because writing inside a memo is an error. Late errors write the failure
41
+ * signal, which re-runs the boundary. After the boundary is disposed, late errors are dropped.
42
+ * Errors thrown by the fallback are not caught by this boundary; they reach the parent.
43
+ *
44
+ * @param props See {@link ErrorBoundaryProps}.
45
+ * @returns An accessor of the current content (children or fallback).
46
+ * @throws Nothing itself. An error from the children is shown through `fallback`, and an error
47
+ * thrown by a function `fallback` goes to the enclosing boundary or the root's error handler.
48
+ * @example
49
+ * import { ErrorBoundary } from "@shadow-js/web";
50
+ *
51
+ * function Dashboard() {
52
+ * return <p>Dashboard</p>;
53
+ * }
54
+ *
55
+ * function Page() {
56
+ * return (
57
+ * <ErrorBoundary
58
+ * fallback={(error, reset) => (
59
+ * <button onClick={reset}>Retry after: {String(error)}</button>
60
+ * )}
61
+ * >
62
+ * <Dashboard />
63
+ * </ErrorBoundary>
64
+ * );
65
+ * }
66
+ * @see Suspense
67
+ * @since 1.0.0
68
+ */
69
+ export declare function ErrorBoundary(props: ErrorBoundaryProps): Accessor<unknown>;
70
+ export declare function ErrorBoundary(props: ErrorBoundaryLooseProps): Accessor<unknown>;
71
+ //#endregion
72
+ //# sourceMappingURL=error-boundary.d.ts.map
@@ -0,0 +1,115 @@
1
+ import { currentScope, withScope } from "../internal/hydration-scope.js";
2
+ import { attachHotModules, createHotLink } from "./hot-link.js";
3
+ import { rootErrorsOf } from "./root-errors.js";
4
+ import { catchError, createRoot, getOwner, onCleanup, untrack, useMemo, useSignal } from "@shadow-js/core";
5
+ import { createSignalNode, handleError, readSignal, writeSignal } from "@shadow-js/core/extend";
6
+ //#region src/control-flow/error-boundary.ts
7
+ function ErrorBoundary(props) {
8
+ const failureCell = createSignalNode(void 0, Object.is);
9
+ /** Where an error of this boundary's own fallback goes: the boundary that encloses it. */
10
+ const parentOwner = getOwner();
11
+ const roots = rootErrorsOf(parentOwner);
12
+ /** The hydration scope at creation (a copy of its counts), or null outside a hydration or server render. */
13
+ const live = currentScope();
14
+ const origin = live === null ? null : {
15
+ id: live.id,
16
+ count: live.count,
17
+ resources: live.resources
18
+ };
19
+ const failure = () => readSignal(failureCell);
20
+ const setFailure = (next) => {
21
+ writeSignal(failureCell, next, { allowInMemo: true });
22
+ };
23
+ /** Bumped by reset(): forces a rebuild even when no failure was recorded. */
24
+ const [version, setVersion] = useSignal(0, { equals: false });
25
+ /** False once the boundary's owner is disposed. */
26
+ let alive = true;
27
+ /** True while the body memo is building or tearing down children; errors are captured then. */
28
+ let busy = false;
29
+ /** An error captured while busy, consumed by the next body computation. */
30
+ let pending;
31
+ const reset = () => {
32
+ if (!alive) return;
33
+ setFailure(void 0);
34
+ setVersion((count) => count + 1);
35
+ };
36
+ /**
37
+ * Dev only: the modules the children were built from. While the fallback is shown, a hot update of one of
38
+ * them resets the boundary, so the edit that fixes the error shows the children without a retry.
39
+ */
40
+ const hot = createHotLink(() => {
41
+ reset();
42
+ });
43
+ const report = (error) => {
44
+ if (!alive) return;
45
+ roots?.onCaughtError?.(error);
46
+ if (busy) {
47
+ if (pending === void 0) pending = { error };
48
+ return;
49
+ }
50
+ setFailure({ error });
51
+ };
52
+ /** Returns the captured error and clears it. A function, so TypeScript does not narrow the variable. */
53
+ const takePending = () => {
54
+ const captured = pending;
55
+ pending = void 0;
56
+ return captured;
57
+ };
58
+ const fallbackFor = (error) => {
59
+ const fallback = props.fallback;
60
+ if (typeof fallback !== "function") return fallback;
61
+ try {
62
+ return untrack(() => fallback(error, reset));
63
+ } catch (thrown) {
64
+ handleError(thrown, parentOwner);
65
+ return;
66
+ }
67
+ };
68
+ /** Builds the children or the fallback, as the current failure state says. */
69
+ const build = () => {
70
+ busy = true;
71
+ try {
72
+ version();
73
+ const current = failure() ?? takePending();
74
+ if (current !== void 0) {
75
+ hot?.arm();
76
+ return fallbackFor(current.error);
77
+ }
78
+ hot?.modules.clear();
79
+ const scope = createRoot((dispose) => {
80
+ if (hot !== void 0) attachHotModules(hot.modules);
81
+ return {
82
+ dispose,
83
+ value: catchError(() => untrack(() => props.children), report)
84
+ };
85
+ });
86
+ const creation = takePending();
87
+ if (creation !== void 0) {
88
+ scope.dispose();
89
+ hot?.arm();
90
+ return fallbackFor(creation.error);
91
+ }
92
+ hot?.disarm();
93
+ return scope.value;
94
+ } finally {
95
+ createRoot(() => {
96
+ onCleanup(() => {
97
+ busy = true;
98
+ });
99
+ });
100
+ busy = false;
101
+ }
102
+ };
103
+ const body = useMemo(() => origin === null ? build() : withScope({ ...origin }, build), { allowWrites: true });
104
+ createRoot(() => {
105
+ onCleanup(() => {
106
+ alive = false;
107
+ hot?.disarm();
108
+ });
109
+ });
110
+ return body;
111
+ }
112
+ //#endregion
113
+ export { ErrorBoundary };
114
+
115
+ //# sourceMappingURL=error-boundary.js.map