@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,145 @@
1
+ //#region src/resource-hints.d.ts
2
+ /**
3
+ * Options of {@link preconnect}, {@link preloadModule} and {@link preinitModule}.
4
+ * @since 1.0.0
5
+ */
6
+ export interface CrossOriginOptions {
7
+ /**
8
+ * CORS mode of the connection or request: `"anonymous"` sends no credentials, `"use-credentials"`
9
+ * sends cookies and client certificates. Fonts and `fetch` preloads need one of them.
10
+ * @default undefined (no `crossorigin` attribute; the browser's default for the resource applies)
11
+ */
12
+ readonly crossOrigin?: "anonymous" | "use-credentials";
13
+ }
14
+ /**
15
+ * Options of {@link preload}: the destination is required, as the browser needs it to pick the
16
+ * right request.
17
+ * @since 1.0.0
18
+ */
19
+ export interface PreloadOptions extends CrossOriginOptions {
20
+ /**
21
+ * The destination of the request, which the browser uses to pick its priority and headers. It
22
+ * must match how the resource is used later, or the preloaded copy is not reused.
23
+ */
24
+ readonly as: "audio" | "document" | "embed" | "fetch" | "font" | "image" | "object" | "script" | "style" | "track" | "video" | "worker";
25
+ /**
26
+ * MIME type, so the browser can skip unsupported formats (for example `font/woff2`).
27
+ * @default undefined (no `type` attribute)
28
+ */
29
+ readonly type?: string;
30
+ /**
31
+ * Media query the hint applies to (for example `(min-width: 800px)`); the browser skips the
32
+ * preload when it does not match.
33
+ * @default undefined (no `media` attribute; the hint always applies)
34
+ */
35
+ readonly media?: string;
36
+ }
37
+ /**
38
+ * Options of {@link preinit}.
39
+ * @since 1.0.0
40
+ */
41
+ export interface PreinitOptions extends CrossOriginOptions {
42
+ /**
43
+ * What to load: `"style"` inserts a stylesheet, `"script"` inserts an async script. Required, as
44
+ * the two produce different elements.
45
+ */
46
+ readonly as: "style" | "script";
47
+ }
48
+ /**
49
+ * Tells the browser to open a connection (DNS, TCP, TLS) to an origin the page will use soon.
50
+ * React's `preconnect`. Calling it again for the same origin adds nothing. Works in a component, in
51
+ * an event handler, or at module scope on the client.
52
+ *
53
+ * @param href An http(s) origin or URL.
54
+ * @param options CORS mode (needed for fonts and fetch with credentials). Undefined adds no
55
+ * `crossorigin` attribute.
56
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or
57
+ * relative.
58
+ * @example
59
+ * import { preconnect } from "@shadow-js/web";
60
+ *
61
+ * preconnect("https://fonts.example.com", { crossOrigin: "anonymous" });
62
+ * @see prefetchDNS
63
+ * @see preload
64
+ * @since 1.0.0
65
+ */
66
+ export declare function preconnect(href: string, options?: CrossOriginOptions): void;
67
+ /**
68
+ * Resolves an origin's DNS ahead of use. Cheaper than {@link preconnect}; React's `prefetchDNS`.
69
+ * @param href An http(s) origin or URL.
70
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
71
+ * @example
72
+ * import { prefetchDNS } from "@shadow-js/web";
73
+ *
74
+ * prefetchDNS("https://api.example.com");
75
+ * @see preconnect
76
+ * @since 1.0.0
77
+ */
78
+ export declare function prefetchDNS(href: string): void;
79
+ /**
80
+ * Starts fetching a resource the page will need, at high priority. The browser stores it for the
81
+ * later request with the same URL and destination (React's `preload`).
82
+ *
83
+ * @param href An http(s) or relative URL.
84
+ * @param options The destination (`as`, required) and the optional type, media and CORS mode.
85
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
86
+ * @example
87
+ * import { preload } from "@shadow-js/web";
88
+ *
89
+ * preload("/fonts/inter.woff2", { as: "font", type: "font/woff2", crossOrigin: "anonymous" });
90
+ * @see preloadModule
91
+ * @see preinit
92
+ * @since 1.0.0
93
+ */
94
+ export declare function preload(href: string, options: PreloadOptions): void;
95
+ /**
96
+ * Starts loading an ES module the page will import, so the import does not wait for the module
97
+ * graph to be discovered. React's `preloadModule`.
98
+ * @param href An http(s) or relative URL of the module.
99
+ * @param options CORS mode. Undefined adds no `crossorigin` attribute.
100
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
101
+ * @example
102
+ * import { preloadModule } from "@shadow-js/web";
103
+ *
104
+ * preloadModule("/chunks/editor.js");
105
+ * @see preinitModule
106
+ * @see preload
107
+ * @since 1.0.0
108
+ */
109
+ export declare function preloadModule(href: string, options?: CrossOriginOptions): void;
110
+ /**
111
+ * Loads a stylesheet or script now, and keeps it applied or executed (React's `preinit`). A
112
+ * stylesheet becomes a `<link rel="stylesheet">`; a script becomes an async `<script>` in the head.
113
+ * On the server a script can only be hinted as a preload, because head tags cannot be scripts.
114
+ *
115
+ * @param href An http(s) or relative URL.
116
+ * @param options What to load (`style` or `script`, required) and the CORS mode.
117
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
118
+ * @example
119
+ * import { preinit } from "@shadow-js/web";
120
+ *
121
+ * preinit("/theme.css", { as: "style" });
122
+ * @see preload
123
+ * @see preinitModule
124
+ * @since 1.0.0
125
+ */
126
+ export declare function preinit(href: string, options: PreinitOptions): void;
127
+ /**
128
+ * Loads and runs an ES module now (React's `preinitModule`). On the client it inserts a
129
+ * `<script type="module">`; on the server it hints the module with `modulepreload`, since the
130
+ * script itself is loaded by the page.
131
+ *
132
+ * @param href An http(s) or relative URL of the module.
133
+ * @param options CORS mode. Undefined adds no `crossorigin` attribute.
134
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
135
+ * @example
136
+ * import { preinitModule } from "@shadow-js/web";
137
+ *
138
+ * preinitModule("/chunks/app.js");
139
+ * @see preloadModule
140
+ * @see preinit
141
+ * @since 1.0.0
142
+ */
143
+ export declare function preinitModule(href: string, options?: CrossOriginOptions): void;
144
+ //#endregion
145
+ //# sourceMappingURL=resource-hints.d.ts.map
@@ -0,0 +1,200 @@
1
+ import { useHead } from "./head/use-head.js";
2
+ import { isServer } from "@shadow-js/core";
3
+ //#region src/resource-hints.ts
4
+ /** Hints are page-level and only ever use http(s) URLs; anything else throws, like head tags do. */
5
+ function checkUrl(href) {
6
+ const url = new URL(href, "https://base.invalid");
7
+ if (url.protocol !== "https:" && url.protocol !== "http:") throw new TypeError(`resource hint: "${href}" must be an http(s) or relative URL`);
8
+ }
9
+ /** Whether an element already carries every attribute of a hint (so the hint is already there). */
10
+ function carries(element, attributes) {
11
+ for (const [name, value] of Object.entries(attributes)) if (element.getAttribute(name) !== value) return false;
12
+ return true;
13
+ }
14
+ /**
15
+ * Inserts a hint element once: an identical element already in the head (server-rendered or added
16
+ * earlier) is kept. On the server the hint joins the render's head collector, when there is one.
17
+ */
18
+ function hint(tag, attributes, serverTag = () => void 0) {
19
+ if (isServer) {
20
+ serverTag();
21
+ return;
22
+ }
23
+ if (typeof document === "undefined") return;
24
+ for (const existing of document.head.querySelectorAll(tag)) if (carries(existing, attributes)) return;
25
+ const element = document.createElement(tag);
26
+ for (const [name, value] of Object.entries(attributes)) element.setAttribute(name, value);
27
+ document.head.append(element);
28
+ }
29
+ /** Server form of a hint: a head link (scripts cannot be head tags, see {@link preinitModule}). */
30
+ function serverLink(attributes) {
31
+ return () => useHead({
32
+ tag: "link",
33
+ props: attributes
34
+ });
35
+ }
36
+ /**
37
+ * Tells the browser to open a connection (DNS, TCP, TLS) to an origin the page will use soon.
38
+ * React's `preconnect`. Calling it again for the same origin adds nothing. Works in a component, in
39
+ * an event handler, or at module scope on the client.
40
+ *
41
+ * @param href An http(s) origin or URL.
42
+ * @param options CORS mode (needed for fonts and fetch with credentials). Undefined adds no
43
+ * `crossorigin` attribute.
44
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or
45
+ * relative.
46
+ * @example
47
+ * import { preconnect } from "@shadow-js/web";
48
+ *
49
+ * preconnect("https://fonts.example.com", { crossOrigin: "anonymous" });
50
+ * @see prefetchDNS
51
+ * @see preload
52
+ * @since 1.0.0
53
+ */
54
+ function preconnect(href, options) {
55
+ checkUrl(href);
56
+ const attributes = {
57
+ rel: "preconnect",
58
+ href,
59
+ ...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
60
+ };
61
+ hint("link", attributes, serverLink(attributes));
62
+ }
63
+ /**
64
+ * Resolves an origin's DNS ahead of use. Cheaper than {@link preconnect}; React's `prefetchDNS`.
65
+ * @param href An http(s) origin or URL.
66
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
67
+ * @example
68
+ * import { prefetchDNS } from "@shadow-js/web";
69
+ *
70
+ * prefetchDNS("https://api.example.com");
71
+ * @see preconnect
72
+ * @since 1.0.0
73
+ */
74
+ function prefetchDNS(href) {
75
+ checkUrl(href);
76
+ const attributes = {
77
+ rel: "dns-prefetch",
78
+ href
79
+ };
80
+ hint("link", attributes, serverLink(attributes));
81
+ }
82
+ /**
83
+ * Starts fetching a resource the page will need, at high priority. The browser stores it for the
84
+ * later request with the same URL and destination (React's `preload`).
85
+ *
86
+ * @param href An http(s) or relative URL.
87
+ * @param options The destination (`as`, required) and the optional type, media and CORS mode.
88
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
89
+ * @example
90
+ * import { preload } from "@shadow-js/web";
91
+ *
92
+ * preload("/fonts/inter.woff2", { as: "font", type: "font/woff2", crossOrigin: "anonymous" });
93
+ * @see preloadModule
94
+ * @see preinit
95
+ * @since 1.0.0
96
+ */
97
+ function preload(href, options) {
98
+ checkUrl(href);
99
+ const attributes = {
100
+ rel: "preload",
101
+ href,
102
+ as: options.as,
103
+ ...options.type === void 0 ? {} : { type: options.type },
104
+ ...options.media === void 0 ? {} : { media: options.media },
105
+ ...options.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
106
+ };
107
+ hint("link", attributes, serverLink(attributes));
108
+ }
109
+ /**
110
+ * Starts loading an ES module the page will import, so the import does not wait for the module
111
+ * graph to be discovered. React's `preloadModule`.
112
+ * @param href An http(s) or relative URL of the module.
113
+ * @param options CORS mode. Undefined adds no `crossorigin` attribute.
114
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
115
+ * @example
116
+ * import { preloadModule } from "@shadow-js/web";
117
+ *
118
+ * preloadModule("/chunks/editor.js");
119
+ * @see preinitModule
120
+ * @see preload
121
+ * @since 1.0.0
122
+ */
123
+ function preloadModule(href, options) {
124
+ checkUrl(href);
125
+ const attributes = {
126
+ rel: "modulepreload",
127
+ href,
128
+ ...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
129
+ };
130
+ hint("link", attributes, serverLink(attributes));
131
+ }
132
+ /**
133
+ * Loads a stylesheet or script now, and keeps it applied or executed (React's `preinit`). A
134
+ * stylesheet becomes a `<link rel="stylesheet">`; a script becomes an async `<script>` in the head.
135
+ * On the server a script can only be hinted as a preload, because head tags cannot be scripts.
136
+ *
137
+ * @param href An http(s) or relative URL.
138
+ * @param options What to load (`style` or `script`, required) and the CORS mode.
139
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
140
+ * @example
141
+ * import { preinit } from "@shadow-js/web";
142
+ *
143
+ * preinit("/theme.css", { as: "style" });
144
+ * @see preload
145
+ * @see preinitModule
146
+ * @since 1.0.0
147
+ */
148
+ function preinit(href, options) {
149
+ checkUrl(href);
150
+ if (options.as === "style") {
151
+ const attributes = {
152
+ rel: "stylesheet",
153
+ href,
154
+ ...options.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
155
+ };
156
+ hint("link", attributes, serverLink(attributes));
157
+ return;
158
+ }
159
+ hint("script", {
160
+ src: href,
161
+ async: "",
162
+ ...options.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
163
+ }, serverLink({
164
+ rel: "preload",
165
+ href,
166
+ as: "script"
167
+ }));
168
+ }
169
+ /**
170
+ * Loads and runs an ES module now (React's `preinitModule`). On the client it inserts a
171
+ * `<script type="module">`; on the server it hints the module with `modulepreload`, since the
172
+ * script itself is loaded by the page.
173
+ *
174
+ * @param href An http(s) or relative URL of the module.
175
+ * @param options CORS mode. Undefined adds no `crossorigin` attribute.
176
+ * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
177
+ * @example
178
+ * import { preinitModule } from "@shadow-js/web";
179
+ *
180
+ * preinitModule("/chunks/app.js");
181
+ * @see preloadModule
182
+ * @see preinit
183
+ * @since 1.0.0
184
+ */
185
+ function preinitModule(href, options) {
186
+ checkUrl(href);
187
+ hint("script", {
188
+ src: href,
189
+ type: "module",
190
+ ...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
191
+ }, serverLink({
192
+ rel: "modulepreload",
193
+ href,
194
+ ...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
195
+ }));
196
+ }
197
+ //#endregion
198
+ export { preconnect, prefetchDNS, preinit, preinitModule, preload, preloadModule };
199
+
200
+ //# sourceMappingURL=resource-hints.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource-hints.js","names":[],"sources":["../../src/resource-hints.ts"],"sourcesContent":["import { isServer } from \"@shadow-js/core\";\nimport { useHead } from \"./head/use-head\";\nimport type { HeadAttributeValue } from \"./head/validate\";\n\n/**\n * Options of {@link preconnect}, {@link preloadModule} and {@link preinitModule}.\n * @since 1.0.0\n */\nexport interface CrossOriginOptions {\n /**\n * CORS mode of the connection or request: `\"anonymous\"` sends no credentials, `\"use-credentials\"`\n * sends cookies and client certificates. Fonts and `fetch` preloads need one of them.\n * @default undefined (no `crossorigin` attribute; the browser's default for the resource applies)\n */\n readonly crossOrigin?: \"anonymous\" | \"use-credentials\";\n}\n\n/**\n * Options of {@link preload}: the destination is required, as the browser needs it to pick the\n * right request.\n * @since 1.0.0\n */\nexport interface PreloadOptions extends CrossOriginOptions {\n /**\n * The destination of the request, which the browser uses to pick its priority and headers. It\n * must match how the resource is used later, or the preloaded copy is not reused.\n */\n readonly as:\n | \"audio\"\n | \"document\"\n | \"embed\"\n | \"fetch\"\n | \"font\"\n | \"image\"\n | \"object\"\n | \"script\"\n | \"style\"\n | \"track\"\n | \"video\"\n | \"worker\";\n /**\n * MIME type, so the browser can skip unsupported formats (for example `font/woff2`).\n * @default undefined (no `type` attribute)\n */\n readonly type?: string;\n /**\n * Media query the hint applies to (for example `(min-width: 800px)`); the browser skips the\n * preload when it does not match.\n * @default undefined (no `media` attribute; the hint always applies)\n */\n readonly media?: string;\n}\n\n/**\n * Options of {@link preinit}.\n * @since 1.0.0\n */\nexport interface PreinitOptions extends CrossOriginOptions {\n /**\n * What to load: `\"style\"` inserts a stylesheet, `\"script\"` inserts an async script. Required, as\n * the two produce different elements.\n */\n readonly as: \"style\" | \"script\";\n}\n\ntype Attributes = Readonly<Record<string, string>>;\n\n/** Hints are page-level and only ever use http(s) URLs; anything else throws, like head tags do. */\nfunction checkUrl(href: string): void {\n const url = new URL(href, \"https://base.invalid\");\n if (url.protocol !== \"https:\" && url.protocol !== \"http:\") {\n throw new TypeError(\n __DEV__\n ? `resource hint: \"${href}\" must be an http(s) or relative URL`\n : \"SHADOW_RESOURCE_HINT_URL\",\n );\n }\n}\n\n/** Whether an element already carries every attribute of a hint (so the hint is already there). */\nfunction carries(element: Element, attributes: Attributes): boolean {\n for (const [name, value] of Object.entries(attributes)) {\n if (element.getAttribute(name) !== value) return false;\n }\n return true;\n}\n\n/**\n * Inserts a hint element once: an identical element already in the head (server-rendered or added\n * earlier) is kept. On the server the hint joins the render's head collector, when there is one.\n */\nfunction hint(\n tag: \"link\" | \"script\",\n attributes: Attributes,\n serverTag: () => void = () => undefined,\n): void {\n if (isServer) {\n serverTag();\n return;\n }\n if (typeof document === \"undefined\") return;\n for (const existing of document.head.querySelectorAll(tag)) {\n if (carries(existing, attributes)) return;\n }\n const element = document.createElement(tag);\n for (const [name, value] of Object.entries(attributes)) element.setAttribute(name, value);\n document.head.append(element);\n}\n\n/** Server form of a hint: a head link (scripts cannot be head tags, see {@link preinitModule}). */\nfunction serverLink(attributes: Readonly<Record<string, HeadAttributeValue>>): () => void {\n return () => useHead({ tag: \"link\", props: attributes });\n}\n\n/**\n * Tells the browser to open a connection (DNS, TCP, TLS) to an origin the page will use soon.\n * React's `preconnect`. Calling it again for the same origin adds nothing. Works in a component, in\n * an event handler, or at module scope on the client.\n *\n * @param href An http(s) origin or URL.\n * @param options CORS mode (needed for fonts and fetch with credentials). Undefined adds no\n * `crossorigin` attribute.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or\n * relative.\n * @example\n * import { preconnect } from \"@shadow-js/web\";\n *\n * preconnect(\"https://fonts.example.com\", { crossOrigin: \"anonymous\" });\n * @see prefetchDNS\n * @see preload\n * @since 1.0.0\n */\nexport function preconnect(href: string, options?: CrossOriginOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n rel: \"preconnect\",\n href,\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Resolves an origin's DNS ahead of use. Cheaper than {@link preconnect}; React's `prefetchDNS`.\n * @param href An http(s) origin or URL.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { prefetchDNS } from \"@shadow-js/web\";\n *\n * prefetchDNS(\"https://api.example.com\");\n * @see preconnect\n * @since 1.0.0\n */\nexport function prefetchDNS(href: string): void {\n checkUrl(href);\n const attributes: Attributes = { rel: \"dns-prefetch\", href };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Starts fetching a resource the page will need, at high priority. The browser stores it for the\n * later request with the same URL and destination (React's `preload`).\n *\n * @param href An http(s) or relative URL.\n * @param options The destination (`as`, required) and the optional type, media and CORS mode.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preload } from \"@shadow-js/web\";\n *\n * preload(\"/fonts/inter.woff2\", { as: \"font\", type: \"font/woff2\", crossOrigin: \"anonymous\" });\n * @see preloadModule\n * @see preinit\n * @since 1.0.0\n */\nexport function preload(href: string, options: PreloadOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n rel: \"preload\",\n href,\n as: options.as,\n ...(options.type === undefined ? {} : { type: options.type }),\n ...(options.media === undefined ? {} : { media: options.media }),\n ...(options.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Starts loading an ES module the page will import, so the import does not wait for the module\n * graph to be discovered. React's `preloadModule`.\n * @param href An http(s) or relative URL of the module.\n * @param options CORS mode. Undefined adds no `crossorigin` attribute.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preloadModule } from \"@shadow-js/web\";\n *\n * preloadModule(\"/chunks/editor.js\");\n * @see preinitModule\n * @see preload\n * @since 1.0.0\n */\nexport function preloadModule(href: string, options?: CrossOriginOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n rel: \"modulepreload\",\n href,\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Loads a stylesheet or script now, and keeps it applied or executed (React's `preinit`). A\n * stylesheet becomes a `<link rel=\"stylesheet\">`; a script becomes an async `<script>` in the head.\n * On the server a script can only be hinted as a preload, because head tags cannot be scripts.\n *\n * @param href An http(s) or relative URL.\n * @param options What to load (`style` or `script`, required) and the CORS mode.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preinit } from \"@shadow-js/web\";\n *\n * preinit(\"/theme.css\", { as: \"style\" });\n * @see preload\n * @see preinitModule\n * @since 1.0.0\n */\nexport function preinit(href: string, options: PreinitOptions): void {\n checkUrl(href);\n if (options.as === \"style\") {\n const attributes: Attributes = {\n rel: \"stylesheet\",\n href,\n ...(options.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n return;\n }\n const attributes: Attributes = {\n src: href,\n async: \"\",\n ...(options.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"script\", attributes, serverLink({ rel: \"preload\", href, as: \"script\" }));\n}\n\n/**\n * Loads and runs an ES module now (React's `preinitModule`). On the client it inserts a\n * `<script type=\"module\">`; on the server it hints the module with `modulepreload`, since the\n * script itself is loaded by the page.\n *\n * @param href An http(s) or relative URL of the module.\n * @param options CORS mode. Undefined adds no `crossorigin` attribute.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preinitModule } from \"@shadow-js/web\";\n *\n * preinitModule(\"/chunks/app.js\");\n * @see preloadModule\n * @see preinit\n * @since 1.0.0\n */\nexport function preinitModule(href: string, options?: CrossOriginOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n src: href,\n type: \"module\",\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\n \"script\",\n attributes,\n serverLink({\n rel: \"modulepreload\",\n href,\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n }),\n );\n}\n"],"mappings":";;;;AAoEA,SAAS,SAAS,MAAoB;CACpC,MAAM,MAAM,IAAI,IAAI,MAAM,sBAAsB;CAChD,IAAI,IAAI,aAAa,YAAY,IAAI,aAAa,SAChD,MAAM,IAAI,UAEJ,mBAAmB,KAAK,qCAE9B;AAEJ;;AAGA,SAAS,QAAQ,SAAkB,YAAiC;CAClE,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,UAAU,GACnD,IAAI,QAAQ,aAAa,IAAI,MAAM,OAAO,OAAO;CAEnD,OAAO;AACT;;;;;AAMA,SAAS,KACP,KACA,YACA,kBAA8B,KAAA,GACxB;CACN,IAAI,UAAU;EACZ,UAAU;EACV;CACF;CACA,IAAI,OAAO,aAAa,aAAa;CACrC,KAAK,MAAM,YAAY,SAAS,KAAK,iBAAiB,GAAG,GACvD,IAAI,QAAQ,UAAU,UAAU,GAAG;CAErC,MAAM,UAAU,SAAS,cAAc,GAAG;CAC1C,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,UAAU,GAAG,QAAQ,aAAa,MAAM,KAAK;CACxF,SAAS,KAAK,OAAO,OAAO;AAC9B;;AAGA,SAAS,WAAW,YAAsE;CACxF,aAAa,QAAQ;EAAE,KAAK;EAAQ,OAAO;CAAW,CAAC;AACzD;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,WAAW,MAAc,SAAoC;CAC3E,SAAS,IAAI;CACb,MAAM,aAAyB;EAC7B,KAAK;EACL;EACA,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CACnF;CACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;AAaA,SAAgB,YAAY,MAAoB;CAC9C,SAAS,IAAI;CACb,MAAM,aAAyB;EAAE,KAAK;EAAgB;CAAK;CAC3D,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;;;;;AAiBA,SAAgB,QAAQ,MAAc,SAA+B;CACnE,SAAS,IAAI;CACb,MAAM,aAAyB;EAC7B,KAAK;EACL;EACA,IAAI,QAAQ;EACZ,GAAI,QAAQ,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;EAC3D,GAAI,QAAQ,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,QAAQ,MAAM;EAC9D,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAClF;CACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;;;;AAgBA,SAAgB,cAAc,MAAc,SAAoC;CAC9E,SAAS,IAAI;CACb,MAAM,aAAyB;EAC7B,KAAK;EACL;EACA,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CACnF;CACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;;;;;;AAkBA,SAAgB,QAAQ,MAAc,SAA+B;CACnE,SAAS,IAAI;CACb,IAAI,QAAQ,OAAO,SAAS;EAC1B,MAAM,aAAyB;GAC7B,KAAK;GACL;GACA,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;EAClF;EACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;EAC/C;CACF;CAMA,KAAK,UAAU;EAJb,KAAK;EACL,OAAO;EACP,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAE1D,GAAG,WAAW;EAAE,KAAK;EAAW;EAAM,IAAI;CAAS,CAAC,CAAC;AAC/E;;;;;;;;;;;;;;;;;AAkBA,SAAgB,cAAc,MAAc,SAAoC;CAC9E,SAAS,IAAI;CAMb,KACE,UACA;EANA,KAAK;EACL,MAAM;EACN,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAIxE,GACT,WAAW;EACT,KAAK;EACL;EACA,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CACnF,CAAC,CACH;AACF"}
@@ -0,0 +1,24 @@
1
+ //#region src/select-value.d.ts
2
+ /**
3
+ * Selects the options a `value` stands for. The compiler calls it for `<select value={...}>`. A
4
+ * single value behaves like `select.value = value` (`null` and `undefined` are the empty string).
5
+ * On a `<select multiple>` an array selects exactly the options whose value it lists and clears
6
+ * the others. The server writes the same state as `selected` on the options (`ssrSelectValue`).
7
+ *
8
+ * @param select The select element; its options must already be in it.
9
+ * @param value A string or number (written as `String(value)`), or `null`/`undefined` (written as
10
+ * `""`: an option with an empty value is selected, otherwise none). For a `multiple` select, an array of them: `null` and `undefined`
11
+ * entries are skipped. An array on a single select is written as `String(array)`.
12
+ * @example
13
+ * import { setSelectValue } from "@shadow-js/web";
14
+ *
15
+ * const select = document.createElement("select");
16
+ * select.multiple = true;
17
+ * select.append(new Option("A", "a"), new Option("B", "b"), new Option("C", "c"));
18
+ * setSelectValue(select, ["a", "c"]); // A and C selected, B cleared
19
+ * @see ssrSelectValue
20
+ * @since 1.0.0
21
+ */
22
+ export declare function setSelectValue(select: HTMLSelectElement, value: unknown): void;
23
+ //#endregion
24
+ //# sourceMappingURL=select-value.d.ts.map
@@ -0,0 +1,51 @@
1
+ //#region src/select-value.ts
2
+ /** The values an array stands for, as strings; null and undefined entries are skipped. */
3
+ function listed(value) {
4
+ const values = /* @__PURE__ */ new Set();
5
+ for (const item of value) if (item !== null && item !== void 0) values.add(String(item));
6
+ return values;
7
+ }
8
+ /** The string a single value assigns to `select.value`; null and undefined clear the choice. */
9
+ function single(value) {
10
+ return value === null || value === void 0 ? "" : String(value);
11
+ }
12
+ /**
13
+ * Selects the options a `value` stands for. The compiler calls it for `<select value={...}>`. A
14
+ * single value behaves like `select.value = value` (`null` and `undefined` are the empty string).
15
+ * On a `<select multiple>` an array selects exactly the options whose value it lists and clears
16
+ * the others. The server writes the same state as `selected` on the options (`ssrSelectValue`).
17
+ *
18
+ * @param select The select element; its options must already be in it.
19
+ * @param value A string or number (written as `String(value)`), or `null`/`undefined` (written as
20
+ * `""`: an option with an empty value is selected, otherwise none). For a `multiple` select, an array of them: `null` and `undefined`
21
+ * entries are skipped. An array on a single select is written as `String(array)`.
22
+ * @example
23
+ * import { setSelectValue } from "@shadow-js/web";
24
+ *
25
+ * const select = document.createElement("select");
26
+ * select.multiple = true;
27
+ * select.append(new Option("A", "a"), new Option("B", "b"), new Option("C", "c"));
28
+ * setSelectValue(select, ["a", "c"]); // A and C selected, B cleared
29
+ * @see ssrSelectValue
30
+ * @since 1.0.0
31
+ */
32
+ function setSelectValue(select, value) {
33
+ if (select.multiple && Array.isArray(value)) {
34
+ const wanted = listed(value);
35
+ for (const option of Array.from(select.options)) option.selected = wanted.has(option.value);
36
+ return;
37
+ }
38
+ select.value = single(value);
39
+ }
40
+ /** True when the select already shows `value` the way {@link setSelectValue} would leave it. @internal */
41
+ function selectShows(select, value) {
42
+ if (select.multiple && Array.isArray(value)) {
43
+ const wanted = listed(value);
44
+ return Array.from(select.options).every((option) => option.selected === wanted.has(option.value));
45
+ }
46
+ return select.value === single(value);
47
+ }
48
+ //#endregion
49
+ export { selectShows, setSelectValue };
50
+
51
+ //# sourceMappingURL=select-value.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"select-value.js","names":[],"sources":["../../src/select-value.ts"],"sourcesContent":["/** The values an array stands for, as strings; null and undefined entries are skipped. */\nfunction listed(value: readonly unknown[]): Set<string> {\n const values = new Set<string>();\n for (const item of value) {\n if (item !== null && item !== undefined) values.add(String(item));\n }\n return values;\n}\n\n/** The string a single value assigns to `select.value`; null and undefined clear the choice. */\nfunction single(value: unknown): string {\n return value === null || value === undefined ? \"\" : String(value);\n}\n\n/**\n * Selects the options a `value` stands for. The compiler calls it for `<select value={...}>`. A\n * single value behaves like `select.value = value` (`null` and `undefined` are the empty string).\n * On a `<select multiple>` an array selects exactly the options whose value it lists and clears\n * the others. The server writes the same state as `selected` on the options (`ssrSelectValue`).\n *\n * @param select The select element; its options must already be in it.\n * @param value A string or number (written as `String(value)`), or `null`/`undefined` (written as\n * `\"\"`: an option with an empty value is selected, otherwise none). For a `multiple` select, an array of them: `null` and `undefined`\n * entries are skipped. An array on a single select is written as `String(array)`.\n * @example\n * import { setSelectValue } from \"@shadow-js/web\";\n *\n * const select = document.createElement(\"select\");\n * select.multiple = true;\n * select.append(new Option(\"A\", \"a\"), new Option(\"B\", \"b\"), new Option(\"C\", \"c\"));\n * setSelectValue(select, [\"a\", \"c\"]); // A and C selected, B cleared\n * @see ssrSelectValue\n * @since 1.0.0\n */\nexport function setSelectValue(select: HTMLSelectElement, value: unknown): void {\n if (select.multiple && Array.isArray(value)) {\n const wanted = listed(value);\n for (const option of Array.from(select.options)) option.selected = wanted.has(option.value);\n return;\n }\n select.value = single(value);\n}\n\n/** True when the select already shows `value` the way {@link setSelectValue} would leave it. @internal */\nexport function selectShows(select: HTMLSelectElement, value: unknown): boolean {\n if (select.multiple && Array.isArray(value)) {\n const wanted = listed(value);\n return Array.from(select.options).every(\n (option) => option.selected === wanted.has(option.value),\n );\n }\n return select.value === single(value);\n}\n"],"mappings":";;AACA,SAAS,OAAO,OAAwC;CACtD,MAAM,yBAAS,IAAI,IAAY;CAC/B,KAAK,MAAM,QAAQ,OACjB,IAAI,SAAS,QAAQ,SAAS,KAAA,GAAW,OAAO,IAAI,OAAO,IAAI,CAAC;CAElE,OAAO;AACT;;AAGA,SAAS,OAAO,OAAwB;CACtC,OAAO,UAAU,QAAQ,UAAU,KAAA,IAAY,KAAK,OAAO,KAAK;AAClE;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,eAAe,QAA2B,OAAsB;CAC9E,IAAI,OAAO,YAAY,MAAM,QAAQ,KAAK,GAAG;EAC3C,MAAM,SAAS,OAAO,KAAK;EAC3B,KAAK,MAAM,UAAU,MAAM,KAAK,OAAO,OAAO,GAAG,OAAO,WAAW,OAAO,IAAI,OAAO,KAAK;EAC1F;CACF;CACA,OAAO,QAAQ,OAAO,KAAK;AAC7B;;AAGA,SAAgB,YAAY,QAA2B,OAAyB;CAC9E,IAAI,OAAO,YAAY,MAAM,QAAQ,KAAK,GAAG;EAC3C,MAAM,SAAS,OAAO,KAAK;EAC3B,OAAO,MAAM,KAAK,OAAO,OAAO,CAAC,CAAC,OAC/B,WAAW,OAAO,aAAa,OAAO,IAAI,OAAO,KAAK,CACzD;CACF;CACA,OAAO,OAAO,UAAU,OAAO,KAAK;AACtC"}
@@ -0,0 +1,33 @@
1
+ //#region src/server/attributes.d.ts
2
+ /**
3
+ * Renders one attribute as markup with a leading space, or `""` when the attribute is absent: the
4
+ * helper the compiler's server output calls for a dynamic attribute. It applies the client's value
5
+ * rules and URL check, so server and client agree on what is written.
6
+ *
7
+ * - `null`, `undefined` and `false` give `""` (except `false` on `aria-*`, `data-*`, `draggable`,
8
+ * `spellcheck` and `contenteditable`, which is written as `"false"`); `true` writes `=""` (or
9
+ * `"true"` for those same names). Other values are written as `String(value)`, HTML-escaped.
10
+ * - URL attributes whose value would run script are dropped, with the check of
11
+ * `isUnsafeUrlAttribute` (including the SVG animation attributes `values`, `from`, `to`, `by`).
12
+ * - `on*` names are dropped: event handlers never reach markup.
13
+ * - Accessors are called (untracked) until a plain value remains.
14
+ *
15
+ * @param name Attribute name, matching `[A-Za-z_:][A-Za-z0-9_:.-]*`. It is validated before
16
+ * anything else, so an invalid name always throws.
17
+ * @param value The value, or an accessor of it.
18
+ * @param isBoolean `true` for a presence attribute such as `disabled`: a truthy value writes the bare
19
+ * name, a falsy one writes nothing. Default: `false`.
20
+ * @returns Markup such as `' title="a&amp;b"'`, or `""`.
21
+ * @throws TypeError `INVALID_ATTRIBUTE_NAME` for an invalid name, and `UNRECOGNIZED_INSERT_VALUE`
22
+ * when the value is a symbol.
23
+ * @example
24
+ * import { ssrAttribute } from "@shadow-js/web/server";
25
+ *
26
+ * ssrAttribute("title", "Tom & Jerry"); // ' title="Tom &amp; Jerry"'
27
+ * ssrAttribute("disabled", true, true); // " disabled"
28
+ * ssrAttribute("href", "javascript:alert(1)"); // ""
29
+ * @since 1.0.0
30
+ */
31
+ export declare function ssrAttribute(name: string, value: unknown, isBoolean?: boolean): string;
32
+ //#endregion
33
+ //# sourceMappingURL=attributes.d.ts.map
@@ -0,0 +1,155 @@
1
+ import { invalid } from "./errors.js";
2
+ import { escapeHtml, resolveValue } from "./escape.js";
3
+ //#region src/server/attributes.ts
4
+ /** Names that can appear in markup: an XML-name subset without `@` or whitespace. Same as the client. */
5
+ const ATTRIBUTE_NAME = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/;
6
+ /** Attributes whose value is a URL and is therefore checked for script schemes. Same as the client. */
7
+ const URL_ATTRIBUTES = /* @__PURE__ */ new Set([
8
+ "href",
9
+ "src",
10
+ "action",
11
+ "formaction",
12
+ "xlink:href",
13
+ "srcdoc",
14
+ "poster",
15
+ "data"
16
+ ]);
17
+ /**
18
+ * SVG animation attributes (`animate`, `set`): with `attributeName="href"` they write an `href` by animation, so their value
19
+ * is checked like one. `values` is a `;` list and every entry is checked. Same as the client.
20
+ */
21
+ const ANIMATION_VALUE_ATTRIBUTES = /* @__PURE__ */ new Set([
22
+ "values",
23
+ "from",
24
+ "to",
25
+ "by"
26
+ ]);
27
+ /** Enumerated attributes where `false` is a real value ("false") rather than an absence. */
28
+ const ENUMERATED_ATTRIBUTES = /* @__PURE__ */ new Set([
29
+ "draggable",
30
+ "spellcheck",
31
+ "contenteditable"
32
+ ]);
33
+ /**
34
+ * Boolean attributes that a props object writes as presence flags (`disabled: true` gives a bare
35
+ * `disabled`). Lower-case names only.
36
+ * @internal
37
+ */
38
+ const BOOLEAN_ATTRIBUTES = /* @__PURE__ */ new Set([
39
+ "async",
40
+ "autofocus",
41
+ "autoplay",
42
+ "checked",
43
+ "controls",
44
+ "default",
45
+ "defer",
46
+ "disabled",
47
+ "formnovalidate",
48
+ "hidden",
49
+ "inert",
50
+ "ismap",
51
+ "loop",
52
+ "multiple",
53
+ "muted",
54
+ "nomodule",
55
+ "novalidate",
56
+ "open",
57
+ "playsinline",
58
+ "readonly",
59
+ "required",
60
+ "reversed",
61
+ "selected"
62
+ ]);
63
+ /** URL prefixes (after normalization) that are never written. Same as the client. */
64
+ const UNSAFE_URL_PREFIXES = [
65
+ "javascript:",
66
+ "data:text/html",
67
+ "vbscript:"
68
+ ];
69
+ /** Throws a TypeError unless `name` can be written as an attribute name. @internal */
70
+ function assertAttributeName(name) {
71
+ if (!ATTRIBUTE_NAME.test(name)) throw invalid("INVALID_ATTRIBUTE_NAME", `"${name}" is not a valid attribute name.`);
72
+ }
73
+ /** True for `on*` names, which never reach markup. Length matches the client's event test. @internal */
74
+ function isEventName(lowerName) {
75
+ return lowerName.length > 2 && lowerName.startsWith("on");
76
+ }
77
+ /** True for `aria-*`, `data-*` and the enumerated attributes: their booleans are strings. */
78
+ function isStringValued(lowerName) {
79
+ return lowerName.startsWith("aria-") || lowerName.startsWith("data-") || ENUMERATED_ATTRIBUTES.has(lowerName);
80
+ }
81
+ /** Removes C0 and C1 control characters, which browsers ignore inside a URL scheme. */
82
+ function stripControls(text) {
83
+ let kept = "";
84
+ for (const char of text) {
85
+ const code = char.charCodeAt(0);
86
+ if (code > 31 && (code < 127 || code > 159)) kept += char;
87
+ }
88
+ return kept;
89
+ }
90
+ /** True when the URL would run script, after the normalization browsers apply. @internal */
91
+ function isUnsafeUrl(value) {
92
+ const normalized = stripControls(value).trim().toLowerCase();
93
+ return UNSAFE_URL_PREFIXES.some((prefix) => normalized.startsWith(prefix));
94
+ }
95
+ /** True when `lowerName` carries a URL (or an animated one) and `value` would run script. */
96
+ function isUnsafeAttributeValue(lowerName, value) {
97
+ if (URL_ATTRIBUTES.has(lowerName)) return isUnsafeUrl(value);
98
+ return ANIMATION_VALUE_ATTRIBUTES.has(lowerName) && value.split(";").some(isUnsafeUrl);
99
+ }
100
+ /** Text to write for `value`, or null when the attribute is removed. Same rules as the client. @internal */
101
+ function attributeText(lowerName, value) {
102
+ if (value === null || value === void 0) return null;
103
+ if (value === false) return isStringValued(lowerName) ? "false" : null;
104
+ if (value === true) return isStringValued(lowerName) ? "true" : "";
105
+ return String(value);
106
+ }
107
+ /** Refuses symbols, which have no markup form and would otherwise be coerced silently. */
108
+ function assertNotSymbol(value) {
109
+ if (typeof value === "symbol") throw invalid("UNRECOGNIZED_INSERT_VALUE", "A symbol cannot be an attribute value.");
110
+ }
111
+ /**
112
+ * Renders one attribute as markup with a leading space, or `""` when the attribute is absent: the
113
+ * helper the compiler's server output calls for a dynamic attribute. It applies the client's value
114
+ * rules and URL check, so server and client agree on what is written.
115
+ *
116
+ * - `null`, `undefined` and `false` give `""` (except `false` on `aria-*`, `data-*`, `draggable`,
117
+ * `spellcheck` and `contenteditable`, which is written as `"false"`); `true` writes `=""` (or
118
+ * `"true"` for those same names). Other values are written as `String(value)`, HTML-escaped.
119
+ * - URL attributes whose value would run script are dropped, with the check of
120
+ * `isUnsafeUrlAttribute` (including the SVG animation attributes `values`, `from`, `to`, `by`).
121
+ * - `on*` names are dropped: event handlers never reach markup.
122
+ * - Accessors are called (untracked) until a plain value remains.
123
+ *
124
+ * @param name Attribute name, matching `[A-Za-z_:][A-Za-z0-9_:.-]*`. It is validated before
125
+ * anything else, so an invalid name always throws.
126
+ * @param value The value, or an accessor of it.
127
+ * @param isBoolean `true` for a presence attribute such as `disabled`: a truthy value writes the bare
128
+ * name, a falsy one writes nothing. Default: `false`.
129
+ * @returns Markup such as `' title="a&amp;b"'`, or `""`.
130
+ * @throws TypeError `INVALID_ATTRIBUTE_NAME` for an invalid name, and `UNRECOGNIZED_INSERT_VALUE`
131
+ * when the value is a symbol.
132
+ * @example
133
+ * import { ssrAttribute } from "@shadow-js/web/server";
134
+ *
135
+ * ssrAttribute("title", "Tom & Jerry"); // ' title="Tom &amp; Jerry"'
136
+ * ssrAttribute("disabled", true, true); // " disabled"
137
+ * ssrAttribute("href", "javascript:alert(1)"); // ""
138
+ * @since 1.0.0
139
+ */
140
+ function ssrAttribute(name, value, isBoolean = false) {
141
+ assertAttributeName(name);
142
+ const lowerName = name.toLowerCase();
143
+ if (isEventName(lowerName)) return "";
144
+ const resolved = resolveValue(value);
145
+ assertNotSymbol(resolved);
146
+ if (isBoolean) return resolved ? ` ${name}` : "";
147
+ const text = attributeText(lowerName, resolved);
148
+ if (text === null) return "";
149
+ if (isUnsafeAttributeValue(lowerName, text)) return "";
150
+ return ` ${name}="${escapeHtml(text)}"`;
151
+ }
152
+ //#endregion
153
+ export { BOOLEAN_ATTRIBUTES, assertAttributeName, attributeText, isEventName, isUnsafeUrl, ssrAttribute };
154
+
155
+ //# sourceMappingURL=attributes.js.map