@shadow-js/web 0.0.0-stage → 1.0.1

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 +18 -0
  2. package/LICENSE +21 -0
  3. package/README.md +190 -2
  4. package/dist/dev/attributes.d.ts +88 -0
  5. package/dist/dev/attributes.js +195 -0
  6. package/dist/dev/attributes.js.map +1 -0
  7. package/dist/dev/autofocus.d.ts +30 -0
  8. package/dist/dev/autofocus.js +44 -0
  9. package/dist/dev/autofocus.js.map +1 -0
  10. package/dist/dev/class-style.d.ts +87 -0
  11. package/dist/dev/class-style.js +196 -0
  12. package/dist/dev/class-style.js.map +1 -0
  13. package/dist/dev/component.d.ts +21 -0
  14. package/dist/dev/component.js +41 -0
  15. package/dist/dev/component.js.map +1 -0
  16. package/dist/dev/control-flow/activity.d.ts +56 -0
  17. package/dist/dev/control-flow/activity.js +135 -0
  18. package/dist/dev/control-flow/activity.js.map +1 -0
  19. package/dist/dev/control-flow/branch.js +103 -0
  20. package/dist/dev/control-flow/branch.js.map +1 -0
  21. package/dist/dev/control-flow/client-only.d.ts +46 -0
  22. package/dist/dev/control-flow/client-only.js +49 -0
  23. package/dist/dev/control-flow/client-only.js.map +1 -0
  24. package/dist/dev/control-flow/dynamic.d.ts +80 -0
  25. package/dist/dev/control-flow/dynamic.js +133 -0
  26. package/dist/dev/control-flow/dynamic.js.map +1 -0
  27. package/dist/dev/control-flow/error-boundary.d.ts +70 -0
  28. package/dist/dev/control-flow/error-boundary.js +114 -0
  29. package/dist/dev/control-flow/error-boundary.js.map +1 -0
  30. package/dist/dev/control-flow/for.d.ts +78 -0
  31. package/dist/dev/control-flow/for.js +22 -0
  32. package/dist/dev/control-flow/for.js.map +1 -0
  33. package/dist/dev/control-flow/fragment.d.ts +36 -0
  34. package/dist/dev/control-flow/fragment.js +30 -0
  35. package/dist/dev/control-flow/fragment.js.map +1 -0
  36. package/dist/dev/control-flow/hot-link.js +63 -0
  37. package/dist/dev/control-flow/hot-link.js.map +1 -0
  38. package/dist/dev/control-flow/index-list.d.ts +46 -0
  39. package/dist/dev/control-flow/index-list.js +30 -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 +56 -0
  43. package/dist/dev/control-flow/lazy.js +63 -0
  44. package/dist/dev/control-flow/lazy.js.map +1 -0
  45. package/dist/dev/control-flow/no-hydration.d.ts +37 -0
  46. package/dist/dev/control-flow/no-hydration.js +57 -0
  47. package/dist/dev/control-flow/no-hydration.js.map +1 -0
  48. package/dist/dev/control-flow/portal.d.ts +67 -0
  49. package/dist/dev/control-flow/portal.js +133 -0
  50. package/dist/dev/control-flow/portal.js.map +1 -0
  51. package/dist/dev/control-flow/root-errors.d.ts +23 -0
  52. package/dist/dev/control-flow/root-errors.js +32 -0
  53. package/dist/dev/control-flow/root-errors.js.map +1 -0
  54. package/dist/dev/control-flow/show.d.ts +99 -0
  55. package/dist/dev/control-flow/show.js +17 -0
  56. package/dist/dev/control-flow/show.js.map +1 -0
  57. package/dist/dev/control-flow/suspense-list.d.ts +63 -0
  58. package/dist/dev/control-flow/suspense-list.js +104 -0
  59. package/dist/dev/control-flow/suspense-list.js.map +1 -0
  60. package/dist/dev/control-flow/suspense.d.ts +51 -0
  61. package/dist/dev/control-flow/suspense.js +101 -0
  62. package/dist/dev/control-flow/suspense.js.map +1 -0
  63. package/dist/dev/control-flow/switch.d.ts +83 -0
  64. package/dist/dev/control-flow/switch.js +89 -0
  65. package/dist/dev/control-flow/switch.js.map +1 -0
  66. package/dist/dev/derived.d.ts +50 -0
  67. package/dist/dev/derived.js +33 -0
  68. package/dist/dev/derived.js.map +1 -0
  69. package/dist/dev/element.d.ts +38 -0
  70. package/dist/dev/element.js +104 -0
  71. package/dist/dev/element.js.map +1 -0
  72. package/dist/dev/events.d.ts +85 -0
  73. package/dist/dev/events.js +264 -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 +135 -0
  78. package/dist/dev/head/components.js +169 -0
  79. package/dist/dev/head/components.js.map +1 -0
  80. package/dist/dev/head/registry.js +67 -0
  81. package/dist/dev/head/registry.js.map +1 -0
  82. package/dist/dev/head/server-head.d.ts +52 -0
  83. package/dist/dev/head/server-head.js +75 -0
  84. package/dist/dev/head/server-head.js.map +1 -0
  85. package/dist/dev/head/sink.js +95 -0
  86. package/dist/dev/head/sink.js.map +1 -0
  87. package/dist/dev/head/use-head.d.ts +33 -0
  88. package/dist/dev/head/use-head.js +83 -0
  89. package/dist/dev/head/use-head.js.map +1 -0
  90. package/dist/dev/head/validate.d.ts +83 -0
  91. package/dist/dev/head/validate.js +267 -0
  92. package/dist/dev/head/validate.js.map +1 -0
  93. package/dist/dev/hmr.d.ts +80 -0
  94. package/dist/dev/hmr.js +123 -0
  95. package/dist/dev/hmr.js.map +1 -0
  96. package/dist/dev/hydration.d.ts +59 -0
  97. package/dist/dev/hydration.js +119 -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 +95 -0
  102. package/dist/dev/insert.js +356 -0
  103. package/dist/dev/insert.js.map +1 -0
  104. package/dist/dev/internal/claim.d.ts +104 -0
  105. package/dist/dev/internal/claim.js +356 -0
  106. package/dist/dev/internal/claim.js.map +1 -0
  107. package/dist/dev/internal/css-units.js +25 -0
  108. package/dist/dev/internal/css-units.js.map +1 -0
  109. package/dist/dev/internal/diagnostics.d.ts +28 -0
  110. package/dist/dev/internal/diagnostics.js +37 -0
  111. package/dist/dev/internal/diagnostics.js.map +1 -0
  112. package/dist/dev/internal/early-events.js +75 -0
  113. package/dist/dev/internal/early-events.js.map +1 -0
  114. package/dist/dev/internal/hydration-hooks.d.ts +41 -0
  115. package/dist/dev/internal/hydration-hooks.js +26 -0
  116. package/dist/dev/internal/hydration-hooks.js.map +1 -0
  117. package/dist/dev/internal/hydration-scope.d.ts +129 -0
  118. package/dist/dev/internal/hydration-scope.js +155 -0
  119. package/dist/dev/internal/hydration-scope.js.map +1 -0
  120. package/dist/dev/internal/names.d.ts +31 -0
  121. package/dist/dev/internal/names.js +34 -0
  122. package/dist/dev/internal/names.js.map +1 -0
  123. package/dist/dev/internal/portal-context.d.ts +37 -0
  124. package/dist/dev/internal/portal-context.js +27 -0
  125. package/dist/dev/internal/portal-context.js.map +1 -0
  126. package/dist/dev/internal/react-names.js +115 -0
  127. package/dist/dev/internal/react-names.js.map +1 -0
  128. package/dist/dev/internal/reconcile.d.ts +38 -0
  129. package/dist/dev/internal/reconcile.js +121 -0
  130. package/dist/dev/internal/reconcile.js.map +1 -0
  131. package/dist/dev/internal/stream-context.d.ts +45 -0
  132. package/dist/dev/internal/stream-context.js +22 -0
  133. package/dist/dev/internal/stream-context.js.map +1 -0
  134. package/dist/dev/jsx/aria.d.ts +70 -0
  135. package/dist/dev/jsx/component.d.ts +87 -0
  136. package/dist/dev/jsx/events.d.ts +362 -0
  137. package/dist/dev/jsx/global.d.ts +209 -0
  138. package/dist/dev/jsx/html.d.ts +877 -0
  139. package/dist/dev/jsx/intrinsic.d.ts +57 -0
  140. package/dist/dev/jsx/mathml.d.ts +184 -0
  141. package/dist/dev/jsx/svg.d.ts +605 -0
  142. package/dist/dev/jsx/types.d.ts +174 -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 +92 -0
  146. package/dist/dev/jsx-runtime.js +0 -0
  147. package/dist/dev/reactive.d.ts +108 -0
  148. package/dist/dev/reactive.js +84 -0
  149. package/dist/dev/reactive.js.map +1 -0
  150. package/dist/dev/render.d.ts +34 -0
  151. package/dist/dev/render.js +51 -0
  152. package/dist/dev/render.js.map +1 -0
  153. package/dist/dev/resource-hints.d.ts +143 -0
  154. package/dist/dev/resource-hints.js +199 -0
  155. package/dist/dev/resource-hints.js.map +1 -0
  156. package/dist/dev/select-value.d.ts +22 -0
  157. package/dist/dev/select-value.js +50 -0
  158. package/dist/dev/select-value.js.map +1 -0
  159. package/dist/dev/server/attributes.d.ts +31 -0
  160. package/dist/dev/server/attributes.js +154 -0
  161. package/dist/dev/server/attributes.js.map +1 -0
  162. package/dist/dev/server/class-style.d.ts +44 -0
  163. package/dist/dev/server/class-style.js +172 -0
  164. package/dist/dev/server/class-style.js.map +1 -0
  165. package/dist/dev/server/component.d.ts +40 -0
  166. package/dist/dev/server/component.js +71 -0
  167. package/dist/dev/server/component.js.map +1 -0
  168. package/dist/dev/server/derived.d.ts +39 -0
  169. package/dist/dev/server/derived.js +25 -0
  170. package/dist/dev/server/derived.js.map +1 -0
  171. package/dist/dev/server/element.d.ts +87 -0
  172. package/dist/dev/server/element.js +215 -0
  173. package/dist/dev/server/element.js.map +1 -0
  174. package/dist/dev/server/errors.js +25 -0
  175. package/dist/dev/server/errors.js.map +1 -0
  176. package/dist/dev/server/escape.d.ts +28 -0
  177. package/dist/dev/server/escape.js +118 -0
  178. package/dist/dev/server/escape.js.map +1 -0
  179. package/dist/dev/server/form-controls.d.ts +48 -0
  180. package/dist/dev/server/form-controls.js +192 -0
  181. package/dist/dev/server/form-controls.js.map +1 -0
  182. package/dist/dev/server/hydration-script.d.ts +63 -0
  183. package/dist/dev/server/hydration-script.js +58 -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 +11 -0
  188. package/dist/dev/server/node.js +20 -0
  189. package/dist/dev/server/node.js.map +1 -0
  190. package/dist/dev/server/portals.d.ts +44 -0
  191. package/dist/dev/server/portals.js +98 -0
  192. package/dist/dev/server/portals.js.map +1 -0
  193. package/dist/dev/server/render.d.ts +127 -0
  194. package/dist/dev/server/render.js +255 -0
  195. package/dist/dev/server/render.js.map +1 -0
  196. package/dist/dev/server/serialize.d.ts +43 -0
  197. package/dist/dev/server/serialize.js +314 -0
  198. package/dist/dev/server/serialize.js.map +1 -0
  199. package/dist/dev/server/stream.d.ts +92 -0
  200. package/dist/dev/server/stream.js +234 -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 +47 -0
  205. package/dist/dev/spread.js +295 -0
  206. package/dist/dev/spread.js.map +1 -0
  207. package/dist/dev/template.d.ts +24 -0
  208. package/dist/dev/template.js +119 -0
  209. package/dist/dev/template.js.map +1 -0
  210. package/dist/dev/view-transition.d.ts +95 -0
  211. package/dist/dev/view-transition.js +120 -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 +195 -0
  480. package/dist/server-dev/attributes.js.map +1 -0
  481. package/dist/server-dev/autofocus.js +44 -0
  482. package/dist/server-dev/autofocus.js.map +1 -0
  483. package/dist/server-dev/class-style.js +196 -0
  484. package/dist/server-dev/class-style.js.map +1 -0
  485. package/dist/server-dev/component.js +41 -0
  486. package/dist/server-dev/component.js.map +1 -0
  487. package/dist/server-dev/control-flow/activity.js +40 -0
  488. package/dist/server-dev/control-flow/activity.js.map +1 -0
  489. package/dist/server-dev/control-flow/branch.js +103 -0
  490. package/dist/server-dev/control-flow/branch.js.map +1 -0
  491. package/dist/server-dev/control-flow/client-only.js +49 -0
  492. package/dist/server-dev/control-flow/client-only.js.map +1 -0
  493. package/dist/server-dev/control-flow/dynamic.js +105 -0
  494. package/dist/server-dev/control-flow/dynamic.js.map +1 -0
  495. package/dist/server-dev/control-flow/error-boundary.js +114 -0
  496. package/dist/server-dev/control-flow/error-boundary.js.map +1 -0
  497. package/dist/server-dev/control-flow/for.js +22 -0
  498. package/dist/server-dev/control-flow/for.js.map +1 -0
  499. package/dist/server-dev/control-flow/fragment.js +30 -0
  500. package/dist/server-dev/control-flow/fragment.js.map +1 -0
  501. package/dist/server-dev/control-flow/hot-link.js +56 -0
  502. package/dist/server-dev/control-flow/hot-link.js.map +1 -0
  503. package/dist/server-dev/control-flow/index-list.js +30 -0
  504. package/dist/server-dev/control-flow/index-list.js.map +1 -0
  505. package/dist/server-dev/control-flow/lazy.js +63 -0
  506. package/dist/server-dev/control-flow/lazy.js.map +1 -0
  507. package/dist/server-dev/control-flow/no-hydration.js +39 -0
  508. package/dist/server-dev/control-flow/no-hydration.js.map +1 -0
  509. package/dist/server-dev/control-flow/portal.js +133 -0
  510. package/dist/server-dev/control-flow/portal.js.map +1 -0
  511. package/dist/server-dev/control-flow/root-errors.js +32 -0
  512. package/dist/server-dev/control-flow/root-errors.js.map +1 -0
  513. package/dist/server-dev/control-flow/show.js +17 -0
  514. package/dist/server-dev/control-flow/show.js.map +1 -0
  515. package/dist/server-dev/control-flow/suspense-list.js +99 -0
  516. package/dist/server-dev/control-flow/suspense-list.js.map +1 -0
  517. package/dist/server-dev/control-flow/suspense.js +118 -0
  518. package/dist/server-dev/control-flow/suspense.js.map +1 -0
  519. package/dist/server-dev/control-flow/switch.js +89 -0
  520. package/dist/server-dev/control-flow/switch.js.map +1 -0
  521. package/dist/server-dev/derived.js +33 -0
  522. package/dist/server-dev/derived.js.map +1 -0
  523. package/dist/server-dev/element.js +65 -0
  524. package/dist/server-dev/element.js.map +1 -0
  525. package/dist/server-dev/events.js +264 -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 +169 -0
  529. package/dist/server-dev/head/components.js.map +1 -0
  530. package/dist/server-dev/head/registry.js +67 -0
  531. package/dist/server-dev/head/registry.js.map +1 -0
  532. package/dist/server-dev/head/server-head.js +75 -0
  533. package/dist/server-dev/head/server-head.js.map +1 -0
  534. package/dist/server-dev/head/sink.js +95 -0
  535. package/dist/server-dev/head/sink.js.map +1 -0
  536. package/dist/server-dev/head/use-head.js +83 -0
  537. package/dist/server-dev/head/use-head.js.map +1 -0
  538. package/dist/server-dev/head/validate.js +267 -0
  539. package/dist/server-dev/head/validate.js.map +1 -0
  540. package/dist/server-dev/hydration.js +119 -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 +356 -0
  544. package/dist/server-dev/insert.js.map +1 -0
  545. package/dist/server-dev/internal/claim.js +356 -0
  546. package/dist/server-dev/internal/claim.js.map +1 -0
  547. package/dist/server-dev/internal/css-units.js +25 -0
  548. package/dist/server-dev/internal/css-units.js.map +1 -0
  549. package/dist/server-dev/internal/diagnostics.js +37 -0
  550. package/dist/server-dev/internal/diagnostics.js.map +1 -0
  551. package/dist/server-dev/internal/early-events.js +75 -0
  552. package/dist/server-dev/internal/early-events.js.map +1 -0
  553. package/dist/server-dev/internal/hydration-hooks.js +26 -0
  554. package/dist/server-dev/internal/hydration-hooks.js.map +1 -0
  555. package/dist/server-dev/internal/hydration-scope.js +155 -0
  556. package/dist/server-dev/internal/hydration-scope.js.map +1 -0
  557. package/dist/server-dev/internal/names.js +34 -0
  558. package/dist/server-dev/internal/names.js.map +1 -0
  559. package/dist/server-dev/internal/portal-context.js +27 -0
  560. package/dist/server-dev/internal/portal-context.js.map +1 -0
  561. package/dist/server-dev/internal/react-names.js +115 -0
  562. package/dist/server-dev/internal/react-names.js.map +1 -0
  563. package/dist/server-dev/internal/reconcile.js +121 -0
  564. package/dist/server-dev/internal/reconcile.js.map +1 -0
  565. package/dist/server-dev/internal/stream-context.js +22 -0
  566. package/dist/server-dev/internal/stream-context.js.map +1 -0
  567. package/dist/server-dev/reactive.js +84 -0
  568. package/dist/server-dev/reactive.js.map +1 -0
  569. package/dist/server-dev/render.js +51 -0
  570. package/dist/server-dev/render.js.map +1 -0
  571. package/dist/server-dev/resource-hints.js +199 -0
  572. package/dist/server-dev/resource-hints.js.map +1 -0
  573. package/dist/server-dev/select-value.js +50 -0
  574. package/dist/server-dev/select-value.js.map +1 -0
  575. package/dist/server-dev/server/attributes.js +154 -0
  576. package/dist/server-dev/server/attributes.js.map +1 -0
  577. package/dist/server-dev/server/class-style.js +172 -0
  578. package/dist/server-dev/server/class-style.js.map +1 -0
  579. package/dist/server-dev/server/component.js +71 -0
  580. package/dist/server-dev/server/component.js.map +1 -0
  581. package/dist/server-dev/server/derived.js +25 -0
  582. package/dist/server-dev/server/derived.js.map +1 -0
  583. package/dist/server-dev/server/element.js +215 -0
  584. package/dist/server-dev/server/element.js.map +1 -0
  585. package/dist/server-dev/server/errors.js +25 -0
  586. package/dist/server-dev/server/errors.js.map +1 -0
  587. package/dist/server-dev/server/escape.js +118 -0
  588. package/dist/server-dev/server/escape.js.map +1 -0
  589. package/dist/server-dev/server/form-controls.js +192 -0
  590. package/dist/server-dev/server/form-controls.js.map +1 -0
  591. package/dist/server-dev/server/hydration-script.js +58 -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 +20 -0
  595. package/dist/server-dev/server/node.js.map +1 -0
  596. package/dist/server-dev/server/portals.js +98 -0
  597. package/dist/server-dev/server/portals.js.map +1 -0
  598. package/dist/server-dev/server/render.js +255 -0
  599. package/dist/server-dev/server/render.js.map +1 -0
  600. package/dist/server-dev/server/serialize.js +314 -0
  601. package/dist/server-dev/server/serialize.js.map +1 -0
  602. package/dist/server-dev/server/stream.js +234 -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 +295 -0
  606. package/dist/server-dev/spread.js.map +1 -0
  607. package/dist/server-dev/template.js +119 -0
  608. package/dist/server-dev/template.js.map +1 -0
  609. package/dist/server-dev/view-transition.js +89 -0
  610. package/dist/server-dev/view-transition.js.map +1 -0
  611. package/package.json +136 -4
