@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 @@
1
+ {"version":3,"file":"error-boundary.js","names":[],"sources":["../../../src/control-flow/error-boundary.ts"],"sourcesContent":["import {\n type Accessor,\n catchError,\n createRoot,\n getOwner,\n onCleanup,\n untrack,\n useMemo,\n useSignal,\n} from \"@shadow-js/core\";\nimport { createSignalNode, handleError, readSignal, writeSignal } from \"@shadow-js/core/extend\";\nimport { currentScope, type HydrationScope, withScope } from \"../extend\";\nimport type { JsxChild } from \"../jsx/types\";\nimport { attachHotModules, createHotLink, type HotLink } from \"./hot-link\";\nimport { rootErrorsOf } from \"./root-errors\";\n\n/**\n * Props of {@link ErrorBoundary}.\n * @since 1.0.0\n */\nexport interface ErrorBoundaryProps {\n /**\n * Shown after an error. A function is called untracked as `(error, reset)`; any other value is\n * shown as is.\n */\n readonly fallback: JsxChild | ((error: unknown, reset: () => void) => unknown);\n /**\n * The protected content, read untracked when the children are built.\n * @default undefined (nothing is protected; the boundary renders nothing)\n */\n readonly children?: JsxChild | (() => unknown);\n}\n\n/**\n * {@link ErrorBoundaryProps} with untyped members, for code that forwards a fallback or children it\n * does not know the shape of.\n * @since 1.0.0\n */\nexport interface ErrorBoundaryLooseProps {\n /** Shown after an error; the same contract as {@link ErrorBoundaryProps.fallback}. */\n readonly fallback: unknown;\n /**\n * The protected content; the same contract as {@link ErrorBoundaryProps.children}.\n * @default undefined (nothing is protected; the boundary renders nothing)\n */\n readonly children?: unknown;\n}\n\n/** A caught error, wrapped so that any thrown value (including `undefined`) is representable. */\ninterface Failure {\n readonly error: unknown;\n}\n\n/**\n * Renders `children`. If they throw while being created, or any effect, memo or cleanup inside\n * them throws later, the children are disposed and `fallback` is rendered instead. A function\n * fallback receives the error and a `reset` that rebuilds the children from scratch.\n *\n * Errors raised while the boundary is building or tearing down its children are captured and\n * never write a signal, because writing inside a memo is an error. Late errors write the failure\n * signal, which re-runs the boundary. After the boundary is disposed, late errors are dropped.\n * Errors thrown by the fallback are not caught by this boundary; they reach the parent.\n *\n * @param props See {@link ErrorBoundaryProps}.\n * @returns An accessor of the current content (children or fallback).\n * @throws Nothing itself. An error from the children is shown through `fallback`, and an error\n * thrown by a function `fallback` goes to the enclosing boundary or the root's error handler.\n * @example\n * import { ErrorBoundary } from \"@shadow-js/web\";\n *\n * function Dashboard() {\n * return <p>Dashboard</p>;\n * }\n *\n * function Page() {\n * return (\n * <ErrorBoundary\n * fallback={(error, reset) => (\n * <button onClick={reset}>Retry after: {String(error)}</button>\n * )}\n * >\n * <Dashboard />\n * </ErrorBoundary>\n * );\n * }\n * @see Suspense\n * @since 1.0.0\n */\nexport function ErrorBoundary(props: ErrorBoundaryProps): Accessor<unknown>;\nexport function ErrorBoundary(props: ErrorBoundaryLooseProps): Accessor<unknown>;\nexport function ErrorBoundary(props: ErrorBoundaryLooseProps): Accessor<unknown> {\n // An extension-API cell: a failure is boundary state, written from places a plain write refuses\n // (a sibling boundary's fallback throwing while its memo computes).\n const failureCell = createSignalNode<Failure | undefined>(undefined, Object.is);\n /** Where an error of this boundary's own fallback goes: the boundary that encloses it. */\n const parentOwner = getOwner();\n // The root's reporters (render/hydrate options): an error this boundary takes is reported to them.\n const roots = rootErrorsOf(parentOwner);\n /** The hydration scope at creation (a copy of its counts), or null outside a hydration or server render. */\n const live = currentScope();\n const origin: HydrationScope | null =\n live === null ? null : { id: live.id, count: live.count, resources: live.resources };\n const failure = (): Failure | undefined => readSignal(failureCell);\n const setFailure = (next: Failure | undefined): void => {\n writeSignal(failureCell, next, { allowInMemo: true });\n };\n /** Bumped by reset(): forces a rebuild even when no failure was recorded. */\n const [version, setVersion] = useSignal(0, { equals: false });\n /** False once the boundary's owner is disposed. */\n let alive = true;\n /** True while the body memo is building or tearing down children; errors are captured then. */\n let busy = false;\n /** An error captured while busy, consumed by the next body computation. */\n let pending: Failure | undefined;\n\n const reset = (): void => {\n if (!alive) return;\n setFailure(undefined);\n setVersion((count) => count + 1);\n };\n\n /**\n * Dev only: the modules the children were built from. While the fallback is shown, a hot update of one of\n * them resets the boundary, so the edit that fixes the error shows the children without a retry.\n */\n const hot: HotLink | undefined = __DEV__\n ? createHotLink(() => {\n reset();\n })\n : undefined;\n\n const report = (error: unknown): void => {\n if (!alive) return;\n roots?.onCaughtError?.(error);\n if (busy) {\n if (pending === undefined) pending = { error };\n return;\n }\n setFailure({ error });\n };\n\n /** Returns the captured error and clears it. A function, so TypeScript does not narrow the variable. */\n const takePending = (): Failure | undefined => {\n const captured = pending;\n pending = undefined;\n return captured;\n };\n\n const fallbackFor = (error: unknown): unknown => {\n const fallback = props.fallback;\n if (typeof fallback !== \"function\") return fallback;\n try {\n return untrack(() =>\n (fallback as (error: unknown, reset: () => void) => unknown)(error, reset),\n );\n } catch (thrown) {\n // A failing fallback is not this boundary's business: hand it to the enclosing boundary now.\n // Left to the memo it would only surface when a consumer outside that boundary reads it.\n handleError(thrown, parentOwner);\n return undefined;\n }\n };\n\n /** Builds the children or the fallback, as the current failure state says. */\n const build = (): unknown => {\n busy = true;\n try {\n version();\n const current = failure() ?? takePending();\n if (current !== undefined) {\n hot?.arm();\n return fallbackFor(current.error);\n }\n\n hot?.modules.clear();\n const scope = createRoot((dispose) => {\n if (hot !== undefined) attachHotModules(hot.modules);\n return {\n dispose,\n value: catchError(() => untrack(() => props.children), report),\n };\n });\n const creation = takePending();\n if (creation !== undefined) {\n scope.dispose();\n hot?.arm();\n return fallbackFor(creation.error);\n }\n hot?.disarm();\n return scope.value;\n } finally {\n // Newest child of the body memo: its cleanup marks the teardown before any child cleanup runs.\n createRoot(() => {\n onCleanup(() => {\n busy = true;\n });\n });\n busy = false;\n }\n // Children and the fallback are built here; their setup may write signals.\n };\n // Every build starts from the hydration scope the boundary was created in (a copy, so the count\n // is the same each time). A rebuild during a hydration pass then numbers its templates as the\n // first build did, so it claims the server's elements instead of missing keys.\n const body = useMemo<unknown>(\n () => (origin === null ? build() : withScope({ ...origin }, build)),\n { allowWrites: true },\n );\n\n // Created after the body memo, so it is the newest child of the owner and is disposed first.\n createRoot(() => {\n onCleanup(() => {\n alive = false;\n hot?.disarm();\n });\n });\n return body;\n}\n"],"mappings":";;;;;;AA0FA,SAAgB,cAAc,OAAmD;CAG/E,MAAM,cAAc,iBAAsC,KAAA,GAAW,OAAO,EAAE;;CAE9E,MAAM,cAAc,SAAS;CAE7B,MAAM,QAAQ,aAAa,WAAW;;CAEtC,MAAM,OAAO,aAAa;CAC1B,MAAM,SACJ,SAAS,OAAO,OAAO;EAAE,IAAI,KAAK;EAAI,OAAO,KAAK;EAAO,WAAW,KAAK;CAAU;CACrF,MAAM,gBAAqC,WAAW,WAAW;CACjE,MAAM,cAAc,SAAoC;EACtD,YAAY,aAAa,MAAM,EAAE,aAAa,KAAK,CAAC;CACtD;;CAEA,MAAM,CAAC,SAAS,cAAc,UAAU,GAAG,EAAE,QAAQ,MAAM,CAAC;;CAE5D,IAAI,QAAQ;;CAEZ,IAAI,OAAO;;CAEX,IAAI;CAEJ,MAAM,cAAoB;EACxB,IAAI,CAAC,OAAO;EACZ,WAAW,KAAA,CAAS;EACpB,YAAY,UAAU,QAAQ,CAAC;CACjC;;;;;CAMA,MAAM,MACF,oBAAoB;EAClB,MAAM;CACR,CAAC;CAGL,MAAM,UAAU,UAAyB;EACvC,IAAI,CAAC,OAAO;EACZ,OAAO,gBAAgB,KAAK;EAC5B,IAAI,MAAM;GACR,IAAI,YAAY,KAAA,GAAW,UAAU,EAAE,MAAM;GAC7C;EACF;EACA,WAAW,EAAE,MAAM,CAAC;CACtB;;CAGA,MAAM,oBAAyC;EAC7C,MAAM,WAAW;EACjB,UAAU,KAAA;EACV,OAAO;CACT;CAEA,MAAM,eAAe,UAA4B;EAC/C,MAAM,WAAW,MAAM;EACvB,IAAI,OAAO,aAAa,YAAY,OAAO;EAC3C,IAAI;GACF,OAAO,cACJ,SAA4D,OAAO,KAAK,CAC3E;EACF,SAAS,QAAQ;GAGf,YAAY,QAAQ,WAAW;GAC/B;EACF;CACF;;CAGA,MAAM,cAAuB;EAC3B,OAAO;EACP,IAAI;GACF,QAAQ;GACR,MAAM,UAAU,QAAQ,KAAK,YAAY;GACzC,IAAI,YAAY,KAAA,GAAW;IACzB,KAAK,IAAI;IACT,OAAO,YAAY,QAAQ,KAAK;GAClC;GAEA,KAAK,QAAQ,MAAM;GACnB,MAAM,QAAQ,YAAY,YAAY;IACpC,IAAI,QAAQ,KAAA,GAAW,iBAAiB,IAAI,OAAO;IACnD,OAAO;KACL;KACA,OAAO,iBAAiB,cAAc,MAAM,QAAQ,GAAG,MAAM;IAC/D;GACF,CAAC;GACD,MAAM,WAAW,YAAY;GAC7B,IAAI,aAAa,KAAA,GAAW;IAC1B,MAAM,QAAQ;IACd,KAAK,IAAI;IACT,OAAO,YAAY,SAAS,KAAK;GACnC;GACA,KAAK,OAAO;GACZ,OAAO,MAAM;EACf,UAAU;GAER,iBAAiB;IACf,gBAAgB;KACd,OAAO;IACT,CAAC;GACH,CAAC;GACD,OAAO;EACT;CAEF;CAIA,MAAM,OAAO,cACJ,WAAW,OAAO,MAAM,IAAI,UAAU,EAAE,GAAG,OAAO,GAAG,KAAK,GACjE,EAAE,aAAa,KAAK,CACtB;CAGA,iBAAiB;EACf,gBAAgB;GACd,QAAQ;GACR,KAAK,OAAO;EACd,CAAC;CACH,CAAC;CACD,OAAO;AACT"}
@@ -0,0 +1,80 @@
1
+ import { Accessor } from "@shadow-js/core";
2
+ //#region src/control-flow/for.d.ts
3
+ /**
4
+ * Props of {@link For} without `key`: rows are matched by item reference.
5
+ * @since 1.0.0
6
+ */
7
+ export interface ForUnkeyedProps<T> {
8
+ /**
9
+ * The list to render. `null`, `undefined` and `false` count as an empty list. Read lazily, inside
10
+ * the list memo, so it is tracked.
11
+ */
12
+ readonly each: readonly T[] | null | undefined | false;
13
+ /**
14
+ * Shown while the list is empty. Read lazily.
15
+ * @default undefined (an empty list renders nothing)
16
+ */
17
+ readonly fallback?: unknown;
18
+ /**
19
+ * Absent in this form: rows are matched by item reference. Pass `key` to match by key.
20
+ * No default: omit it for reference matching.
21
+ */
22
+ readonly key?: undefined;
23
+ /** Called once per row, untracked. The callback receives the item value. */
24
+ readonly children: (item: T, index: () => number) => unknown;
25
+ }
26
+ /**
27
+ * Props of {@link For} with `key`: rows are matched by `key(item)`.
28
+ * @since 1.0.0
29
+ */
30
+ export interface ForKeyedProps<T> {
31
+ /**
32
+ * The list to render. `null`, `undefined` and `false` count as an empty list. Read lazily, inside
33
+ * the list memo, so it is tracked.
34
+ */
35
+ readonly each: readonly T[] | null | undefined | false;
36
+ /**
37
+ * Shown while the list is empty. Read lazily.
38
+ * @default undefined (an empty list renders nothing)
39
+ */
40
+ readonly fallback?: unknown;
41
+ /** Identifies each item. A new object under the same key updates the row's `item()`. */
42
+ readonly key: (item: T) => unknown;
43
+ /** Called once per row, untracked. The callback receives an accessor of the item. */
44
+ readonly children: (item: () => T, index: () => number) => unknown;
45
+ }
46
+ /**
47
+ * Props of {@link For}.
48
+ * @since 1.0.0
49
+ */
50
+ export type ForProps<T> = ForUnkeyedProps<T> | ForKeyedProps<T>;
51
+ /**
52
+ * Renders one row per item. Rows whose key survives an update keep their DOM and state; only
53
+ * changed items create or dispose rows. The list is read lazily, inside the list memo.
54
+ *
55
+ * Whether rows are keyed is decided when `For` is created: it reads `key` once. When the list
56
+ * is empty and `fallback` is not given, the result is `[undefined]`, which renders nothing.
57
+ *
58
+ * @param props See {@link ForUnkeyedProps} and {@link ForKeyedProps}.
59
+ * @returns An accessor of the row values, in input order.
60
+ * @example
61
+ * import { useSignal } from "@shadow-js/core";
62
+ * import { For } from "@shadow-js/web";
63
+ *
64
+ * function TodoList() {
65
+ * const [todos] = useSignal([{ id: 1, title: "Write docs" }]);
66
+ * return (
67
+ * <ul>
68
+ * <For each={todos()} key={(todo) => todo.id} fallback={<li>Nothing to do</li>}>
69
+ * {(todo) => <li>{todo().title}</li>}
70
+ * </For>
71
+ * </ul>
72
+ * );
73
+ * }
74
+ * @see Index
75
+ * @since 1.0.0
76
+ */
77
+ export declare function For<T>(props: ForKeyedProps<T>): Accessor<unknown[]>;
78
+ export declare function For<T>(props: ForUnkeyedProps<T>): Accessor<unknown[]>;
79
+ //#endregion
80
+ //# sourceMappingURL=for.d.ts.map
@@ -0,0 +1,23 @@
1
+ import { mapArray, untrack } from "@shadow-js/core";
2
+ //#region src/control-flow/for.ts
3
+ /**
4
+ * Calls the row callback. `props.children` is read untracked, once per row.
5
+ * @internal
6
+ */
7
+ function renderRow(props, item, index) {
8
+ return untrack(() => props.children)(item, index);
9
+ }
10
+ function For(props) {
11
+ const list = () => props.each;
12
+ const fallback = () => props.fallback;
13
+ const keyOf = props.key;
14
+ if (keyOf === void 0) return mapArray(list, (item, index) => renderRow(props, item, index), { fallback });
15
+ return mapArray(list, (item, index) => renderRow(props, item, index), {
16
+ key: keyOf,
17
+ fallback
18
+ });
19
+ }
20
+ //#endregion
21
+ export { For };
22
+
23
+ //# sourceMappingURL=for.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"for.js","names":[],"sources":["../../../src/control-flow/for.ts"],"sourcesContent":["import { type Accessor, mapArray, untrack } from \"@shadow-js/core\";\n\n/**\n * Props of {@link For} without `key`: rows are matched by item reference.\n * @since 1.0.0\n */\nexport interface ForUnkeyedProps<T> {\n /**\n * The list to render. `null`, `undefined` and `false` count as an empty list. Read lazily, inside\n * the list memo, so it is tracked.\n */\n readonly each: readonly T[] | null | undefined | false;\n /**\n * Shown while the list is empty. Read lazily.\n * @default undefined (an empty list renders nothing)\n */\n readonly fallback?: unknown;\n /**\n * Absent in this form: rows are matched by item reference. Pass `key` to match by key.\n * No default: omit it for reference matching.\n */\n readonly key?: undefined;\n /** Called once per row, untracked. The callback receives the item value. */\n readonly children: (item: T, index: () => number) => unknown;\n}\n\n/**\n * Props of {@link For} with `key`: rows are matched by `key(item)`.\n * @since 1.0.0\n */\nexport interface ForKeyedProps<T> {\n /**\n * The list to render. `null`, `undefined` and `false` count as an empty list. Read lazily, inside\n * the list memo, so it is tracked.\n */\n readonly each: readonly T[] | null | undefined | false;\n /**\n * Shown while the list is empty. Read lazily.\n * @default undefined (an empty list renders nothing)\n */\n readonly fallback?: unknown;\n /** Identifies each item. A new object under the same key updates the row's `item()`. */\n readonly key: (item: T) => unknown;\n /** Called once per row, untracked. The callback receives an accessor of the item. */\n readonly children: (item: () => T, index: () => number) => unknown;\n}\n\n/**\n * Props of {@link For}.\n * @since 1.0.0\n */\nexport type ForProps<T> = ForUnkeyedProps<T> | ForKeyedProps<T>;\n\n/**\n * Calls the row callback. `props.children` is read untracked, once per row.\n * @internal\n */\nfunction renderRow(props: { readonly children: unknown }, item: unknown, index: () => number) {\n const render = untrack(() => props.children) as (item: unknown, index: () => number) => unknown;\n return render(item, index);\n}\n\n/**\n * Renders one row per item. Rows whose key survives an update keep their DOM and state; only\n * changed items create or dispose rows. The list is read lazily, inside the list memo.\n *\n * Whether rows are keyed is decided when `For` is created: it reads `key` once. When the list\n * is empty and `fallback` is not given, the result is `[undefined]`, which renders nothing.\n *\n * @param props See {@link ForUnkeyedProps} and {@link ForKeyedProps}.\n * @returns An accessor of the row values, in input order.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { For } from \"@shadow-js/web\";\n *\n * function TodoList() {\n * const [todos] = useSignal([{ id: 1, title: \"Write docs\" }]);\n * return (\n * <ul>\n * <For each={todos()} key={(todo) => todo.id} fallback={<li>Nothing to do</li>}>\n * {(todo) => <li>{todo().title}</li>}\n * </For>\n * </ul>\n * );\n * }\n * @see Index\n * @since 1.0.0\n */\nexport function For<T>(props: ForKeyedProps<T>): Accessor<unknown[]>;\nexport function For<T>(props: ForUnkeyedProps<T>): Accessor<unknown[]>;\nexport function For<T>(props: ForProps<T>): Accessor<unknown[]> {\n const list = (): readonly T[] | null | undefined | false => props.each;\n const fallback = (): unknown => props.fallback;\n const keyOf = props.key;\n if (keyOf === undefined) {\n return mapArray(list, (item: T, index: () => number) => renderRow(props, item, index), {\n fallback,\n });\n }\n return mapArray(list, (item: () => T, index: () => number) => renderRow(props, item, index), {\n key: keyOf,\n fallback,\n });\n}\n"],"mappings":";;;;;;AAyDA,SAAS,UAAU,OAAuC,MAAe,OAAqB;CAE5F,OADe,cAAc,MAAM,QACvB,CAAC,CAAC,MAAM,KAAK;AAC3B;AA8BA,SAAgB,IAAO,OAAyC;CAC9D,MAAM,aAAsD,MAAM;CAClE,MAAM,iBAA0B,MAAM;CACtC,MAAM,QAAQ,MAAM;CACpB,IAAI,UAAU,KAAA,GACZ,OAAO,SAAS,OAAO,MAAS,UAAwB,UAAU,OAAO,MAAM,KAAK,GAAG,EACrF,SACF,CAAC;CAEH,OAAO,SAAS,OAAO,MAAe,UAAwB,UAAU,OAAO,MAAM,KAAK,GAAG;EAC3F,KAAK;EACL;CACF,CAAC;AACH"}
@@ -0,0 +1,38 @@
1
+ //#region src/control-flow/fragment.d.ts
2
+ /**
3
+ * Props of {@link Fragment}.
4
+ * @since 1.0.0
5
+ */
6
+ export interface FragmentProps {
7
+ /**
8
+ * The children to group.
9
+ * @default undefined (the Fragment renders nothing)
10
+ */
11
+ readonly children?: unknown;
12
+ }
13
+ /**
14
+ * A no-op wrapper: returns `props.children` untouched, so the children are created by the caller's
15
+ * getter exactly as if no wrapper existed. Use it to group several children under one element.
16
+ *
17
+ * @param props The children to group.
18
+ * @returns `props.children`, unchanged.
19
+ * @example
20
+ * import { Fragment } from "@shadow-js/web";
21
+ *
22
+ * function Header() {
23
+ * return <h1>Title</h1>;
24
+ * }
25
+ *
26
+ * function Page() {
27
+ * return (
28
+ * <Fragment>
29
+ * <Header />
30
+ * <p>Body</p>
31
+ * </Fragment>
32
+ * );
33
+ * }
34
+ * @since 1.0.0
35
+ */
36
+ export declare function Fragment(props: FragmentProps): unknown;
37
+ //#endregion
38
+ //# sourceMappingURL=fragment.d.ts.map
@@ -0,0 +1,31 @@
1
+ //#region src/control-flow/fragment.ts
2
+ /**
3
+ * A no-op wrapper: returns `props.children` untouched, so the children are created by the caller's
4
+ * getter exactly as if no wrapper existed. Use it to group several children under one element.
5
+ *
6
+ * @param props The children to group.
7
+ * @returns `props.children`, unchanged.
8
+ * @example
9
+ * import { Fragment } from "@shadow-js/web";
10
+ *
11
+ * function Header() {
12
+ * return <h1>Title</h1>;
13
+ * }
14
+ *
15
+ * function Page() {
16
+ * return (
17
+ * <Fragment>
18
+ * <Header />
19
+ * <p>Body</p>
20
+ * </Fragment>
21
+ * );
22
+ * }
23
+ * @since 1.0.0
24
+ */
25
+ function Fragment(props) {
26
+ return props.children;
27
+ }
28
+ //#endregion
29
+ export { Fragment };
30
+
31
+ //# sourceMappingURL=fragment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fragment.js","names":[],"sources":["../../../src/control-flow/fragment.ts"],"sourcesContent":["/**\n * Props of {@link Fragment}.\n * @since 1.0.0\n */\nexport interface FragmentProps {\n /**\n * The children to group.\n * @default undefined (the Fragment renders nothing)\n */\n readonly children?: unknown;\n}\n\n/**\n * A no-op wrapper: returns `props.children` untouched, so the children are created by the caller's\n * getter exactly as if no wrapper existed. Use it to group several children under one element.\n *\n * @param props The children to group.\n * @returns `props.children`, unchanged.\n * @example\n * import { Fragment } from \"@shadow-js/web\";\n *\n * function Header() {\n * return <h1>Title</h1>;\n * }\n *\n * function Page() {\n * return (\n * <Fragment>\n * <Header />\n * <p>Body</p>\n * </Fragment>\n * );\n * }\n * @since 1.0.0\n */\nexport function Fragment(props: FragmentProps): unknown {\n return props.children;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,SAAS,OAA+B;CACtD,OAAO,MAAM;AACf"}
@@ -0,0 +1,64 @@
1
+ import { getOwner } from "@shadow-js/core";
2
+ //#region src/control-flow/hot-link.ts
3
+ /**
4
+ * The hot-update link between an error boundary and the modules its children were built from. Dev
5
+ * only: the callers reach this code behind `__DEV__`, so production bundles never include it.
6
+ *
7
+ * A boundary that shows its fallback listens to those modules. When one of them is hot-replaced (the
8
+ * edit is usually the fix), the boundary resets and builds its children again, so the user does not
9
+ * have to press retry. The same module set is kept while the children are built: each component instance
10
+ * adds its module to it when it is created (`hotModulesOf` in the proxy of `component()`).
11
+ */
12
+ /** The key the module set is stored under in the owner context of a boundary's children. */
13
+ const HOT_MODULES = /* @__PURE__ */ Symbol("HotModules");
14
+ /**
15
+ * Makes `modules` the set of the root that is being created (called inside its `createRoot`): every
16
+ * component created below that root adds its module to it.
17
+ * @internal
18
+ */
19
+ function attachHotModules(modules) {
20
+ const root = getOwner();
21
+ if (root === null) return;
22
+ const map = Object.create(root.context);
23
+ map[HOT_MODULES] = modules;
24
+ root.context = map;
25
+ }
26
+ /**
27
+ * The module set of the nearest boundary above `owner`, or undefined when there is none.
28
+ * @internal
29
+ */
30
+ function hotModulesOf(owner) {
31
+ return owner?.context?.[HOT_MODULES];
32
+ }
33
+ /**
34
+ * Creates the link of a boundary. `onUpdate` runs after a hot update of a module the boundary listens to,
35
+ * once the update is applied.
36
+ * @internal
37
+ */
38
+ function createHotLink(onUpdate) {
39
+ const modules = /* @__PURE__ */ new Set();
40
+ let armed = [];
41
+ const listener = () => {
42
+ onUpdate();
43
+ };
44
+ const disarm = () => {
45
+ for (const registry of armed) registry.listeners.delete(listener);
46
+ armed = [];
47
+ };
48
+ const arm = () => {
49
+ disarm();
50
+ for (const registry of modules) {
51
+ registry.listeners.add(listener);
52
+ armed.push(registry);
53
+ }
54
+ };
55
+ return {
56
+ modules,
57
+ arm,
58
+ disarm
59
+ };
60
+ }
61
+ //#endregion
62
+ export { attachHotModules, createHotLink, hotModulesOf };
63
+
64
+ //# sourceMappingURL=hot-link.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hot-link.js","names":[],"sources":["../../../src/control-flow/hot-link.ts"],"sourcesContent":["import { getOwner, type Owner } from \"@shadow-js/core\";\nimport type { ModuleRegistry } from \"../hmr\";\n\n/**\n * The hot-update link between an error boundary and the modules its children were built from. Dev\n * only: the callers reach this code behind `__DEV__`, so production bundles never include it.\n *\n * A boundary that shows its fallback listens to those modules. When one of them is hot-replaced (the\n * edit is usually the fix), the boundary resets and builds its children again, so the user does not\n * have to press retry. The same module set is kept while the children are built: each component instance\n * adds its module to it when it is created (`hotModulesOf` in the proxy of `component()`).\n */\n\n/** The key the module set is stored under in the owner context of a boundary's children. */\nconst HOT_MODULES: symbol = /* @__PURE__ */ Symbol(\"HotModules\");\n\n/**\n * Makes `modules` the set of the root that is being created (called inside its `createRoot`): every\n * component created below that root adds its module to it.\n * @internal\n */\nexport function attachHotModules(modules: Set<ModuleRegistry>): void {\n const root = getOwner();\n if (root === null) return;\n const map = Object.create(root.context) as Record<symbol, unknown>;\n map[HOT_MODULES] = modules;\n root.context = map;\n}\n\n/**\n * The module set of the nearest boundary above `owner`, or undefined when there is none.\n * @internal\n */\nexport function hotModulesOf(owner: Owner | null): Set<ModuleRegistry> | undefined {\n return owner?.context?.[HOT_MODULES] as Set<ModuleRegistry> | undefined;\n}\n\n/**\n * The link of one boundary: the modules its children were last built from, and the listener armed on\n * them while the boundary shows its fallback.\n * @internal\n */\nexport interface HotLink {\n /** The modules of the last children build. Cleared by the boundary before each build. */\n readonly modules: Set<ModuleRegistry>;\n /** Listens to every module in `modules`: a hot update of one of them calls the boundary's `onUpdate`. */\n arm(): void;\n /** Stops listening (the children built, or the boundary was disposed). */\n disarm(): void;\n}\n\n/**\n * Creates the link of a boundary. `onUpdate` runs after a hot update of a module the boundary listens to,\n * once the update is applied.\n * @internal\n */\nexport function createHotLink(onUpdate: () => void): HotLink {\n const modules = new Set<ModuleRegistry>();\n let armed: ModuleRegistry[] = [];\n const listener = (): void => {\n onUpdate();\n };\n const disarm = (): void => {\n for (const registry of armed) registry.listeners.delete(listener);\n armed = [];\n };\n const arm = (): void => {\n disarm();\n for (const registry of modules) {\n registry.listeners.add(listener);\n armed.push(registry);\n }\n };\n return { modules, arm, disarm };\n}\n"],"mappings":";;;;;;;;;;;;AAcA,MAAM,cAAsC,uBAAO,YAAY;;;;;;AAO/D,SAAgB,iBAAiB,SAAoC;CACnE,MAAM,OAAO,SAAS;CACtB,IAAI,SAAS,MAAM;CACnB,MAAM,MAAM,OAAO,OAAO,KAAK,OAAO;CACtC,IAAI,eAAe;CACnB,KAAK,UAAU;AACjB;;;;;AAMA,SAAgB,aAAa,OAAsD;CACjF,OAAO,OAAO,UAAU;AAC1B;;;;;;AAqBA,SAAgB,cAAc,UAA+B;CAC3D,MAAM,0BAAU,IAAI,IAAoB;CACxC,IAAI,QAA0B,CAAC;CAC/B,MAAM,iBAAuB;EAC3B,SAAS;CACX;CACA,MAAM,eAAqB;EACzB,KAAK,MAAM,YAAY,OAAO,SAAS,UAAU,OAAO,QAAQ;EAChE,QAAQ,CAAC;CACX;CACA,MAAM,YAAkB;EACtB,OAAO;EACP,KAAK,MAAM,YAAY,SAAS;GAC9B,SAAS,UAAU,IAAI,QAAQ;GAC/B,MAAM,KAAK,QAAQ;EACrB;CACF;CACA,OAAO;EAAE;EAAS;EAAK;CAAO;AAChC"}
@@ -0,0 +1,48 @@
1
+ import { Accessor } from "@shadow-js/core";
2
+ //#region src/control-flow/index-list.d.ts
3
+ /**
4
+ * Props of {@link Index}.
5
+ * @since 1.0.0
6
+ */
7
+ export interface IndexProps<T> {
8
+ /**
9
+ * The list to render. `null`, `undefined` and `false` count as an empty list. Read lazily, so it
10
+ * is tracked.
11
+ */
12
+ readonly each: readonly T[] | null | undefined | false;
13
+ /**
14
+ * Shown while the list is empty. Read lazily.
15
+ * @default undefined (an empty list renders nothing)
16
+ */
17
+ readonly fallback?: unknown;
18
+ /**
19
+ * Called once per position, untracked. The item is an accessor that follows the value at this
20
+ * position; the index is a plain number, because a position never changes.
21
+ */
22
+ readonly children: (item: () => T, index: number) => unknown;
23
+ }
24
+ /**
25
+ * Renders one row per position. Rows are created and removed only when the length changes; the
26
+ * row at position `i` stays, and its item accessor follows the value at `i`. Use it for
27
+ * primitive lists where identity does not matter.
28
+ *
29
+ * @param props See {@link IndexProps}.
30
+ * @returns An accessor of the row values, in input order.
31
+ * @example
32
+ * import { useSignal } from "@shadow-js/core";
33
+ * import { Index } from "@shadow-js/web";
34
+ *
35
+ * function Cells() {
36
+ * const [values] = useSignal([10, 20, 30]);
37
+ * return (
38
+ * <ul>
39
+ * <Index each={values()}>{(value, index) => <li>{`${index}: ${value()}`}</li>}</Index>
40
+ * </ul>
41
+ * );
42
+ * }
43
+ * @see For
44
+ * @since 1.0.0
45
+ */
46
+ export declare function Index<T>(props: IndexProps<T>): Accessor<unknown[]>;
47
+ //#endregion
48
+ //# sourceMappingURL=index-list.d.ts.map
@@ -0,0 +1,31 @@
1
+ import { indexArray, untrack } from "@shadow-js/core";
2
+ //#region src/control-flow/index-list.ts
3
+ /**
4
+ * Renders one row per position. Rows are created and removed only when the length changes; the
5
+ * row at position `i` stays, and its item accessor follows the value at `i`. Use it for
6
+ * primitive lists where identity does not matter.
7
+ *
8
+ * @param props See {@link IndexProps}.
9
+ * @returns An accessor of the row values, in input order.
10
+ * @example
11
+ * import { useSignal } from "@shadow-js/core";
12
+ * import { Index } from "@shadow-js/web";
13
+ *
14
+ * function Cells() {
15
+ * const [values] = useSignal([10, 20, 30]);
16
+ * return (
17
+ * <ul>
18
+ * <Index each={values()}>{(value, index) => <li>{`${index}: ${value()}`}</li>}</Index>
19
+ * </ul>
20
+ * );
21
+ * }
22
+ * @see For
23
+ * @since 1.0.0
24
+ */
25
+ function Index(props) {
26
+ return indexArray(() => props.each, (item, index) => untrack(() => props.children)(item, index), { fallback: () => props.fallback });
27
+ }
28
+ //#endregion
29
+ export { Index };
30
+
31
+ //# sourceMappingURL=index-list.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-list.js","names":[],"sources":["../../../src/control-flow/index-list.ts"],"sourcesContent":["import { type Accessor, indexArray, untrack } from \"@shadow-js/core\";\n\n/**\n * Props of {@link Index}.\n * @since 1.0.0\n */\nexport interface IndexProps<T> {\n /**\n * The list to render. `null`, `undefined` and `false` count as an empty list. Read lazily, so it\n * is tracked.\n */\n readonly each: readonly T[] | null | undefined | false;\n /**\n * Shown while the list is empty. Read lazily.\n * @default undefined (an empty list renders nothing)\n */\n readonly fallback?: unknown;\n /**\n * Called once per position, untracked. The item is an accessor that follows the value at this\n * position; the index is a plain number, because a position never changes.\n */\n readonly children: (item: () => T, index: number) => unknown;\n}\n\n/**\n * Renders one row per position. Rows are created and removed only when the length changes; the\n * row at position `i` stays, and its item accessor follows the value at `i`. Use it for\n * primitive lists where identity does not matter.\n *\n * @param props See {@link IndexProps}.\n * @returns An accessor of the row values, in input order.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { Index } from \"@shadow-js/web\";\n *\n * function Cells() {\n * const [values] = useSignal([10, 20, 30]);\n * return (\n * <ul>\n * <Index each={values()}>{(value, index) => <li>{`${index}: ${value()}`}</li>}</Index>\n * </ul>\n * );\n * }\n * @see For\n * @since 1.0.0\n */\nexport function Index<T>(props: IndexProps<T>): Accessor<unknown[]> {\n return indexArray(\n () => props.each,\n (item: () => T, index: number) => untrack(() => props.children)(item, index),\n { fallback: () => props.fallback },\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,MAAS,OAA2C;CAClE,OAAO,iBACC,MAAM,OACX,MAAe,UAAkB,cAAc,MAAM,QAAQ,CAAC,CAAC,MAAM,KAAK,GAC3E,EAAE,gBAAgB,MAAM,SAAS,CACnC;AACF"}
@@ -0,0 +1,15 @@
1
+ import { Activity, ActivityMode, ActivityProps } from "./activity.js";
2
+ import { ClientOnly, ClientOnlyProps } from "./client-only.js";
3
+ import { Dynamic, DynamicProps, createDynamic } from "./dynamic.js";
4
+ import { ErrorBoundary, ErrorBoundaryLooseProps, ErrorBoundaryProps } from "./error-boundary.js";
5
+ import { For, ForKeyedProps, ForProps, ForUnkeyedProps } from "./for.js";
6
+ import { Fragment, FragmentProps } from "./fragment.js";
7
+ import { Index, IndexProps } from "./index-list.js";
8
+ import { LazyComponent, lazy } from "./lazy.js";
9
+ import { NoHydration, NoHydrationProps } from "./no-hydration.js";
10
+ import { Portal, PortalProps } from "./portal.js";
11
+ import { Show, ShowLooseProps, ShowProps } from "./show.js";
12
+ import { Suspense, SuspenseProps } from "./suspense.js";
13
+ import { SuspenseList, SuspenseListProps } from "./suspense-list.js";
14
+ import { Match, MatchProps, Switch, SwitchProps } from "./switch.js";
15
+ export { Activity, type ActivityMode, type ActivityProps, ClientOnly, type ClientOnlyProps, Dynamic, type DynamicProps, ErrorBoundary, type ErrorBoundaryLooseProps, type ErrorBoundaryProps, For, type ForKeyedProps, type ForProps, type ForUnkeyedProps, Fragment, type FragmentProps, Index, type IndexProps, type LazyComponent, Match, type MatchProps, NoHydration, type NoHydrationProps, Portal, type PortalProps, Show, type ShowLooseProps, type ShowProps, Suspense, SuspenseList, type SuspenseListProps, type SuspenseProps, Switch, type SwitchProps, createDynamic, lazy };
@@ -0,0 +1,58 @@
1
+ import { Accessor } from "@shadow-js/core";
2
+ //#region src/control-flow/lazy.d.ts
3
+ type ComponentFunction<P> = (props: P) => unknown;
4
+ /**
5
+ * A component made by {@link lazy}: call it (or write it in JSX) like any component, and use
6
+ * `preload` to start the load early.
7
+ * @since 1.0.0
8
+ */
9
+ export interface LazyComponent<P> {
10
+ /**
11
+ * Renders the loaded component with `props`. While the code is loading the result is empty and the
12
+ * nearest `<Suspense>` shows its fallback; without a boundary nothing is rendered until the load
13
+ * resolves.
14
+ */
15
+ (props: P): Accessor<unknown>;
16
+ /**
17
+ * Starts loading without rendering and resolves to the component. Calls share one load, so the
18
+ * loader runs once. A failed load is not cached: the next call or render loads again.
19
+ */
20
+ preload(): Promise<ComponentFunction<P>>;
21
+ }
22
+ /**
23
+ * Defines a component whose code is loaded on first render. While loading, the nearest
24
+ * `<Suspense>` shows its fallback; a failed load throws to the nearest `<ErrorBoundary>` and the
25
+ * next render retries.
26
+ *
27
+ * @param loader Returns a promise of a module whose `default` export is the component, such as
28
+ * `() => import("./chart")`. Called at most once while its load succeeds.
29
+ * @returns A {@link LazyComponent}.
30
+ * @throws Nothing synchronously. A rejected load surfaces as an error when the component's output
31
+ * is read, so the nearest `<ErrorBoundary>` takes it; `preload()` rejects with the same error.
32
+ * @example
33
+ * import { lazy, Suspense } from "@shadow-js/web";
34
+ *
35
+ * function Chart(props: { title: string }) {
36
+ * return <h2>{props.title}</h2>;
37
+ * }
38
+ *
39
+ * // In an app the loader is `() => import("./chart")`.
40
+ * const LazyChart = lazy(() => Promise.resolve({ default: Chart }));
41
+ *
42
+ * function Page() {
43
+ * return (
44
+ * <Suspense fallback={<p>Loading...</p>}>
45
+ * <LazyChart title="Sales" />
46
+ * </Suspense>
47
+ * );
48
+ * }
49
+ * @see Suspense
50
+ * @see ErrorBoundary
51
+ * @since 1.0.0
52
+ */
53
+ export declare function lazy<P>(loader: () => Promise<{
54
+ default: ComponentFunction<P>;
55
+ }>): LazyComponent<P>;
56
+ //#endregion
57
+ export {};
58
+ //# sourceMappingURL=lazy.d.ts.map
@@ -0,0 +1,64 @@
1
+ import { untrack, useMemo, useResource } from "@shadow-js/core";
2
+ //#region src/control-flow/lazy.ts
3
+ /**
4
+ * Defines a component whose code is loaded on first render. While loading, the nearest
5
+ * `<Suspense>` shows its fallback; a failed load throws to the nearest `<ErrorBoundary>` and the
6
+ * next render retries.
7
+ *
8
+ * @param loader Returns a promise of a module whose `default` export is the component, such as
9
+ * `() => import("./chart")`. Called at most once while its load succeeds.
10
+ * @returns A {@link LazyComponent}.
11
+ * @throws Nothing synchronously. A rejected load surfaces as an error when the component's output
12
+ * is read, so the nearest `<ErrorBoundary>` takes it; `preload()` rejects with the same error.
13
+ * @example
14
+ * import { lazy, Suspense } from "@shadow-js/web";
15
+ *
16
+ * function Chart(props: { title: string }) {
17
+ * return <h2>{props.title}</h2>;
18
+ * }
19
+ *
20
+ * // In an app the loader is `() => import("./chart")`.
21
+ * const LazyChart = lazy(() => Promise.resolve({ default: Chart }));
22
+ *
23
+ * function Page() {
24
+ * return (
25
+ * <Suspense fallback={<p>Loading...</p>}>
26
+ * <LazyChart title="Sales" />
27
+ * </Suspense>
28
+ * );
29
+ * }
30
+ * @see Suspense
31
+ * @see ErrorBoundary
32
+ * @since 1.0.0
33
+ */
34
+ function lazy(loader) {
35
+ let pending;
36
+ let loaded;
37
+ const load = () => {
38
+ if (pending === void 0) pending = loader().then((module) => {
39
+ loaded = module.default;
40
+ return module.default;
41
+ }, (error) => {
42
+ pending = void 0;
43
+ throw error;
44
+ });
45
+ return pending;
46
+ };
47
+ const Lazy = ((props) => {
48
+ if (loaded !== void 0) {
49
+ const component = loaded;
50
+ return useMemo(() => untrack(() => component(props)), { allowWrites: true });
51
+ }
52
+ const resource = useResource(() => load());
53
+ return useMemo(() => {
54
+ const component = resource();
55
+ return component === void 0 ? void 0 : untrack(() => component(props));
56
+ }, { allowWrites: true });
57
+ });
58
+ Lazy.preload = load;
59
+ return Lazy;
60
+ }
61
+ //#endregion
62
+ export { lazy };
63
+
64
+ //# sourceMappingURL=lazy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lazy.js","names":[],"sources":["../../../src/control-flow/lazy.ts"],"sourcesContent":["import { type Accessor, untrack, useMemo, useResource } from \"@shadow-js/core\";\n\ntype ComponentFunction<P> = (props: P) => unknown;\n\n/**\n * A component made by {@link lazy}: call it (or write it in JSX) like any component, and use\n * `preload` to start the load early.\n * @since 1.0.0\n */\nexport interface LazyComponent<P> {\n /**\n * Renders the loaded component with `props`. While the code is loading the result is empty and the\n * nearest `<Suspense>` shows its fallback; without a boundary nothing is rendered until the load\n * resolves.\n */\n (props: P): Accessor<unknown>;\n /**\n * Starts loading without rendering and resolves to the component. Calls share one load, so the\n * loader runs once. A failed load is not cached: the next call or render loads again.\n */\n preload(): Promise<ComponentFunction<P>>;\n}\n\n/**\n * Defines a component whose code is loaded on first render. While loading, the nearest\n * `<Suspense>` shows its fallback; a failed load throws to the nearest `<ErrorBoundary>` and the\n * next render retries.\n *\n * @param loader Returns a promise of a module whose `default` export is the component, such as\n * `() => import(\"./chart\")`. Called at most once while its load succeeds.\n * @returns A {@link LazyComponent}.\n * @throws Nothing synchronously. A rejected load surfaces as an error when the component's output\n * is read, so the nearest `<ErrorBoundary>` takes it; `preload()` rejects with the same error.\n * @example\n * import { lazy, Suspense } from \"@shadow-js/web\";\n *\n * function Chart(props: { title: string }) {\n * return <h2>{props.title}</h2>;\n * }\n *\n * // In an app the loader is `() => import(\"./chart\")`.\n * const LazyChart = lazy(() => Promise.resolve({ default: Chart }));\n *\n * function Page() {\n * return (\n * <Suspense fallback={<p>Loading...</p>}>\n * <LazyChart title=\"Sales\" />\n * </Suspense>\n * );\n * }\n * @see Suspense\n * @see ErrorBoundary\n * @since 1.0.0\n */\nexport function lazy<P>(\n loader: () => Promise<{ default: ComponentFunction<P> }>,\n): LazyComponent<P> {\n let pending: Promise<ComponentFunction<P>> | undefined;\n let loaded: ComponentFunction<P> | undefined;\n\n const load = (): Promise<ComponentFunction<P>> => {\n if (pending === undefined) {\n pending = loader().then(\n (module) => {\n loaded = module.default;\n return module.default;\n },\n (error: unknown) => {\n pending = undefined;\n throw error;\n },\n );\n }\n return pending;\n };\n\n const Lazy = ((props: P): Accessor<unknown> => {\n if (loaded !== undefined) {\n const component = loaded;\n return useMemo(() => untrack(() => component(props)), { allowWrites: true });\n }\n const resource = useResource(() => load());\n return useMemo(\n () => {\n const component = resource();\n return component === undefined ? undefined : untrack(() => component(props));\n },\n { allowWrites: true },\n );\n }) as LazyComponent<P>;\n Lazy.preload = load;\n return Lazy;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,SAAgB,KACd,QACkB;CAClB,IAAI;CACJ,IAAI;CAEJ,MAAM,aAA4C;EAChD,IAAI,YAAY,KAAA,GACd,UAAU,OAAO,CAAC,CAAC,MAChB,WAAW;GACV,SAAS,OAAO;GAChB,OAAO,OAAO;EAChB,IACC,UAAmB;GAClB,UAAU,KAAA;GACV,MAAM;EACR,CACF;EAEF,OAAO;CACT;CAEA,MAAM,SAAS,UAAgC;EAC7C,IAAI,WAAW,KAAA,GAAW;GACxB,MAAM,YAAY;GAClB,OAAO,cAAc,cAAc,UAAU,KAAK,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC;EAC7E;EACA,MAAM,WAAW,kBAAkB,KAAK,CAAC;EACzC,OAAO,cACC;GACJ,MAAM,YAAY,SAAS;GAC3B,OAAO,cAAc,KAAA,IAAY,KAAA,IAAY,cAAc,UAAU,KAAK,CAAC;EAC7E,GACA,EAAE,aAAa,KAAK,CACtB;CACF;CACA,KAAK,UAAU;CACf,OAAO;AACT"}
@@ -0,0 +1,39 @@
1
+ import { Accessor } from "@shadow-js/core";
2
+ //#region src/control-flow/no-hydration.d.ts
3
+ /**
4
+ * Props of {@link NoHydration}.
5
+ * @since 1.0.0
6
+ */
7
+ export interface NoHydrationProps {
8
+ /**
9
+ * The static content. Rendered by the server without hydration keys and left untouched by the
10
+ * browser's hydration pass.
11
+ * @default undefined (renders nothing)
12
+ */
13
+ readonly children?: unknown;
14
+ }
15
+ /**
16
+ * Content the browser never hydrates: the server renders it without hydration keys, and while the
17
+ * page hydrates the browser leaves that markup exactly as it is (no code runs for it, no event
18
+ * handlers or reactivity are attached). Use it for static, heavy markup such as rendered
19
+ * documentation or a long article. Rendered by the browser alone (a client-side navigation), its
20
+ * children render normally.
21
+ *
22
+ * @param props See {@link NoHydrationProps}.
23
+ * @returns An accessor of the content: the children, or the server's own nodes while the browser hydrates.
24
+ * @example
25
+ * import { NoHydration } from "@shadow-js/web";
26
+ *
27
+ * function Docs(props: { html: string }) {
28
+ * return (
29
+ * <NoHydration>
30
+ * <article innerHTML={props.html} />
31
+ * </NoHydration>
32
+ * );
33
+ * }
34
+ * @see ClientOnly
35
+ * @since 1.0.0
36
+ */
37
+ export declare function NoHydration(props: NoHydrationProps): Accessor<unknown>;
38
+ //#endregion
39
+ //# sourceMappingURL=no-hydration.d.ts.map
@@ -0,0 +1,58 @@
1
+ import { nextKey } from "../internal/hydration-scope.js";
2
+ import { claims } from "../internal/hydration-hooks.js";
3
+ //#region src/control-flow/no-hydration.ts
4
+ /** The nodes between `<!--nh:KEY-->` and its `<!--/nh-->` in the lifted regions, or undefined when the server sent none. */
5
+ function findStatic(key, regions) {
6
+ if (key === void 0 || regions === void 0) return void 0;
7
+ for (const region of regions) {
8
+ const open = region.findIndex((node) => node.nodeType === 8 && node.data === `nh:${key}`);
9
+ if (open === -1) continue;
10
+ const nodes = [];
11
+ let depth = 1;
12
+ for (let i = open + 1; i < region.length; i += 1) {
13
+ const node = region[i];
14
+ if (node.nodeType === 8) {
15
+ const data = node.data;
16
+ if (data.startsWith("nh:")) depth += 1;
17
+ else if (data === "/nh" && --depth === 0) break;
18
+ }
19
+ nodes.push(node);
20
+ }
21
+ return nodes;
22
+ }
23
+ }
24
+ /**
25
+ * Content the browser never hydrates: the server renders it without hydration keys, and while the
26
+ * page hydrates the browser leaves that markup exactly as it is (no code runs for it, no event
27
+ * handlers or reactivity are attached). Use it for static, heavy markup such as rendered
28
+ * documentation or a long article. Rendered by the browser alone (a client-side navigation), its
29
+ * children render normally.
30
+ *
31
+ * @param props See {@link NoHydrationProps}.
32
+ * @returns An accessor of the content: the children, or the server's own nodes while the browser hydrates.
33
+ * @example
34
+ * import { NoHydration } from "@shadow-js/web";
35
+ *
36
+ * function Docs(props: { html: string }) {
37
+ * return (
38
+ * <NoHydration>
39
+ * <article innerHTML={props.html} />
40
+ * </NoHydration>
41
+ * );
42
+ * }
43
+ * @see ClientOnly
44
+ * @since 1.0.0
45
+ */
46
+ function NoHydration(props) {
47
+ const key = nextKey();
48
+ if (claims.current.isClaiming()) {
49
+ const kept = findStatic(key, claims.current.liftedRegions());
50
+ if (kept !== void 0) return () => kept;
51
+ return () => claims.current.withoutClaiming(() => props.children);
52
+ }
53
+ return () => props.children;
54
+ }
55
+ //#endregion
56
+ export { NoHydration };
57
+
58
+ //# sourceMappingURL=no-hydration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"no-hydration.js","names":[],"sources":["../../../src/control-flow/no-hydration.ts"],"sourcesContent":["import type { Accessor } from \"@shadow-js/core\";\nimport { claims, nextKey, withScope } from \"../extend\";\nimport { ssrRaw } from \"../server/element\";\n\n/** The nodes between `<!--nh:KEY-->` and its `<!--/nh-->` in the lifted regions, or undefined when the server sent none. */\nfunction findStatic(\n key: string | undefined,\n regions: readonly (readonly Node[])[] | undefined,\n): Node[] | undefined {\n if (key === undefined || regions === undefined) return undefined;\n for (const region of regions) {\n const open = region.findIndex(\n (node) => node.nodeType === 8 && (node as Comment).data === `nh:${key}`,\n );\n if (open === -1) continue;\n const nodes: Node[] = [];\n let depth = 1;\n for (let i = open + 1; i < region.length; i += 1) {\n const node = region[i] as Node;\n if (node.nodeType === 8) {\n const data = (node as Comment).data;\n if (data.startsWith(\"nh:\")) depth += 1;\n else if (data === \"/nh\" && --depth === 0) break;\n }\n nodes.push(node);\n }\n return nodes;\n }\n return undefined;\n}\n\n/**\n * Props of {@link NoHydration}.\n * @since 1.0.0\n */\nexport interface NoHydrationProps {\n /**\n * The static content. Rendered by the server without hydration keys and left untouched by the\n * browser's hydration pass.\n * @default undefined (renders nothing)\n */\n readonly children?: unknown;\n}\n\n/**\n * Content the browser never hydrates: the server renders it without hydration keys, and while the\n * page hydrates the browser leaves that markup exactly as it is (no code runs for it, no event\n * handlers or reactivity are attached). Use it for static, heavy markup such as rendered\n * documentation or a long article. Rendered by the browser alone (a client-side navigation), its\n * children render normally.\n *\n * @param props See {@link NoHydrationProps}.\n * @returns An accessor of the content: the children, or the server's own nodes while the browser hydrates.\n * @example\n * import { NoHydration } from \"@shadow-js/web\";\n *\n * function Docs(props: { html: string }) {\n * return (\n * <NoHydration>\n * <article innerHTML={props.html} />\n * </NoHydration>\n * );\n * }\n * @see ClientOnly\n * @since 1.0.0\n */\nexport function NoHydration(props: NoHydrationProps): Accessor<unknown> {\n // The component has its own scope, so this key does not move the keys of its siblings.\n const key = nextKey();\n if (__SERVER__) {\n // No scope for the content: the keys of what is rendered inside are not handed out.\n const built = withScope(null, () => props.children);\n return () => [ssrRaw(`<!--nh:${key ?? \"\"}-->`), built, ssrRaw(\"<!--/nh-->\")];\n }\n if (claims.current.isClaiming()) {\n // Hydrating: the server's nodes between the markers are handed to the region as they are.\n const kept = findStatic(key, claims.current.liftedRegions());\n if (kept !== undefined) return () => kept;\n // No markers from the server (the root of the container): render on the client, claiming nothing.\n return () => claims.current.withoutClaiming(() => props.children);\n }\n return () => props.children;\n}\n"],"mappings":";;;;AAKA,SAAS,WACP,KACA,SACoB;CACpB,IAAI,QAAQ,KAAA,KAAa,YAAY,KAAA,GAAW,OAAO,KAAA;CACvD,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,OAAO,OAAO,WACjB,SAAS,KAAK,aAAa,KAAM,KAAiB,SAAS,MAAM,KACpE;EACA,IAAI,SAAS,IAAI;EACjB,MAAM,QAAgB,CAAC;EACvB,IAAI,QAAQ;EACZ,KAAK,IAAI,IAAI,OAAO,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;GAChD,MAAM,OAAO,OAAO;GACpB,IAAI,KAAK,aAAa,GAAG;IACvB,MAAM,OAAQ,KAAiB;IAC/B,IAAI,KAAK,WAAW,KAAK,GAAG,SAAS;SAChC,IAAI,SAAS,SAAS,EAAE,UAAU,GAAG;GAC5C;GACA,MAAM,KAAK,IAAI;EACjB;EACA,OAAO;CACT;AAEF;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,YAAY,OAA4C;CAEtE,MAAM,MAAM,QAAQ;CAMpB,IAAI,OAAO,QAAQ,WAAW,GAAG;EAE/B,MAAM,OAAO,WAAW,KAAK,OAAO,QAAQ,cAAc,CAAC;EAC3D,IAAI,SAAS,KAAA,GAAW,aAAa;EAErC,aAAa,OAAO,QAAQ,sBAAsB,MAAM,QAAQ;CAClE;CACA,aAAa,MAAM;AACrB"}