@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,196 @@
1
+ import { cssValueText } from "./internal/css-units.js";
2
+ import { HTML_NS } from "./internal/names.js";
3
+ // src/class-style.ts
4
+ /** Appends the truthy class names of `value` (strings, numbers, nested arrays, objects) to `parts`. */
5
+ function collectClasses(root, parts) {
6
+ const frames = [[root]];
7
+ const cursors = [0];
8
+ const active = /* @__PURE__ */ new Set();
9
+ while (frames.length > 0) {
10
+ const top = frames.length - 1;
11
+ const frame = frames[top];
12
+ const cursor = cursors[top] ?? 0;
13
+ if (frame === void 0 || cursor >= frame.length) {
14
+ const done = frames.pop();
15
+ if (done !== void 0) active.delete(done);
16
+ cursors.pop();
17
+ continue;
18
+ }
19
+ cursors[top] = cursor + 1;
20
+ const item = frame[cursor];
21
+ if (Array.isArray(item)) {
22
+ if (active.has(item)) throw new TypeError("className(): a class array contains itself.");
23
+ active.add(item);
24
+ frames.push(item);
25
+ cursors.push(0);
26
+ } else if (typeof item === "string") {
27
+ if (item !== "") parts.push(item);
28
+ } else if (typeof item === "number") {
29
+ if (item !== 0 && !Number.isNaN(item)) parts.push(String(item));
30
+ } else if (item !== null && typeof item === "object") {
31
+ const record = item;
32
+ for (const key of Object.keys(record)) if (record[key] && key !== "") parts.push(key);
33
+ }
34
+ }
35
+ }
36
+ /** Class text for `value`, or null when the class attribute must be removed. */
37
+ function classText(value) {
38
+ if (typeof value === "string") return value;
39
+ if (value === null || value === void 0 || value === false) return null;
40
+ const parts = [];
41
+ collectClasses(value, parts);
42
+ return parts.join(" ");
43
+ }
44
+ /**
45
+ * Writes a class value. `svg` selects the attribute path, which SVG and MathML need because their
46
+ * `className` is not a plain string.
47
+ * @internal
48
+ */
49
+ function applyClass(el, value, svg) {
50
+ const text = classText(value);
51
+ if (text === null) {
52
+ el.removeAttribute("class");
53
+ return;
54
+ }
55
+ if (svg) {
56
+ if (el.getAttribute("class") !== text) el.setAttribute("class", text);
57
+ } else if (el.className !== text) el.className = text;
58
+ }
59
+ /**
60
+ * Replaces the whole `class` of an element: the helper compiled templates call for `class` and
61
+ * `className`. HTML elements are written through `className`; SVG and MathML elements (whose
62
+ * `className` is not a plain string) through the `class` attribute. The DOM is touched only when
63
+ * the text changes.
64
+ *
65
+ * @param el Target element.
66
+ * @param value A string is used as is. Arrays and objects are clsx-style: non-empty strings,
67
+ * numbers other than `0` and `NaN`, nested arrays, and the keys of objects whose value is truthy,
68
+ * joined with spaces. `null`, `undefined` and `false` remove the attribute.
69
+ * @throws TypeError `SHADOW_CLASS_CYCLE` when an array contains itself (directly or through a nested
70
+ * array).
71
+ * @example
72
+ * import { className } from "@shadow-js/web";
73
+ *
74
+ * const card = document.createElement("div");
75
+ * className(card, ["card", { "card--active": true, "card--muted": false }]);
76
+ * card.className; // "card card--active"
77
+ * @see classList
78
+ * @since 1.0.0
79
+ */
80
+ function className(el, value) {
81
+ applyClass(el, value, el.namespaceURI !== HTML_NS);
82
+ }
83
+ /** Narrows an object value to a record of keys; arrays and primitives are not class maps. */
84
+ function asRecord(value) {
85
+ if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
86
+ return value;
87
+ }
88
+ /**
89
+ * Toggles individual classes from an object: the helper compiled templates call for `classList`.
90
+ * Unlike {@link className}, it leaves classes it did not set alone: only keys whose truthiness
91
+ * changed relative to `prev` are touched. A key may hold several space-separated names. Keys that
92
+ * disappeared from `value` are switched off.
93
+ *
94
+ * @param el Target element.
95
+ * @param value Map from class names to truthiness. `undefined` switches off every class `prev` had on.
96
+ * @param prev The map returned by the previous call. Undefined (the first call) means no class was
97
+ * on yet.
98
+ * @returns The map now in effect (`value`, or `{}` for undefined), to pass back as `prev` next time.
99
+ * @example
100
+ * import { classList } from "@shadow-js/web";
101
+ *
102
+ * const el = document.createElement("li");
103
+ * let prev = classList(el, { active: true, "is-new pulse": true });
104
+ * prev = classList(el, { active: false }, prev); // removes active, is-new and pulse
105
+ * @see className
106
+ * @since 1.0.0
107
+ */
108
+ function classList(el, value, prev) {
109
+ const next = value ?? {};
110
+ const before = prev ?? {};
111
+ const keys = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(next)]);
112
+ for (const key of keys) {
113
+ const now = Boolean(next[key]);
114
+ if (now === Boolean(before[key])) continue;
115
+ for (const token of key.split(/\s+/)) if (token !== "") el.classList.toggle(token, now);
116
+ }
117
+ return next;
118
+ }
119
+ /**
120
+ * Converts a camelCase style name to a CSS property name. Custom properties are kept as they are,
121
+ * and vendor prefixes map to `-webkit-` and `-ms-`.
122
+ * @internal
123
+ */
124
+ function toCssProperty(name) {
125
+ if (name.startsWith("--")) return name;
126
+ const kebab = name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
127
+ return kebab.startsWith("ms-") ? `-${kebab}` : kebab;
128
+ }
129
+ /**
130
+ * Sets or removes one inline style property: the helper compiled templates call for the `style:`
131
+ * prefix. Other inline properties are left alone.
132
+ *
133
+ * @param el HTML or SVG element.
134
+ * @param name CSS property in camelCase (`backgroundColor`, `msTransform` gives `-ms-transform`) or
135
+ * kebab-case, or a custom property (`--accent`, kept as is).
136
+ * @param value `null`, `undefined` and `false` remove the property. A number is in pixels, as in
137
+ * React, unless it is `0`, the property is unitless (`opacity`, `zIndex`, `flexGrow`, `lineHeight`,
138
+ * ...) or a custom property. Any other value is written as `String(value)`.
139
+ * @example
140
+ * import { setStyleProperty } from "@shadow-js/web";
141
+ *
142
+ * const el = document.createElement("div");
143
+ * setStyleProperty(el, "marginTop", 8); // margin-top: 8px
144
+ * setStyleProperty(el, "--accent", "rebeccapurple");
145
+ * setStyleProperty(el, "opacity", 0.5); // unitless
146
+ * @see style
147
+ * @since 1.0.0
148
+ */
149
+ function setStyleProperty(el, name, value) {
150
+ const property = toCssProperty(name);
151
+ if (value === null || value === void 0 || value === false) el.style.removeProperty(property);
152
+ else el.style.setProperty(property, cssValueText(property, value));
153
+ }
154
+ /**
155
+ * Sets the inline style of an element: the helper compiled templates call for a `style` attribute.
156
+ * An object is diffed against `prev` so that only changed properties are written, each with the
157
+ * rules of {@link setStyleProperty}; properties that disappeared are removed.
158
+ *
159
+ * @param el HTML or SVG element.
160
+ * @param value An object of properties (camelCase, kebab-case or custom names). A string replaces
161
+ * `cssText`. `null`, `undefined` and `false` remove the `style` attribute.
162
+ * @param prev The value returned by the previous call. Undefined (the first call) diffs against an
163
+ * empty style. When it is a string, `cssText` is cleared before the object is written.
164
+ * @returns What to pass back as `prev` next time: a shallow copy of an object value, otherwise
165
+ * `value` itself.
166
+ * @example
167
+ * import { style } from "@shadow-js/web";
168
+ *
169
+ * const el = document.createElement("div");
170
+ * let prev = style(el, { color: "red", width: 120 }); // width: 120px
171
+ * prev = style(el, { color: "blue" }, prev); // writes color, removes width
172
+ * @see setStyleProperty
173
+ * @since 1.0.0
174
+ */
175
+ function style(el, value, prev) {
176
+ if (value === null || value === void 0 || value === false) {
177
+ el.removeAttribute("style");
178
+ return value;
179
+ }
180
+ if (typeof value !== "object") {
181
+ el.style.cssText = String(value);
182
+ return value;
183
+ }
184
+ const next = { ...value };
185
+ const before = asRecord(prev) ?? {};
186
+ if (typeof prev === "string") el.style.cssText = "";
187
+ const keys = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(next)]);
188
+ for (const key of keys) {
189
+ if (Object.is(before[key], next[key])) continue;
190
+ setStyleProperty(el, key, next[key]);
191
+ }
192
+ return next;
193
+ }
194
+ export { applyClass, classList, className, setStyleProperty, style, toCssProperty };
195
+
196
+ //# sourceMappingURL=class-style.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"class-style.js","names":[],"sources":["../../src/class-style.ts"],"sourcesContent":["import { cssValueText } from \"./internal/css-units\";\nimport { HTML_NS } from \"./internal/names\";\n\n/** Appends the truthy class names of `value` (strings, numbers, nested arrays, objects) to `parts`. */\nfunction collectClasses(root: unknown, parts: string[]): void {\n // Explicit frames instead of recursion: array nesting depth is controlled by the user.\n const frames: unknown[][] = [[root]];\n const cursors: number[] = [0];\n const active = new Set<unknown[]>();\n while (frames.length > 0) {\n const top = frames.length - 1;\n const frame = frames[top];\n const cursor = cursors[top] ?? 0;\n if (frame === undefined || cursor >= frame.length) {\n const done = frames.pop();\n if (done !== undefined) active.delete(done);\n cursors.pop();\n continue;\n }\n cursors[top] = cursor + 1;\n const item = frame[cursor];\n if (Array.isArray(item)) {\n if (active.has(item))\n throw new TypeError(\n __DEV__ ? \"className(): a class array contains itself.\" : \"SHADOW_CLASS_CYCLE\",\n );\n active.add(item);\n frames.push(item);\n cursors.push(0);\n } else if (typeof item === \"string\") {\n if (item !== \"\") parts.push(item);\n } else if (typeof item === \"number\") {\n if (item !== 0 && !Number.isNaN(item)) parts.push(String(item));\n } else if (item !== null && typeof item === \"object\") {\n const record = item as Record<string, unknown>;\n for (const key of Object.keys(record)) {\n if (record[key] && key !== \"\") parts.push(key);\n }\n }\n }\n}\n\n/** Class text for `value`, or null when the class attribute must be removed. */\nfunction classText(value: unknown): string | null {\n if (typeof value === \"string\") return value;\n if (value === null || value === undefined || value === false) return null;\n const parts: string[] = [];\n collectClasses(value, parts);\n return parts.join(\" \");\n}\n\n/**\n * Writes a class value. `svg` selects the attribute path, which SVG and MathML need because their\n * `className` is not a plain string.\n * @internal\n */\nexport function applyClass(el: Element, value: unknown, svg: boolean): void {\n const text = classText(value);\n if (text === null) {\n el.removeAttribute(\"class\");\n return;\n }\n if (svg) {\n if (el.getAttribute(\"class\") !== text) el.setAttribute(\"class\", text);\n } else if (el.className !== text) {\n el.className = text;\n }\n}\n\n/**\n * Replaces the whole `class` of an element: the helper compiled templates call for `class` and\n * `className`. HTML elements are written through `className`; SVG and MathML elements (whose\n * `className` is not a plain string) through the `class` attribute. The DOM is touched only when\n * the text changes.\n *\n * @param el Target element.\n * @param value A string is used as is. Arrays and objects are clsx-style: non-empty strings,\n * numbers other than `0` and `NaN`, nested arrays, and the keys of objects whose value is truthy,\n * joined with spaces. `null`, `undefined` and `false` remove the attribute.\n * @throws TypeError `SHADOW_CLASS_CYCLE` when an array contains itself (directly or through a nested\n * array).\n * @example\n * import { className } from \"@shadow-js/web\";\n *\n * const card = document.createElement(\"div\");\n * className(card, [\"card\", { \"card--active\": true, \"card--muted\": false }]);\n * card.className; // \"card card--active\"\n * @see classList\n * @since 1.0.0\n */\nexport function className(el: Element, value: unknown): void {\n applyClass(el, value, el.namespaceURI !== HTML_NS);\n}\n\n/** Narrows an object value to a record of keys; arrays and primitives are not class maps. */\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n if (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n return value as Record<string, unknown>;\n}\n\n/**\n * Toggles individual classes from an object: the helper compiled templates call for `classList`.\n * Unlike {@link className}, it leaves classes it did not set alone: only keys whose truthiness\n * changed relative to `prev` are touched. A key may hold several space-separated names. Keys that\n * disappeared from `value` are switched off.\n *\n * @param el Target element.\n * @param value Map from class names to truthiness. `undefined` switches off every class `prev` had on.\n * @param prev The map returned by the previous call. Undefined (the first call) means no class was\n * on yet.\n * @returns The map now in effect (`value`, or `{}` for undefined), to pass back as `prev` next time.\n * @example\n * import { classList } from \"@shadow-js/web\";\n *\n * const el = document.createElement(\"li\");\n * let prev = classList(el, { active: true, \"is-new pulse\": true });\n * prev = classList(el, { active: false }, prev); // removes active, is-new and pulse\n * @see className\n * @since 1.0.0\n */\nexport function classList(\n el: Element,\n value: Record<string, unknown> | undefined,\n prev?: Record<string, unknown>,\n): Record<string, unknown> {\n const next: Record<string, unknown> = value ?? {};\n const before: Record<string, unknown> = prev ?? {};\n const keys = new Set([...Object.keys(before), ...Object.keys(next)]);\n for (const key of keys) {\n const now = Boolean(next[key]);\n const was = Boolean(before[key]);\n if (now === was) continue;\n for (const token of key.split(/\\s+/)) {\n if (token !== \"\") el.classList.toggle(token, now);\n }\n }\n return next;\n}\n\n/**\n * Converts a camelCase style name to a CSS property name. Custom properties are kept as they are,\n * and vendor prefixes map to `-webkit-` and `-ms-`.\n * @internal\n */\nexport function toCssProperty(name: string): string {\n if (name.startsWith(\"--\")) return name;\n const kebab = name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);\n return kebab.startsWith(\"ms-\") ? `-${kebab}` : kebab;\n}\n\n/**\n * Sets or removes one inline style property: the helper compiled templates call for the `style:`\n * prefix. Other inline properties are left alone.\n *\n * @param el HTML or SVG element.\n * @param name CSS property in camelCase (`backgroundColor`, `msTransform` gives `-ms-transform`) or\n * kebab-case, or a custom property (`--accent`, kept as is).\n * @param value `null`, `undefined` and `false` remove the property. A number is in pixels, as in\n * React, unless it is `0`, the property is unitless (`opacity`, `zIndex`, `flexGrow`, `lineHeight`,\n * ...) or a custom property. Any other value is written as `String(value)`.\n * @example\n * import { setStyleProperty } from \"@shadow-js/web\";\n *\n * const el = document.createElement(\"div\");\n * setStyleProperty(el, \"marginTop\", 8); // margin-top: 8px\n * setStyleProperty(el, \"--accent\", \"rebeccapurple\");\n * setStyleProperty(el, \"opacity\", 0.5); // unitless\n * @see style\n * @since 1.0.0\n */\nexport function setStyleProperty(el: HTMLElement | SVGElement, name: string, value: unknown): void {\n const property = toCssProperty(name);\n if (value === null || value === undefined || value === false) {\n el.style.removeProperty(property);\n } else {\n el.style.setProperty(property, cssValueText(property, value));\n }\n}\n\n/**\n * Sets the inline style of an element: the helper compiled templates call for a `style` attribute.\n * An object is diffed against `prev` so that only changed properties are written, each with the\n * rules of {@link setStyleProperty}; properties that disappeared are removed.\n *\n * @param el HTML or SVG element.\n * @param value An object of properties (camelCase, kebab-case or custom names). A string replaces\n * `cssText`. `null`, `undefined` and `false` remove the `style` attribute.\n * @param prev The value returned by the previous call. Undefined (the first call) diffs against an\n * empty style. When it is a string, `cssText` is cleared before the object is written.\n * @returns What to pass back as `prev` next time: a shallow copy of an object value, otherwise\n * `value` itself.\n * @example\n * import { style } from \"@shadow-js/web\";\n *\n * const el = document.createElement(\"div\");\n * let prev = style(el, { color: \"red\", width: 120 }); // width: 120px\n * prev = style(el, { color: \"blue\" }, prev); // writes color, removes width\n * @see setStyleProperty\n * @since 1.0.0\n */\nexport function style(el: HTMLElement | SVGElement, value: unknown, prev?: unknown): unknown {\n if (value === null || value === undefined || value === false) {\n el.removeAttribute(\"style\");\n return value;\n }\n if (typeof value !== \"object\") {\n el.style.cssText = String(value);\n return value;\n }\n const next = { ...(value as Record<string, unknown>) };\n const before = asRecord(prev) ?? {};\n if (typeof prev === \"string\") el.style.cssText = \"\";\n const keys = new Set([...Object.keys(before), ...Object.keys(next)]);\n for (const key of keys) {\n if (Object.is(before[key], next[key])) continue;\n setStyleProperty(el, key, next[key]);\n }\n return next;\n}\n"],"mappings":";;;;AAIA,SAAS,eAAe,MAAe,OAAuB;CAE5D,MAAM,SAAsB,CAAC,CAAC,IAAI,CAAC;CACnC,MAAM,UAAoB,CAAC,CAAC;CAC5B,MAAM,yBAAS,IAAI,IAAe;CAClC,OAAO,OAAO,SAAS,GAAG;EACxB,MAAM,MAAM,OAAO,SAAS;EAC5B,MAAM,QAAQ,OAAO;EACrB,MAAM,SAAS,QAAQ,QAAQ;EAC/B,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,QAAQ;GACjD,MAAM,OAAO,OAAO,IAAI;GACxB,IAAI,SAAS,KAAA,GAAW,OAAO,OAAO,IAAI;GAC1C,QAAQ,IAAI;GACZ;EACF;EACA,QAAQ,OAAO,SAAS;EACxB,MAAM,OAAO,MAAM;EACnB,IAAI,MAAM,QAAQ,IAAI,GAAG;GACvB,IAAI,OAAO,IAAI,IAAI,GACjB,MAAM,IAAI,UACE,6CACZ;GACF,OAAO,IAAI,IAAI;GACf,OAAO,KAAK,IAAI;GAChB,QAAQ,KAAK,CAAC;EAChB,OAAO,IAAI,OAAO,SAAS,UACrB;OAAA,SAAS,IAAI,MAAM,KAAK,IAAI;EAAA,OAC3B,IAAI,OAAO,SAAS,UACrB;OAAA,SAAS,KAAK,CAAC,OAAO,MAAM,IAAI,GAAG,MAAM,KAAK,OAAO,IAAI,CAAC;EAAA,OACzD,IAAI,SAAS,QAAQ,OAAO,SAAS,UAAU;GACpD,MAAM,SAAS;GACf,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAClC,IAAI,OAAO,QAAQ,QAAQ,IAAI,MAAM,KAAK,GAAG;EAEjD;CACF;AACF;;AAGA,SAAS,UAAU,OAA+B;CAChD,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,OAAO,OAAO;CACrE,MAAM,QAAkB,CAAC;CACzB,eAAe,OAAO,KAAK;CAC3B,OAAO,MAAM,KAAK,GAAG;AACvB;;;;;;AAOA,SAAgB,WAAW,IAAa,OAAgB,KAAoB;CAC1E,MAAM,OAAO,UAAU,KAAK;CAC5B,IAAI,SAAS,MAAM;EACjB,GAAG,gBAAgB,OAAO;EAC1B;CACF;CACA,IAAI,KACE;MAAA,GAAG,aAAa,OAAO,MAAM,MAAM,GAAG,aAAa,SAAS,IAAI;CAAA,OAC/D,IAAI,GAAG,cAAc,MAC1B,GAAG,YAAY;AAEnB;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,UAAU,IAAa,OAAsB;CAC3D,WAAW,IAAI,OAAO,GAAG,iBAAiB,OAAO;AACnD;;AAGA,SAAS,SAAS,OAAqD;CACrE,IAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG,OAAO,KAAA;CAChF,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,UACd,IACA,OACA,MACyB;CACzB,MAAM,OAAgC,SAAS,CAAC;CAChD,MAAM,SAAkC,QAAQ,CAAC;CACjD,MAAM,uBAAO,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC;CACnE,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,MAAM,QAAQ,KAAK,IAAI;EAE7B,IAAI,QADQ,QAAQ,OAAO,IACb,GAAG;EACjB,KAAK,MAAM,SAAS,IAAI,MAAM,KAAK,GACjC,IAAI,UAAU,IAAI,GAAG,UAAU,OAAO,OAAO,GAAG;CAEpD;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,cAAc,MAAsB;CAClD,IAAI,KAAK,WAAW,IAAI,GAAG,OAAO;CAClC,MAAM,QAAQ,KAAK,QAAQ,WAAW,WAAW,IAAI,OAAO,YAAY,GAAG;CAC3E,OAAO,MAAM,WAAW,KAAK,IAAI,IAAI,UAAU;AACjD;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,iBAAiB,IAA8B,MAAc,OAAsB;CACjG,MAAM,WAAW,cAAc,IAAI;CACnC,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,OACrD,GAAG,MAAM,eAAe,QAAQ;MAEhC,GAAG,MAAM,YAAY,UAAU,aAAa,UAAU,KAAK,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,MAAM,IAA8B,OAAgB,MAAyB;CAC3F,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,OAAO;EAC5D,GAAG,gBAAgB,OAAO;EAC1B,OAAO;CACT;CACA,IAAI,OAAO,UAAU,UAAU;EAC7B,GAAG,MAAM,UAAU,OAAO,KAAK;EAC/B,OAAO;CACT;CACA,MAAM,OAAO,EAAE,GAAI,MAAkC;CACrD,MAAM,SAAS,SAAS,IAAI,KAAK,CAAC;CAClC,IAAI,OAAO,SAAS,UAAU,GAAG,MAAM,UAAU;CACjD,MAAM,uBAAO,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC;CACnE,KAAK,MAAM,OAAO,MAAM;EACtB,IAAI,OAAO,GAAG,OAAO,MAAM,KAAK,IAAI,GAAG;EACvC,iBAAiB,IAAI,KAAK,KAAK,IAAI;CACrC;CACA,OAAO;AACT"}
@@ -0,0 +1,41 @@
1
+ import { currentScope, enterComponent } from "./internal/hydration-scope.js";
2
+ import { DEVTOOLS_EVENT, addCleanup, createOwner, devtoolsReport, runInScope } from "@shadow-js/core/extend";
3
+ // src/component.ts
4
+ /** Dev-only: the name each component was created with, for devtools. Weak, so components are not kept alive. */
5
+ const componentNames = /* @__PURE__ */ new WeakMap();
6
+ /**
7
+ * Calls a component untracked, under a new owner that is a child of the current one: cleanups and
8
+ * effects it creates are disposed with the enclosing scope. The name, given in development builds,
9
+ * is recorded for devtools.
10
+ *
11
+ * @param component The component function.
12
+ * @param props The props object (usually with getters for reactive props).
13
+ * @param name Optional devtools name.
14
+ * @returns Whatever the component returns.
15
+ * @example
16
+ * import { createComponent } from "@shadow-js/web";
17
+ *
18
+ * function Counter(props: { start: number }) {
19
+ * return `Count: ${props.start}`;
20
+ * }
21
+ *
22
+ * const view = createComponent(Counter, { start: 0 }, "Counter");
23
+ * @since 1.0.0
24
+ */
25
+ function createComponent(component, props, name) {
26
+ if (name !== void 0) componentNames.set(component, name);
27
+ return enterComponent(() => {
28
+ const owner = createOwner();
29
+ owner.idPrefix = currentScope()?.id;
30
+ const result = runInScope({
31
+ owner,
32
+ listener: null
33
+ }, () => component(props));
34
+ devtoolsReport(DEVTOOLS_EVENT.COMPONENT_MOUNTED, owner, componentNames.get(component), result);
35
+ addCleanup(owner, () => devtoolsReport(DEVTOOLS_EVENT.COMPONENT_UNMOUNTED, owner));
36
+ return result;
37
+ });
38
+ }
39
+ export { createComponent };
40
+
41
+ //# sourceMappingURL=component.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"component.js","names":[],"sources":["../../src/component.ts"],"sourcesContent":["import {\n addCleanup,\n createOwner,\n DEVTOOLS_EVENT,\n devtoolsReport,\n runInScope,\n} from \"@shadow-js/core/extend\";\nimport { currentScope, enterComponent } from \"./internal/hydration-scope\";\n\n/** Dev-only: the name each component was created with, for devtools. Weak, so components are not kept alive. */\nconst componentNames = new WeakMap<object, string>();\n\n/**\n * Calls a component untracked, under a new owner that is a child of the current one: cleanups and\n * effects it creates are disposed with the enclosing scope. The name, given in development builds,\n * is recorded for devtools.\n *\n * @param component The component function.\n * @param props The props object (usually with getters for reactive props).\n * @param name Optional devtools name.\n * @returns Whatever the component returns.\n * @example\n * import { createComponent } from \"@shadow-js/web\";\n *\n * function Counter(props: { start: number }) {\n * return `Count: ${props.start}`;\n * }\n *\n * const view = createComponent(Counter, { start: 0 }, \"Counter\");\n * @since 1.0.0\n */\nexport function createComponent<P>(\n component: (props: P) => unknown,\n props: P,\n name?: string,\n): unknown {\n if (__DEV__ && name !== undefined) componentNames.set(component, name);\n return enterComponent(() => {\n // Every component runs under an owner of its own: devtools attribute updates to it, and\n // `useId` uses its hydration-scope key as a prefix, so ids agree between server and browser\n // even though the browser creates more owners (effects) than the server does.\n const owner = createOwner();\n owner.idPrefix = currentScope()?.id;\n // One scope switch (owner in, listener off): deep component trees are bounded by the call stack.\n const result = runInScope({ owner, listener: null }, () => component(props));\n if (__DEV__) {\n devtoolsReport(\n DEVTOOLS_EVENT.COMPONENT_MOUNTED,\n owner,\n componentNames.get(component),\n result,\n );\n addCleanup(owner, () => devtoolsReport(DEVTOOLS_EVENT.COMPONENT_UNMOUNTED, owner));\n }\n return result;\n });\n}\n\n/**\n * The devtools name recorded for a component in development builds, if any.\n * @internal\n */\nexport function componentName(component: object): string | undefined {\n return componentNames.get(component);\n}\n"],"mappings":";;;;AAUA,MAAM,iCAAiB,IAAI,QAAwB;;;;;;;;;;;;;;;;;;;;AAqBnD,SAAgB,gBACd,WACA,OACA,MACS;CACT,IAAe,SAAS,KAAA,GAAW,eAAe,IAAI,WAAW,IAAI;CACrE,OAAO,qBAAqB;EAI1B,MAAM,QAAQ,YAAY;EAC1B,MAAM,WAAW,aAAa,CAAC,EAAE;EAEjC,MAAM,SAAS,WAAW;GAAE;GAAO,UAAU;EAAK,SAAS,UAAU,KAAK,CAAC;EAEzE,eACE,eAAe,mBACf,OACA,eAAe,IAAI,SAAS,GAC5B,MACF;EACA,WAAW,aAAa,eAAe,eAAe,qBAAqB,KAAK,CAAC;EAEnF,OAAO;CACT,CAAC;AACH"}
@@ -0,0 +1,40 @@
1
+ import "@shadow-js/core";
2
+ import "@shadow-js/core/extend";
3
+ // src/control-flow/activity.ts
4
+ /**
5
+ * Keeps its children alive while hidden: `mode="hidden"` removes them from sight but keeps their state,
6
+ * their DOM nodes and their focus and scroll position. Hidden content is paused: its effects run their
7
+ * cleanups and wait, its memos keep their last value, and its DOM does not update. Updates that arrive
8
+ * while hidden are applied once, when the content is shown again.
9
+ *
10
+ * Use it for tabs, wizards and routes you want back instantly. A hidden Activity mounted hidden renders
11
+ * its DOM once (so it is ready to show) and runs no effects until it is shown. The server renders the
12
+ * children without hiding them; the client hides them once it hydrates.
13
+ *
14
+ * @param props See {@link ActivityProps}.
15
+ * @returns An accessor of the content (two anchors and the children).
16
+ * @example
17
+ * import { useSignal } from "@shadow-js/core";
18
+ * import { Activity } from "@shadow-js/web";
19
+ *
20
+ * function Chat() {
21
+ * return <p>Chat</p>;
22
+ * }
23
+ *
24
+ * function Tabs() {
25
+ * const [tab] = useSignal("chat");
26
+ * return (
27
+ * <Activity mode={tab() === "chat" ? "visible" : "hidden"}>
28
+ * <Chat />
29
+ * </Activity>
30
+ * );
31
+ * }
32
+ * @see Show
33
+ * @since 1.0.0
34
+ */
35
+ function Activity(props) {
36
+ return () => props.children;
37
+ }
38
+ export { Activity };
39
+
40
+ //# sourceMappingURL=activity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activity.js","names":[],"sources":["../../../src/control-flow/activity.ts"],"sourcesContent":["import {\n type Accessor,\n runWithOwner,\n untrack,\n useEffect,\n useRenderEffect,\n useSignal,\n} from \"@shadow-js/core\";\nimport { createOwner, pauseOwner, resumeOwner } from \"@shadow-js/core/extend\";\n\n/**\n * `visible` shows the children; `hidden` keeps them alive (state, DOM and focus) but out of sight.\n * @since 1.0.0\n */\nexport type ActivityMode = \"visible\" | \"hidden\";\n\n/**\n * Props of {@link Activity}.\n * @since 1.0.0\n */\nexport interface ActivityProps {\n /**\n * `\"visible\"` shows the children; `\"hidden\"` keeps them alive but out of sight. Changing it\n * does not rebuild the children and may be reactive.\n * @default \"visible\"\n */\n readonly mode?: ActivityMode;\n /**\n * The content. Built once, when the parent first renders the Activity.\n * @default undefined (the Activity renders nothing)\n */\n readonly children?: unknown;\n}\n\n/** What a hidden Activity changed in the DOM, so showing it restores exactly that. */\ninterface Stash {\n readonly elements: Array<readonly [HTMLElement, string]>;\n readonly texts: Array<{ readonly text: Text; readonly parent: Node; readonly next: Node | null }>;\n readonly scrolls: Array<readonly [Element, number, number]>;\n readonly focus: Element | null;\n}\n\n/**\n * Hides the nodes between two anchors without removing them. Top-level elements get\n * `display: none` (their own state, subtree and listeners are untouched). Top-level text nodes are\n * detached (a text node cannot be hidden) and put back in order when shown. Scroll offsets and the\n * focused element are remembered, because `display: none` loses both.\n */\nfunction stashBetween(start: Node, end: Node): Stash | undefined {\n const parent = start.parentNode;\n if (parent === null) return undefined;\n const elements: Array<readonly [HTMLElement, string]> = [];\n const texts: Stash[\"texts\"][number][] = [];\n const scrolls: Array<readonly [Element, number, number]> = [];\n const active = document.activeElement;\n let focus: Element | null = null;\n let node: Node | null = start.nextSibling;\n while (node !== null && node !== end) {\n const next: Node | null = node.nextSibling;\n if (node.nodeType === 1) {\n const element = node as HTMLElement;\n elements.push([element, element.style.display]);\n element.style.display = \"none\";\n for (const scrollable of [element, ...Array.from(element.querySelectorAll(\"*\"))]) {\n if (scrollable.scrollTop !== 0 || scrollable.scrollLeft !== 0) {\n scrolls.push([scrollable, scrollable.scrollTop, scrollable.scrollLeft]);\n }\n }\n if (active !== null && element.contains(active)) focus = active;\n } else if (node.nodeType === 3) {\n texts.push({ text: node as Text, parent, next });\n parent.removeChild(node);\n }\n node = next;\n }\n return { elements, texts, scrolls, focus };\n}\n\n/** Puts back what {@link stashBetween} changed. Texts are restored last-to-first, so each finds its next. */\nfunction restore(stash: Stash, end: Node): void {\n for (let i = stash.texts.length - 1; i >= 0; i -= 1) {\n const entry = stash.texts[i];\n if (entry === undefined || entry.text.parentNode !== null) continue;\n const before = entry.next !== null && entry.next.parentNode === entry.parent ? entry.next : end;\n entry.parent.insertBefore(entry.text, before);\n }\n for (const [element, display] of stash.elements) element.style.display = display;\n for (const [element, top, left] of stash.scrolls) {\n element.scrollTop = top;\n element.scrollLeft = left;\n }\n const focus = stash.focus;\n if (focus instanceof HTMLElement && focus.isConnected) focus.focus({ preventScroll: true });\n}\n\n/**\n * Keeps its children alive while hidden: `mode=\"hidden\"` removes them from sight but keeps their state,\n * their DOM nodes and their focus and scroll position. Hidden content is paused: its effects run their\n * cleanups and wait, its memos keep their last value, and its DOM does not update. Updates that arrive\n * while hidden are applied once, when the content is shown again.\n *\n * Use it for tabs, wizards and routes you want back instantly. A hidden Activity mounted hidden renders\n * its DOM once (so it is ready to show) and runs no effects until it is shown. The server renders the\n * children without hiding them; the client hides them once it hydrates.\n *\n * @param props See {@link ActivityProps}.\n * @returns An accessor of the content (two anchors and the children).\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { Activity } from \"@shadow-js/web\";\n *\n * function Chat() {\n * return <p>Chat</p>;\n * }\n *\n * function Tabs() {\n * const [tab] = useSignal(\"chat\");\n * return (\n * <Activity mode={tab() === \"chat\" ? \"visible\" : \"hidden\"}>\n * <Chat />\n * </Activity>\n * );\n * }\n * @see Show\n * @since 1.0.0\n */\nexport function Activity(props: ActivityProps): Accessor<unknown> {\n if (__SERVER__) return () => props.children;\n // The content lives under its own owner, so pausing it reaches every effect and memo it created.\n const content = createOwner();\n // Built when the parent first reads it, not here: the server builds children at the same point of the\n // render, which keeps hydration keys equal on both sides.\n let built: unknown;\n let ready = false;\n const contentValue = (): unknown => {\n if (!ready) {\n ready = true;\n built = runWithOwner(content, () => untrack(() => props.children));\n }\n return built;\n };\n // Empty text anchors bound the content: the DOM range the visibility code hides and shows.\n const start = document.createTextNode(\"\");\n const end = document.createTextNode(\"\");\n const [hidden, setHidden] = useSignal(false);\n let paused = false;\n // Pausing happens in the render phase, before the content's own effects can run.\n useRenderEffect(\n () => props.mode === \"hidden\",\n (isHidden) => {\n if (isHidden === paused) return;\n paused = isHidden;\n if (isHidden) pauseOwner(content);\n else resumeOwner(content);\n setHidden(isHidden);\n },\n );\n // Runs after the DOM is committed (a user effect), so the nodes it hides exist.\n let stash: Stash | undefined;\n useEffect(() => {\n if (hidden()) {\n if (stash === undefined) stash = stashBetween(start, end);\n } else if (stash !== undefined) {\n const previous = stash;\n stash = undefined;\n restore(previous, end);\n }\n });\n return () => [start, contentValue(), end];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8HA,SAAgB,SAAS,OAAyC;CAChD,aAAa,MAAM;AA0CrC"}
@@ -0,0 +1,103 @@
1
+ import { createRoot, getOwner, onCleanup, untrack, useMemo } from "@shadow-js/core";
2
+ import { transitionHooks } from "@shadow-js/core/extend";
3
+ /**
4
+ * Whether two selections describe the same rendered output. Non-keyed branches only care about
5
+ * which branch is chosen, which is the same as comparing truthiness of the condition. Keyed
6
+ * branches also rebuild when the condition's identity changes. The fallback never rebuilds.
7
+ */
8
+ function sameChoice(a, b) {
9
+ if (a.index !== b.index) return false;
10
+ return a.index === -1 || !a.keyed || a.when === b.when;
11
+ }
12
+ /**
13
+ * Builds the accessor behind `Show` and `Switch`. The selection memo decides which branch is chosen;
14
+ * the output memo commits it.
15
+ *
16
+ * Ordinary changes build the branch inside the output memo: the memo's teardown removes the previous
17
+ * branch first. A change made during a transition, while a branch is on screen, is handled by the
18
+ * transition layer (core's `slotSwap`, reached through `transitionHooks`), created by the first such change: it builds the
19
+ * new branch under a hold and commits it once its reads have settled. Until then the shown branch stays
20
+ * on screen, its DOM untouched, and nothing is built twice. Apps that never change a shown branch in a
21
+ * transition never create that layer.
22
+ *
23
+ * Teardown ordering: the owner of a branch is marked `disposing` before it is torn down, so a cleanup
24
+ * that reads the callback's accessor learns that the branch is going away and gets the last truthy
25
+ * value instead of a stale-accessor error.
26
+ *
27
+ * @param name Component name used in diagnostics.
28
+ * @param select Tracked selection; runs inside the selection memo.
29
+ * @param fallback Reads the fallback lazily, untracked, only when it is shown.
30
+ * @returns The output accessor.
31
+ * @throws TypeError (production message `SHADOW_STALE_ACCESSOR`) from the accessor handed to a
32
+ * callback child, when it is read after its branch was replaced.
33
+ * @internal
34
+ * @since 1.0.0
35
+ */
36
+ function createBranches(name, select, fallback) {
37
+ /** Selection computed most recently; its `read` is always current, unlike the held value. */
38
+ let latest;
39
+ /** The branch on screen, and what the output last returned. The transition layer reads and writes it. */
40
+ const state = { live: void 0 };
41
+ /** The transition layer, created by the first transition that replaces the branch on screen. */
42
+ let swap;
43
+ /** The slot's owner: the transition layer's holder for the branches it builds lives under it. */
44
+ const owner = getOwner();
45
+ const pick = () => {
46
+ const next = select();
47
+ latest = next;
48
+ const live = state.live;
49
+ if (live !== void 0 && next.index === live.owned.index) live.owned.value = next.when;
50
+ return next;
51
+ };
52
+ const selection = useMemo(pick, { equals: sameChoice });
53
+ const accessorFor = (owned) => {
54
+ return () => {
55
+ if (owned.disposing) return owned.value;
56
+ const current = untrack(selection);
57
+ if (current.index !== owned.index) throw new TypeError(`ShadowJS ${name}: stale accessor. The branch was replaced; read the accessor only while its condition is truthy.`);
58
+ return (latest ?? current).read();
59
+ };
60
+ };
61
+ /**
62
+ * The value a branch (or the fallback) produces. `eager` evaluates a zero-argument accessor now (a
63
+ * transition build needs to see whether a read was held); otherwise it is evaluated when rendered.
64
+ */
65
+ const produce = (choice, owned, eager) => {
66
+ if (choice.index === -1) return untrack(fallback);
67
+ const body = choice.body();
68
+ if (typeof body !== "function") return body;
69
+ if (body.length === 0) return useMemo(() => body(), {
70
+ allowWrites: true,
71
+ lazy: !eager
72
+ });
73
+ const callback = body;
74
+ return untrack(() => callback(choice.keyed ? choice.when : accessorFor(owned)));
75
+ };
76
+ return useMemo(() => {
77
+ const choice = selection();
78
+ if (swap === void 0 && state.live !== void 0) swap = transitionHooks()?.slotSwap(state, produce, sameChoice, owner);
79
+ if (swap?.step(choice)) return state.live?.result;
80
+ if (state.live !== void 0) state.live.owned.disposing = false;
81
+ state.live = void 0;
82
+ const owned = {
83
+ index: choice.index,
84
+ value: choice.when,
85
+ disposing: false
86
+ };
87
+ const result = produce(choice, owned, false);
88
+ createRoot(() => {
89
+ onCleanup(() => {
90
+ owned.disposing = true;
91
+ });
92
+ });
93
+ state.live = {
94
+ choice,
95
+ owned,
96
+ result
97
+ };
98
+ return result;
99
+ }, { allowWrites: true });
100
+ }
101
+ export { createBranches };
102
+
103
+ //# sourceMappingURL=branch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"branch.js","names":[],"sources":["../../../src/control-flow/branch.ts"],"sourcesContent":["import { type Accessor, createRoot, getOwner, onCleanup, untrack, useMemo } from \"@shadow-js/core\";\nimport {\n type SlotBranch,\n type SlotOwned,\n type SlotState,\n type SlotSwap,\n transitionHooks,\n} from \"@shadow-js/core/extend\";\n\n/**\n * Branch index meaning \"no branch is selected\": the fallback is shown.\n * @internal\n */\nexport const FALLBACK = -1;\n\n/**\n * One selection made by a control-flow component.\n *\n * - `index` names the chosen branch, or {@link FALLBACK}.\n * - `keyed` and `when` decide whether a change of selection rebuilds the branch.\n * - `read` reads the condition reactively; the callback child's accessor argument uses it.\n * - `body` reads the branch's children getter. It is read tracked: a compiled `children` getter\n * that is a plain reactive expression (`{count()}`) must update the output. Creating child JSX\n * reads nothing here, because components and bindings track inside their own computations.\n *\n * @internal\n * @since 1.0.0\n */\nexport interface Choice {\n /** The chosen branch: a zero-based position, or {@link FALLBACK} when no branch is chosen. */\n readonly index: number;\n /** True when a change of `when` (by identity) rebuilds the branch even if `index` is the same. */\n readonly keyed: boolean;\n /** The value of the condition at selection time; a keyed callback child receives it. */\n readonly when: unknown;\n /** Reads the current value of the condition, tracked; backs the callback child's accessor. */\n readonly read: () => unknown;\n /** Reads the chosen branch's children (content, an accessor, or a callback), tracked. */\n readonly body: () => unknown;\n}\n\n/** Bookkeeping for the branch that is on screen. */\ntype Rendered = SlotOwned;\n\n/** A branch on screen, or one a transition builds (see the transition layer in core's concurrency.ts). */\ntype Live = SlotBranch<Choice>;\n\n/**\n * Whether two selections describe the same rendered output. Non-keyed branches only care about\n * which branch is chosen, which is the same as comparing truthiness of the condition. Keyed\n * branches also rebuild when the condition's identity changes. The fallback never rebuilds.\n */\nfunction sameChoice(a: Choice, b: Choice): boolean {\n if (a.index !== b.index) return false;\n return a.index === FALLBACK || !a.keyed || a.when === b.when;\n}\n\n/**\n * Builds the accessor behind `Show` and `Switch`. The selection memo decides which branch is chosen;\n * the output memo commits it.\n *\n * Ordinary changes build the branch inside the output memo: the memo's teardown removes the previous\n * branch first. A change made during a transition, while a branch is on screen, is handled by the\n * transition layer (core's `slotSwap`, reached through `transitionHooks`), created by the first such change: it builds the\n * new branch under a hold and commits it once its reads have settled. Until then the shown branch stays\n * on screen, its DOM untouched, and nothing is built twice. Apps that never change a shown branch in a\n * transition never create that layer.\n *\n * Teardown ordering: the owner of a branch is marked `disposing` before it is torn down, so a cleanup\n * that reads the callback's accessor learns that the branch is going away and gets the last truthy\n * value instead of a stale-accessor error.\n *\n * @param name Component name used in diagnostics.\n * @param select Tracked selection; runs inside the selection memo.\n * @param fallback Reads the fallback lazily, untracked, only when it is shown.\n * @returns The output accessor.\n * @throws TypeError (production message `SHADOW_STALE_ACCESSOR`) from the accessor handed to a\n * callback child, when it is read after its branch was replaced.\n * @internal\n * @since 1.0.0\n */\nexport function createBranches(\n name: string,\n select: () => Choice,\n fallback: () => unknown,\n): Accessor<unknown> {\n /** Selection computed most recently; its `read` is always current, unlike the held value. */\n let latest: Choice | undefined;\n /** The branch on screen, and what the output last returned. The transition layer reads and writes it. */\n const state: SlotState<Choice> = { live: undefined };\n /** The transition layer, created by the first transition that replaces the branch on screen. */\n let swap: SlotSwap<Choice> | undefined;\n /** The slot's owner: the transition layer's holder for the branches it builds lives under it. */\n const owner = getOwner();\n\n const pick = (): Choice => {\n const next = select();\n latest = next;\n const live: Live | undefined = state.live;\n if (live !== undefined && next.index === live.owned.index) live.owned.value = next.when;\n return next;\n };\n const selection = useMemo<Choice>(pick, { equals: sameChoice });\n\n const accessorFor = (owned: Rendered): (() => unknown) => {\n return () => {\n if (owned.disposing) return owned.value;\n const current = untrack(selection);\n if (current.index !== owned.index) {\n throw new TypeError(\n __DEV__\n ? `ShadowJS ${name}: stale accessor. The branch was replaced; read the accessor only while its condition is truthy.`\n : \"SHADOW_STALE_ACCESSOR\",\n );\n }\n return (latest ?? current).read();\n };\n };\n\n /**\n * The value a branch (or the fallback) produces. `eager` evaluates a zero-argument accessor now (a\n * transition build needs to see whether a read was held); otherwise it is evaluated when rendered.\n */\n const produce = (choice: Choice, owned: Rendered, eager: boolean): unknown => {\n if (choice.index === FALLBACK) return untrack(fallback);\n const body = choice.body();\n if (typeof body !== \"function\") return body;\n // A zero-argument function is an accessor. Returned as it is, the renderer would call it in an\n // effect outside this branch, so an error it throws would escape the boundary around the Show\n // (STATUS: ErrorBoundary does not catch a Show function child). A memo owned here evaluates it\n // inside the branch, where the nearest error handler applies.\n if (body.length === 0) {\n // Lazy outside a transition: the parent evaluates it when it renders, so a deep chain of\n // branches is built in that render rather than inside this one.\n return useMemo<unknown>(() => (body as () => unknown)(), {\n allowWrites: true,\n lazy: !eager,\n });\n }\n const callback = body as (value: unknown) => unknown;\n return untrack(() => callback(choice.keyed ? choice.when : accessorFor(owned)));\n };\n\n return useMemo<unknown>(\n () => {\n const choice = selection();\n if (swap === undefined && state.live !== undefined) {\n swap = transitionHooks()?.slotSwap(state, produce, sameChoice, owner);\n }\n if (swap?.step(choice)) return state.live?.result;\n\n // The usual path: the previous branch was torn down by this memo (its teardown marked it disposing;\n // the flag is cleared again, so a stale accessor throws). Build the next one here.\n if (state.live !== undefined) state.live.owned.disposing = false;\n state.live = undefined;\n const owned: Rendered = { index: choice.index, value: choice.when, disposing: false };\n const result = produce(choice, owned, false);\n // Created last, so it is the newest child: the memo's teardown marks the branch first.\n createRoot(() => {\n onCleanup(() => {\n owned.disposing = true;\n });\n });\n state.live = { choice, owned, result };\n return result;\n },\n { allowWrites: true },\n );\n}\n"],"mappings":";;;;;;;AAoDA,SAAS,WAAW,GAAW,GAAoB;CACjD,IAAI,EAAE,UAAU,EAAE,OAAO,OAAO;CAChC,OAAO,EAAE,UAAA,MAAsB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE;AAC1D;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,eACd,MACA,QACA,UACmB;;CAEnB,IAAI;;CAEJ,MAAM,QAA2B,EAAE,MAAM,KAAA,EAAU;;CAEnD,IAAI;;CAEJ,MAAM,QAAQ,SAAS;CAEvB,MAAM,aAAqB;EACzB,MAAM,OAAO,OAAO;EACpB,SAAS;EACT,MAAM,OAAyB,MAAM;EACrC,IAAI,SAAS,KAAA,KAAa,KAAK,UAAU,KAAK,MAAM,OAAO,KAAK,MAAM,QAAQ,KAAK;EACnF,OAAO;CACT;CACA,MAAM,YAAY,QAAgB,MAAM,EAAE,QAAQ,WAAW,CAAC;CAE9D,MAAM,eAAe,UAAqC;EACxD,aAAa;GACX,IAAI,MAAM,WAAW,OAAO,MAAM;GAClC,MAAM,UAAU,QAAQ,SAAS;GACjC,IAAI,QAAQ,UAAU,MAAM,OAC1B,MAAM,IAAI,UAEJ,YAAY,KAAK,iGAEvB;GAEF,QAAQ,UAAU,QAAA,CAAS,KAAK;EAClC;CACF;;;;;CAMA,MAAM,WAAW,QAAgB,OAAiB,UAA4B;EAC5E,IAAI,OAAO,UAAA,IAAoB,OAAO,QAAQ,QAAQ;EACtD,MAAM,OAAO,OAAO,KAAK;EACzB,IAAI,OAAO,SAAS,YAAY,OAAO;EAKvC,IAAI,KAAK,WAAW,GAGlB,OAAO,cAAwB,KAAuB,GAAG;GACvD,aAAa;GACb,MAAM,CAAC;EACT,CAAC;EAEH,MAAM,WAAW;EACjB,OAAO,cAAc,SAAS,OAAO,QAAQ,OAAO,OAAO,YAAY,KAAK,CAAC,CAAC;CAChF;CAEA,OAAO,cACC;EACJ,MAAM,SAAS,UAAU;EACzB,IAAI,SAAS,KAAA,KAAa,MAAM,SAAS,KAAA,GACvC,OAAO,gBAAgB,CAAC,EAAE,SAAS,OAAO,SAAS,YAAY,KAAK;EAEtE,IAAI,MAAM,KAAK,MAAM,GAAG,OAAO,MAAM,MAAM;EAI3C,IAAI,MAAM,SAAS,KAAA,GAAW,MAAM,KAAK,MAAM,YAAY;EAC3D,MAAM,OAAO,KAAA;EACb,MAAM,QAAkB;GAAE,OAAO,OAAO;GAAO,OAAO,OAAO;GAAM,WAAW;EAAM;EACpF,MAAM,SAAS,QAAQ,QAAQ,OAAO,KAAK;EAE3C,iBAAiB;GACf,gBAAgB;IACd,MAAM,YAAY;GACpB,CAAC;EACH,CAAC;EACD,MAAM,OAAO;GAAE;GAAQ;GAAO;EAAO;EACrC,OAAO;CACT,GACA,EAAE,aAAa,KAAK,CACtB;AACF"}
@@ -0,0 +1,49 @@
1
+ import { Show } from "./show.js";
2
+ import { onMount, useSignal } from "@shadow-js/core";
3
+ // src/control-flow/client-only.ts
4
+ /**
5
+ * Renders `children` in the browser only. The server (and the first client pass, which must match
6
+ * the server's markup) renders `fallback`; once mounted, the children replace it. Use it for
7
+ * content that depends on browser state: `window`, `localStorage`, media queries, charts.
8
+ *
9
+ * @param props See {@link ClientOnlyProps}.
10
+ * @returns An accessor of the current content: the fallback until mount, then the children.
11
+ * @example
12
+ * import { useSignal } from "@shadow-js/core";
13
+ * import { ClientOnly } from "@shadow-js/web";
14
+ *
15
+ * function Chart(props: { data: number[] }) {
16
+ * return <canvas data-points={props.data.length} />;
17
+ * }
18
+ *
19
+ * function Report() {
20
+ * const [rows] = useSignal([1, 2, 3]);
21
+ * return (
22
+ * <ClientOnly fallback={<p>Loading chart...</p>}>
23
+ * <Chart data={rows()} />
24
+ * </ClientOnly>
25
+ * );
26
+ * }
27
+ * @see Show
28
+ * @since 1.0.0
29
+ */
30
+ function ClientOnly(props) {
31
+ const [mounted, setMounted] = useSignal(false);
32
+ onMount(() => {
33
+ setMounted(true);
34
+ });
35
+ return Show({
36
+ get when() {
37
+ return mounted();
38
+ },
39
+ get fallback() {
40
+ return props.fallback;
41
+ },
42
+ get children() {
43
+ return props.children;
44
+ }
45
+ });
46
+ }
47
+ export { ClientOnly };
48
+
49
+ //# sourceMappingURL=client-only.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client-only.js","names":[],"sources":["../../../src/control-flow/client-only.ts"],"sourcesContent":["import { type Accessor, onMount, useSignal } from \"@shadow-js/core\";\nimport type { JsxChild } from \"../jsx/types\";\nimport { Show } from \"./show\";\n\n/**\n * Props of {@link ClientOnly}.\n * @since 1.0.0\n */\nexport interface ClientOnlyProps {\n /**\n * Rendered on the server and while the page hydrates, until the browser has mounted.\n * @default undefined (nothing is rendered until mount)\n */\n readonly fallback?: JsxChild;\n /**\n * Rendered in the browser only, after mount.\n * @default undefined (nothing is rendered after mount either)\n */\n readonly children?: JsxChild | (() => unknown);\n}\n\n/**\n * Renders `children` in the browser only. The server (and the first client pass, which must match\n * the server's markup) renders `fallback`; once mounted, the children replace it. Use it for\n * content that depends on browser state: `window`, `localStorage`, media queries, charts.\n *\n * @param props See {@link ClientOnlyProps}.\n * @returns An accessor of the current content: the fallback until mount, then the children.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { ClientOnly } from \"@shadow-js/web\";\n *\n * function Chart(props: { data: number[] }) {\n * return <canvas data-points={props.data.length} />;\n * }\n *\n * function Report() {\n * const [rows] = useSignal([1, 2, 3]);\n * return (\n * <ClientOnly fallback={<p>Loading chart...</p>}>\n * <Chart data={rows()} />\n * </ClientOnly>\n * );\n * }\n * @see Show\n * @since 1.0.0\n */\nexport function ClientOnly(props: ClientOnlyProps): Accessor<unknown> {\n const [mounted, setMounted] = useSignal(false);\n // Never runs on the server, so the server always renders the fallback.\n onMount(() => {\n setMounted(true);\n });\n return Show({\n get when() {\n return mounted();\n },\n get fallback() {\n return props.fallback;\n },\n get children() {\n return props.children;\n },\n });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,WAAW,OAA2C;CACpE,MAAM,CAAC,SAAS,cAAc,UAAU,KAAK;CAE7C,cAAc;EACZ,WAAW,IAAI;CACjB,CAAC;CACD,OAAO,KAAK;EACV,IAAI,OAAO;GACT,OAAO,QAAQ;EACjB;EACA,IAAI,WAAW;GACb,OAAO,MAAM;EACf;EACA,IAAI,WAAW;GACb,OAAO,MAAM;EACf;CACF,CAAC;AACH"}
@@ -0,0 +1,105 @@
1
+ import { createComponent } from "../component.js";
2
+ import { ssrElement, ssrRaw } from "../server/element.js";
3
+ import { mergeProps, splitProps, untrack, useMemo } from "@shadow-js/core";
4
+ // src/control-flow/dynamic.ts
5
+ /** Shape of a tag name: a letter, then letters, digits or dashes. Anything else is refused. */
6
+ const TAG_PATTERN = /^[a-z][a-z0-9-]*$/i;
7
+ /** Tags refused in any letter case: a script would bypass CSP nonces and Trusted Types. */
8
+ const DENIED_TAGS = /* @__PURE__ */ new Set(["script"]);
9
+ /**
10
+ * Creates an element for a validated tag name and applies the props to it, children included.
11
+ * The namespace comes from the tag: SVG-only names get the SVG namespace, the rest are HTML.
12
+ * On the server it renders the element as markup (with the hydration key and the children region
13
+ * the client adopts); while hydrating it claims that element instead of creating one.
14
+ */
15
+ function buildElement(tag, props) {
16
+ const lower = tag.toLowerCase();
17
+ if (!TAG_PATTERN.test(tag) || DENIED_TAGS.has(lower)) throw new TypeError("ShadowJS Dynamic: invalid tag");
18
+ return ssrElement(tag, props, () => {
19
+ const { children } = props;
20
+ return children === void 0 ? void 0 : [
21
+ ssrRaw("<!--[-->"),
22
+ children,
23
+ ssrRaw("<!--]-->")
24
+ ];
25
+ }, true);
26
+ }
27
+ /**
28
+ * Renders one value of `component`: nothing for a falsy value, an element for a tag name, the
29
+ * component's result for a function. Anything else is a TypeError.
30
+ */
31
+ function buildTarget(target, props) {
32
+ if (!target) return null;
33
+ if (typeof target === "string") return buildElement(target, props);
34
+ if (typeof target === "function") return createComponent(target, props);
35
+ throw new TypeError("ShadowJS Dynamic: component must be a string, a function, or a falsy value.");
36
+ }
37
+ /**
38
+ * Renders a component function or an element chosen by a tag name, and re-renders when
39
+ * `component` changes. Only `component` is tracked: the rest of the props are passed through
40
+ * reactive, so changing them updates the rendered output without rebuilding it. Swapping
41
+ * `component` disposes the old subtree, cleanups included, and builds the new one once. A falsy
42
+ * `component` renders nothing.
43
+ *
44
+ * Tag names are checked against `^[a-z][a-z0-9-]*$` (case-insensitive) and `script` is refused, so
45
+ * data-driven tags cannot inject markup. SVG-only names (`circle`, `path`, `svg`, ...) are created
46
+ * in the SVG namespace.
47
+ *
48
+ * @param props `component` and the props of what it renders.
49
+ * @returns An accessor of the rendered output, to be inserted by the caller.
50
+ * @throws TypeError for an invalid tag name or a component that is neither a string nor a function
51
+ * (at read time, which is when the caller inserts it).
52
+ * @example
53
+ * import { createRoot, useSignal } from "@shadow-js/core";
54
+ * import { Dynamic, insert } from "@shadow-js/web";
55
+ *
56
+ * const parent = document.createElement("div");
57
+ * createRoot(() => {
58
+ * const [level] = useSignal(1);
59
+ * insert(
60
+ * parent,
61
+ * Dynamic({
62
+ * get component() {
63
+ * return level() === 1 ? "h1" : "h2";
64
+ * },
65
+ * children: "Title",
66
+ * }),
67
+ * );
68
+ * });
69
+ * @see createDynamic
70
+ * @since 1.0.0
71
+ */
72
+ function Dynamic(props) {
73
+ const [, rest] = splitProps(props, ["component"]);
74
+ return useMemo(() => {
75
+ const target = props.component;
76
+ return untrack(() => buildTarget(target, rest));
77
+ }, { allowWrites: true });
78
+ }
79
+ /**
80
+ * Function form of {@link Dynamic}, for code that is not JSX: renders what `component()` returns (a
81
+ * component, a tag name or a falsy value) with `props`, and follows it when it changes.
82
+ *
83
+ * @param component Accessor of the target.
84
+ * @param props The props of what it renders (reactive getters stay reactive).
85
+ * @returns An accessor of the rendered output.
86
+ * @example
87
+ * import { createRoot, useSignal } from "@shadow-js/core";
88
+ * import { createDynamic, insert } from "@shadow-js/web";
89
+ *
90
+ * const parent = document.createElement("div");
91
+ * createRoot(() => {
92
+ * const [level] = useSignal(1);
93
+ * insert(parent, createDynamic(() => (level() === 1 ? "h1" : "h2"), { children: "Title" }));
94
+ * });
95
+ * @see Dynamic
96
+ * @since 1.0.0
97
+ */
98
+ function createDynamic(component, props = {}) {
99
+ return Dynamic(mergeProps({ get component() {
100
+ return component();
101
+ } }, props));
102
+ }
103
+ export { Dynamic, createDynamic };
104
+
105
+ //# sourceMappingURL=dynamic.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dynamic.js","names":[],"sources":["../../../src/control-flow/dynamic.ts"],"sourcesContent":["import { mergeProps, splitProps, untrack, useMemo } from \"@shadow-js/core\";\nimport { createComponent } from \"../component\";\nimport { bindRegion, claims, createRegion, nextKey, SVG_NS } from \"../extend\";\nimport { ssrElement, ssrRaw } from \"../server/element\";\nimport { spread } from \"../spread\";\n\n/**\n * A component function or a tag name, as {@link Dynamic} accepts it. The props of a function are\n * checked by the caller.\n * @since 1.0.0\n */\nexport type DynamicComponent = string | ((props: never) => unknown);\n\n/**\n * Everything `component` may be: a component, a tag name, or `undefined`, `null` or `false`, which\n * render nothing.\n * @since 1.0.0\n */\nexport type DynamicTarget = DynamicComponent | undefined | null | false;\n\n/**\n * Props of {@link Dynamic}: `component` plus the props of whatever it renders. Every other prop\n * passes through, reactive getters included.\n * @since 1.0.0\n */\nexport interface DynamicProps<C extends DynamicTarget = DynamicTarget> {\n /** The component to render, a tag name, or a falsy value for nothing. */\n readonly component: C;\n /** Any other prop is passed to the rendered component or set on the element, still reactive. */\n readonly [prop: string]: unknown;\n}\n\n/** Tag names that take the SVG namespace. Anything else is HTML. */\nconst SVG_TAGS: ReadonlySet<string> = new Set([\n \"svg\",\n \"g\",\n \"path\",\n \"circle\",\n \"ellipse\",\n \"line\",\n \"polygon\",\n \"polyline\",\n \"rect\",\n \"text\",\n \"tspan\",\n \"textpath\",\n \"defs\",\n \"use\",\n \"symbol\",\n \"marker\",\n \"clippath\",\n \"mask\",\n \"pattern\",\n \"lineargradient\",\n \"radialgradient\",\n \"stop\",\n \"filter\",\n]);\n\n/** Shape of a tag name: a letter, then letters, digits or dashes. Anything else is refused. */\nconst TAG_PATTERN = /^[a-z][a-z0-9-]*$/i;\n\n/** Tags refused in any letter case: a script would bypass CSP nonces and Trusted Types. */\nconst DENIED_TAGS: ReadonlySet<string> = new Set([\"script\"]);\n\n/**\n * Creates an element for a validated tag name and applies the props to it, children included.\n * The namespace comes from the tag: SVG-only names get the SVG namespace, the rest are HTML.\n * On the server it renders the element as markup (with the hydration key and the children region\n * the client adopts); while hydrating it claims that element instead of creating one.\n */\nfunction buildElement(tag: string, props: object): unknown {\n const lower = tag.toLowerCase();\n if (!TAG_PATTERN.test(tag) || DENIED_TAGS.has(lower)) {\n throw new TypeError(__DEV__ ? \"ShadowJS Dynamic: invalid tag\" : \"SHADOW_DYNAMIC_TAG\");\n }\n if (__SERVER__) {\n // The children are read lazily, after `ssrElement` took the element's hydration key: the client\n // claims the element first and builds its children second, so the keys must be drawn in that\n // order here too, or a component inside the element and every sibling after it would miss.\n return ssrElement(\n tag,\n props,\n () => {\n const { children } = props as { children?: unknown };\n return children === undefined\n ? undefined\n : [ssrRaw(\"<!--[-->\"), children, ssrRaw(\"<!--]-->\")];\n },\n true,\n );\n }\n const svg = SVG_TAGS.has(lower);\n const claimed = claims.current.claimElement(nextKey());\n const el = claimed ?? (svg ? document.createElementNS(SVG_NS, tag) : document.createElement(tag));\n // Attributes through spread; children through insert, which adopts the server's children region.\n spread(el, props, svg, true);\n const region = createRegion(el, null, claims.current.takeRegion(el, null));\n bindRegion(region, () => (props as { children?: unknown }).children);\n return el;\n}\n\n/**\n * Renders one value of `component`: nothing for a falsy value, an element for a tag name, the\n * component's result for a function. Anything else is a TypeError.\n */\nfunction buildTarget(target: unknown, props: object): unknown {\n if (!target) return null;\n if (typeof target === \"string\") return buildElement(target, props);\n if (typeof target === \"function\") {\n return createComponent(target as (props: object) => unknown, props);\n }\n throw new TypeError(\n __DEV__\n ? \"ShadowJS Dynamic: component must be a string, a function, or a falsy value.\"\n : \"SHADOW_DYNAMIC_COMPONENT\",\n );\n}\n\n/**\n * Renders a component function or an element chosen by a tag name, and re-renders when\n * `component` changes. Only `component` is tracked: the rest of the props are passed through\n * reactive, so changing them updates the rendered output without rebuilding it. Swapping\n * `component` disposes the old subtree, cleanups included, and builds the new one once. A falsy\n * `component` renders nothing.\n *\n * Tag names are checked against `^[a-z][a-z0-9-]*$` (case-insensitive) and `script` is refused, so\n * data-driven tags cannot inject markup. SVG-only names (`circle`, `path`, `svg`, ...) are created\n * in the SVG namespace.\n *\n * @param props `component` and the props of what it renders.\n * @returns An accessor of the rendered output, to be inserted by the caller.\n * @throws TypeError for an invalid tag name or a component that is neither a string nor a function\n * (at read time, which is when the caller inserts it).\n * @example\n * import { createRoot, useSignal } from \"@shadow-js/core\";\n * import { Dynamic, insert } from \"@shadow-js/web\";\n *\n * const parent = document.createElement(\"div\");\n * createRoot(() => {\n * const [level] = useSignal(1);\n * insert(\n * parent,\n * Dynamic({\n * get component() {\n * return level() === 1 ? \"h1\" : \"h2\";\n * },\n * children: \"Title\",\n * }),\n * );\n * });\n * @see createDynamic\n * @since 1.0.0\n */\nexport function Dynamic<C extends DynamicTarget>(props: DynamicProps<C>): () => unknown {\n const [, rest] = splitProps(props, [\"component\"]);\n // The component is built inside this memo, so its setup (or a ref, or a directive) may write signals.\n return useMemo(\n (): unknown => {\n const target: unknown = props.component;\n return untrack(() => buildTarget(target, rest));\n },\n { allowWrites: true },\n );\n}\n\n/**\n * Function form of {@link Dynamic}, for code that is not JSX: renders what `component()` returns (a\n * component, a tag name or a falsy value) with `props`, and follows it when it changes.\n *\n * @param component Accessor of the target.\n * @param props The props of what it renders (reactive getters stay reactive).\n * @returns An accessor of the rendered output.\n * @example\n * import { createRoot, useSignal } from \"@shadow-js/core\";\n * import { createDynamic, insert } from \"@shadow-js/web\";\n *\n * const parent = document.createElement(\"div\");\n * createRoot(() => {\n * const [level] = useSignal(1);\n * insert(parent, createDynamic(() => (level() === 1 ? \"h1\" : \"h2\"), { children: \"Title\" }));\n * });\n * @see Dynamic\n * @since 1.0.0\n */\nexport function createDynamic<C extends DynamicTarget>(\n component: () => C,\n props: object = {},\n): () => unknown {\n return Dynamic(\n mergeProps(\n {\n get component(): C {\n return component();\n },\n },\n props,\n ) as DynamicProps<C>,\n );\n}\n"],"mappings":";;;;;AA4DA,MAAM,cAAc;;AAGpB,MAAM,8BAAmC,IAAI,IAAI,CAAC,QAAQ,CAAC;;;;;;;AAQ3D,SAAS,aAAa,KAAa,OAAwB;CACzD,MAAM,QAAQ,IAAI,YAAY;CAC9B,IAAI,CAAC,YAAY,KAAK,GAAG,KAAK,YAAY,IAAI,KAAK,GACjD,MAAM,IAAI,UAAoB,+BAAsD;CAMpF,OAAO,WACL,KACA,aACM;EACJ,MAAM,EAAE,aAAa;EACrB,OAAO,aAAa,KAAA,IAChB,KAAA,IACA;GAAC,OAAO,UAAU;GAAG;GAAU,OAAO,UAAU;EAAC;CACvD,GACA,IACF;AAUJ;;;;;AAMA,SAAS,YAAY,QAAiB,OAAwB;CAC5D,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,WAAW,UAAU,OAAO,aAAa,QAAQ,KAAK;CACjE,IAAI,OAAO,WAAW,YACpB,OAAO,gBAAgB,QAAsC,KAAK;CAEpE,MAAM,IAAI,UAEJ,6EAEN;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,QAAiC,OAAuC;CACtF,MAAM,GAAG,QAAQ,WAAW,OAAO,CAAC,WAAW,CAAC;CAEhD,OAAO,cACU;EACb,MAAM,SAAkB,MAAM;EAC9B,OAAO,cAAc,YAAY,QAAQ,IAAI,CAAC;CAChD,GACA,EAAE,aAAa,KAAK,CACtB;AACF;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cACd,WACA,QAAgB,CAAC,GACF;CACf,OAAO,QACL,WACE,EACE,IAAI,YAAe;EACjB,OAAO,UAAU;CACnB,EACF,GACA,KACF,CACF;AACF"}