@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":"server-head.js","names":[],"sources":["../../../src/head/server-head.ts"],"sourcesContent":["import { type Context, createContext } from \"@shadow-js/core\";\nimport { escapeHtml } from \"../server/escape\";\nimport { createHeadRegistry, type HeadRegistry } from \"./registry\";\nimport { HEAD_KEY, HEAD_MARKER, type NormalizedTag } from \"./validate\";\n\n/** Elements that never have content or a closing tag. */\nconst VOID_TAGS: ReadonlySet<string> = new Set([\"meta\", \"link\", \"base\"]);\n\n/**\n * The head of one server render: what `useHead`, `<Title>`, `<Meta>`, `<Link>`, `<Style>` and\n * `<Base>` registered while the app rendered. Pass it to a render function through its `head`\n * option, then write {@link ServerHead.html} into the document's `<head>`.\n *\n * Tags follow the same rules as in the browser: the last registration of an identity wins\n * (`title`, `meta` by name, ...), append-only tags all stay. Every tag carries the marker the\n * browser's head sink looks for, so the client adopts the server's elements instead of adding\n * duplicates.\n * @since 1.0.0\n */\nexport interface ServerHead {\n /** Registers tags. Used by `useHead`; the returned function removes them again. */\n add(tags: readonly NormalizedTag[]): () => void;\n /** Forgets every registration. Multi-pass renders call this before each pass. */\n clear(): void;\n /**\n * The markup of the winning tags, in registration order. With a `nonce`, every `<style>` carries\n * it, so the page's Content-Security-Policy (`style-src 'nonce-...'`) accepts the styles. Throws a\n * TypeError when the text of a style contains a closing style tag.\n *\n * @param options `nonce` is added to every `<style>`. Default: no options, so no nonce.\n */\n html(options?: { readonly nonce?: string }): string;\n /** The winning tags, for hosts that build the head themselves. */\n tags(): readonly NormalizedTag[];\n}\n\n/** The collector `useHead` writes to while a render is running; null outside a render with `head`. @internal */\nexport const ServerHeadContext: Context<ServerHead | null> =\n /* @__PURE__ */ createContext<ServerHead | null>(null, { name: \"ServerHead\" });\n\n/** Markup of one tag. Text and attribute values are escaped; `</style` cannot appear in a style. */\nfunction tagHtml(tag: NormalizedTag, nonce: string | undefined): string {\n let attributes = ` ${HEAD_MARKER}`;\n if (tag.key !== undefined) attributes += ` ${HEAD_KEY}=\"${escapeHtml(tag.key)}\"`;\n for (const [name, value] of tag.attributes) {\n attributes += value === \"\" ? ` ${name}` : ` ${name}=\"${escapeHtml(value)}\"`;\n }\n if (VOID_TAGS.has(tag.tag)) return `<${tag.tag}${attributes}>`;\n const text = tag.text ?? \"\";\n if (tag.tag === \"style\") {\n if (/<\\/style/i.test(text)) {\n throw new TypeError(\"ShadowJS head: style text may not contain a closing style tag.\");\n }\n const withNonce =\n nonce === undefined ? attributes : `${attributes} nonce=\"${escapeHtml(nonce)}\"`;\n return `<style${withNonce}>${text}</style>`;\n }\n return `<${tag.tag}${attributes}>${escapeHtml(text)}</${tag.tag}>`;\n}\n\n/**\n * Creates an empty server head collector.\n *\n * @returns A collector to pass as the `head` option of `renderToString`, `renderToStringAsync` or\n * `renderToStream`.\n * @example\n * import { createComponent, Title } from \"@shadow-js/web\";\n * import { createServerHead, renderToString } from \"@shadow-js/web/server\";\n *\n * function App() {\n * return Title({ children: \"Home\" });\n * }\n *\n * const head = createServerHead();\n * const html = renderToString(() => createComponent(App, {}), { head });\n * const page = `<!doctype html><head>${head.html()}</head><body>${html}</body>`;\n * @see useHead\n * @since 1.0.0\n */\nexport function createServerHead(): ServerHead {\n let registry: HeadRegistry = createHeadRegistry(() => undefined);\n return {\n add: (tags) => registry.add(tags),\n clear() {\n registry = createHeadRegistry(() => undefined);\n },\n html: (options) =>\n registry\n .winners()\n .map((winner) => tagHtml(winner.tag, options?.nonce))\n .join(\"\"),\n tags: () => registry.winners().map((winner) => winner.tag),\n };\n}\n\n/**\n * Runs `fn` with `head` as the collector `useHead` writes to. Server renderers call it around the\n * app; with no collector `fn` runs as is. @internal\n */\nexport function runWithServerHead<T>(head: ServerHead | undefined, fn: () => T): T {\n if (head === undefined) return fn();\n const holder: { value?: T } = {};\n ServerHeadContext({\n value: head,\n get children() {\n holder.value = fn();\n return null;\n },\n });\n return holder.value as T;\n}\n"],"mappings":";;;;;;AAMA,MAAM,4BAAiC,IAAI,IAAI;CAAC;CAAQ;CAAQ;AAAM,CAAC;;AA+BvE,MAAa,oBACK,8BAAiC,MAAM,EAAE,MAAM,aAAa,CAAC;;AAG/E,SAAS,QAAQ,KAAoB,OAAmC;CACtE,IAAI,aAAa,IAAI;CACrB,IAAI,IAAI,QAAQ,KAAA,GAAW,cAAc,IAAI,SAAS,IAAI,WAAW,IAAI,GAAG,EAAE;CAC9E,KAAK,MAAM,CAAC,MAAM,UAAU,IAAI,YAC9B,cAAc,UAAU,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,WAAW,KAAK,EAAE;CAE3E,IAAI,UAAU,IAAI,IAAI,GAAG,GAAG,OAAO,IAAI,IAAI,MAAM,WAAW;CAC5D,MAAM,OAAO,IAAI,QAAQ;CACzB,IAAI,IAAI,QAAQ,SAAS;EACvB,IAAI,YAAY,KAAK,IAAI,GACvB,MAAM,IAAI,UAAU,gEAAgE;EAItF,OAAO,SADL,UAAU,KAAA,IAAY,aAAa,GAAG,WAAW,UAAU,WAAW,KAAK,EAAE,GACrD,GAAG,KAAK;CACpC;CACA,OAAO,IAAI,IAAI,MAAM,WAAW,GAAG,WAAW,IAAI,EAAE,IAAI,IAAI,IAAI;AAClE;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBAA+B;CAC7C,IAAI,WAAyB,yBAAyB,KAAA,CAAS;CAC/D,OAAO;EACL,MAAM,SAAS,SAAS,IAAI,IAAI;EAChC,QAAQ;GACN,WAAW,yBAAyB,KAAA,CAAS;EAC/C;EACA,OAAO,YACL,SACG,QAAQ,CAAC,CACT,KAAK,WAAW,QAAQ,OAAO,KAAK,SAAS,KAAK,CAAC,CAAC,CACpD,KAAK,EAAE;EACZ,YAAY,SAAS,QAAQ,CAAC,CAAC,KAAK,WAAW,OAAO,GAAG;CAC3D;AACF;;;;;AAMA,SAAgB,kBAAqB,MAA8B,IAAgB;CACjF,IAAI,SAAS,KAAA,GAAW,OAAO,GAAG;CAClC,MAAM,SAAwB,CAAC;CAC/B,kBAAkB;EAChB,OAAO;EACP,IAAI,WAAW;GACb,OAAO,QAAQ,GAAG;GAClB,OAAO;EACT;CACF,CAAC;CACD,OAAO,OAAO;AAChB"}
@@ -0,0 +1,96 @@
1
+ import { HEAD_KEY, HEAD_MARKER, identityOfElement } from "./validate.js";
2
+ //#region src/head/sink.ts
3
+ /** Removes or restores one element the sink owned. Elements already gone are ignored. */
4
+ function release(head, record) {
5
+ const el = record.el;
6
+ if (el.parentNode !== head) return;
7
+ if (el.localName === "title" && !record.created) {
8
+ if (record.restoreText !== void 0 && el.textContent !== record.restoreText) el.textContent = record.restoreText;
9
+ return;
10
+ }
11
+ el.remove();
12
+ }
13
+ /**
14
+ * Finds an element to adopt for a slot, or returns undefined. Only identity-keyed slots adopt. A
15
+ * server-rendered element carries the marker, and a page title or base is adopted even without it,
16
+ * because the browser shows that one, so it must be the one that changes.
17
+ */
18
+ function adoptable(head, slot, tag, claimed) {
19
+ if (tag.identity === void 0) return void 0;
20
+ for (const candidate of Array.from(head.querySelectorAll(tag.tag))) {
21
+ if (claimed.has(candidate)) continue;
22
+ if (identityOfElement(candidate) !== slot) continue;
23
+ if (candidate.hasAttribute("data-shadow-head") || tag.tag === "title") return candidate;
24
+ }
25
+ }
26
+ /** Takes over an existing element for a slot, or creates and marks a new one. */
27
+ function acquire(doc, slot, tag, claimed) {
28
+ const head = doc.head;
29
+ const existing = adoptable(head, slot, tag, claimed);
30
+ if (existing !== void 0) return {
31
+ el: existing,
32
+ created: false,
33
+ restoreText: tag.tag === "title" ? existing.textContent : void 0,
34
+ attributes: []
35
+ };
36
+ const el = doc.createElement(tag.tag);
37
+ el.setAttribute(HEAD_MARKER, "");
38
+ if (tag.key !== void 0) el.setAttribute(HEAD_KEY, tag.key);
39
+ if (tag.tag === "base") head.insertBefore(el, head.firstChild);
40
+ else head.appendChild(el);
41
+ return {
42
+ el,
43
+ created: true,
44
+ restoreText: void 0,
45
+ attributes: []
46
+ };
47
+ }
48
+ /** Writes the attributes and text of `tag` to its element, touching only what changed. */
49
+ function sync(record, tag) {
50
+ const el = record.el;
51
+ const wanted = new Map(tag.attributes);
52
+ for (const [name] of record.attributes) if (!wanted.has(name)) el.removeAttribute(name);
53
+ for (const [name, value] of tag.attributes) if (el.getAttribute(name) !== value) el.setAttribute(name, value);
54
+ record.attributes = tag.attributes;
55
+ if (tag.tag === "title" || tag.tag === "style") {
56
+ const text = tag.text ?? "";
57
+ if (el.textContent !== text) el.textContent = text;
58
+ }
59
+ }
60
+ /**
61
+ * Creates the DOM sink for one document. The returned function makes `document.head` show the
62
+ * given winners: it releases elements whose slot is gone, adopts or creates the rest and updates
63
+ * them in place. It is called once per batch of registrations, so one call is one DOM pass.
64
+ *
65
+ * @param doc The document whose head is written.
66
+ * @returns A function that applies a list of winners.
67
+ * @internal
68
+ * @since 1.0.0
69
+ */
70
+ function createDomHeadSink(doc) {
71
+ const owned = /* @__PURE__ */ new Map();
72
+ return (winners) => {
73
+ const head = doc.head;
74
+ const wanted = new Set(winners.map((winner) => winner.slot));
75
+ for (const [slot, record] of owned) {
76
+ if (wanted.has(slot) && record.el.parentNode === head) continue;
77
+ owned.delete(slot);
78
+ release(head, record);
79
+ }
80
+ const claimed = /* @__PURE__ */ new Set();
81
+ for (const record of owned.values()) claimed.add(record.el);
82
+ for (const winner of winners) {
83
+ let record = owned.get(winner.slot);
84
+ if (record === void 0) {
85
+ record = acquire(doc, winner.slot, winner.tag, claimed);
86
+ owned.set(winner.slot, record);
87
+ claimed.add(record.el);
88
+ }
89
+ sync(record, winner.tag);
90
+ }
91
+ };
92
+ }
93
+ //#endregion
94
+ export { createDomHeadSink };
95
+
96
+ //# sourceMappingURL=sink.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sink.js","names":[],"sources":["../../../src/head/sink.ts"],"sourcesContent":["import type { HeadWinner } from \"./registry\";\nimport { HEAD_KEY, HEAD_MARKER, identityOfElement, type NormalizedTag } from \"./validate\";\n\n/**\n * What the sink knows about one element it writes. `created` elements are removed on release;\n * adopted ones are removed too unless they are titles, where the original text comes back.\n */\ninterface Owned {\n readonly el: Element;\n readonly created: boolean;\n /** Text an adopted title had before the sink took it over. */\n readonly restoreText: string | undefined;\n /** Attributes last written, so the next write can remove the ones that disappeared. */\n attributes: ReadonlyArray<readonly [string, string]>;\n}\n\n/** Removes or restores one element the sink owned. Elements already gone are ignored. */\nfunction release(head: HTMLHeadElement, record: Owned): void {\n const el = record.el;\n if (el.parentNode !== head) return;\n if (el.localName === \"title\" && !record.created) {\n if (record.restoreText !== undefined && el.textContent !== record.restoreText) {\n el.textContent = record.restoreText;\n }\n return;\n }\n el.remove();\n}\n\n/**\n * Finds an element to adopt for a slot, or returns undefined. Only identity-keyed slots adopt. A\n * server-rendered element carries the marker, and a page title or base is adopted even without it,\n * because the browser shows that one, so it must be the one that changes.\n */\nfunction adoptable(\n head: HTMLHeadElement,\n slot: string,\n tag: NormalizedTag,\n claimed: Set<Element>,\n): Element | undefined {\n if (tag.identity === undefined) return undefined;\n for (const candidate of Array.from(head.querySelectorAll(tag.tag))) {\n if (claimed.has(candidate)) continue;\n if (identityOfElement(candidate) !== slot) continue;\n if (candidate.hasAttribute(HEAD_MARKER) || tag.tag === \"title\") return candidate;\n }\n return undefined;\n}\n\n/** Takes over an existing element for a slot, or creates and marks a new one. */\nfunction acquire(doc: Document, slot: string, tag: NormalizedTag, claimed: Set<Element>): Owned {\n const head = doc.head;\n const existing = adoptable(head, slot, tag, claimed);\n if (existing !== undefined) {\n const restoreText = tag.tag === \"title\" ? existing.textContent : undefined;\n return { el: existing, created: false, restoreText, attributes: [] };\n }\n const el = doc.createElement(tag.tag);\n el.setAttribute(HEAD_MARKER, \"\");\n if (tag.key !== undefined) el.setAttribute(HEAD_KEY, tag.key);\n if (tag.tag === \"base\") head.insertBefore(el, head.firstChild);\n else head.appendChild(el);\n return { el, created: true, restoreText: undefined, attributes: [] };\n}\n\n/** Writes the attributes and text of `tag` to its element, touching only what changed. */\nfunction sync(record: Owned, tag: NormalizedTag): void {\n const el = record.el;\n const wanted = new Map<string, string>(tag.attributes);\n for (const [name] of record.attributes) {\n if (!wanted.has(name)) el.removeAttribute(name);\n }\n for (const [name, value] of tag.attributes) {\n if (el.getAttribute(name) !== value) el.setAttribute(name, value);\n }\n record.attributes = tag.attributes;\n if (tag.tag === \"title\" || tag.tag === \"style\") {\n const text = tag.text ?? \"\";\n if (el.textContent !== text) el.textContent = text;\n }\n}\n\n/**\n * Creates the DOM sink for one document. The returned function makes `document.head` show the\n * given winners: it releases elements whose slot is gone, adopts or creates the rest and updates\n * them in place. It is called once per batch of registrations, so one call is one DOM pass.\n *\n * @param doc The document whose head is written.\n * @returns A function that applies a list of winners.\n * @internal\n * @since 1.0.0\n */\nexport function createDomHeadSink(doc: Document): (winners: readonly HeadWinner[]) => void {\n const owned = new Map<string, Owned>();\n return (winners: readonly HeadWinner[]): void => {\n const head = doc.head;\n const wanted = new Set(winners.map((winner) => winner.slot));\n for (const [slot, record] of owned) {\n if (wanted.has(slot) && record.el.parentNode === head) continue;\n owned.delete(slot);\n release(head, record);\n }\n const claimed = new Set<Element>();\n for (const record of owned.values()) claimed.add(record.el);\n for (const winner of winners) {\n let record = owned.get(winner.slot);\n if (record === undefined) {\n record = acquire(doc, winner.slot, winner.tag, claimed);\n owned.set(winner.slot, record);\n claimed.add(record.el);\n }\n sync(record, winner.tag);\n }\n };\n}\n"],"mappings":";;;AAiBA,SAAS,QAAQ,MAAuB,QAAqB;CAC3D,MAAM,KAAK,OAAO;CAClB,IAAI,GAAG,eAAe,MAAM;CAC5B,IAAI,GAAG,cAAc,WAAW,CAAC,OAAO,SAAS;EAC/C,IAAI,OAAO,gBAAgB,KAAA,KAAa,GAAG,gBAAgB,OAAO,aAChE,GAAG,cAAc,OAAO;EAE1B;CACF;CACA,GAAG,OAAO;AACZ;;;;;;AAOA,SAAS,UACP,MACA,MACA,KACA,SACqB;CACrB,IAAI,IAAI,aAAa,KAAA,GAAW,OAAO,KAAA;CACvC,KAAK,MAAM,aAAa,MAAM,KAAK,KAAK,iBAAiB,IAAI,GAAG,CAAC,GAAG;EAClE,IAAI,QAAQ,IAAI,SAAS,GAAG;EAC5B,IAAI,kBAAkB,SAAS,MAAM,MAAM;EAC3C,IAAI,UAAU,aAAA,kBAAwB,KAAK,IAAI,QAAQ,SAAS,OAAO;CACzE;AAEF;;AAGA,SAAS,QAAQ,KAAe,MAAc,KAAoB,SAA8B;CAC9F,MAAM,OAAO,IAAI;CACjB,MAAM,WAAW,UAAU,MAAM,MAAM,KAAK,OAAO;CACnD,IAAI,aAAa,KAAA,GAEf,OAAO;EAAE,IAAI;EAAU,SAAS;EAAO,aADnB,IAAI,QAAQ,UAAU,SAAS,cAAc,KAAA;EACb,YAAY,CAAC;CAAE;CAErE,MAAM,KAAK,IAAI,cAAc,IAAI,GAAG;CACpC,GAAG,aAAa,aAAa,EAAE;CAC/B,IAAI,IAAI,QAAQ,KAAA,GAAW,GAAG,aAAa,UAAU,IAAI,GAAG;CAC5D,IAAI,IAAI,QAAQ,QAAQ,KAAK,aAAa,IAAI,KAAK,UAAU;MACxD,KAAK,YAAY,EAAE;CACxB,OAAO;EAAE;EAAI,SAAS;EAAM,aAAa,KAAA;EAAW,YAAY,CAAC;CAAE;AACrE;;AAGA,SAAS,KAAK,QAAe,KAA0B;CACrD,MAAM,KAAK,OAAO;CAClB,MAAM,SAAS,IAAI,IAAoB,IAAI,UAAU;CACrD,KAAK,MAAM,CAAC,SAAS,OAAO,YAC1B,IAAI,CAAC,OAAO,IAAI,IAAI,GAAG,GAAG,gBAAgB,IAAI;CAEhD,KAAK,MAAM,CAAC,MAAM,UAAU,IAAI,YAC9B,IAAI,GAAG,aAAa,IAAI,MAAM,OAAO,GAAG,aAAa,MAAM,KAAK;CAElE,OAAO,aAAa,IAAI;CACxB,IAAI,IAAI,QAAQ,WAAW,IAAI,QAAQ,SAAS;EAC9C,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,GAAG,gBAAgB,MAAM,GAAG,cAAc;CAChD;AACF;;;;;;;;;;;AAYA,SAAgB,kBAAkB,KAAyD;CACzF,MAAM,wBAAQ,IAAI,IAAmB;CACrC,QAAQ,YAAyC;EAC/C,MAAM,OAAO,IAAI;EACjB,MAAM,SAAS,IAAI,IAAI,QAAQ,KAAK,WAAW,OAAO,IAAI,CAAC;EAC3D,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO;GAClC,IAAI,OAAO,IAAI,IAAI,KAAK,OAAO,GAAG,eAAe,MAAM;GACvD,MAAM,OAAO,IAAI;GACjB,QAAQ,MAAM,MAAM;EACtB;EACA,MAAM,0BAAU,IAAI,IAAa;EACjC,KAAK,MAAM,UAAU,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE;EAC1D,KAAK,MAAM,UAAU,SAAS;GAC5B,IAAI,SAAS,MAAM,IAAI,OAAO,IAAI;GAClC,IAAI,WAAW,KAAA,GAAW;IACxB,SAAS,QAAQ,KAAK,OAAO,MAAM,OAAO,KAAK,OAAO;IACtD,MAAM,IAAI,OAAO,MAAM,MAAM;IAC7B,QAAQ,IAAI,OAAO,EAAE;GACvB;GACA,KAAK,QAAQ,OAAO,GAAG;EACzB;CACF;AACF"}
@@ -0,0 +1,84 @@
1
+ import { createHeadRegistry } from "./registry.js";
2
+ import { normalizeTags } from "./validate.js";
3
+ import { ServerHeadContext } from "./server-head.js";
4
+ import { createDomHeadSink } from "./sink.js";
5
+ import { createRoot, getOwner, isServer, untrack, useContext, useEffect, useRenderEffect, useSignal } from "@shadow-js/core";
6
+ //#region src/head/use-head.ts
7
+ /** One registry per document, shared by every `useHead` call on it. */
8
+ const registries = /* @__PURE__ */ new WeakMap();
9
+ /**
10
+ * Creates the registry for a document and the deferred effect that writes it to the head. The
11
+ * effect is detached: it lives as long as the document, not as long as the first caller. It runs
12
+ * in the user-effect queue, so every registration made in one flush produces one DOM pass.
13
+ */
14
+ function createRegistryFor(doc) {
15
+ return createRoot(() => {
16
+ const [version, bump] = useSignal(0);
17
+ const registry = createHeadRegistry(() => {
18
+ bump((count) => count + 1);
19
+ });
20
+ const apply = createDomHeadSink(doc);
21
+ useEffect(() => {
22
+ version();
23
+ return registry.winners();
24
+ }, (winners) => {
25
+ apply(winners);
26
+ });
27
+ return registry;
28
+ }, { detached: true });
29
+ }
30
+ /** The registry of a document, created on first use. */
31
+ function registryFor(doc) {
32
+ const known = registries.get(doc);
33
+ if (known !== void 0) return known;
34
+ const registry = createRegistryFor(doc);
35
+ registries.set(doc, registry);
36
+ return registry;
37
+ }
38
+ /**
39
+ * Registers head tags for the lifetime of the current owner. Each registration joins the stack of
40
+ * its identity: `title` and `base` are singletons, `meta` is keyed by its name, property,
41
+ * http-equiv or charset (and media), icons by rel, sizes and type, resource links by rel, href and
42
+ * as, and styles by key. The last registration of an identity wins; disposing it restores the one
43
+ * below. Append-only tags (no identity) all stay. Passing a function re-registers when its
44
+ * dependencies change. On the client the registrations are written to `document.head` after the
45
+ * render phase of a flush, in one pass per flush. On the server the tags go to the render's `head`
46
+ * collector (see `createServerHead`), read once; without one, or outside an owner, nothing is
47
+ * registered.
48
+ *
49
+ * @param input One tag, several tags, or a function returning them. `null`, `undefined` and `false`
50
+ * register nothing.
51
+ * @throws TypeError for an invalid tag description (see {@link normalizeTags}); on the client the
52
+ * error is raised in the registration's render effect and goes to the owner's error handler.
53
+ * In development builds, calling it on the client with no owner does not throw: it warns
54
+ * `HEAD_OUTSIDE_OWNER` and registers nothing.
55
+ * @example
56
+ * import { useSignal } from "@shadow-js/core";
57
+ * import { useHead } from "@shadow-js/web";
58
+ *
59
+ * function Post() {
60
+ * const [post] = useSignal({ title: "Hello" });
61
+ * useHead(() => ({ tag: "title", children: `${post().title} | Blog` }));
62
+ * return null;
63
+ * }
64
+ * @see Title
65
+ * @see Meta
66
+ * @since 1.0.0
67
+ */
68
+ function useHead(input) {
69
+ if (isServer) {
70
+ const collector = getOwner() === null ? null : useContext(ServerHeadContext);
71
+ if (collector !== null) collector.add(normalizeTags(untrack(() => typeof input === "function" ? input() : input)));
72
+ return;
73
+ }
74
+ if (getOwner() === null) {
75
+ console.warn("[shadow HEAD_OUTSIDE_OWNER] useHead() needs an owner; nothing was registered.");
76
+ return;
77
+ }
78
+ const registry = registryFor(document);
79
+ useRenderEffect(() => normalizeTags(typeof input === "function" ? input() : input), (tags) => registry.add(tags));
80
+ }
81
+ //#endregion
82
+ export { useHead };
83
+
84
+ //# sourceMappingURL=use-head.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-head.js","names":[],"sources":["../../../src/head/use-head.ts"],"sourcesContent":["import {\n createRoot,\n getOwner,\n isServer,\n untrack,\n useContext,\n useEffect,\n useRenderEffect,\n useSignal,\n} from \"@shadow-js/core\";\nimport { createHeadRegistry, type HeadRegistry } from \"./registry\";\nimport { ServerHeadContext } from \"./server-head\";\nimport { createDomHeadSink } from \"./sink\";\nimport { type HeadInput, normalizeTags } from \"./validate\";\n\n/** One registry per document, shared by every `useHead` call on it. */\nconst registries = new WeakMap<Document, HeadRegistry>();\n\n/**\n * Creates the registry for a document and the deferred effect that writes it to the head. The\n * effect is detached: it lives as long as the document, not as long as the first caller. It runs\n * in the user-effect queue, so every registration made in one flush produces one DOM pass.\n */\nfunction createRegistryFor(doc: Document): HeadRegistry {\n return createRoot(\n (): HeadRegistry => {\n const [version, bump] = useSignal(0);\n const registry = createHeadRegistry(() => {\n bump((count) => count + 1);\n });\n const apply = createDomHeadSink(doc);\n useEffect(\n () => {\n version();\n return registry.winners();\n },\n (winners) => {\n apply(winners);\n },\n );\n return registry;\n },\n { detached: true },\n );\n}\n\n/** The registry of a document, created on first use. */\nfunction registryFor(doc: Document): HeadRegistry {\n const known = registries.get(doc);\n if (known !== undefined) return known;\n const registry = createRegistryFor(doc);\n registries.set(doc, registry);\n return registry;\n}\n\n/**\n * Registers head tags for the lifetime of the current owner. Each registration joins the stack of\n * its identity: `title` and `base` are singletons, `meta` is keyed by its name, property,\n * http-equiv or charset (and media), icons by rel, sizes and type, resource links by rel, href and\n * as, and styles by key. The last registration of an identity wins; disposing it restores the one\n * below. Append-only tags (no identity) all stay. Passing a function re-registers when its\n * dependencies change. On the client the registrations are written to `document.head` after the\n * render phase of a flush, in one pass per flush. On the server the tags go to the render's `head`\n * collector (see `createServerHead`), read once; without one, or outside an owner, nothing is\n * registered.\n *\n * @param input One tag, several tags, or a function returning them. `null`, `undefined` and `false`\n * register nothing.\n * @throws TypeError for an invalid tag description (see {@link normalizeTags}); on the client the\n * error is raised in the registration's render effect and goes to the owner's error handler.\n * In development builds, calling it on the client with no owner does not throw: it warns\n * `HEAD_OUTSIDE_OWNER` and registers nothing.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { useHead } from \"@shadow-js/web\";\n *\n * function Post() {\n * const [post] = useSignal({ title: \"Hello\" });\n * useHead(() => ({ tag: \"title\", children: `${post().title} | Blog` }));\n * return null;\n * }\n * @see Title\n * @see Meta\n * @since 1.0.0\n */\nexport function useHead(input: HeadInput | (() => HeadInput)): void {\n if (isServer) {\n const collector = getOwner() === null ? null : useContext(ServerHeadContext);\n if (collector !== null) {\n collector.add(normalizeTags(untrack(() => (typeof input === \"function\" ? input() : input))));\n }\n return;\n }\n if (getOwner() === null) {\n if (__DEV__) {\n console.warn(\"[shadow HEAD_OUTSIDE_OWNER] useHead() needs an owner; nothing was registered.\");\n }\n return;\n }\n const registry = registryFor(document);\n useRenderEffect(\n () => normalizeTags(typeof input === \"function\" ? input() : input),\n (tags) => registry.add(tags),\n );\n}\n"],"mappings":";;;;;;;AAgBA,MAAM,6BAAa,IAAI,QAAgC;;;;;;AAOvD,SAAS,kBAAkB,KAA6B;CACtD,OAAO,iBACe;EAClB,MAAM,CAAC,SAAS,QAAQ,UAAU,CAAC;EACnC,MAAM,WAAW,yBAAyB;GACxC,MAAM,UAAU,QAAQ,CAAC;EAC3B,CAAC;EACD,MAAM,QAAQ,kBAAkB,GAAG;EACnC,gBACQ;GACJ,QAAQ;GACR,OAAO,SAAS,QAAQ;EAC1B,IACC,YAAY;GACX,MAAM,OAAO;EACf,CACF;EACA,OAAO;CACT,GACA,EAAE,UAAU,KAAK,CACnB;AACF;;AAGA,SAAS,YAAY,KAA6B;CAChD,MAAM,QAAQ,WAAW,IAAI,GAAG;CAChC,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,WAAW,kBAAkB,GAAG;CACtC,WAAW,IAAI,KAAK,QAAQ;CAC5B,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,QAAQ,OAA4C;CAClE,IAAI,UAAU;EACZ,MAAM,YAAY,SAAS,MAAM,OAAO,OAAO,WAAW,iBAAiB;EAC3E,IAAI,cAAc,MAChB,UAAU,IAAI,cAAc,cAAe,OAAO,UAAU,aAAa,MAAM,IAAI,KAAM,CAAC,CAAC;EAE7F;CACF;CACA,IAAI,SAAS,MAAM,MAAM;EAErB,QAAQ,KAAK,+EAA+E;EAE9F;CACF;CACA,MAAM,WAAW,YAAY,QAAQ;CACrC,sBACQ,cAAc,OAAO,UAAU,aAAa,MAAM,IAAI,KAAK,IAChE,SAAS,SAAS,IAAI,IAAI,CAC7B;AACF"}
@@ -0,0 +1,268 @@
1
+ import { warnOnce } from "../internal/diagnostics.js";
2
+ import { isUnsafeUrlAttribute } from "../attributes.js";
3
+ //#region src/head/validate.ts
4
+ /** Marks every element the sink created or adopted. Callers may not supply it. @internal */
5
+ const HEAD_MARKER = "data-shadow-head";
6
+ /** Carries a style's key so a server-rendered style can be adopted. @internal */
7
+ const HEAD_KEY = "data-shadow-key";
8
+ const TAG_NAMES = /* @__PURE__ */ new Set([
9
+ "title",
10
+ "meta",
11
+ "link",
12
+ "style",
13
+ "base"
14
+ ]);
15
+ const ATTRIBUTE_NAME = /^[a-zA-Z_][a-zA-Z0-9_:.-]*$/;
16
+ const RESERVED_ATTRIBUTES = /* @__PURE__ */ new Set([HEAD_MARKER, HEAD_KEY]);
17
+ /** Names skipped silently, as spread does: they would reach a prototype if written as keys. */
18
+ const FORBIDDEN_NAMES = /* @__PURE__ */ new Set([
19
+ "__proto__",
20
+ "constructor",
21
+ "prototype"
22
+ ]);
23
+ const META_IDENTITY_FIELDS = [
24
+ "name",
25
+ "property",
26
+ "http-equiv",
27
+ "charset"
28
+ ];
29
+ /**
30
+ * Properties that repeat by design (one tag per image, per tag, per locale). Their identity includes the content,
31
+ * so every value stays; the others are last-wins. Sub-properties of an image (`og:image:width`) are single.
32
+ * @since 1.0.0
33
+ */
34
+ const MULTI_VALUED_META = /* @__PURE__ */ new Set([
35
+ "og:image",
36
+ "og:video",
37
+ "og:audio",
38
+ "og:locale:alternate",
39
+ "og:email",
40
+ "og:phone_number",
41
+ "og:fax_number",
42
+ "article:tag",
43
+ "article:author",
44
+ "book:author",
45
+ "book:tag",
46
+ "music:album",
47
+ "music:song",
48
+ "music:musician",
49
+ "music:creator",
50
+ "video:actor",
51
+ "video:director",
52
+ "video:writer",
53
+ "video:tag",
54
+ "fb:admins",
55
+ "twitter:image"
56
+ ]);
57
+ /** Links that repeat (alternates per language, authors, archives): their identity is every attribute. */
58
+ const MULTI_LINK_RELS = /* @__PURE__ */ new Set([
59
+ "alternate",
60
+ "author",
61
+ "archives",
62
+ "assets",
63
+ "bookmarks",
64
+ "me",
65
+ "apple-touch-startup-image"
66
+ ]);
67
+ const RESOURCE_RELS = /* @__PURE__ */ new Set([
68
+ "preload",
69
+ "modulepreload",
70
+ "prefetch",
71
+ "preconnect",
72
+ "dns-prefetch",
73
+ "stylesheet"
74
+ ]);
75
+ /** True for the tag names the registry manages. @internal */
76
+ function isHeadTagName(value) {
77
+ return TAG_NAMES.has(value);
78
+ }
79
+ /**
80
+ * Length-prefixed identity: `["a|b"]` and `["a", "b"]` can never collide because every part
81
+ * carries its own length.
82
+ */
83
+ function frame(parts) {
84
+ return parts.map((part) => `${part.length}:${part}`).join("");
85
+ }
86
+ /** Text of an attribute value, or undefined when the attribute is omitted. */
87
+ function attributeText(value) {
88
+ if (value === void 0 || value === null || value === false) return void 0;
89
+ if (value === true) return "";
90
+ if (typeof value === "string") return value;
91
+ if (typeof value === "number") return String(value);
92
+ throw new TypeError("ShadowJS head: attribute values must be strings, numbers or booleans.");
93
+ }
94
+ /**
95
+ * Validates the props of one tag and returns its lower-case, de-duplicated attributes, in order. The
96
+ * map is the lookup that the identity is built from, so it is built once per tag.
97
+ */
98
+ function attributesFrom(tag, props) {
99
+ if (props === void 0 || props === null) return /* @__PURE__ */ new Map();
100
+ if (typeof props !== "object" || Array.isArray(props)) throw new TypeError("ShadowJS head: props must be an object.");
101
+ const values = /* @__PURE__ */ new Map();
102
+ for (const key of Object.keys(props)) {
103
+ if (!ATTRIBUTE_NAME.test(key)) throw new TypeError(`ShadowJS head: "${key}" is not a valid attribute name.`);
104
+ const name = key.toLowerCase();
105
+ if (name.startsWith("on")) throw new TypeError(`ShadowJS head: event attribute "${key}" is not allowed.`);
106
+ if (RESERVED_ATTRIBUTES.has(name)) throw new TypeError(`ShadowJS head: "${key}" is reserved for the runtime.`);
107
+ if (FORBIDDEN_NAMES.has(name)) continue;
108
+ const text = attributeText(Reflect.get(props, key));
109
+ if (text === void 0) continue;
110
+ if (isUnsafeUrlAttribute(name, text)) {
111
+ warnOnce("UNSAFE_URL_BLOCKED", `Dropped the unsafe "${name}" value of a <${tag}> head tag.`);
112
+ continue;
113
+ }
114
+ values.set(name, text);
115
+ }
116
+ return values;
117
+ }
118
+ /** Children text: title and style only, and only as a string. */
119
+ function textFrom(tag, children) {
120
+ if (children === void 0 || children === null) return void 0;
121
+ if (tag !== "title" && tag !== "style") throw new TypeError(`ShadowJS head: <${tag}> takes no children.`);
122
+ if (typeof children !== "string") throw new TypeError("ShadowJS head: children must be text.");
123
+ return children;
124
+ }
125
+ /** The key of a style. Only style takes one. */
126
+ function keyFrom(tag, key) {
127
+ if (key === void 0 || key === null) return void 0;
128
+ if (tag !== "style") throw new TypeError("ShadowJS head: only <style> takes a key.");
129
+ if (typeof key !== "string" || key === "") throw new TypeError("ShadowJS head: a key must be a non-empty string.");
130
+ return key;
131
+ }
132
+ /** Rel tokens, lower-cased and sorted, so `"ICON apple"` and `"apple icon"` compare equal. */
133
+ function normalizeRel(raw) {
134
+ if (raw === void 0) return void 0;
135
+ const tokens = raw.toLowerCase().split(/\s+/).filter((token) => token !== "");
136
+ if (tokens.length === 0) return void 0;
137
+ return tokens.sort().join(" ");
138
+ }
139
+ /** Identity of a meta: its first identifying field and the media query. */
140
+ function metaIdentity(lookup) {
141
+ const media = lookup.get("media") ?? "";
142
+ for (const field of META_IDENTITY_FIELDS) {
143
+ const value = lookup.get(field);
144
+ if (value === void 0) continue;
145
+ if (field === "charset") return frame(["meta", field]);
146
+ if (MULTI_VALUED_META.has(value)) return frame([
147
+ "meta",
148
+ field,
149
+ value,
150
+ media,
151
+ lookup.get("content") ?? ""
152
+ ]);
153
+ return frame([
154
+ "meta",
155
+ field,
156
+ value,
157
+ media
158
+ ]);
159
+ }
160
+ }
161
+ /** Identity of a link: icons by rel, sizes and type; preloads and stylesheets by rel, href and as. */
162
+ function linkIdentity(lookup) {
163
+ const rel = normalizeRel(lookup.get("rel"));
164
+ if (rel === void 0) return void 0;
165
+ if (rel.split(" ").some((token) => token === "icon" || token.endsWith("-icon"))) return frame([
166
+ "link",
167
+ "icon",
168
+ rel,
169
+ lookup.get("sizes") ?? "",
170
+ lookup.get("type") ?? ""
171
+ ]);
172
+ if (rel === "canonical") return frame(["link", "canonical"]);
173
+ if (RESOURCE_RELS.has(rel)) return frame([
174
+ "link",
175
+ "resource",
176
+ rel,
177
+ lookup.get("href") ?? "",
178
+ lookup.get("as") ?? ""
179
+ ]);
180
+ if (MULTI_LINK_RELS.has(rel)) return frame([
181
+ "link",
182
+ "multi",
183
+ rel,
184
+ lookup.get("href") ?? "",
185
+ lookup.get("hreflang") ?? "",
186
+ lookup.get("media") ?? "",
187
+ lookup.get("type") ?? ""
188
+ ]);
189
+ }
190
+ /** Identity of a validated tag, or undefined when the tag is append-only. @internal */
191
+ function identityOf(tag, lookup, key) {
192
+ if (tag === "title") return frame(["title"]);
193
+ if (tag === "base") return frame(["base"]);
194
+ if (tag === "style") return key === void 0 ? void 0 : frame(["style", key]);
195
+ return tag === "meta" ? metaIdentity(lookup) : linkIdentity(lookup);
196
+ }
197
+ /**
198
+ * Validates one head tag description and computes its identity. Hostile input throws a
199
+ * TypeError: an unknown tag (including `script`), a bad attribute name, an event attribute, a
200
+ * reserved marker, children on a void tag, or a key on anything but a style. An unsafe URL
201
+ * attribute is dropped with a dev warning, the same way `setAttribute` treats it.
202
+ *
203
+ * @param input The description, usually a {@link HeadTag}; any value is checked.
204
+ * @returns The normalized tag.
205
+ * @throws TypeError for every invalid input listed above.
206
+ * @internal
207
+ * @since 1.0.0
208
+ */
209
+ function normalizeTag(input) {
210
+ if (input === null || typeof input !== "object" || Array.isArray(input)) throw new TypeError("ShadowJS head: a head tag must be an object.");
211
+ const name = Reflect.get(input, "tag");
212
+ if (typeof name !== "string" || !isHeadTagName(name)) throw new TypeError(`ShadowJS head: unsupported tag "${typeof name === "string" ? name : typeof name}".`);
213
+ const lookup = attributesFrom(name, Reflect.get(input, "props"));
214
+ const text = textFrom(name, Reflect.get(input, "children"));
215
+ const key = keyFrom(name, Reflect.get(input, "key"));
216
+ return {
217
+ tag: name,
218
+ attributes: [...lookup],
219
+ text,
220
+ key,
221
+ identity: identityOf(name, lookup, key)
222
+ };
223
+ }
224
+ /**
225
+ * Normalizes what {@link useHead} receives: one description, a list, or nothing.
226
+ *
227
+ * @param input A description, a list of them, or null, undefined or false for none.
228
+ * @returns The normalized tags, in order.
229
+ * @throws TypeError when any description is invalid: an unknown tag (including `script`), an
230
+ * attribute name that is not valid or starts with `on`, a reserved marker attribute, an attribute
231
+ * value that is not a string, number or boolean, children on a tag other than `title` and `style`,
232
+ * or a key on anything but a `style`. The production messages start with `SHADOW_HEAD_`.
233
+ * @example
234
+ * import { normalizeTags } from "@shadow-js/web/server";
235
+ *
236
+ * const tags = normalizeTags([
237
+ * { tag: "title", children: "A" },
238
+ * { tag: "base", props: { href: "/" } },
239
+ * ]);
240
+ * console.log(tags.length); // 2
241
+ * @see useHead
242
+ * @since 1.0.0
243
+ */
244
+ function normalizeTags(input) {
245
+ if (input === null || input === void 0 || input === false) return [];
246
+ if (Array.isArray(input)) return input.map((item) => normalizeTag(item));
247
+ return [normalizeTag(input)];
248
+ }
249
+ /**
250
+ * The identity of an element already in the document, computed the same way as for a
251
+ * registration, so the sink can adopt a server-rendered element. Undefined for elements that are
252
+ * not head tags or that are append-only.
253
+ * @internal
254
+ */
255
+ function identityOfElement(element) {
256
+ const name = element.localName;
257
+ if (!isHeadTagName(name)) return void 0;
258
+ const lookup = /* @__PURE__ */ new Map();
259
+ for (const attribute of Array.from(element.attributes)) {
260
+ if (attribute.name === "data-shadow-head" || attribute.name === "data-shadow-key") continue;
261
+ lookup.set(attribute.name.toLowerCase(), attribute.value);
262
+ }
263
+ return identityOf(name, lookup, element.getAttribute("data-shadow-key") ?? void 0);
264
+ }
265
+ //#endregion
266
+ export { HEAD_KEY, HEAD_MARKER, identityOf, identityOfElement, isHeadTagName, normalizeTag, normalizeTags };
267
+
268
+ //# sourceMappingURL=validate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.js","names":[],"sources":["../../../src/head/validate.ts"],"sourcesContent":["import { isUnsafeUrlAttribute, warnOnce } from \"../extend\";\n\n/**\n * Head elements the registry manages. `script` and `noscript` are refused: a head-registered\n * script would bypass CSP nonces and Trusted Types, so scripts come only from the asset pipeline.\n * @since 1.0.0\n */\nexport type HeadTagName = \"title\" | \"meta\" | \"link\" | \"style\" | \"base\";\n\n/**\n * One attribute value: a string is written as is, `true` as an empty attribute, `false` and\n * `undefined` omit it, and a number is written as text.\n * @since 1.0.0\n */\nexport type HeadAttributeValue = string | number | boolean | undefined;\n\n/**\n * Describes one head element. `key` identifies a `style` for replacement; other tags use their\n * own identity (see {@link useHead}).\n *\n * @example\n * import type { HeadTag } from \"@shadow-js/web\";\n *\n * const description: HeadTag = { tag: \"meta\", props: { name: \"description\", content: \"Docs\" } };\n * @since 1.0.0\n */\nexport interface HeadTag {\n /** The element to register: `title`, `meta`, `link`, `style` or `base`. Any other name throws. */\n readonly tag: HeadTagName;\n /**\n * The attributes of the element. Names are case-insensitive, must be valid attribute names, and\n * may not start with `on`.\n * @default undefined (the element has no attributes)\n */\n readonly props?: Readonly<Record<string, HeadAttributeValue>>;\n /**\n * The text of a `title` or `style`. Other tags take no text and throw when it is given.\n * @default undefined (no text)\n */\n readonly children?: string;\n /**\n * Identity of a `style`: a later style with the same key replaces an earlier one. Only `style`\n * takes a key.\n * @default undefined (the style has no identity and always stays)\n */\n readonly key?: string;\n}\n\n/**\n * What {@link useHead} accepts: one tag, several tags, or nothing (which registers nothing).\n * @since 1.0.0\n */\nexport type HeadInput = HeadTag | readonly HeadTag[] | null | undefined | false;\n\n/**\n * A validated tag: lower-case attribute names, the text it carries, and its identity. Produced\n * only by {@link normalizeTag}, so the registry and the DOM sink never see unchecked input.\n * @internal\n */\nexport interface NormalizedTag {\n readonly tag: HeadTagName;\n readonly attributes: ReadonlyArray<readonly [string, string]>;\n readonly text: string | undefined;\n readonly key: string | undefined;\n /** Identity that replaces earlier registrations; undefined for append-only tags. */\n readonly identity: string | undefined;\n}\n\n/** Marks every element the sink created or adopted. Callers may not supply it. @internal */\nexport const HEAD_MARKER = \"data-shadow-head\";\n/** Carries a style's key so a server-rendered style can be adopted. @internal */\nexport const HEAD_KEY = \"data-shadow-key\";\n\nconst TAG_NAMES: ReadonlySet<string> = new Set([\"title\", \"meta\", \"link\", \"style\", \"base\"]);\nconst ATTRIBUTE_NAME = /^[a-zA-Z_][a-zA-Z0-9_:.-]*$/;\nconst RESERVED_ATTRIBUTES: ReadonlySet<string> = new Set([HEAD_MARKER, HEAD_KEY]);\n/** Names skipped silently, as spread does: they would reach a prototype if written as keys. */\nconst FORBIDDEN_NAMES: ReadonlySet<string> = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\nconst META_IDENTITY_FIELDS = [\"name\", \"property\", \"http-equiv\", \"charset\"] as const;\n/**\n * Properties that repeat by design (one tag per image, per tag, per locale). Their identity includes the content,\n * so every value stays; the others are last-wins. Sub-properties of an image (`og:image:width`) are single.\n * @since 1.0.0\n */\nconst MULTI_VALUED_META: ReadonlySet<string> = new Set([\n \"og:image\",\n \"og:video\",\n \"og:audio\",\n \"og:locale:alternate\",\n \"og:email\",\n \"og:phone_number\",\n \"og:fax_number\",\n \"article:tag\",\n \"article:author\",\n \"book:author\",\n \"book:tag\",\n \"music:album\",\n \"music:song\",\n \"music:musician\",\n \"music:creator\",\n \"video:actor\",\n \"video:director\",\n \"video:writer\",\n \"video:tag\",\n \"fb:admins\",\n \"twitter:image\",\n]);\n/** Links that repeat (alternates per language, authors, archives): their identity is every attribute. */\nconst MULTI_LINK_RELS: ReadonlySet<string> = new Set([\n \"alternate\",\n \"author\",\n \"archives\",\n \"assets\",\n \"bookmarks\",\n \"me\",\n \"apple-touch-startup-image\",\n]);\nconst RESOURCE_RELS: ReadonlySet<string> = new Set([\n \"preload\",\n \"modulepreload\",\n \"prefetch\",\n \"preconnect\",\n \"dns-prefetch\",\n \"stylesheet\",\n]);\n\n/** True for the tag names the registry manages. @internal */\nexport function isHeadTagName(value: string): value is HeadTagName {\n return TAG_NAMES.has(value);\n}\n\n/**\n * Length-prefixed identity: `[\"a|b\"]` and `[\"a\", \"b\"]` can never collide because every part\n * carries its own length.\n */\nfunction frame(parts: readonly string[]): string {\n return parts.map((part) => `${part.length}:${part}`).join(\"\");\n}\n\n/** Text of an attribute value, or undefined when the attribute is omitted. */\nfunction attributeText(value: unknown): string | undefined {\n if (value === undefined || value === null || value === false) return undefined;\n if (value === true) return \"\";\n if (typeof value === \"string\") return value;\n if (typeof value === \"number\") return String(value);\n throw new TypeError(\n __DEV__\n ? \"ShadowJS head: attribute values must be strings, numbers or booleans.\"\n : \"SHADOW_HEAD_ATTRIBUTE_VALUE\",\n );\n}\n\n/**\n * Validates the props of one tag and returns its lower-case, de-duplicated attributes, in order. The\n * map is the lookup that the identity is built from, so it is built once per tag.\n */\nfunction attributesFrom(tag: HeadTagName, props: unknown): ReadonlyMap<string, string> {\n if (props === undefined || props === null) return new Map();\n if (typeof props !== \"object\" || Array.isArray(props)) {\n throw new TypeError(__DEV__ ? \"ShadowJS head: props must be an object.\" : \"SHADOW_HEAD_PROPS\");\n }\n const values = new Map<string, string>();\n for (const key of Object.keys(props)) {\n if (!ATTRIBUTE_NAME.test(key)) {\n throw new TypeError(\n __DEV__\n ? `ShadowJS head: \"${key}\" is not a valid attribute name.`\n : \"SHADOW_HEAD_ATTRIBUTE_NAME\",\n );\n }\n const name = key.toLowerCase();\n if (name.startsWith(\"on\")) {\n throw new TypeError(\n __DEV__\n ? `ShadowJS head: event attribute \"${key}\" is not allowed.`\n : \"SHADOW_HEAD_EVENT_ATTRIBUTE\",\n );\n }\n if (RESERVED_ATTRIBUTES.has(name)) {\n throw new TypeError(\n __DEV__ ? `ShadowJS head: \"${key}\" is reserved for the runtime.` : \"SHADOW_HEAD_RESERVED\",\n );\n }\n if (FORBIDDEN_NAMES.has(name)) continue;\n const text = attributeText(Reflect.get(props, key));\n if (text === undefined) continue;\n if (isUnsafeUrlAttribute(name, text)) {\n warnOnce(\"UNSAFE_URL_BLOCKED\", `Dropped the unsafe \"${name}\" value of a <${tag}> head tag.`);\n continue;\n }\n values.set(name, text);\n }\n return values;\n}\n\n/** Children text: title and style only, and only as a string. */\nfunction textFrom(tag: HeadTagName, children: unknown): string | undefined {\n if (children === undefined || children === null) return undefined;\n if (tag !== \"title\" && tag !== \"style\") {\n throw new TypeError(\n __DEV__ ? `ShadowJS head: <${tag}> takes no children.` : \"SHADOW_HEAD_NO_CHILDREN\",\n );\n }\n if (typeof children !== \"string\")\n throw new TypeError(__DEV__ ? \"ShadowJS head: children must be text.\" : \"SHADOW_HEAD_TEXT\");\n return children;\n}\n\n/** The key of a style. Only style takes one. */\nfunction keyFrom(tag: HeadTagName, key: unknown): string | undefined {\n if (key === undefined || key === null) return undefined;\n if (tag !== \"style\")\n throw new TypeError(\n __DEV__ ? \"ShadowJS head: only <style> takes a key.\" : \"SHADOW_HEAD_STYLE_KEY\",\n );\n if (typeof key !== \"string\" || key === \"\") {\n throw new TypeError(\n __DEV__ ? \"ShadowJS head: a key must be a non-empty string.\" : \"SHADOW_HEAD_KEY\",\n );\n }\n return key;\n}\n\n/** Rel tokens, lower-cased and sorted, so `\"ICON apple\"` and `\"apple icon\"` compare equal. */\nfunction normalizeRel(raw: string | undefined): string | undefined {\n if (raw === undefined) return undefined;\n const tokens = raw\n .toLowerCase()\n .split(/\\s+/)\n .filter((token) => token !== \"\");\n if (tokens.length === 0) return undefined;\n return tokens.sort().join(\" \");\n}\n\n/** Identity of a meta: its first identifying field and the media query. */\nfunction metaIdentity(lookup: ReadonlyMap<string, string>): string | undefined {\n const media = lookup.get(\"media\") ?? \"\";\n for (const field of META_IDENTITY_FIELDS) {\n const value = lookup.get(field);\n if (value === undefined) continue;\n // A document has one charset, whatever its value: that meta is a singleton.\n if (field === \"charset\") return frame([\"meta\", field]);\n if (MULTI_VALUED_META.has(value))\n return frame([\"meta\", field, value, media, lookup.get(\"content\") ?? \"\"]);\n return frame([\"meta\", field, value, media]);\n }\n return undefined;\n}\n\n/** Identity of a link: icons by rel, sizes and type; preloads and stylesheets by rel, href and as. */\nfunction linkIdentity(lookup: ReadonlyMap<string, string>): string | undefined {\n const rel = normalizeRel(lookup.get(\"rel\"));\n if (rel === undefined) return undefined;\n const isIcon = rel.split(\" \").some((token) => token === \"icon\" || token.endsWith(\"-icon\"));\n if (isIcon) {\n return frame([\"link\", \"icon\", rel, lookup.get(\"sizes\") ?? \"\", lookup.get(\"type\") ?? \"\"]);\n }\n // A document has one canonical URL: a singleton, so a new value replaces the old element (and a server's\n // copy is adopted) instead of a second `<link rel=\"canonical\">` being appended.\n if (rel === \"canonical\") return frame([\"link\", \"canonical\"]);\n if (RESOURCE_RELS.has(rel)) {\n return frame([\"link\", \"resource\", rel, lookup.get(\"href\") ?? \"\", lookup.get(\"as\") ?? \"\"]);\n }\n if (MULTI_LINK_RELS.has(rel)) {\n return frame([\n \"link\",\n \"multi\",\n rel,\n lookup.get(\"href\") ?? \"\",\n lookup.get(\"hreflang\") ?? \"\",\n lookup.get(\"media\") ?? \"\",\n lookup.get(\"type\") ?? \"\",\n ]);\n }\n return undefined;\n}\n\n/** Identity of a validated tag, or undefined when the tag is append-only. @internal */\nexport function identityOf(\n tag: HeadTagName,\n lookup: ReadonlyMap<string, string>,\n key: string | undefined,\n): string | undefined {\n if (tag === \"title\") return frame([\"title\"]);\n if (tag === \"base\") return frame([\"base\"]);\n if (tag === \"style\") return key === undefined ? undefined : frame([\"style\", key]);\n return tag === \"meta\" ? metaIdentity(lookup) : linkIdentity(lookup);\n}\n\n/**\n * Validates one head tag description and computes its identity. Hostile input throws a\n * TypeError: an unknown tag (including `script`), a bad attribute name, an event attribute, a\n * reserved marker, children on a void tag, or a key on anything but a style. An unsafe URL\n * attribute is dropped with a dev warning, the same way `setAttribute` treats it.\n *\n * @param input The description, usually a {@link HeadTag}; any value is checked.\n * @returns The normalized tag.\n * @throws TypeError for every invalid input listed above.\n * @internal\n * @since 1.0.0\n */\nexport function normalizeTag(input: unknown): NormalizedTag {\n if (input === null || typeof input !== \"object\" || Array.isArray(input)) {\n throw new TypeError(\n __DEV__ ? \"ShadowJS head: a head tag must be an object.\" : \"SHADOW_HEAD_TAG\",\n );\n }\n const name = Reflect.get(input, \"tag\");\n if (typeof name !== \"string\" || !isHeadTagName(name)) {\n const shown = typeof name === \"string\" ? name : typeof name;\n throw new TypeError(\n __DEV__ ? `ShadowJS head: unsupported tag \"${shown}\".` : \"SHADOW_HEAD_TAG_NAME\",\n );\n }\n const lookup = attributesFrom(name, Reflect.get(input, \"props\"));\n const text = textFrom(name, Reflect.get(input, \"children\"));\n const key = keyFrom(name, Reflect.get(input, \"key\"));\n return {\n tag: name,\n attributes: [...lookup],\n text,\n key,\n identity: identityOf(name, lookup, key),\n };\n}\n\n/**\n * Normalizes what {@link useHead} receives: one description, a list, or nothing.\n *\n * @param input A description, a list of them, or null, undefined or false for none.\n * @returns The normalized tags, in order.\n * @throws TypeError when any description is invalid: an unknown tag (including `script`), an\n * attribute name that is not valid or starts with `on`, a reserved marker attribute, an attribute\n * value that is not a string, number or boolean, children on a tag other than `title` and `style`,\n * or a key on anything but a `style`. The production messages start with `SHADOW_HEAD_`.\n * @example\n * import { normalizeTags } from \"@shadow-js/web/server\";\n *\n * const tags = normalizeTags([\n * { tag: \"title\", children: \"A\" },\n * { tag: \"base\", props: { href: \"/\" } },\n * ]);\n * console.log(tags.length); // 2\n * @see useHead\n * @since 1.0.0\n */\nexport function normalizeTags(input: unknown): NormalizedTag[] {\n if (input === null || input === undefined || input === false) return [];\n if (Array.isArray(input)) return input.map((item: unknown) => normalizeTag(item));\n return [normalizeTag(input)];\n}\n\n/**\n * The identity of an element already in the document, computed the same way as for a\n * registration, so the sink can adopt a server-rendered element. Undefined for elements that are\n * not head tags or that are append-only.\n * @internal\n */\nexport function identityOfElement(element: Element): string | undefined {\n const name = element.localName;\n if (!isHeadTagName(name)) return undefined;\n const lookup = new Map<string, string>();\n for (const attribute of Array.from(element.attributes)) {\n if (attribute.name === HEAD_MARKER || attribute.name === HEAD_KEY) continue;\n lookup.set(attribute.name.toLowerCase(), attribute.value);\n }\n const key = element.getAttribute(HEAD_KEY) ?? undefined;\n return identityOf(name, lookup, key);\n}\n"],"mappings":"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"}
@@ -0,0 +1,120 @@
1
+ import { createRootScope, resourceKey, withScope } from "./internal/hydration-scope.js";
2
+ import { beginClaiming, claimElement, claimPortal, endClaiming, isClaiming, liftedRegions, releaseUnclaimedPortals, takeRegion, withoutClaiming } from "./internal/claim.js";
3
+ import { claims } from "./internal/hydration-hooks.js";
4
+ import { bindRegion, createRegion, removeRegion } from "./insert.js";
5
+ import { attachRootErrors } from "./control-flow/root-errors.js";
6
+ import { replayEarlyEvents } from "./internal/early-events.js";
7
+ import { ResourceCacheContext, batch, createRoot, flushSync, runWithOwner, untrack } from "@shadow-js/core";
8
+ import { withHydration } from "@shadow-js/core/extend";
9
+ //#region src/hydration.ts
10
+ function dataCache(data) {
11
+ const used = /* @__PURE__ */ new Set();
12
+ return {
13
+ key: resourceKey,
14
+ read(key) {
15
+ if (used.has(key) || !Object.hasOwn(data, key)) return void 0;
16
+ used.add(key);
17
+ return { value: data[key] };
18
+ },
19
+ track() {}
20
+ };
21
+ }
22
+ /**
23
+ * Removes marker comments the pass did not claim, so the live DOM never keeps any, and the server
24
+ * blocks of portals the client did not render (they would show content the client does not have).
25
+ */
26
+ function stripLeftovers(container) {
27
+ const doc = container instanceof Document ? container : container.ownerDocument;
28
+ if (doc === null) return;
29
+ if (doc.body !== null) releaseUnclaimedPortals(doc.body);
30
+ const walker = doc.createTreeWalker(container, NodeFilter.SHOW_COMMENT);
31
+ const stale = [];
32
+ while (walker.nextNode()) {
33
+ const comment = walker.currentNode;
34
+ if (comment.data === "[" || comment.data === "]") stale.push(comment);
35
+ }
36
+ for (const comment of stale) comment.remove();
37
+ }
38
+ /**
39
+ * Attaches the application to HTML the server already rendered into `container`. Elements are
40
+ * claimed by their `data-hk` keys instead of created, so the DOM is not rebuilt and nodes keep
41
+ * their identity. Event handlers and reactive bindings are attached; markers are removed. Parts the
42
+ * server and client disagree on are repaired by reconciliation, never left half hydrated.
43
+ *
44
+ * @param code Runs once, untracked, and builds the same component tree the server rendered.
45
+ * @param container Element or Document that holds the server markup.
46
+ * @param options `renderId` (must match the server), the server's resource `data`, an `owner`, and
47
+ * the error reporters. Undefined uses the defaults.
48
+ * @returns A dispose function that stops the hydrated root and removes its nodes. Safe to call more
49
+ * than once.
50
+ * @throws Error (production message `SHADOW_HYDRATE_RUNNING`) when called while another hydration
51
+ * pass is in progress.
52
+ * @example
53
+ * import { createComponent, hydrate } from "@shadow-js/web";
54
+ *
55
+ * function App() {
56
+ * return "Hello";
57
+ * }
58
+ *
59
+ * const container = document.getElementById("app") as Element;
60
+ * const data = JSON.parse(document.getElementById("data")?.textContent ?? "{}") as Record<
61
+ * string,
62
+ * unknown
63
+ * >;
64
+ * const dispose = hydrate(() => createComponent(App, {}), container, { data });
65
+ * @see render
66
+ * @since 1.0.0
67
+ */
68
+ function hydrate(code, container, options = {}) {
69
+ if (isClaiming()) throw new Error("hydrate(): a hydration pass is already running.");
70
+ const registry = /* @__PURE__ */ new Map();
71
+ const roots = container instanceof Element ? [container] : [];
72
+ for (const element of [...roots, ...Array.from(container.querySelectorAll("[data-hk]"))]) {
73
+ const key = element.getAttribute("data-hk");
74
+ if (key !== null) registry.set(key, element);
75
+ }
76
+ beginClaiming(registry, options.onRecoverableError);
77
+ const passClaims = {
78
+ claimElement,
79
+ takeRegion,
80
+ liftedRegions,
81
+ claimPortal,
82
+ isClaiming,
83
+ withoutClaiming
84
+ };
85
+ const previousClaims = claims.current;
86
+ claims.current = passClaims;
87
+ const cache = dataCache(options.data ?? {});
88
+ const region = createRegion(container, null, Array.from(container.childNodes));
89
+ let stop;
90
+ try {
91
+ stop = withHydration(() => batch(() => withScope(createRootScope(options.renderId), () => runWithOwner(options.owner ?? null, () => createRoot((dispose) => {
92
+ attachRootErrors(options);
93
+ ResourceCacheContext({
94
+ value: cache,
95
+ get children() {
96
+ bindRegion(region, untrack(code));
97
+ return null;
98
+ }
99
+ });
100
+ return dispose;
101
+ })))));
102
+ flushSync();
103
+ } finally {
104
+ endClaiming();
105
+ claims.current = previousClaims;
106
+ }
107
+ replayEarlyEvents();
108
+ stripLeftovers(container);
109
+ let disposed = false;
110
+ return () => {
111
+ if (disposed) return;
112
+ disposed = true;
113
+ stop();
114
+ removeRegion(region);
115
+ };
116
+ }
117
+ //#endregion
118
+ export { hydrate };
119
+
120
+ //# sourceMappingURL=hydration.js.map