@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,314 @@
1
+ import { invalid } from "./errors.js";
2
+ // src/server/serialize.ts
3
+ /** Characters that may not appear raw in the output: they would end a script element or a line. */
4
+ const UNSAFE_TEXT = /[<>&\u2028\u2029]/g;
5
+ /** Escapes text for `<script type="application/json">`: the JSON stays valid, the markup cannot close. */
6
+ function escapeForScript(json) {
7
+ return json.replace(UNSAFE_TEXT, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`);
8
+ }
9
+ /** Encodes a number that JSON cannot carry exactly. */
10
+ function encodeNumber(value) {
11
+ if (Number.isFinite(value) && !Object.is(value, -0)) return value;
12
+ return {
13
+ $: "num",
14
+ v: Object.is(value, -0) ? "-0" : String(value)
15
+ };
16
+ }
17
+ const BINARY_KINDS = /* @__PURE__ */ new Map([
18
+ ["Int8Array", Int8Array],
19
+ ["Uint8Array", Uint8Array],
20
+ ["Uint8ClampedArray", Uint8ClampedArray],
21
+ ["Int16Array", Int16Array],
22
+ ["Uint16Array", Uint16Array],
23
+ ["Int32Array", Int32Array],
24
+ ["Uint32Array", Uint32Array],
25
+ ["Float32Array", Float32Array],
26
+ ["Float64Array", Float64Array],
27
+ ["BigInt64Array", BigInt64Array],
28
+ ["BigUint64Array", BigUint64Array],
29
+ ["DataView", DataView]
30
+ ]);
31
+ /** Base64 of `bytes`, converted in chunks so a large buffer cannot overflow the call stack. */
32
+ function toBase64(bytes) {
33
+ let binary = "";
34
+ for (let offset = 0; offset < bytes.length; offset += 32768) binary += String.fromCharCode(...bytes.subarray(offset, offset + 32768));
35
+ return btoa(binary);
36
+ }
37
+ /** Bytes of a base64 text; malformed text throws a TypeError. */
38
+ function fromBase64(text) {
39
+ let binary;
40
+ try {
41
+ binary = atob(text);
42
+ } catch {
43
+ throw malformed("binary data is not valid base64.");
44
+ }
45
+ const bytes = new Uint8Array(binary.length);
46
+ for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
47
+ return bytes;
48
+ }
49
+ /** The wire name of a typed array or DataView, or undefined for anything else. */
50
+ function binaryKindOf(value) {
51
+ for (const [name, ctor] of BINARY_KINDS) if (value instanceof ctor) return name;
52
+ }
53
+ /** True for plain objects: prototype is Object.prototype or none. */
54
+ function isPlainObject(value) {
55
+ const proto = Object.getPrototypeOf(value);
56
+ return proto === Object.prototype || proto === null;
57
+ }
58
+ /**
59
+ * Serializes data for embedding in a page, as JSON that is safe inside a
60
+ * `<script type="application/json">` element. It carries what JSON cannot: undefined, NaN,
61
+ * infinities, -0, bigint, Date, URL, Map, Set, ArrayBuffer, typed arrays and DataView (copied: views
62
+ * that shared a buffer come back as independent copies), plus shared references and cycles between
63
+ * plain objects and arrays. Read it back with {@link deserialize}.
64
+ *
65
+ * @param data The value to serialize.
66
+ * @returns JSON text with `<`, `>`, `&`, U+2028 and U+2029 written as `\u` escapes, so it cannot
67
+ * close the script element.
68
+ * @throws TypeError `UNSERIALIZABLE_VALUE` for a function, a symbol, or an object that is not one of
69
+ * the supported kinds (a class instance, for example).
70
+ * @example
71
+ * import { serialize } from "@shadow-js/web/server";
72
+ *
73
+ * const data = { user: { name: "Ada" }, seen: new Set([1, 2]), at: new Date(0) };
74
+ * const tag = `<script type="application/json" id="data">${serialize(data)}<\/script>`;
75
+ * @see deserialize
76
+ * @since 1.0.0
77
+ */
78
+ function serialize(data) {
79
+ const table = [];
80
+ const index = /* @__PURE__ */ new Map();
81
+ const queue = [];
82
+ const slotOf = (value) => {
83
+ const existing = index.get(value);
84
+ if (existing !== void 0) return existing;
85
+ const slot = table.length;
86
+ table.push(null);
87
+ index.set(value, slot);
88
+ queue.push({
89
+ value,
90
+ slot
91
+ });
92
+ return slot;
93
+ };
94
+ const encodeValue = (value) => {
95
+ if (value === void 0) return { $: "u" };
96
+ if (value === null || typeof value === "boolean" || typeof value === "string") return value;
97
+ if (typeof value === "number") return encodeNumber(value);
98
+ if (typeof value === "bigint") return {
99
+ $: "big",
100
+ v: value.toString()
101
+ };
102
+ if (typeof value === "object") return {
103
+ $: "ref",
104
+ i: slotOf(value)
105
+ };
106
+ throw invalid("UNSERIALIZABLE_VALUE", `A ${typeof value} cannot be serialized.`);
107
+ };
108
+ const encodeEntry = (value) => {
109
+ if (value instanceof Date) return {
110
+ $: "date",
111
+ v: encodeValue(value.getTime())
112
+ };
113
+ if (value instanceof ArrayBuffer) return {
114
+ $: "buf",
115
+ v: toBase64(new Uint8Array(value))
116
+ };
117
+ if (ArrayBuffer.isView(value)) {
118
+ const kind = binaryKindOf(value);
119
+ if (kind !== void 0) return {
120
+ $: "bin",
121
+ k: kind,
122
+ v: toBase64(new Uint8Array(value.buffer, value.byteOffset, value.byteLength))
123
+ };
124
+ }
125
+ if (value instanceof URL) return {
126
+ $: "url",
127
+ v: value.href
128
+ };
129
+ if (value instanceof Map) {
130
+ const pairs = [];
131
+ for (const [key, item] of value) pairs.push([encodeValue(key), encodeValue(item)]);
132
+ return {
133
+ $: "map",
134
+ e: pairs
135
+ };
136
+ }
137
+ if (value instanceof Set) {
138
+ const items = [];
139
+ for (const item of value) items.push(encodeValue(item));
140
+ return {
141
+ $: "set",
142
+ e: items
143
+ };
144
+ }
145
+ if (Array.isArray(value)) {
146
+ const items = [];
147
+ for (let i = 0; i < value.length; i += 1) items.push(encodeValue(value[i]));
148
+ return {
149
+ $: "arr",
150
+ e: items
151
+ };
152
+ }
153
+ if (!isPlainObject(value)) throw invalid("UNSERIALIZABLE_VALUE", "Only plain objects, arrays, Map, Set, Date, URL, ArrayBuffer and typed arrays can be serialized.");
154
+ const pairs = [];
155
+ for (const key of Object.keys(value)) pairs.push([key, encodeValue(Reflect.get(value, key))]);
156
+ return {
157
+ $: "obj",
158
+ e: pairs
159
+ };
160
+ };
161
+ const root = encodeValue(data);
162
+ for (let head = 0; head < queue.length; head += 1) {
163
+ const entry = queue[head];
164
+ if (entry === void 0) break;
165
+ table[entry.slot] = encodeEntry(entry.value);
166
+ }
167
+ return escapeForScript(JSON.stringify({
168
+ r: root,
169
+ t: table
170
+ }));
171
+ }
172
+ /** Reads an own property of a parsed JSON object; never reaches the prototype chain. */
173
+ function own(record, key) {
174
+ return Object.hasOwn(record, key) ? Reflect.get(record, key) : void 0;
175
+ }
176
+ /** True for a non-null, non-array object. */
177
+ function isRecord(value) {
178
+ return typeof value === "object" && value !== null && !Array.isArray(value);
179
+ }
180
+ /** Throws the TypeError for a payload that is not in the wire format. */
181
+ function malformed(detail) {
182
+ return /* @__PURE__ */ new TypeError(`deserialize(): ${detail}`);
183
+ }
184
+ /** Decodes a value that cannot refer to other entries (used while the table is created). */
185
+ function decodeScalar(value) {
186
+ if (value === null || typeof value === "boolean" || typeof value === "string" || typeof value === "number") return value;
187
+ if (!isRecord(value)) throw malformed("unexpected value.");
188
+ const tag = own(value, "$");
189
+ if (tag === "u") return void 0;
190
+ if (tag === "num") {
191
+ const text = own(value, "v");
192
+ if (text === "NaN") return NaN;
193
+ if (text === "Infinity") return Number.POSITIVE_INFINITY;
194
+ if (text === "-Infinity") return Number.NEGATIVE_INFINITY;
195
+ if (text === "-0") return -0;
196
+ throw malformed("unknown number.");
197
+ }
198
+ if (tag === "big") {
199
+ const text = own(value, "v");
200
+ if (typeof text !== "string") throw malformed("bigint without digits.");
201
+ return BigInt(text);
202
+ }
203
+ throw malformed("unknown tag.");
204
+ }
205
+ /**
206
+ * Rebuilds a value from the table. Plain objects get a null prototype; their keys are defined as
207
+ * own data properties, so no key can reach or replace a prototype.
208
+ */
209
+ function decodeValue(value, table) {
210
+ if (isRecord(value) && own(value, "$") === "ref") {
211
+ const slot = own(value, "i");
212
+ if (typeof slot !== "number" || !Number.isInteger(slot) || slot < 0 || slot >= table.length) throw malformed("reference outside the table.");
213
+ return table[slot];
214
+ }
215
+ return decodeScalar(value);
216
+ }
217
+ /** Defines an own data property; never assigns, so no setter or prototype is involved. */
218
+ function defineOwn(target, key, value) {
219
+ Object.defineProperty(target, key, {
220
+ value,
221
+ enumerable: true,
222
+ writable: true,
223
+ configurable: true
224
+ });
225
+ }
226
+ /** Creates an empty container for a table entry, or the value of a scalar entry. */
227
+ function createEntry(entry) {
228
+ if (!isRecord(entry)) throw malformed("table entry is not an object.");
229
+ const tag = own(entry, "$");
230
+ if (tag === "obj") return Object.create(null);
231
+ if (tag === "arr") return [];
232
+ if (tag === "map") return /* @__PURE__ */ new Map();
233
+ if (tag === "set") return /* @__PURE__ */ new Set();
234
+ if (tag === "date") {
235
+ const time = decodeScalar(own(entry, "v"));
236
+ if (typeof time !== "number") throw malformed("date without a time.");
237
+ return new Date(time);
238
+ }
239
+ if (tag === "buf" || tag === "bin") {
240
+ const text = own(entry, "v");
241
+ if (typeof text !== "string") throw malformed("binary entry without data.");
242
+ const bytes = fromBase64(text);
243
+ const buffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
244
+ if (tag === "buf") return buffer;
245
+ const kind = own(entry, "k");
246
+ const ctor = typeof kind === "string" ? BINARY_KINDS.get(kind) : void 0;
247
+ if (ctor === void 0) throw malformed("unknown binary kind.");
248
+ try {
249
+ return new ctor(buffer);
250
+ } catch {
251
+ throw malformed("binary data does not fit its type.");
252
+ }
253
+ }
254
+ if (tag === "url") {
255
+ const href = own(entry, "v");
256
+ if (typeof href !== "string") throw malformed("url without an href.");
257
+ return new URL(href);
258
+ }
259
+ throw malformed("unknown table entry.");
260
+ }
261
+ /** Fills one container from its entry list. Date and URL entries are already complete. */
262
+ function fillEntry(entry, target, table) {
263
+ const tag = own(entry, "$");
264
+ if (tag === "date" || tag === "url" || tag === "buf" || tag === "bin") return;
265
+ const items = own(entry, "e");
266
+ if (!Array.isArray(items)) throw malformed("entry without a list.");
267
+ if (tag === "obj" && target !== null && typeof target === "object") for (const pair of items) {
268
+ if (!Array.isArray(pair) || pair.length !== 2 || typeof pair[0] !== "string") throw malformed("object entry is not a key and value.");
269
+ defineOwn(target, pair[0], decodeValue(pair[1], table));
270
+ }
271
+ else if (tag === "arr" && Array.isArray(target)) for (const item of items) target.push(decodeValue(item, table));
272
+ else if (tag === "map" && target instanceof Map) for (const pair of items) {
273
+ if (!Array.isArray(pair) || pair.length !== 2) throw malformed("map entry is not a pair.");
274
+ target.set(decodeValue(pair[0], table), decodeValue(pair[1], table));
275
+ }
276
+ else if (tag === "set" && target instanceof Set) for (const item of items) target.add(decodeValue(item, table));
277
+ else throw malformed("entry does not match its tag.");
278
+ }
279
+ /**
280
+ * Rebuilds the value {@link serialize} wrote, with its shared references and cycles. Plain objects
281
+ * come back with a null prototype (so a `__proto__` key is ordinary data), and malformed input throws
282
+ * instead of producing a partial value. No code is evaluated.
283
+ *
284
+ * @param text JSON text produced by {@link serialize}.
285
+ * @returns The rebuilt value.
286
+ * @throws SyntaxError when `text` is not JSON; TypeError when the JSON is not in the format
287
+ * `serialize` writes.
288
+ * @example
289
+ * import { deserialize, serialize } from "@shadow-js/web/server";
290
+ *
291
+ * const copy = deserialize(serialize({ tags: new Set(["a"]), total: 10n })) as {
292
+ * tags: Set<string>;
293
+ * total: bigint;
294
+ * };
295
+ * copy.tags.has("a"); // true
296
+ * @see serialize
297
+ * @since 1.0.0
298
+ */
299
+ function deserialize(text) {
300
+ const payload = JSON.parse(text);
301
+ if (!isRecord(payload)) throw malformed("payload is not an object.");
302
+ const table = own(payload, "t");
303
+ if (!Array.isArray(table)) throw malformed("payload has no table.");
304
+ const made = [];
305
+ for (const entry of table) made.push(createEntry(entry));
306
+ for (let slot = 0; slot < table.length; slot += 1) {
307
+ const entry = table[slot];
308
+ if (isRecord(entry)) fillEntry(entry, made[slot], made);
309
+ }
310
+ return decodeValue(own(payload, "r"), made);
311
+ }
312
+ export { deserialize, serialize };
313
+
314
+ //# sourceMappingURL=serialize.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serialize.js","names":[],"sources":["../../../src/server/serialize.ts"],"sourcesContent":["import { invalid } from \"./errors\";\n\n/*\n * Wire format: {\"r\": <value>, \"t\": [<entry>, ...]}. Containers (objects, arrays, Map, Set, Date,\n * URL) live in the table and refer to each other by index, so cycles and shared references keep\n * their identity and the walk needs no recursion. A value is a JSON primitive, or a tagged object:\n * {\"$\":\"u\"} undefined\n * {\"$\":\"num\",\"v\":\"NaN\"|\"Infinity\"|\"-Infinity\"|\"-0\"}\n * {\"$\":\"big\",\"v\":\"<decimal>\"} bigint\n * {\"$\":\"ref\",\"i\":<index>} a table entry\n * Table entries are {\"$\":\"obj\",\"e\":[[key,value],...]}, {\"$\":\"arr\",\"e\":[...]},\n * {\"$\":\"map\",\"e\":[[key,value],...]}, {\"$\":\"set\",\"e\":[...]}, {\"$\":\"date\",\"v\":<number>},\n * {\"$\":\"url\",\"v\":\"<href>\"}. Plain objects are read with own properties only and rebuilt with a\n * null prototype, so \"__proto__\" or \"constructor\" keys are ordinary data.\n */\n\n/** Characters that may not appear raw in the output: they would end a script element or a line. */\nconst UNSAFE_TEXT = /[<>&\\u2028\\u2029]/g;\n\n/** Escapes text for `<script type=\"application/json\">`: the JSON stays valid, the markup cannot close. */\nfunction escapeForScript(json: string): string {\n return json.replace(\n UNSAFE_TEXT,\n (char) => `\\\\u${char.charCodeAt(0).toString(16).padStart(4, \"0\")}`,\n );\n}\n\n/** Encodes a number that JSON cannot carry exactly. */\nfunction encodeNumber(value: number): unknown {\n if (Number.isFinite(value) && !Object.is(value, -0)) return value;\n return { $: \"num\", v: Object.is(value, -0) ? \"-0\" : String(value) };\n}\n\n/** Binary types the wire format carries, by the name written on the wire. */\ntype BinaryConstructor = new (buffer: ArrayBuffer) => ArrayBufferView;\nconst BINARY_KINDS: ReadonlyMap<string, BinaryConstructor> = new Map<string, BinaryConstructor>([\n [\"Int8Array\", Int8Array],\n [\"Uint8Array\", Uint8Array],\n [\"Uint8ClampedArray\", Uint8ClampedArray],\n [\"Int16Array\", Int16Array],\n [\"Uint16Array\", Uint16Array],\n [\"Int32Array\", Int32Array],\n [\"Uint32Array\", Uint32Array],\n [\"Float32Array\", Float32Array],\n [\"Float64Array\", Float64Array],\n [\"BigInt64Array\", BigInt64Array],\n [\"BigUint64Array\", BigUint64Array],\n [\"DataView\", DataView],\n]);\n\n/** Base64 of `bytes`, converted in chunks so a large buffer cannot overflow the call stack. */\nfunction toBase64(bytes: Uint8Array): string {\n let binary = \"\";\n for (let offset = 0; offset < bytes.length; offset += 0x8000) {\n binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));\n }\n return btoa(binary);\n}\n\n/** Bytes of a base64 text; malformed text throws a TypeError. */\nfunction fromBase64(text: string): Uint8Array {\n let binary: string;\n try {\n binary = atob(text);\n } catch {\n throw malformed(\"binary data is not valid base64.\");\n }\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);\n return bytes;\n}\n\n/** The wire name of a typed array or DataView, or undefined for anything else. */\nfunction binaryKindOf(value: object): string | undefined {\n for (const [name, ctor] of BINARY_KINDS) {\n if (value instanceof ctor) return name;\n }\n return undefined;\n}\n\n/** True for plain objects: prototype is Object.prototype or none. */\nfunction isPlainObject(value: object): boolean {\n const proto: unknown = Object.getPrototypeOf(value);\n return proto === Object.prototype || proto === null;\n}\n\n/**\n * Serializes data for embedding in a page, as JSON that is safe inside a\n * `<script type=\"application/json\">` element. It carries what JSON cannot: undefined, NaN,\n * infinities, -0, bigint, Date, URL, Map, Set, ArrayBuffer, typed arrays and DataView (copied: views\n * that shared a buffer come back as independent copies), plus shared references and cycles between\n * plain objects and arrays. Read it back with {@link deserialize}.\n *\n * @param data The value to serialize.\n * @returns JSON text with `<`, `>`, `&`, U+2028 and U+2029 written as `\\u` escapes, so it cannot\n * close the script element.\n * @throws TypeError `UNSERIALIZABLE_VALUE` for a function, a symbol, or an object that is not one of\n * the supported kinds (a class instance, for example).\n * @example\n * import { serialize } from \"@shadow-js/web/server\";\n *\n * const data = { user: { name: \"Ada\" }, seen: new Set([1, 2]), at: new Date(0) };\n * const tag = `<script type=\"application/json\" id=\"data\">${serialize(data)}</script>`;\n * @see deserialize\n * @since 1.0.0\n */\nexport function serialize(data: unknown): string {\n const table: unknown[] = [];\n const index = new Map<object, number>();\n const queue: Array<{ readonly value: object; readonly slot: number }> = [];\n\n const slotOf = (value: object): number => {\n const existing = index.get(value);\n if (existing !== undefined) return existing;\n const slot = table.length;\n table.push(null);\n index.set(value, slot);\n queue.push({ value, slot });\n return slot;\n };\n\n const encodeValue = (value: unknown): unknown => {\n if (value === undefined) return { $: \"u\" };\n if (value === null || typeof value === \"boolean\" || typeof value === \"string\") return value;\n if (typeof value === \"number\") return encodeNumber(value);\n if (typeof value === \"bigint\") return { $: \"big\", v: value.toString() };\n if (typeof value === \"object\") return { $: \"ref\", i: slotOf(value) };\n throw invalid(\"UNSERIALIZABLE_VALUE\", `A ${typeof value} cannot be serialized.`);\n };\n\n const encodeEntry = (value: object): unknown => {\n if (value instanceof Date) return { $: \"date\", v: encodeValue(value.getTime()) };\n if (value instanceof ArrayBuffer) return { $: \"buf\", v: toBase64(new Uint8Array(value)) };\n if (ArrayBuffer.isView(value)) {\n const kind = binaryKindOf(value);\n if (kind !== undefined) {\n const bytes = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n return { $: \"bin\", k: kind, v: toBase64(bytes) };\n }\n }\n if (value instanceof URL) return { $: \"url\", v: value.href };\n if (value instanceof Map) {\n const pairs: unknown[] = [];\n for (const [key, item] of value) pairs.push([encodeValue(key), encodeValue(item)]);\n return { $: \"map\", e: pairs };\n }\n if (value instanceof Set) {\n const items: unknown[] = [];\n for (const item of value) items.push(encodeValue(item));\n return { $: \"set\", e: items };\n }\n if (Array.isArray(value)) {\n const items: unknown[] = [];\n // An index loop, so holes in a sparse array become undefined instead of being skipped.\n for (let i = 0; i < value.length; i += 1) items.push(encodeValue(value[i]));\n return { $: \"arr\", e: items };\n }\n if (!isPlainObject(value)) {\n throw invalid(\n \"UNSERIALIZABLE_VALUE\",\n \"Only plain objects, arrays, Map, Set, Date, URL, ArrayBuffer and typed arrays can be serialized.\",\n );\n }\n const pairs: unknown[] = [];\n for (const key of Object.keys(value)) pairs.push([key, encodeValue(Reflect.get(value, key))]);\n return { $: \"obj\", e: pairs };\n };\n\n const root = encodeValue(data);\n for (let head = 0; head < queue.length; head += 1) {\n const entry = queue[head];\n if (entry === undefined) break;\n table[entry.slot] = encodeEntry(entry.value);\n }\n return escapeForScript(JSON.stringify({ r: root, t: table }));\n}\n\n/** Reads an own property of a parsed JSON object; never reaches the prototype chain. */\nfunction own(record: object, key: string): unknown {\n return Object.hasOwn(record, key) ? Reflect.get(record, key) : undefined;\n}\n\n/** True for a non-null, non-array object. */\nfunction isRecord(value: unknown): value is object {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Throws the TypeError for a payload that is not in the wire format. */\nfunction malformed(detail: string): TypeError {\n return new TypeError(`deserialize(): ${detail}`);\n}\n\n/** Decodes a value that cannot refer to other entries (used while the table is created). */\nfunction decodeScalar(value: unknown): unknown {\n if (\n value === null ||\n typeof value === \"boolean\" ||\n typeof value === \"string\" ||\n typeof value === \"number\"\n ) {\n return value;\n }\n if (!isRecord(value)) throw malformed(\"unexpected value.\");\n const tag = own(value, \"$\");\n if (tag === \"u\") return undefined;\n if (tag === \"num\") {\n const text = own(value, \"v\");\n if (text === \"NaN\") return Number.NaN;\n if (text === \"Infinity\") return Number.POSITIVE_INFINITY;\n if (text === \"-Infinity\") return Number.NEGATIVE_INFINITY;\n if (text === \"-0\") return -0;\n throw malformed(\"unknown number.\");\n }\n if (tag === \"big\") {\n const text = own(value, \"v\");\n if (typeof text !== \"string\") throw malformed(\"bigint without digits.\");\n return BigInt(text);\n }\n throw malformed(\"unknown tag.\");\n}\n\n/**\n * Rebuilds a value from the table. Plain objects get a null prototype; their keys are defined as\n * own data properties, so no key can reach or replace a prototype.\n */\nfunction decodeValue(value: unknown, table: readonly unknown[]): unknown {\n if (isRecord(value) && own(value, \"$\") === \"ref\") {\n const slot = own(value, \"i\");\n if (typeof slot !== \"number\" || !Number.isInteger(slot) || slot < 0 || slot >= table.length) {\n throw malformed(\"reference outside the table.\");\n }\n return table[slot];\n }\n return decodeScalar(value);\n}\n\n/** Defines an own data property; never assigns, so no setter or prototype is involved. */\nfunction defineOwn(target: object, key: string, value: unknown): void {\n Object.defineProperty(target, key, {\n value,\n enumerable: true,\n writable: true,\n configurable: true,\n });\n}\n\n/** Creates an empty container for a table entry, or the value of a scalar entry. */\nfunction createEntry(entry: unknown): unknown {\n if (!isRecord(entry)) throw malformed(\"table entry is not an object.\");\n const tag = own(entry, \"$\");\n if (tag === \"obj\") return Object.create(null) as object;\n if (tag === \"arr\") return [];\n if (tag === \"map\") return new Map<unknown, unknown>();\n if (tag === \"set\") return new Set<unknown>();\n if (tag === \"date\") {\n const time = decodeScalar(own(entry, \"v\"));\n if (typeof time !== \"number\") throw malformed(\"date without a time.\");\n return new Date(time);\n }\n if (tag === \"buf\" || tag === \"bin\") {\n const text = own(entry, \"v\");\n if (typeof text !== \"string\") throw malformed(\"binary entry without data.\");\n const bytes = fromBase64(text);\n // A copy that owns exactly these bytes, so a view never exposes a larger buffer.\n const buffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);\n if (tag === \"buf\") return buffer;\n const kind = own(entry, \"k\");\n const ctor = typeof kind === \"string\" ? BINARY_KINDS.get(kind) : undefined;\n if (ctor === undefined) throw malformed(\"unknown binary kind.\");\n try {\n return new ctor(buffer as ArrayBuffer);\n } catch {\n throw malformed(\"binary data does not fit its type.\");\n }\n }\n if (tag === \"url\") {\n const href = own(entry, \"v\");\n if (typeof href !== \"string\") throw malformed(\"url without an href.\");\n return new URL(href);\n }\n throw malformed(\"unknown table entry.\");\n}\n\n/** Fills one container from its entry list. Date and URL entries are already complete. */\nfunction fillEntry(entry: object, target: unknown, table: readonly unknown[]): void {\n const tag = own(entry, \"$\");\n if (tag === \"date\" || tag === \"url\" || tag === \"buf\" || tag === \"bin\") return;\n const items = own(entry, \"e\");\n if (!Array.isArray(items)) throw malformed(\"entry without a list.\");\n if (tag === \"obj\" && target !== null && typeof target === \"object\") {\n for (const pair of items) {\n if (!Array.isArray(pair) || pair.length !== 2 || typeof pair[0] !== \"string\") {\n throw malformed(\"object entry is not a key and value.\");\n }\n defineOwn(target, pair[0], decodeValue(pair[1], table));\n }\n } else if (tag === \"arr\" && Array.isArray(target)) {\n for (const item of items) target.push(decodeValue(item, table));\n } else if (tag === \"map\" && target instanceof Map) {\n for (const pair of items) {\n if (!Array.isArray(pair) || pair.length !== 2) throw malformed(\"map entry is not a pair.\");\n target.set(decodeValue(pair[0], table), decodeValue(pair[1], table));\n }\n } else if (tag === \"set\" && target instanceof Set) {\n for (const item of items) target.add(decodeValue(item, table));\n } else {\n throw malformed(\"entry does not match its tag.\");\n }\n}\n\n/**\n * Rebuilds the value {@link serialize} wrote, with its shared references and cycles. Plain objects\n * come back with a null prototype (so a `__proto__` key is ordinary data), and malformed input throws\n * instead of producing a partial value. No code is evaluated.\n *\n * @param text JSON text produced by {@link serialize}.\n * @returns The rebuilt value.\n * @throws SyntaxError when `text` is not JSON; TypeError when the JSON is not in the format\n * `serialize` writes.\n * @example\n * import { deserialize, serialize } from \"@shadow-js/web/server\";\n *\n * const copy = deserialize(serialize({ tags: new Set([\"a\"]), total: 10n })) as {\n * tags: Set<string>;\n * total: bigint;\n * };\n * copy.tags.has(\"a\"); // true\n * @see serialize\n * @since 1.0.0\n */\nexport function deserialize(text: string): unknown {\n const payload: unknown = JSON.parse(text);\n if (!isRecord(payload)) throw malformed(\"payload is not an object.\");\n const table = own(payload, \"t\");\n if (!Array.isArray(table)) throw malformed(\"payload has no table.\");\n const made: unknown[] = [];\n for (const entry of table) made.push(createEntry(entry));\n for (let slot = 0; slot < table.length; slot += 1) {\n const entry = table[slot];\n if (isRecord(entry)) fillEntry(entry, made[slot], made);\n }\n return decodeValue(own(payload, \"r\"), made);\n}\n"],"mappings":"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"}
@@ -0,0 +1,92 @@
1
+ import { ServerHead } from "../head/server-head.js";
2
+ import { ServerPortals } from "./portals.js";
3
+ /**
4
+ * Options of {@link renderToStream}.
5
+ * @since 1.0.0
6
+ */
7
+ export interface StreamOptions {
8
+ /**
9
+ * Prefix of every hydration key: letters, digits, `_` and `-` only. Pass the same id to `hydrate()`.
10
+ * @default "0"
11
+ */
12
+ readonly renderId?: string;
13
+ /**
14
+ * CSP nonce for the inline swap scripts. Characters outside letters, digits, `+`, `/`, `=`, `_` and
15
+ * `-` are removed before it is written.
16
+ * @default undefined (the scripts get no nonce attribute)
17
+ */
18
+ readonly nonce?: string;
19
+ /**
20
+ * Upper bound for the whole stream, in milliseconds, a positive finite number. When it runs out, the stream errors with an
21
+ * `SsrError` whose `code` is `SSR_TIMEOUT`.
22
+ * @default 30000
23
+ */
24
+ readonly timeoutMs?: number;
25
+ /**
26
+ * Aborts the render: the stream errors with the signal's reason and every pending fetch is abandoned.
27
+ * @default undefined (the render is bounded only by `timeoutMs`)
28
+ */
29
+ readonly signal?: AbortSignal;
30
+ /**
31
+ * Collects the tags `useHead`, `<Title>`, ... register while the shell renders (see
32
+ * `createServerHead`).
33
+ * @default undefined (head tags are not collected)
34
+ */
35
+ readonly head?: ServerHead;
36
+ /**
37
+ * Called with the shell markup as soon as it is ready, before it is enqueued: the moment to write
38
+ * the document head and choose the response status.
39
+ * @default undefined (no callback)
40
+ */
41
+ readonly onShellReady?: (shell: string) => void;
42
+ /**
43
+ * Collects the markup of the portals the stream produces (see {@link createServerPortals}). The stream
44
+ * does not write it: once the stream has ended, emit `portals.html()` at the end of `<body>`.
45
+ * @default undefined (a portal renders nothing on the server)
46
+ */
47
+ readonly portals?: ServerPortals;
48
+ /**
49
+ * Receives an error an `ErrorBoundary` of the stream caught, once per caught error. An error in the shell
50
+ * happens before the first chunk, so the caller can still choose the response status; an error in a later
51
+ * boundary happens after the shell and changes only that boundary (its fallback stays).
52
+ * @default undefined (caught errors are not reported)
53
+ */
54
+ readonly onCaughtError?: (error: unknown) => void;
55
+ /**
56
+ * Receives an error no boundary took. With it the stream does not error on that error and the markup lacks
57
+ * the part that failed.
58
+ * @default undefined (the error ends the stream in its `error` state)
59
+ */
60
+ readonly onUncaughtError?: (error: unknown) => void;
61
+ }
62
+ /**
63
+ * Renders an app as a stream of HTML, for the fastest first byte: the shell first (pending Suspense
64
+ * boundaries show their fallback), then one chunk per boundary as its data arrives, in the order the
65
+ * data settles, and finally, when resources resolved, a
66
+ * `<script type="application/json" data-sh="RENDER_ID">` block with their values. The page works without JavaScript: each chunk is a `<template>` that a
67
+ * tiny inline script swaps in for the fallback. A boundary whose data can no longer arrive keeps its
68
+ * fallback for the client.
69
+ *
70
+ * @param code Builds the app.
71
+ * @param options Hydration-key prefix, nonce, time budget, abort signal, collectors, shell callback
72
+ * and error reporters. Undefined uses the defaults of {@link StreamOptions}.
73
+ * @returns A byte stream of the app markup, to be placed inside your document. Canceling it stops
74
+ * the render.
75
+ * @throws TypeError, synchronously, for an invalid `renderId` or `timeoutMs`. The stream itself errors with an
76
+ * `SsrError` whose `code` is `SSR_TIMEOUT` when `timeoutMs` runs out, with the signal's reason when
77
+ * `signal` aborts, and with an error no boundary caught when `onUncaughtError` is not set.
78
+ * @example
79
+ * import { createComponent, renderToStream } from "@shadow-js/web/server";
80
+ *
81
+ * function App() {
82
+ * return <h1>Hello</h1>;
83
+ * }
84
+ * function handle(request: Request): Response {
85
+ * const stream = renderToStream(() => createComponent(App, {}), { signal: request.signal });
86
+ * return new Response(stream, { headers: { "content-type": "text/html" } });
87
+ * }
88
+ * @see renderToStringAsync
89
+ * @since 1.0.0
90
+ */
91
+ export declare function renderToStream(code: () => unknown, options?: StreamOptions): ReadableStream<Uint8Array>;
92
+ //# sourceMappingURL=stream.d.ts.map