@@ -0,0 +1,37 @@
1
+ // src/internal/diagnostics.ts
2
+ const seen = /* @__PURE__ */ new Set();
3
+ /**
4
+ * Prints a development warning as `[shadow CODE] detail`, at most once per code for the life of the
5
+ * page or process (the same pattern as core's `warn`): for a custom renderer that refuses a value the
6
+ * way the built-in ones do. Production builds print nothing.
7
+ *
8
+ * @param code The diagnostic code. A code that was already reported is ignored, whatever the detail.
9
+ * @param detail The text after the code.
10
+ * @example
11
+ * import { isUnsafeUrlAttribute, warnOnce } from "@shadow-js/web/extend";
12
+ *
13
+ * function setLink(el: Element, url: string): void {
14
+ * if (isUnsafeUrlAttribute("href", url)) {
15
+ * warnOnce("UNSAFE_URL_BLOCKED", `Blocked a script URL: ${url}`);
16
+ * return;
17
+ * }
18
+ * el.setAttribute("href", url);
19
+ * }
20
+ * @since 1.0.0
21
+ */
22
+ function warnOnce(code, detail) {
23
+ if (seen.has(code)) return;
24
+ seen.add(code);
25
+ console.warn(`[shadow ${code}] ${detail}`);
26
+ }
27
+ /**
28
+ * Error thrown for attribute names that cannot appear in markup. Dev builds carry the full text;
29
+ * production keeps the code and the name (the same split as core's messages).
30
+ * @internal
31
+ */
32
+ function invalidAttributeName(name) {
33
+ return /* @__PURE__ */ new TypeError(`[shadow INVALID_ATTRIBUTE_NAME] "${name}" is not a valid attribute name.`);
34
+ }
35
+ export { invalidAttributeName, warnOnce };
36
+
37
+ //# sourceMappingURL=diagnostics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diagnostics.js","names":[],"sources":["../../../src/internal/diagnostics.ts"],"sourcesContent":["/**\n * The diagnostic codes of the DOM runtime: `UNSAFE_URL_BLOCKED` (a URL attribute that would run\n * script was not written), `INVALID_ATTRIBUTE_NAME` (a name that cannot appear in markup) and\n * `DUPLICATE_CLASS_ATTRIBUTE` (one element carries `class` and `className`, so the parser drops one).\n * @since 1.0.0\n */\nexport type WebWarningCode =\n | \"UNSAFE_URL_BLOCKED\"\n | \"INVALID_ATTRIBUTE_NAME\"\n | \"DUPLICATE_CLASS_ATTRIBUTE\";\n\nconst seen = new Set<WebWarningCode>();\n\n/**\n * Prints a development warning as `[shadow CODE] detail`, at most once per code for the life of the\n * page or process (the same pattern as core's `warn`): for a custom renderer that refuses a value the\n * way the built-in ones do. Production builds print nothing.\n *\n * @param code The diagnostic code. A code that was already reported is ignored, whatever the detail.\n * @param detail The text after the code.\n * @example\n * import { isUnsafeUrlAttribute, warnOnce } from \"@shadow-js/web/extend\";\n *\n * function setLink(el: Element, url: string): void {\n * if (isUnsafeUrlAttribute(\"href\", url)) {\n * warnOnce(\"UNSAFE_URL_BLOCKED\", `Blocked a script URL: ${url}`);\n * return;\n * }\n * el.setAttribute(\"href\", url);\n * }\n * @since 1.0.0\n */\nexport function warnOnce(code: WebWarningCode, detail: string): void {\n if (!__DEV__) return;\n if (seen.has(code)) return;\n seen.add(code);\n console.warn(`[shadow ${code}] ${detail}`);\n}\n\n/** Forgets which codes were already reported. Used by tests; not part of the public surface. @internal */\nexport function resetWebWarningDedupe(): void {\n seen.clear();\n}\n\n/**\n * Error thrown for attribute names that cannot appear in markup. Dev builds carry the full text;\n * production keeps the code and the name (the same split as core's messages).\n * @internal\n */\nexport function invalidAttributeName(name: string): TypeError {\n if (!__DEV__) return new TypeError(`SHADOW_INVALID_ATTRIBUTE_NAME: \"${name}\"`);\n return new TypeError(`[shadow INVALID_ATTRIBUTE_NAME] \"${name}\" is not a valid attribute name.`);\n}\n"],"mappings":";AAWA,MAAM,uBAAO,IAAI,IAAoB;;;;;;;;;;;;;;;;;;;;AAqBrC,SAAgB,SAAS,MAAsB,QAAsB;CAEnE,IAAI,KAAK,IAAI,IAAI,GAAG;CACpB,KAAK,IAAI,IAAI;CACb,QAAQ,KAAK,WAAW,KAAK,IAAI,QAAQ;AAC3C;;;;;;AAYA,SAAgB,qBAAqB,MAAyB;CAE5D,uBAAO,IAAI,UAAU,oCAAoC,KAAK,iCAAiC;AACjG"}
@@ -0,0 +1,75 @@
1
+ // src/internal/early-events.ts
2
+ /**
3
+ * Early event capture (ADR-016): a tiny inline script, placed before the bundle, records the events a
4
+ * user makes before the application has hydrated. `hydrate()` then replays them once its handlers are
5
+ * attached, so a click made while the page was still loading is not lost. The script is generated by
6
+ * `generateHydrationScript` on the server; the replay is the client half, and it does nothing when the
7
+ * page has no captured events.
8
+ */
9
+ /** The event types recorded when a page does not name its own. @internal */
10
+ const DEFAULT_EARLY_EVENTS = ["click", "input"];
11
+ /** The window property the capture script writes. Its shape is checked before use. @internal */
12
+ const EARLY_CAPTURE_KEY = "__SHADOWJS_EARLY__";
13
+ /** Event names are plain lower-case words: anything else would end up inside the script text. */
14
+ const EVENT_NAME = /^[a-z]+$/;
15
+ /**
16
+ * The inline script body. A capture listener on the document (capture phase, so it sees events even
17
+ * when a page stops their propagation) queues each event; the queue and the listener are kept on
18
+ * `window` for the replay.
19
+ * @internal
20
+ */
21
+ function captureScriptBody(names) {
22
+ return "(function(){var d=document,n=" + JSON.stringify(names.filter((name) => EVENT_NAME.test(name))) + `,q=[];function c(e){q.push(e)}for(var i=0;i<n.length;i++)d.addEventListener(n[i],c,true);window.${EARLY_CAPTURE_KEY}={queue:q,names:n,listener:c};})();`;
23
+ }
24
+ /** The capture the script left on the window, validated, or undefined. */
25
+ function readCapture() {
26
+ const value = Reflect.get(globalThis, EARLY_CAPTURE_KEY);
27
+ if (typeof value !== "object" || value === null) return void 0;
28
+ const queue = Reflect.get(value, "queue");
29
+ const names = Reflect.get(value, "names");
30
+ const listener = Reflect.get(value, "listener");
31
+ if (!Array.isArray(queue) || !Array.isArray(names) || typeof listener !== "function") return;
32
+ return {
33
+ queue: queue.filter((item) => item instanceof Event),
34
+ names: names.filter((name) => typeof name === "string"),
35
+ listener
36
+ };
37
+ }
38
+ /** A new event of the same type that bubbles like the original and carries its pointer position. */
39
+ function reissue(event) {
40
+ const init = {
41
+ bubbles: true,
42
+ cancelable: event.cancelable,
43
+ composed: true
44
+ };
45
+ if (event instanceof MouseEvent) return new MouseEvent(event.type, {
46
+ ...init,
47
+ clientX: event.clientX,
48
+ clientY: event.clientY,
49
+ button: event.button,
50
+ buttons: event.buttons,
51
+ altKey: event.altKey,
52
+ ctrlKey: event.ctrlKey,
53
+ metaKey: event.metaKey,
54
+ shiftKey: event.shiftKey
55
+ });
56
+ return new Event(event.type, init);
57
+ }
58
+ /**
59
+ * Stops the capture and replays what it recorded, in order, on the elements they were made on. Called
60
+ * by `hydrate()` after the handlers are attached. Does nothing when no capture ran.
61
+ * @internal
62
+ */
63
+ function replayEarlyEvents() {
64
+ const capture = readCapture();
65
+ if (capture === void 0) return;
66
+ Reflect.deleteProperty(globalThis, EARLY_CAPTURE_KEY);
67
+ for (const name of capture.names) document.removeEventListener(name, capture.listener, true);
68
+ for (const event of capture.queue) {
69
+ const target = event.target;
70
+ if (target instanceof Node) target.dispatchEvent(reissue(event));
71
+ }
72
+ }
73
+ export { DEFAULT_EARLY_EVENTS, EARLY_CAPTURE_KEY, captureScriptBody, replayEarlyEvents };
74
+
75
+ //# sourceMappingURL=early-events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"early-events.js","names":[],"sources":["../../../src/internal/early-events.ts"],"sourcesContent":["/**\n * Early event capture (ADR-016): a tiny inline script, placed before the bundle, records the events a\n * user makes before the application has hydrated. `hydrate()` then replays them once its handlers are\n * attached, so a click made while the page was still loading is not lost. The script is generated by\n * `generateHydrationScript` on the server; the replay is the client half, and it does nothing when the\n * page has no captured events.\n */\n\n/** The event types recorded when a page does not name its own. @internal */\nexport const DEFAULT_EARLY_EVENTS: readonly string[] = [\"click\", \"input\"];\n\n/** The window property the capture script writes. Its shape is checked before use. @internal */\nexport const EARLY_CAPTURE_KEY = \"__SHADOWJS_EARLY__\";\n\n/** Event names are plain lower-case words: anything else would end up inside the script text. */\nconst EVENT_NAME = /^[a-z]+$/;\n\n/**\n * The inline script body. A capture listener on the document (capture phase, so it sees events even\n * when a page stops their propagation) queues each event; the queue and the listener are kept on\n * `window` for the replay.\n * @internal\n */\nexport function captureScriptBody(names: readonly string[]): string {\n const list = JSON.stringify(names.filter((name) => EVENT_NAME.test(name)));\n return (\n \"(function(){var d=document,n=\" +\n list +\n \",q=[];function c(e){q.push(e)}\" +\n \"for(var i=0;i<n.length;i++)d.addEventListener(n[i],c,true);\" +\n `window.${EARLY_CAPTURE_KEY}={queue:q,names:n,listener:c};})();`\n );\n}\n\ninterface Capture {\n readonly queue: Event[];\n readonly names: string[];\n readonly listener: (event: Event) => void;\n}\n\n/** The capture the script left on the window, validated, or undefined. */\nfunction readCapture(): Capture | undefined {\n const value: unknown = Reflect.get(globalThis, EARLY_CAPTURE_KEY);\n if (typeof value !== \"object\" || value === null) return undefined;\n const queue: unknown = Reflect.get(value, \"queue\");\n const names: unknown = Reflect.get(value, \"names\");\n const listener: unknown = Reflect.get(value, \"listener\");\n if (!Array.isArray(queue) || !Array.isArray(names) || typeof listener !== \"function\") {\n return undefined;\n }\n const events = queue.filter((item): item is Event => item instanceof Event);\n const kinds = names.filter((name): name is string => typeof name === \"string\");\n return { queue: events, names: kinds, listener: listener as (event: Event) => void };\n}\n\n/** A new event of the same type that bubbles like the original and carries its pointer position. */\nfunction reissue(event: Event): Event {\n const init: EventInit = { bubbles: true, cancelable: event.cancelable, composed: true };\n if (event instanceof MouseEvent) {\n return new MouseEvent(event.type, {\n ...init,\n clientX: event.clientX,\n clientY: event.clientY,\n button: event.button,\n buttons: event.buttons,\n altKey: event.altKey,\n ctrlKey: event.ctrlKey,\n metaKey: event.metaKey,\n shiftKey: event.shiftKey,\n });\n }\n return new Event(event.type, init);\n}\n\n/**\n * Stops the capture and replays what it recorded, in order, on the elements they were made on. Called\n * by `hydrate()` after the handlers are attached. Does nothing when no capture ran.\n * @internal\n */\nexport function replayEarlyEvents(): void {\n const capture = readCapture();\n if (capture === undefined) return;\n Reflect.deleteProperty(globalThis, EARLY_CAPTURE_KEY);\n for (const name of capture.names) document.removeEventListener(name, capture.listener, true);\n for (const event of capture.queue) {\n const target = event.target;\n if (target instanceof Node) target.dispatchEvent(reissue(event));\n }\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,uBAA0C,CAAC,SAAS,OAAO;;AAGxE,MAAa,oBAAoB;;AAGjC,MAAM,aAAa;;;;;;;AAQnB,SAAgB,kBAAkB,OAAkC;CAElE,OACE,kCAFW,KAAK,UAAU,MAAM,QAAQ,SAAS,WAAW,KAAK,IAAI,CAAC,CAGnE,IACH,mGAEU,kBAAkB;AAEhC;;AASA,SAAS,cAAmC;CAC1C,MAAM,QAAiB,QAAQ,IAAI,YAAY,iBAAiB;CAChE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,QAAiB,QAAQ,IAAI,OAAO,OAAO;CACjD,MAAM,QAAiB,QAAQ,IAAI,OAAO,OAAO;CACjD,MAAM,WAAoB,QAAQ,IAAI,OAAO,UAAU;CACvD,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,CAAC,MAAM,QAAQ,KAAK,KAAK,OAAO,aAAa,YACxE;CAIF,OAAO;EAAE,OAFM,MAAM,QAAQ,SAAwB,gBAAgB,KAEhD;EAAG,OADV,MAAM,QAAQ,SAAyB,OAAO,SAAS,QAClC;EAAa;CAAmC;AACrF;;AAGA,SAAS,QAAQ,OAAqB;CACpC,MAAM,OAAkB;EAAE,SAAS;EAAM,YAAY,MAAM;EAAY,UAAU;CAAK;CACtF,IAAI,iBAAiB,YACnB,OAAO,IAAI,WAAW,MAAM,MAAM;EAChC,GAAG;EACH,SAAS,MAAM;EACf,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,SAAS,MAAM;EACf,SAAS,MAAM;EACf,UAAU,MAAM;CAClB,CAAC;CAEH,OAAO,IAAI,MAAM,MAAM,MAAM,IAAI;AACnC;;;;;;AAOA,SAAgB,oBAA0B;CACxC,MAAM,UAAU,YAAY;CAC5B,IAAI,YAAY,KAAA,GAAW;CAC3B,QAAQ,eAAe,YAAY,iBAAiB;CACpD,KAAK,MAAM,QAAQ,QAAQ,OAAO,SAAS,oBAAoB,MAAM,QAAQ,UAAU,IAAI;CAC3F,KAAK,MAAM,SAAS,QAAQ,OAAO;EACjC,MAAM,SAAS,MAAM;EACrB,IAAI,kBAAkB,MAAM,OAAO,cAAc,QAAQ,KAAK,CAAC;CACjE;AACF"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * The claiming half of hydration, as a hook. `hydrate()` installs the real implementation for the
3
+ * length of its pass; outside a pass the hooks are idle: nothing is claimed, and the renderer builds
4
+ * the same DOM it builds on a fresh page. Templates, regions, `Dynamic`, `Portal` and `NoHydration`
5
+ * call through {@link claims}, so only code that reaches `hydrate()` carries the claiming code (the
6
+ * registry, the server-block lifting and the portal scan). A custom renderer reads the same hook.
7
+ * @since 1.0.0
8
+ */
9
+ export interface Claims {
10
+ /** Claims the server element for `key` (see `claimElement`). */
11
+ claimElement(key: string | undefined): Element | null;
12
+ /** Adopts the next server region of `parent` (see `takeRegion`). */
13
+ takeRegion(parent: Node, anchorNode: Node | null): Node[] | undefined;
14
+ /** The content of every region lifted out of a claimed element (see `liftedRegions`). */
15
+ liftedRegions(): readonly (readonly Node[])[] | undefined;
16
+ /** Adopts the server block of a portal (see `claimPortal`). */
17
+ claimPortal(key: string | undefined): Node[] | undefined;
18
+ /** True while a hydration pass claims server DOM (see `isClaiming`). */
19
+ isClaiming(): boolean;
20
+ /** Runs `fn` with claiming off (see `withoutClaiming`). */
21
+ withoutClaiming<T>(fn: () => T): T;
22
+ }
23
+ /**
24
+ * The claims in effect. Read at each call (never captured), so a region that is updated after its
25
+ * hydration pass ended builds fresh DOM. Only `hydrate()` replaces it, and restores it in `finally`.
26
+ * Outside a hydration pass every method is a no-op.
27
+ *
28
+ * @example
29
+ * import { claims, nextKey } from "@shadow-js/web/extend";
30
+ *
31
+ * function createCard(): Element {
32
+ * // Adopts the server's element during hydrate(); builds a new one otherwise.
33
+ * return claims.current.claimElement(nextKey()) ?? document.createElement("article");
34
+ * }
35
+ * @see Claims
36
+ * @since 1.0.0
37
+ */
38
+ export declare const claims: {
39
+ current: Claims;
40
+ };
41
+ //# sourceMappingURL=hydration-hooks.d.ts.map
@@ -0,0 +1,26 @@
1
+ /**
2
+ * The claims in effect. Read at each call (never captured), so a region that is updated after its
3
+ * hydration pass ended builds fresh DOM. Only `hydrate()` replaces it, and restores it in `finally`.
4
+ * Outside a hydration pass every method is a no-op.
5
+ *
6
+ * @example
7
+ * import { claims, nextKey } from "@shadow-js/web/extend";
8
+ *
9
+ * function createCard(): Element {
10
+ * // Adopts the server's element during hydrate(); builds a new one otherwise.
11
+ * return claims.current.claimElement(nextKey()) ?? document.createElement("article");
12
+ * }
13
+ * @see Claims
14
+ * @since 1.0.0
15
+ */
16
+ const claims = { current: {
17
+ claimElement: () => null,
18
+ takeRegion: () => void 0,
19
+ liftedRegions: () => void 0,
20
+ claimPortal: () => void 0,
21
+ isClaiming: () => false,
22
+ withoutClaiming: (fn) => fn()
23
+ } };
24
+ export { claims };
25
+
26
+ //# sourceMappingURL=hydration-hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hydration-hooks.js","names":[],"sources":["../../../src/internal/hydration-hooks.ts"],"sourcesContent":["/**\n * The claiming half of hydration, as a hook. `hydrate()` installs the real implementation for the\n * length of its pass; outside a pass the hooks are idle: nothing is claimed, and the renderer builds\n * the same DOM it builds on a fresh page. Templates, regions, `Dynamic`, `Portal` and `NoHydration`\n * call through {@link claims}, so only code that reaches `hydrate()` carries the claiming code (the\n * registry, the server-block lifting and the portal scan). A custom renderer reads the same hook.\n * @since 1.0.0\n */\nexport interface Claims {\n /** Claims the server element for `key` (see `claimElement`). */\n claimElement(key: string | undefined): Element | null;\n /** Adopts the next server region of `parent` (see `takeRegion`). */\n takeRegion(parent: Node, anchorNode: Node | null): Node[] | undefined;\n /** The content of every region lifted out of a claimed element (see `liftedRegions`). */\n liftedRegions(): readonly (readonly Node[])[] | undefined;\n /** Adopts the server block of a portal (see `claimPortal`). */\n claimPortal(key: string | undefined): Node[] | undefined;\n /** True while a hydration pass claims server DOM (see `isClaiming`). */\n isClaiming(): boolean;\n /** Runs `fn` with claiming off (see `withoutClaiming`). */\n withoutClaiming<T>(fn: () => T): T;\n}\n\nconst idle: Claims = {\n claimElement: () => null,\n takeRegion: () => undefined,\n liftedRegions: () => undefined,\n claimPortal: () => undefined,\n isClaiming: () => false,\n withoutClaiming: (fn) => fn(),\n};\n\n/**\n * The claims in effect. Read at each call (never captured), so a region that is updated after its\n * hydration pass ended builds fresh DOM. Only `hydrate()` replaces it, and restores it in `finally`.\n * Outside a hydration pass every method is a no-op.\n *\n * @example\n * import { claims, nextKey } from \"@shadow-js/web/extend\";\n *\n * function createCard(): Element {\n * // Adopts the server's element during hydrate(); builds a new one otherwise.\n * return claims.current.claimElement(nextKey()) ?? document.createElement(\"article\");\n * }\n * @see Claims\n * @since 1.0.0\n */\nexport const claims: { current: Claims } = { current: idle };\n"],"mappings":";;;;;;;;;;;;;;;AA+CA,MAAa,SAA8B,EAAE,SAAS;CAvBpD,oBAAoB;CACpB,kBAAkB,KAAA;CAClB,qBAAqB,KAAA;CACrB,mBAAmB,KAAA;CACnB,kBAAkB;CAClB,kBAAkB,OAAO,GAAG;AAkBwB,EAAK"}
@@ -0,0 +1,129 @@
1
+ /**
2
+ * A hydration scope: the deterministic source of hydration keys shared by the server renderer and
3
+ * the client hydrator. Keys depend only on the nesting and order of component calls, never on owners,
4
+ * effects or memos, so server and client agree as long as they run the same components. Scopes are
5
+ * created by {@link createRootScope}, {@link enterComponent} and {@link childScope}; treat their
6
+ * fields as read-only.
7
+ *
8
+ * @since 1.0.0
9
+ */
10
+ export interface HydrationScope {
11
+ /** Prefix of every key allocated in this scope, ending with `-` (`"0-"` for a root, `"0-3-"` below). */
12
+ readonly id: string;
13
+ /** Next number handed out by this scope: component scopes and template root keys share it. */
14
+ count: number;
15
+ /** Number of auto-keyed resources created directly in this scope so far. */
16
+ resources: number;
17
+ }
18
+ /**
19
+ * Creates the scope a render or a hydration starts from: what `renderToString` and `hydrate()` put in
20
+ * effect around the app. A custom renderer that hands out hydration keys does the same.
21
+ *
22
+ * @param renderId The prefix of every key of this render. Default: `"0"`, the default `renderId` of
23
+ * the renderers.
24
+ * @returns A fresh scope whose `id` is `` `${renderId}-` ``.
25
+ * @example
26
+ * import { createRootScope, nextKey, withScope } from "@shadow-js/web/extend";
27
+ *
28
+ * const keys = withScope(createRootScope("app"), () => [nextKey(), nextKey()]);
29
+ * // ["app-0", "app-1"]
30
+ * @see withScope
31
+ * @since 1.0.0
32
+ */
33
+ export declare function createRootScope(renderId?: string): HydrationScope;
34
+ /**
35
+ * Returns the hydration scope in effect.
36
+ *
37
+ * @returns The current scope; `null` outside a server render, a hydration, or a {@link withScope}
38
+ * call.
39
+ * @example
40
+ * import { currentScope } from "@shadow-js/web/extend";
41
+ *
42
+ * function scopeLabel(): string {
43
+ * return currentScope()?.id ?? "no scope";
44
+ * }
45
+ * @since 1.0.0
46
+ */
47
+ export declare function currentScope(): HydrationScope | null;
48
+ /**
49
+ * Runs `fn` with `scope` in effect, so the keys `fn` draws come from it. The previous scope is
50
+ * restored when `fn` returns or throws.
51
+ *
52
+ * @param scope The scope to put in effect; `null` runs `fn` with no scope (no keys are drawn).
53
+ * @param fn The code to run, synchronously, once.
54
+ * @returns What `fn` returns. An error `fn` throws propagates.
55
+ * @example
56
+ * import { childScope, nextKey, withScope } from "@shadow-js/web/extend";
57
+ *
58
+ * // The keys of an isolated subtree, independent of its siblings.
59
+ * const first = withScope(childScope("0-4"), () => nextKey()); // "0-4-0"
60
+ * @see createRootScope
61
+ * @since 1.0.0
62
+ */
63
+ export declare function withScope<T>(scope: HydrationScope | null, fn: () => T): T;
64
+ /**
65
+ * Runs a component call in a scope of its own, so the keys it draws depend only on its position
66
+ * among its parent's calls: what `createComponent` does on the client and on the server. The
67
+ * component's scope takes the next number of the parent scope.
68
+ *
69
+ * @param fn The component call, run synchronously, once.
70
+ * @returns What `fn` returns. Without a scope in effect, `fn` simply runs.
71
+ * @example
72
+ * import { createRootScope, enterComponent, nextKey, withScope } from "@shadow-js/web/extend";
73
+ *
74
+ * withScope(createRootScope(), () => {
75
+ * nextKey(); // "0-0"
76
+ * return enterComponent(() => nextKey()); // "0-1-0": the component's first key
77
+ * });
78
+ * @since 1.0.0
79
+ */
80
+ export declare function enterComponent<T>(fn: () => T): T;
81
+ /**
82
+ * Draws the key of the next template root in the current scope: what `template()` and
83
+ * `ssrHydrationKey()` call, in the same order on the server and the client. Each call advances the
84
+ * scope.
85
+ *
86
+ * @returns The key (`"0-0"`, `"0-1"`, ...); undefined outside a scope.
87
+ * @example
88
+ * import { claimElement, nextKey } from "@shadow-js/web/extend";
89
+ *
90
+ * function createBadge(): Element {
91
+ * return claimElement(nextKey()) ?? document.createElement("span");
92
+ * }
93
+ * @see claimElement
94
+ * @since 1.0.0
95
+ */
96
+ export declare function nextKey(): string | undefined;
97
+ /**
98
+ * Returns the key a resource's value is stored under in the server data, the same on the server and
99
+ * the client: the explicit key when there is one, else one drawn from the current scope.
100
+ *
101
+ * @param explicit The resource's own key. When given, the result is `` `k:${explicit}` ``, a prefix
102
+ * no generated key has. Undefined draws the next resource key of the scope.
103
+ * @returns `` `k:${explicit}` ``; otherwise the scope id, `r` and the creation index (`"0-1-r0"`);
104
+ * `"r"` outside a scope.
105
+ * @example
106
+ * import { createRootScope, resourceKey, withScope } from "@shadow-js/web/extend";
107
+ *
108
+ * withScope(createRootScope(), () => [resourceKey(undefined), resourceKey("user")]);
109
+ * // ["0-r0", "k:user"]
110
+ * @since 1.0.0
111
+ */
112
+ export declare function resourceKey(explicit: string | undefined): string;
113
+ /**
114
+ * Creates a fresh scope for an isolated part of the tree, such as a Suspense boundary's content or
115
+ * fallback, or a portal's content: its keys depend only on `key`, not on the siblings around it.
116
+ *
117
+ * @param key The key of the boundary (from `nextKey()`); undefined means no scope.
118
+ * @returns A scope whose `id` is `` `${key}-` ``; `null` when `key` is undefined.
119
+ * @example
120
+ * import { childScope, nextKey, withScope } from "@shadow-js/web/extend";
121
+ *
122
+ * function renderIsolated<T>(build: () => T): T {
123
+ * return withScope(childScope(nextKey()), build);
124
+ * }
125
+ * @see withScope
126
+ * @since 1.0.0
127
+ */
128
+ export declare function childScope(key: string | undefined): HydrationScope | null;
129
+ //# sourceMappingURL=hydration-scope.d.ts.map
@@ -0,0 +1,155 @@
1
+ // src/internal/hydration-scope.ts
2
+ let current = null;
3
+ /**
4
+ * Creates the scope a render or a hydration starts from: what `renderToString` and `hydrate()` put in
5
+ * effect around the app. A custom renderer that hands out hydration keys does the same.
6
+ *
7
+ * @param renderId The prefix of every key of this render. Default: `"0"`, the default `renderId` of
8
+ * the renderers.
9
+ * @returns A fresh scope whose `id` is `` `${renderId}-` ``.
10
+ * @example
11
+ * import { createRootScope, nextKey, withScope } from "@shadow-js/web/extend";
12
+ *
13
+ * const keys = withScope(createRootScope("app"), () => [nextKey(), nextKey()]);
14
+ * // ["app-0", "app-1"]
15
+ * @see withScope
16
+ * @since 1.0.0
17
+ */
18
+ function createRootScope(renderId = "0") {
19
+ return {
20
+ id: `${renderId}-`,
21
+ count: 0,
22
+ resources: 0
23
+ };
24
+ }
25
+ /**
26
+ * Returns the hydration scope in effect.
27
+ *
28
+ * @returns The current scope; `null` outside a server render, a hydration, or a {@link withScope}
29
+ * call.
30
+ * @example
31
+ * import { currentScope } from "@shadow-js/web/extend";
32
+ *
33
+ * function scopeLabel(): string {
34
+ * return currentScope()?.id ?? "no scope";
35
+ * }
36
+ * @since 1.0.0
37
+ */
38
+ function currentScope() {
39
+ return current;
40
+ }
41
+ /**
42
+ * Runs `fn` with `scope` in effect, so the keys `fn` draws come from it. The previous scope is
43
+ * restored when `fn` returns or throws.
44
+ *
45
+ * @param scope The scope to put in effect; `null` runs `fn` with no scope (no keys are drawn).
46
+ * @param fn The code to run, synchronously, once.
47
+ * @returns What `fn` returns. An error `fn` throws propagates.
48
+ * @example
49
+ * import { childScope, nextKey, withScope } from "@shadow-js/web/extend";
50
+ *
51
+ * // The keys of an isolated subtree, independent of its siblings.
52
+ * const first = withScope(childScope("0-4"), () => nextKey()); // "0-4-0"
53
+ * @see createRootScope
54
+ * @since 1.0.0
55
+ */
56
+ function withScope(scope, fn) {
57
+ const previous = current;
58
+ current = scope;
59
+ try {
60
+ return fn();
61
+ } finally {
62
+ current = previous;
63
+ }
64
+ }
65
+ /**
66
+ * Runs a component call in a scope of its own, so the keys it draws depend only on its position
67
+ * among its parent's calls: what `createComponent` does on the client and on the server. The
68
+ * component's scope takes the next number of the parent scope.
69
+ *
70
+ * @param fn The component call, run synchronously, once.
71
+ * @returns What `fn` returns. Without a scope in effect, `fn` simply runs.
72
+ * @example
73
+ * import { createRootScope, enterComponent, nextKey, withScope } from "@shadow-js/web/extend";
74
+ *
75
+ * withScope(createRootScope(), () => {
76
+ * nextKey(); // "0-0"
77
+ * return enterComponent(() => nextKey()); // "0-1-0": the component's first key
78
+ * });
79
+ * @since 1.0.0
80
+ */
81
+ function enterComponent(fn) {
82
+ const parent = current;
83
+ if (parent === null) return fn();
84
+ return withScope({
85
+ id: `${parent.id}${parent.count++}-`,
86
+ count: 0,
87
+ resources: 0
88
+ }, fn);
89
+ }
90
+ /**
91
+ * Draws the key of the next template root in the current scope: what `template()` and
92
+ * `ssrHydrationKey()` call, in the same order on the server and the client. Each call advances the
93
+ * scope.
94
+ *
95
+ * @returns The key (`"0-0"`, `"0-1"`, ...); undefined outside a scope.
96
+ * @example
97
+ * import { claimElement, nextKey } from "@shadow-js/web/extend";
98
+ *
99
+ * function createBadge(): Element {
100
+ * return claimElement(nextKey()) ?? document.createElement("span");
101
+ * }
102
+ * @see claimElement
103
+ * @since 1.0.0
104
+ */
105
+ function nextKey() {
106
+ const scope = current;
107
+ if (scope === null) return void 0;
108
+ return `${scope.id}${scope.count++}`;
109
+ }
110
+ /**
111
+ * Returns the key a resource's value is stored under in the server data, the same on the server and
112
+ * the client: the explicit key when there is one, else one drawn from the current scope.
113
+ *
114
+ * @param explicit The resource's own key. When given, the result is `` `k:${explicit}` ``, a prefix
115
+ * no generated key has. Undefined draws the next resource key of the scope.
116
+ * @returns `` `k:${explicit}` ``; otherwise the scope id, `r` and the creation index (`"0-1-r0"`);
117
+ * `"r"` outside a scope.
118
+ * @example
119
+ * import { createRootScope, resourceKey, withScope } from "@shadow-js/web/extend";
120
+ *
121
+ * withScope(createRootScope(), () => [resourceKey(undefined), resourceKey("user")]);
122
+ * // ["0-r0", "k:user"]
123
+ * @since 1.0.0
124
+ */
125
+ function resourceKey(explicit) {
126
+ if (explicit !== void 0) return `k:${explicit}`;
127
+ const scope = current;
128
+ if (scope === null) return "r";
129
+ return `${scope.id}r${scope.resources++}`;
130
+ }
131
+ /**
132
+ * Creates a fresh scope for an isolated part of the tree, such as a Suspense boundary's content or
133
+ * fallback, or a portal's content: its keys depend only on `key`, not on the siblings around it.
134
+ *
135
+ * @param key The key of the boundary (from `nextKey()`); undefined means no scope.
136
+ * @returns A scope whose `id` is `` `${key}-` ``; `null` when `key` is undefined.
137
+ * @example
138
+ * import { childScope, nextKey, withScope } from "@shadow-js/web/extend";
139
+ *
140
+ * function renderIsolated<T>(build: () => T): T {
141
+ * return withScope(childScope(nextKey()), build);
142
+ * }
143
+ * @see withScope
144
+ * @since 1.0.0
145
+ */
146
+ function childScope(key) {
147
+ return key === void 0 ? null : {
148
+ id: `${key}-`,
149
+ count: 0,
150
+ resources: 0
151
+ };
152
+ }
153
+ export { childScope, createRootScope, currentScope, enterComponent, nextKey, resourceKey, withScope };
154
+
155
+ //# sourceMappingURL=hydration-scope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hydration-scope.js","names":[],"sources":["../../../src/internal/hydration-scope.ts"],"sourcesContent":["/**\n * A hydration scope: the deterministic source of hydration keys shared by the server renderer and\n * the client hydrator. Keys depend only on the nesting and order of component calls, never on owners,\n * effects or memos, so server and client agree as long as they run the same components. Scopes are\n * created by {@link createRootScope}, {@link enterComponent} and {@link childScope}; treat their\n * fields as read-only.\n *\n * @since 1.0.0\n */\nexport interface HydrationScope {\n /** Prefix of every key allocated in this scope, ending with `-` (`\"0-\"` for a root, `\"0-3-\"` below). */\n readonly id: string;\n /** Next number handed out by this scope: component scopes and template root keys share it. */\n count: number;\n /** Number of auto-keyed resources created directly in this scope so far. */\n resources: number;\n}\n\nlet current: HydrationScope | null = null;\n\n/**\n * Creates the scope a render or a hydration starts from: what `renderToString` and `hydrate()` put in\n * effect around the app. A custom renderer that hands out hydration keys does the same.\n *\n * @param renderId The prefix of every key of this render. Default: `\"0\"`, the default `renderId` of\n * the renderers.\n * @returns A fresh scope whose `id` is `` `${renderId}-` ``.\n * @example\n * import { createRootScope, nextKey, withScope } from \"@shadow-js/web/extend\";\n *\n * const keys = withScope(createRootScope(\"app\"), () => [nextKey(), nextKey()]);\n * // [\"app-0\", \"app-1\"]\n * @see withScope\n * @since 1.0.0\n */\nexport function createRootScope(renderId = \"0\"): HydrationScope {\n return { id: `${renderId}-`, count: 0, resources: 0 };\n}\n\n/**\n * Returns the hydration scope in effect.\n *\n * @returns The current scope; `null` outside a server render, a hydration, or a {@link withScope}\n * call.\n * @example\n * import { currentScope } from \"@shadow-js/web/extend\";\n *\n * function scopeLabel(): string {\n * return currentScope()?.id ?? \"no scope\";\n * }\n * @since 1.0.0\n */\nexport function currentScope(): HydrationScope | null {\n return current;\n}\n\n/**\n * Runs `fn` with `scope` in effect, so the keys `fn` draws come from it. The previous scope is\n * restored when `fn` returns or throws.\n *\n * @param scope The scope to put in effect; `null` runs `fn` with no scope (no keys are drawn).\n * @param fn The code to run, synchronously, once.\n * @returns What `fn` returns. An error `fn` throws propagates.\n * @example\n * import { childScope, nextKey, withScope } from \"@shadow-js/web/extend\";\n *\n * // The keys of an isolated subtree, independent of its siblings.\n * const first = withScope(childScope(\"0-4\"), () => nextKey()); // \"0-4-0\"\n * @see createRootScope\n * @since 1.0.0\n */\nexport function withScope<T>(scope: HydrationScope | null, fn: () => T): T {\n const previous = current;\n current = scope;\n try {\n return fn();\n } finally {\n current = previous;\n }\n}\n\n/**\n * Runs a component call in a scope of its own, so the keys it draws depend only on its position\n * among its parent's calls: what `createComponent` does on the client and on the server. The\n * component's scope takes the next number of the parent scope.\n *\n * @param fn The component call, run synchronously, once.\n * @returns What `fn` returns. Without a scope in effect, `fn` simply runs.\n * @example\n * import { createRootScope, enterComponent, nextKey, withScope } from \"@shadow-js/web/extend\";\n *\n * withScope(createRootScope(), () => {\n * nextKey(); // \"0-0\"\n * return enterComponent(() => nextKey()); // \"0-1-0\": the component's first key\n * });\n * @since 1.0.0\n */\nexport function enterComponent<T>(fn: () => T): T {\n const parent = current;\n if (parent === null) return fn();\n return withScope({ id: `${parent.id}${parent.count++}-`, count: 0, resources: 0 }, fn);\n}\n\n/**\n * Draws the key of the next template root in the current scope: what `template()` and\n * `ssrHydrationKey()` call, in the same order on the server and the client. Each call advances the\n * scope.\n *\n * @returns The key (`\"0-0\"`, `\"0-1\"`, ...); undefined outside a scope.\n * @example\n * import { claimElement, nextKey } from \"@shadow-js/web/extend\";\n *\n * function createBadge(): Element {\n * return claimElement(nextKey()) ?? document.createElement(\"span\");\n * }\n * @see claimElement\n * @since 1.0.0\n */\nexport function nextKey(): string | undefined {\n const scope = current;\n if (scope === null) return undefined;\n return `${scope.id}${scope.count++}`;\n}\n\n/**\n * Returns the key a resource's value is stored under in the server data, the same on the server and\n * the client: the explicit key when there is one, else one drawn from the current scope.\n *\n * @param explicit The resource's own key. When given, the result is `` `k:${explicit}` ``, a prefix\n * no generated key has. Undefined draws the next resource key of the scope.\n * @returns `` `k:${explicit}` ``; otherwise the scope id, `r` and the creation index (`\"0-1-r0\"`);\n * `\"r\"` outside a scope.\n * @example\n * import { createRootScope, resourceKey, withScope } from \"@shadow-js/web/extend\";\n *\n * withScope(createRootScope(), () => [resourceKey(undefined), resourceKey(\"user\")]);\n * // [\"0-r0\", \"k:user\"]\n * @since 1.0.0\n */\nexport function resourceKey(explicit: string | undefined): string {\n if (explicit !== undefined) return `k:${explicit}`;\n const scope = current;\n if (scope === null) return \"r\";\n return `${scope.id}r${scope.resources++}`;\n}\n\n/**\n * Creates a fresh scope for an isolated part of the tree, such as a Suspense boundary's content or\n * fallback, or a portal's content: its keys depend only on `key`, not on the siblings around it.\n *\n * @param key The key of the boundary (from `nextKey()`); undefined means no scope.\n * @returns A scope whose `id` is `` `${key}-` ``; `null` when `key` is undefined.\n * @example\n * import { childScope, nextKey, withScope } from \"@shadow-js/web/extend\";\n *\n * function renderIsolated<T>(build: () => T): T {\n * return withScope(childScope(nextKey()), build);\n * }\n * @see withScope\n * @since 1.0.0\n */\nexport function childScope(key: string | undefined): HydrationScope | null {\n return key === undefined ? null : { id: `${key}-`, count: 0, resources: 0 };\n}\n"],"mappings":";AAkBA,IAAI,UAAiC;;;;;;;;;;;;;;;;AAiBrC,SAAgB,gBAAgB,WAAW,KAAqB;CAC9D,OAAO;EAAE,IAAI,GAAG,SAAS;EAAI,OAAO;EAAG,WAAW;CAAE;AACtD;;;;;;;;;;;;;;AAeA,SAAgB,eAAsC;CACpD,OAAO;AACT;;;;;;;;;;;;;;;;AAiBA,SAAgB,UAAa,OAA8B,IAAgB;CACzE,MAAM,WAAW;CACjB,UAAU;CACV,IAAI;EACF,OAAO,GAAG;CACZ,UAAU;EACR,UAAU;CACZ;AACF;;;;;;;;;;;;;;;;;AAkBA,SAAgB,eAAkB,IAAgB;CAChD,MAAM,SAAS;CACf,IAAI,WAAW,MAAM,OAAO,GAAG;CAC/B,OAAO,UAAU;EAAE,IAAI,GAAG,OAAO,KAAK,OAAO,QAAQ;EAAI,OAAO;EAAG,WAAW;CAAE,GAAG,EAAE;AACvF;;;;;;;;;;;;;;;;AAiBA,SAAgB,UAA8B;CAC5C,MAAM,QAAQ;CACd,IAAI,UAAU,MAAM,OAAO,KAAA;CAC3B,OAAO,GAAG,MAAM,KAAK,MAAM;AAC7B;;;;;;;;;;;;;;;;AAiBA,SAAgB,YAAY,UAAsC;CAChE,IAAI,aAAa,KAAA,GAAW,OAAO,KAAK;CACxC,MAAM,QAAQ;CACd,IAAI,UAAU,MAAM,OAAO;CAC3B,OAAO,GAAG,MAAM,GAAG,GAAG,MAAM;AAC9B;;;;;;;;;;;;;;;;AAiBA,SAAgB,WAAW,KAAgD;CACzE,OAAO,QAAQ,KAAA,IAAY,OAAO;EAAE,IAAI,GAAG,IAAI;EAAI,OAAO;EAAG,WAAW;CAAE;AAC5E"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * The XHTML namespace URI: the `namespaceURI` of ordinary HTML elements.
3
+ *
4
+ * @example
5
+ * import { HTML_NS } from "@shadow-js/web/extend";
6
+ *
7
+ * const isHtml = (el: Element): boolean => el.namespaceURI === HTML_NS;
8
+ * @since 1.0.0
9
+ */
10
+ export declare const HTML_NS = "http://www.w3.org/1999/xhtml";
11
+ /**
12
+ * The SVG namespace URI, for `createElementNS` and `namespaceURI` checks.
13
+ *
14
+ * @example
15
+ * import { SVG_NS } from "@shadow-js/web/extend";
16
+ *
17
+ * const circle = document.createElementNS(SVG_NS, "circle");
18
+ * @since 1.0.0
19
+ */
20
+ export declare const SVG_NS = "http://www.w3.org/2000/svg";
21
+ /**
22
+ * The MathML namespace URI, for `createElementNS` and `namespaceURI` checks.
23
+ *
24
+ * @example
25
+ * import { MATHML_NS } from "@shadow-js/web/extend";
26
+ *
27
+ * const fraction = document.createElementNS(MATHML_NS, "mfrac");
28
+ * @since 1.0.0
29
+ */
30
+ export declare const MATHML_NS = "http://www.w3.org/1998/Math/MathML";
31
+ //# sourceMappingURL=names.d.ts.map
@@ -0,0 +1,34 @@
1
+ // src/internal/names.ts
2
+ /**
3
+ * The XHTML namespace URI: the `namespaceURI` of ordinary HTML elements.
4
+ *
5
+ * @example
6
+ * import { HTML_NS } from "@shadow-js/web/extend";
7
+ *
8
+ * const isHtml = (el: Element): boolean => el.namespaceURI === HTML_NS;
9
+ * @since 1.0.0
10
+ */
11
+ const HTML_NS = "http://www.w3.org/1999/xhtml";
12
+ /**
13
+ * The SVG namespace URI, for `createElementNS` and `namespaceURI` checks.
14
+ *
15
+ * @example
16
+ * import { SVG_NS } from "@shadow-js/web/extend";
17
+ *
18
+ * const circle = document.createElementNS(SVG_NS, "circle");
19
+ * @since 1.0.0
20
+ */
21
+ const SVG_NS = "http://www.w3.org/2000/svg";
22
+ /**
23
+ * The MathML namespace URI, for `createElementNS` and `namespaceURI` checks.
24
+ *
25
+ * @example
26
+ * import { MATHML_NS } from "@shadow-js/web/extend";
27
+ *
28
+ * const fraction = document.createElementNS(MATHML_NS, "mfrac");
29
+ * @since 1.0.0
30
+ */
31
+ const MATHML_NS = "http://www.w3.org/1998/Math/MathML";
32
+ export { HTML_NS, MATHML_NS, SVG_NS };
33
+
34
+ //# sourceMappingURL=names.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"names.js","names":[],"sources":["../../../src/internal/names.ts"],"sourcesContent":["/**\n * The XHTML namespace URI: the `namespaceURI` of ordinary HTML elements.\n *\n * @example\n * import { HTML_NS } from \"@shadow-js/web/extend\";\n *\n * const isHtml = (el: Element): boolean => el.namespaceURI === HTML_NS;\n * @since 1.0.0\n */\nexport const HTML_NS = \"http://www.w3.org/1999/xhtml\";\n/**\n * The SVG namespace URI, for `createElementNS` and `namespaceURI` checks.\n *\n * @example\n * import { SVG_NS } from \"@shadow-js/web/extend\";\n *\n * const circle = document.createElementNS(SVG_NS, \"circle\");\n * @since 1.0.0\n */\nexport const SVG_NS = \"http://www.w3.org/2000/svg\";\n/**\n * The MathML namespace URI, for `createElementNS` and `namespaceURI` checks.\n *\n * @example\n * import { MATHML_NS } from \"@shadow-js/web/extend\";\n *\n * const fraction = document.createElementNS(MATHML_NS, \"mfrac\");\n * @since 1.0.0\n */\nexport const MATHML_NS = \"http://www.w3.org/1998/Math/MathML\";\n\n/** `template()` flag: the markup is SVG. @internal */\nexport const TEMPLATE_SVG = 1;\n/** `template()` flag: the markup is MathML. @internal */\nexport const TEMPLATE_MATHML = 2;\n/** `template()` flag: clone with `document.importNode` (custom elements). @internal */\nexport const TEMPLATE_IMPORT_NODE = 4;\n"],"mappings":";;;;;;;;;;AASA,MAAa,UAAU;;;;;;;;;;AAUvB,MAAa,SAAS;;;;;;;;;;AAUtB,MAAa,YAAY"}
@@ -0,0 +1,37 @@
1
+ import { Context } from "@shadow-js/core";
2
+ /**
3
+ * Receives the markup of the portals a server render produces: what {@link PortalContext} provides
4
+ * when the render was given a `portals` collector.
5
+ * @since 1.0.0
6
+ */
7
+ export interface PortalSink {
8
+ /**
9
+ * Records the markup of the portal with hydration key `key`. A key recorded again replaces the
10
+ * earlier markup. Throws an `SsrError` whose `code` is `SSR_PORTAL_LIMIT` past 256 portals in one
11
+ * render.
12
+ */
13
+ add(key: string, html: string): void;
14
+ }
15
+ /**
16
+ * The context through which a server render hands portals their collector: the renderers provide it
17
+ * when they are given a `portals` option (see `createServerPortals`). A custom portal reads it on the
18
+ * server and records its markup under its hydration key, so the client's `claimPortal` adopts it.
19
+ * Its value is `null` for every other render, and in the browser, where a portal writes nothing on
20
+ * the server.
21
+ *
22
+ * @example
23
+ * import { useContext } from "@shadow-js/core";
24
+ * import { nextKey, PortalContext } from "@shadow-js/web/extend";
25
+ * import { escape } from "@shadow-js/web/server";
26
+ *
27
+ * function ServerToast(props: { text: string }): null {
28
+ * const key = nextKey();
29
+ * const sink = useContext(PortalContext);
30
+ * if (sink !== null && key !== undefined) sink.add(key, `<div role="status">${escape(props.text)}</div>`);
31
+ * return null;
32
+ * }
33
+ * @see claimPortal
34
+ * @since 1.0.0
35
+ */
36
+ export declare const PortalContext: Context<PortalSink | null>;
37
+ //# sourceMappingURL=portal-context.d.ts.map
@@ -0,0 +1,27 @@
1
+ import { createContext } from "@shadow-js/core";
2
+ // src/internal/portal-context.ts
3
+ /**
4
+ * The context through which a server render hands portals their collector: the renderers provide it
5
+ * when they are given a `portals` option (see `createServerPortals`). A custom portal reads it on the
6
+ * server and records its markup under its hydration key, so the client's `claimPortal` adopts it.
7
+ * Its value is `null` for every other render, and in the browser, where a portal writes nothing on
8
+ * the server.
9
+ *
10
+ * @example
11
+ * import { useContext } from "@shadow-js/core";
12
+ * import { nextKey, PortalContext } from "@shadow-js/web/extend";
13
+ * import { escape } from "@shadow-js/web/server";
14
+ *
15
+ * function ServerToast(props: { text: string }): null {
16
+ * const key = nextKey();
17
+ * const sink = useContext(PortalContext);
18
+ * if (sink !== null && key !== undefined) sink.add(key, `<div role="status">${escape(props.text)}</div>`);
19
+ * return null;
20
+ * }
21
+ * @see claimPortal
22
+ * @since 1.0.0
23
+ */
24
+ const PortalContext = /* @__PURE__ */ createContext(null, { name: "Portal" });
25
+ export { PortalContext };
26
+
27
+ //# sourceMappingURL=portal-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"portal-context.js","names":[],"sources":["../../../src/internal/portal-context.ts"],"sourcesContent":["import { type Context, createContext } from \"@shadow-js/core\";\n\n/**\n * Receives the markup of the portals a server render produces: what {@link PortalContext} provides\n * when the render was given a `portals` collector.\n * @since 1.0.0\n */\nexport interface PortalSink {\n /**\n * Records the markup of the portal with hydration key `key`. A key recorded again replaces the\n * earlier markup. Throws an `SsrError` whose `code` is `SSR_PORTAL_LIMIT` past 256 portals in one\n * render.\n */\n add(key: string, html: string): void;\n}\n\n/**\n * The context through which a server render hands portals their collector: the renderers provide it\n * when they are given a `portals` option (see `createServerPortals`). A custom portal reads it on the\n * server and records its markup under its hydration key, so the client's `claimPortal` adopts it.\n * Its value is `null` for every other render, and in the browser, where a portal writes nothing on\n * the server.\n *\n * @example\n * import { useContext } from \"@shadow-js/core\";\n * import { nextKey, PortalContext } from \"@shadow-js/web/extend\";\n * import { escape } from \"@shadow-js/web/server\";\n *\n * function ServerToast(props: { text: string }): null {\n * const key = nextKey();\n * const sink = useContext(PortalContext);\n * if (sink !== null && key !== undefined) sink.add(key, `<div role=\"status\">${escape(props.text)}</div>`);\n * return null;\n * }\n * @see claimPortal\n * @since 1.0.0\n */\nexport const PortalContext: Context<PortalSink | null> =\n /* @__PURE__ */ createContext<PortalSink | null>(null, {\n name: \"Portal\",\n });\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,gBACK,8BAAiC,MAAM,EACrD,MAAM,SACR,CAAC"}