@shadow-js/core 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (387) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/LICENSE +2 -2
  3. package/README.md +134 -331
  4. package/dist/dev/action.d.ts +36 -0
  5. package/dist/dev/action.js +90 -0
  6. package/dist/dev/action.js.map +1 -0
  7. package/dist/dev/cache.d.ts +35 -0
  8. package/dist/dev/cache.js +62 -0
  9. package/dist/dev/cache.js.map +1 -0
  10. package/dist/dev/context.d.ts +106 -0
  11. package/dist/dev/context.js +111 -0
  12. package/dist/dev/context.js.map +1 -0
  13. package/dist/dev/effect.d.ts +122 -0
  14. package/dist/dev/effect.js +111 -0
  15. package/dist/dev/effect.js.map +1 -0
  16. package/dist/dev/env.d.ts +29 -0
  17. package/dist/dev/env.js +31 -0
  18. package/dist/dev/env.js.map +1 -0
  19. package/dist/dev/events.d.ts +28 -0
  20. package/dist/dev/events.js +33 -0
  21. package/dist/dev/events.js.map +1 -0
  22. package/dist/dev/extend/index.d.ts +331 -0
  23. package/dist/dev/extend/index.js +317 -0
  24. package/dist/dev/extend/index.js.map +1 -0
  25. package/dist/dev/external-store.d.ts +60 -0
  26. package/dist/dev/external-store.js +60 -0
  27. package/dist/dev/external-store.js.map +1 -0
  28. package/dist/dev/index.d.ts +29 -0
  29. package/dist/dev/index.js +26 -0
  30. package/dist/dev/internal/concurrency.d.ts +213 -0
  31. package/dist/dev/internal/concurrency.js +632 -0
  32. package/dist/dev/internal/concurrency.js.map +1 -0
  33. package/dist/dev/internal/devtools.d.ts +71 -0
  34. package/dist/dev/internal/devtools.js +77 -0
  35. package/dist/dev/internal/devtools.js.map +1 -0
  36. package/dist/dev/internal/diagnostics.d.ts +90 -0
  37. package/dist/dev/internal/diagnostics.js +102 -0
  38. package/dist/dev/internal/diagnostics.js.map +1 -0
  39. package/dist/dev/internal/dispose.d.ts +28 -0
  40. package/dist/dev/internal/dispose.js +49 -0
  41. package/dist/dev/internal/dispose.js.map +1 -0
  42. package/dist/dev/internal/flags.js +11 -0
  43. package/dist/dev/internal/flags.js.map +1 -0
  44. package/dist/dev/internal/graph.d.ts +233 -0
  45. package/dist/dev/internal/graph.js +578 -0
  46. package/dist/dev/internal/graph.js.map +1 -0
  47. package/dist/dev/internal/hydration-flag.d.ts +33 -0
  48. package/dist/dev/internal/hydration-flag.js +46 -0
  49. package/dist/dev/internal/hydration-flag.js.map +1 -0
  50. package/dist/dev/internal/messages.d.ts +56 -0
  51. package/dist/dev/internal/messages.js +54 -0
  52. package/dist/dev/internal/messages.js.map +1 -0
  53. package/dist/dev/internal/owner.d.ts +142 -0
  54. package/dist/dev/internal/owner.js +290 -0
  55. package/dist/dev/internal/owner.js.map +1 -0
  56. package/dist/dev/internal/queue.js +46 -0
  57. package/dist/dev/internal/queue.js.map +1 -0
  58. package/dist/dev/internal/scheduler.d.ts +113 -0
  59. package/dist/dev/internal/scheduler.js +287 -0
  60. package/dist/dev/internal/scheduler.js.map +1 -0
  61. package/dist/dev/internal/state.d.ts +141 -0
  62. package/dist/dev/internal/state.js +28 -0
  63. package/dist/dev/internal/state.js.map +1 -0
  64. package/dist/dev/internal/suspension.d.ts +43 -0
  65. package/dist/dev/internal/suspension.js +45 -0
  66. package/dist/dev/internal/suspension.js.map +1 -0
  67. package/dist/dev/internal/types.d.ts +46 -0
  68. package/dist/dev/list.d.ts +93 -0
  69. package/dist/dev/list.js +282 -0
  70. package/dist/dev/list.js.map +1 -0
  71. package/dist/dev/memo.d.ts +60 -0
  72. package/dist/dev/memo.js +41 -0
  73. package/dist/dev/memo.js.map +1 -0
  74. package/dist/dev/optimistic.d.ts +26 -0
  75. package/dist/dev/optimistic.js +45 -0
  76. package/dist/dev/optimistic.js.map +1 -0
  77. package/dist/dev/ownership.d.ts +204 -0
  78. package/dist/dev/ownership.js +261 -0
  79. package/dist/dev/ownership.js.map +1 -0
  80. package/dist/dev/props.d.ts +134 -0
  81. package/dist/dev/props.js +282 -0
  82. package/dist/dev/props.js.map +1 -0
  83. package/dist/dev/reaction.d.ts +29 -0
  84. package/dist/dev/reaction.js +61 -0
  85. package/dist/dev/reaction.js.map +1 -0
  86. package/dist/dev/reducer.d.ts +41 -0
  87. package/dist/dev/reducer.js +39 -0
  88. package/dist/dev/reducer.js.map +1 -0
  89. package/dist/dev/refs.d.ts +52 -0
  90. package/dist/dev/refs.js +58 -0
  91. package/dist/dev/refs.js.map +1 -0
  92. package/dist/dev/resource.d.ts +135 -0
  93. package/dist/dev/resource.js +177 -0
  94. package/dist/dev/resource.js.map +1 -0
  95. package/dist/dev/selector.d.ts +34 -0
  96. package/dist/dev/selector.js +118 -0
  97. package/dist/dev/selector.js.map +1 -0
  98. package/dist/dev/signal.d.ts +42 -0
  99. package/dist/dev/signal.js +39 -0
  100. package/dist/dev/signal.js.map +1 -0
  101. package/dist/dev/store/index.d.ts +5 -0
  102. package/dist/dev/store/index.js +4 -0
  103. package/dist/dev/store/nodes.js +192 -0
  104. package/dist/dev/store/nodes.js.map +1 -0
  105. package/dist/dev/store/proxies.js +160 -0
  106. package/dist/dev/store/proxies.js.map +1 -0
  107. package/dist/dev/store/read.d.ts +39 -0
  108. package/dist/dev/store/read.js +72 -0
  109. package/dist/dev/store/read.js.map +1 -0
  110. package/dist/dev/store/reconcile.d.ts +73 -0
  111. package/dist/dev/store/reconcile.js +186 -0
  112. package/dist/dev/store/reconcile.js.map +1 -0
  113. package/dist/dev/store/types.d.ts +106 -0
  114. package/dist/dev/store/use-store.d.ts +60 -0
  115. package/dist/dev/store/use-store.js +168 -0
  116. package/dist/dev/store/use-store.js.map +1 -0
  117. package/dist/dev/suspense.d.ts +101 -0
  118. package/dist/dev/suspense.js +45 -0
  119. package/dist/dev/suspense.js.map +1 -0
  120. package/dist/dev/transitions.d.ts +77 -0
  121. package/dist/dev/transitions.js +101 -0
  122. package/dist/dev/transitions.js.map +1 -0
  123. package/dist/prod/action.js +2 -0
  124. package/dist/prod/action.js.map +1 -0
  125. package/dist/prod/cache.js +2 -0
  126. package/dist/prod/cache.js.map +1 -0
  127. package/dist/prod/context.js +2 -0
  128. package/dist/prod/context.js.map +1 -0
  129. package/dist/prod/effect.js +2 -0
  130. package/dist/prod/effect.js.map +1 -0
  131. package/dist/prod/env.js +2 -0
  132. package/dist/prod/env.js.map +1 -0
  133. package/dist/prod/events.js +2 -0
  134. package/dist/prod/events.js.map +1 -0
  135. package/dist/prod/extend/index.js +2 -0
  136. package/dist/prod/extend/index.js.map +1 -0
  137. package/dist/prod/external-store.js +2 -0
  138. package/dist/prod/external-store.js.map +1 -0
  139. package/dist/prod/index.js +1 -0
  140. package/dist/prod/internal/concurrency.js +2 -0
  141. package/dist/prod/internal/concurrency.js.map +1 -0
  142. package/dist/prod/internal/devtools.js +2 -0
  143. package/dist/prod/internal/devtools.js.map +1 -0
  144. package/dist/prod/internal/diagnostics.js +2 -0
  145. package/dist/prod/internal/diagnostics.js.map +1 -0
  146. package/dist/prod/internal/dispose.js +2 -0
  147. package/dist/prod/internal/dispose.js.map +1 -0
  148. package/dist/prod/internal/flags.js +2 -0
  149. package/dist/prod/internal/flags.js.map +1 -0
  150. package/dist/prod/internal/graph.js +2 -0
  151. package/dist/prod/internal/graph.js.map +1 -0
  152. package/dist/prod/internal/hydration-flag.js +2 -0
  153. package/dist/prod/internal/hydration-flag.js.map +1 -0
  154. package/dist/prod/internal/messages.js +2 -0
  155. package/dist/prod/internal/messages.js.map +1 -0
  156. package/dist/prod/internal/owner.js +2 -0
  157. package/dist/prod/internal/owner.js.map +1 -0
  158. package/dist/prod/internal/queue.js +2 -0
  159. package/dist/prod/internal/queue.js.map +1 -0
  160. package/dist/prod/internal/scheduler.js +2 -0
  161. package/dist/prod/internal/scheduler.js.map +1 -0
  162. package/dist/prod/internal/state.js +2 -0
  163. package/dist/prod/internal/state.js.map +1 -0
  164. package/dist/prod/internal/suspension.js +2 -0
  165. package/dist/prod/internal/suspension.js.map +1 -0
  166. package/dist/prod/list.js +2 -0
  167. package/dist/prod/list.js.map +1 -0
  168. package/dist/prod/memo.js +2 -0
  169. package/dist/prod/memo.js.map +1 -0
  170. package/dist/prod/optimistic.js +2 -0
  171. package/dist/prod/optimistic.js.map +1 -0
  172. package/dist/prod/ownership.js +2 -0
  173. package/dist/prod/ownership.js.map +1 -0
  174. package/dist/prod/props.js +2 -0
  175. package/dist/prod/props.js.map +1 -0
  176. package/dist/prod/reaction.js +2 -0
  177. package/dist/prod/reaction.js.map +1 -0
  178. package/dist/prod/reducer.js +2 -0
  179. package/dist/prod/reducer.js.map +1 -0
  180. package/dist/prod/refs.js +2 -0
  181. package/dist/prod/refs.js.map +1 -0
  182. package/dist/prod/resource.js +2 -0
  183. package/dist/prod/resource.js.map +1 -0
  184. package/dist/prod/selector.js +2 -0
  185. package/dist/prod/selector.js.map +1 -0
  186. package/dist/prod/signal.js +2 -0
  187. package/dist/prod/signal.js.map +1 -0
  188. package/dist/prod/store/index.js +1 -0
  189. package/dist/prod/store/nodes.js +2 -0
  190. package/dist/prod/store/nodes.js.map +1 -0
  191. package/dist/prod/store/proxies.js +2 -0
  192. package/dist/prod/store/proxies.js.map +1 -0
  193. package/dist/prod/store/read.js +2 -0
  194. package/dist/prod/store/read.js.map +1 -0
  195. package/dist/prod/store/reconcile.js +2 -0
  196. package/dist/prod/store/reconcile.js.map +1 -0
  197. package/dist/prod/store/use-store.js +2 -0
  198. package/dist/prod/store/use-store.js.map +1 -0
  199. package/dist/prod/suspense.js +2 -0
  200. package/dist/prod/suspense.js.map +1 -0
  201. package/dist/prod/transitions.js +2 -0
  202. package/dist/prod/transitions.js.map +1 -0
  203. package/dist/server/action.js +2 -0
  204. package/dist/server/action.js.map +1 -0
  205. package/dist/server/cache.js +2 -0
  206. package/dist/server/cache.js.map +1 -0
  207. package/dist/server/context.js +2 -0
  208. package/dist/server/context.js.map +1 -0
  209. package/dist/server/effect.js +2 -0
  210. package/dist/server/effect.js.map +1 -0
  211. package/dist/server/env.js +2 -0
  212. package/dist/server/env.js.map +1 -0
  213. package/dist/server/events.js +2 -0
  214. package/dist/server/events.js.map +1 -0
  215. package/dist/server/extend/index.js +2 -0
  216. package/dist/server/extend/index.js.map +1 -0
  217. package/dist/server/external-store.js +2 -0
  218. package/dist/server/external-store.js.map +1 -0
  219. package/dist/server/index.js +1 -0
  220. package/dist/server/internal/concurrency.js +2 -0
  221. package/dist/server/internal/concurrency.js.map +1 -0
  222. package/dist/server/internal/devtools.js +2 -0
  223. package/dist/server/internal/devtools.js.map +1 -0
  224. package/dist/server/internal/diagnostics.js +2 -0
  225. package/dist/server/internal/diagnostics.js.map +1 -0
  226. package/dist/server/internal/dispose.js +2 -0
  227. package/dist/server/internal/dispose.js.map +1 -0
  228. package/dist/server/internal/flags.js +2 -0
  229. package/dist/server/internal/flags.js.map +1 -0
  230. package/dist/server/internal/graph.js +2 -0
  231. package/dist/server/internal/graph.js.map +1 -0
  232. package/dist/server/internal/hydration-flag.js +2 -0
  233. package/dist/server/internal/hydration-flag.js.map +1 -0
  234. package/dist/server/internal/messages.js +2 -0
  235. package/dist/server/internal/messages.js.map +1 -0
  236. package/dist/server/internal/owner.js +2 -0
  237. package/dist/server/internal/owner.js.map +1 -0
  238. package/dist/server/internal/queue.js +2 -0
  239. package/dist/server/internal/queue.js.map +1 -0
  240. package/dist/server/internal/scheduler.js +2 -0
  241. package/dist/server/internal/scheduler.js.map +1 -0
  242. package/dist/server/internal/state.js +2 -0
  243. package/dist/server/internal/state.js.map +1 -0
  244. package/dist/server/internal/suspension.js +2 -0
  245. package/dist/server/internal/suspension.js.map +1 -0
  246. package/dist/server/list.js +2 -0
  247. package/dist/server/list.js.map +1 -0
  248. package/dist/server/memo.js +2 -0
  249. package/dist/server/memo.js.map +1 -0
  250. package/dist/server/optimistic.js +2 -0
  251. package/dist/server/optimistic.js.map +1 -0
  252. package/dist/server/ownership.js +2 -0
  253. package/dist/server/ownership.js.map +1 -0
  254. package/dist/server/props.js +2 -0
  255. package/dist/server/props.js.map +1 -0
  256. package/dist/server/reaction.js +2 -0
  257. package/dist/server/reaction.js.map +1 -0
  258. package/dist/server/reducer.js +2 -0
  259. package/dist/server/reducer.js.map +1 -0
  260. package/dist/server/refs.js +2 -0
  261. package/dist/server/refs.js.map +1 -0
  262. package/dist/server/resource.js +2 -0
  263. package/dist/server/resource.js.map +1 -0
  264. package/dist/server/selector.js +2 -0
  265. package/dist/server/selector.js.map +1 -0
  266. package/dist/server/signal.js +2 -0
  267. package/dist/server/signal.js.map +1 -0
  268. package/dist/server/store/index.js +1 -0
  269. package/dist/server/store/nodes.js +2 -0
  270. package/dist/server/store/nodes.js.map +1 -0
  271. package/dist/server/store/proxies.js +2 -0
  272. package/dist/server/store/proxies.js.map +1 -0
  273. package/dist/server/store/read.js +2 -0
  274. package/dist/server/store/read.js.map +1 -0
  275. package/dist/server/store/reconcile.js +2 -0
  276. package/dist/server/store/reconcile.js.map +1 -0
  277. package/dist/server/store/use-store.js +2 -0
  278. package/dist/server/store/use-store.js.map +1 -0
  279. package/dist/server/suspense.js +2 -0
  280. package/dist/server/suspense.js.map +1 -0
  281. package/dist/server/transitions.js +2 -0
  282. package/dist/server/transitions.js.map +1 -0
  283. package/dist/server-dev/action.js +90 -0
  284. package/dist/server-dev/action.js.map +1 -0
  285. package/dist/server-dev/cache.js +62 -0
  286. package/dist/server-dev/cache.js.map +1 -0
  287. package/dist/server-dev/context.js +108 -0
  288. package/dist/server-dev/context.js.map +1 -0
  289. package/dist/server-dev/effect.js +56 -0
  290. package/dist/server-dev/effect.js.map +1 -0
  291. package/dist/server-dev/env.js +31 -0
  292. package/dist/server-dev/env.js.map +1 -0
  293. package/dist/server-dev/events.js +33 -0
  294. package/dist/server-dev/events.js.map +1 -0
  295. package/dist/server-dev/extend/index.js +317 -0
  296. package/dist/server-dev/extend/index.js.map +1 -0
  297. package/dist/server-dev/external-store.js +46 -0
  298. package/dist/server-dev/external-store.js.map +1 -0
  299. package/dist/server-dev/index.js +26 -0
  300. package/dist/server-dev/internal/concurrency.js +633 -0
  301. package/dist/server-dev/internal/concurrency.js.map +1 -0
  302. package/dist/server-dev/internal/devtools.js +77 -0
  303. package/dist/server-dev/internal/devtools.js.map +1 -0
  304. package/dist/server-dev/internal/diagnostics.js +102 -0
  305. package/dist/server-dev/internal/diagnostics.js.map +1 -0
  306. package/dist/server-dev/internal/dispose.js +49 -0
  307. package/dist/server-dev/internal/dispose.js.map +1 -0
  308. package/dist/server-dev/internal/flags.js +11 -0
  309. package/dist/server-dev/internal/flags.js.map +1 -0
  310. package/dist/server-dev/internal/graph.js +578 -0
  311. package/dist/server-dev/internal/graph.js.map +1 -0
  312. package/dist/server-dev/internal/hydration-flag.js +46 -0
  313. package/dist/server-dev/internal/hydration-flag.js.map +1 -0
  314. package/dist/server-dev/internal/messages.js +54 -0
  315. package/dist/server-dev/internal/messages.js.map +1 -0
  316. package/dist/server-dev/internal/owner.js +290 -0
  317. package/dist/server-dev/internal/owner.js.map +1 -0
  318. package/dist/server-dev/internal/queue.js +46 -0
  319. package/dist/server-dev/internal/queue.js.map +1 -0
  320. package/dist/server-dev/internal/scheduler.js +287 -0
  321. package/dist/server-dev/internal/scheduler.js.map +1 -0
  322. package/dist/server-dev/internal/state.js +28 -0
  323. package/dist/server-dev/internal/state.js.map +1 -0
  324. package/dist/server-dev/internal/suspension.js +45 -0
  325. package/dist/server-dev/internal/suspension.js.map +1 -0
  326. package/dist/server-dev/list.js +282 -0
  327. package/dist/server-dev/list.js.map +1 -0
  328. package/dist/server-dev/memo.js +41 -0
  329. package/dist/server-dev/memo.js.map +1 -0
  330. package/dist/server-dev/optimistic.js +45 -0
  331. package/dist/server-dev/optimistic.js.map +1 -0
  332. package/dist/server-dev/ownership.js +261 -0
  333. package/dist/server-dev/ownership.js.map +1 -0
  334. package/dist/server-dev/props.js +282 -0
  335. package/dist/server-dev/props.js.map +1 -0
  336. package/dist/server-dev/reaction.js +61 -0
  337. package/dist/server-dev/reaction.js.map +1 -0
  338. package/dist/server-dev/reducer.js +39 -0
  339. package/dist/server-dev/reducer.js.map +1 -0
  340. package/dist/server-dev/refs.js +58 -0
  341. package/dist/server-dev/refs.js.map +1 -0
  342. package/dist/server-dev/resource.js +176 -0
  343. package/dist/server-dev/resource.js.map +1 -0
  344. package/dist/server-dev/selector.js +82 -0
  345. package/dist/server-dev/selector.js.map +1 -0
  346. package/dist/server-dev/signal.js +39 -0
  347. package/dist/server-dev/signal.js.map +1 -0
  348. package/dist/server-dev/store/index.js +4 -0
  349. package/dist/server-dev/store/nodes.js +192 -0
  350. package/dist/server-dev/store/nodes.js.map +1 -0
  351. package/dist/server-dev/store/proxies.js +160 -0
  352. package/dist/server-dev/store/proxies.js.map +1 -0
  353. package/dist/server-dev/store/read.js +72 -0
  354. package/dist/server-dev/store/read.js.map +1 -0
  355. package/dist/server-dev/store/reconcile.js +186 -0
  356. package/dist/server-dev/store/reconcile.js.map +1 -0
  357. package/dist/server-dev/store/use-store.js +168 -0
  358. package/dist/server-dev/store/use-store.js.map +1 -0
  359. package/dist/server-dev/suspense.js +45 -0
  360. package/dist/server-dev/suspense.js.map +1 -0
  361. package/dist/server-dev/transitions.js +86 -0
  362. package/dist/server-dev/transitions.js.map +1 -0
  363. package/package.json +111 -50
  364. package/dist/chunk-6Y3CCWOY.js +0 -887
  365. package/dist/chunk-6Y3CCWOY.js.map +0 -1
  366. package/dist/chunk-B5FTYDUG.js +0 -3
  367. package/dist/chunk-B5FTYDUG.js.map +0 -1
  368. package/dist/index.cjs +0 -2000
  369. package/dist/index.cjs.map +0 -1
  370. package/dist/index.d.cts +0 -609
  371. package/dist/index.d.ts +0 -609
  372. package/dist/index.js +0 -1094
  373. package/dist/index.js.map +0 -1
  374. package/dist/jsx-Bugil6CJ.d.cts +0 -151
  375. package/dist/jsx-Bugil6CJ.d.ts +0 -151
  376. package/dist/jsx-dev-runtime.cjs +0 -742
  377. package/dist/jsx-dev-runtime.cjs.map +0 -1
  378. package/dist/jsx-dev-runtime.d.cts +0 -2
  379. package/dist/jsx-dev-runtime.d.ts +0 -2
  380. package/dist/jsx-dev-runtime.js +0 -4
  381. package/dist/jsx-dev-runtime.js.map +0 -1
  382. package/dist/jsx-runtime.cjs +0 -742
  383. package/dist/jsx-runtime.cjs.map +0 -1
  384. package/dist/jsx-runtime.d.cts +0 -36
  385. package/dist/jsx-runtime.d.ts +0 -36
  386. package/dist/jsx-runtime.js +0 -4
  387. package/dist/jsx-runtime.js.map +0 -1
@@ -0,0 +1,633 @@
1
+ import { DEVTOOLS_EVENT, report } from "./devtools.js";
2
+ import { ShadowError } from "./diagnostics.js";
3
+ import { FLAG_PARKED, FLAG_SUSPENDED, FLAG_TRANSITION } from "./flags.js";
4
+ import { rt } from "./state.js";
5
+ import { Owner, addCleanup, handleError } from "./owner.js";
6
+ import { clearQueues, hasPending, place, renderQueue, userQueue } from "./queue.js";
7
+ import { Computation, Signal, hasObservers, markObservers, readSignal, recompute, updateIfNecessary } from "./graph.js";
8
+ import { byCreation, isOrdered, reportUncaught, schedule } from "./scheduler.js";
9
+ import { runWithContext } from "../context.js";
10
+ import { SuspenseContext } from "../suspense.js";
11
+ import { disposeTree } from "./dispose.js";
12
+ import { SUSPENSION, isSuspension } from "./suspension.js";
13
+ //#region src/internal/concurrency.ts
14
+ /** Transition-lane effects run per macrotask; between two chunks urgent work and input can run. */
15
+ const LANE_CHUNK = 64;
16
+ /** Visits `root` and every node below it. Iterative: the depth is user controlled. */
17
+ function walk(root, visit) {
18
+ const stack = [root];
19
+ while (stack.length > 0) {
20
+ const node = stack.pop();
21
+ if (node === void 0) break;
22
+ visit(node);
23
+ for (let child = node.lastChild; child !== null; child = child.prevSibling) stack.push(child);
24
+ }
25
+ }
26
+ /** Creates the transition machinery. Called once, by the first API that needs it. */
27
+ function createHooks() {
28
+ const laneRender = [];
29
+ const laneUser = [];
30
+ /** Resolvers of the transitions waiting for the lane to go idle. */
31
+ const waiters = [];
32
+ /** Memos and effects that caught a suspension; woken all at once when a boundary releases them. */
33
+ const suspended = [];
34
+ /** Suspense boundaries currently holding a transition (the lane is busy while any holds). */
35
+ let holds = 0;
36
+ let scheduled = false;
37
+ const hasLanePending = () => laneRender.length > 0 || laneUser.length > 0;
38
+ const laneBusy = () => hasLanePending() || holds > 0;
39
+ /**
40
+ * Runs one chunk of a lane queue. An entry without FLAG_TRANSITION was promoted to the urgent queue
41
+ * after it was queued here; it is skipped (the urgent queue owns its FLAG_QUEUED).
42
+ */
43
+ const drainLane = (queue, limit) => {
44
+ const batch = queue.splice(0, limit);
45
+ if (!isOrdered(batch)) batch.sort(byCreation);
46
+ for (const effect of batch) {
47
+ if ((effect.flags & 1024) === 0) continue;
48
+ effect.flags &= ~(2 | FLAG_TRANSITION);
49
+ if ((effect.flags & 4) !== 0) continue;
50
+ if (effect.pauses > 0) {
51
+ effect.flags |= FLAG_PARKED | FLAG_TRANSITION;
52
+ continue;
53
+ }
54
+ try {
55
+ if (effect.state === 2) recompute(effect);
56
+ else updateIfNecessary(effect);
57
+ } catch (error) {
58
+ handleError(error, effect);
59
+ }
60
+ }
61
+ return batch.length;
62
+ };
63
+ /** Resolves the transitions that wait for the lane, once the lane is idle. */
64
+ const settleLane = () => {
65
+ if (laneBusy() || waiters.length === 0) return;
66
+ const resolved = waiters.splice(0, waiters.length);
67
+ report(DEVTOOLS_EVENT.TRANSITION_END, resolved.length);
68
+ for (const resolve of resolved) resolve();
69
+ };
70
+ /** Asks for one lane macrotask (the timer lets the browser paint and take input first). */
71
+ const scheduleLane = () => {
72
+ if (scheduled) return;
73
+ scheduled = true;
74
+ setTimeout(flushLane, 0);
75
+ };
76
+ /**
77
+ * Runs the transition lane: one chunk per macrotask, render effects first. Writes made here belong to
78
+ * the lane, so the effects they wake join it. Errors nobody handled are reported, not thrown, because
79
+ * no caller is waiting for this macrotask.
80
+ */
81
+ const flushLane = () => {
82
+ scheduled = false;
83
+ if (rt.flushing) {
84
+ scheduleLane();
85
+ return;
86
+ }
87
+ const previous = rt.inTransition;
88
+ rt.inTransition = true;
89
+ rt.flushing = true;
90
+ let budget = LANE_CHUNK;
91
+ let passes = 0;
92
+ try {
93
+ while (budget > 0 && hasLanePending()) {
94
+ passes += 1;
95
+ if (passes > 1e3) {
96
+ clearQueues();
97
+ rt.uncaught.push(new ShadowError("INFINITE_LOOP"));
98
+ break;
99
+ }
100
+ const queue = laneRender.length > 0 ? laneRender : laneUser;
101
+ budget -= drainLane(queue, budget);
102
+ }
103
+ } finally {
104
+ rt.inTransition = previous;
105
+ rt.flushing = false;
106
+ }
107
+ const errors = rt.uncaught.splice(0, rt.uncaught.length);
108
+ for (const error of errors) reportUncaught(error);
109
+ if (hasLanePending()) scheduleLane();
110
+ else settleLane();
111
+ if (hasPending()) schedule();
112
+ };
113
+ const startTransition = (fn) => {
114
+ const previous = rt.inTransition;
115
+ const listener = rt.listener;
116
+ rt.inTransition = true;
117
+ rt.listener = null;
118
+ try {
119
+ fn();
120
+ } finally {
121
+ rt.inTransition = previous;
122
+ rt.listener = listener;
123
+ }
124
+ report(DEVTOOLS_EVENT.TRANSITION_START);
125
+ const applied = new Promise((resolve) => {
126
+ waiters.push(resolve);
127
+ });
128
+ settleLane();
129
+ return applied;
130
+ };
131
+ /** The hook's `place`: parks a paused effect or queues a lane effect. */
132
+ const parkOrLane = (effect, inLane) => {
133
+ if (effect.pauses > 0) {
134
+ effect.flags = inLane ? effect.flags | FLAG_PARKED | FLAG_TRANSITION : (effect.flags | FLAG_PARKED) & ~FLAG_TRANSITION;
135
+ return;
136
+ }
137
+ const render = (effect.flags & 16) !== 0;
138
+ effect.flags = effect.flags & ~FLAG_PARKED | 2 | FLAG_TRANSITION;
139
+ if (render) laneRender.push(effect);
140
+ else laneUser.push(effect);
141
+ scheduleLane();
142
+ };
143
+ const promote = (effect) => {
144
+ if ((effect.flags & 512) !== 0 || effect.pauses > 0) return;
145
+ if ((effect.flags & 2048) !== 0) {
146
+ place(effect, false);
147
+ return;
148
+ }
149
+ if ((effect.flags & 1026) !== 1026) return;
150
+ effect.flags &= ~FLAG_TRANSITION;
151
+ if ((effect.flags & 16) !== 0) renderQueue.push(effect);
152
+ else userQueue.push(effect);
153
+ };
154
+ const clear = () => {
155
+ for (const queue of [laneRender, laneUser]) {
156
+ for (const effect of queue) {
157
+ effect.flags &= ~(2 | FLAG_TRANSITION);
158
+ effect.state = 0;
159
+ }
160
+ queue.length = 0;
161
+ }
162
+ };
163
+ const suspend = (node, error) => {
164
+ if (error !== SUSPENSION) return false;
165
+ node.flags |= FLAG_SUSPENDED;
166
+ suspended.push(node);
167
+ return true;
168
+ };
169
+ const holdReader = (tracker) => {
170
+ if (tracker.hold?.() === true) throw SUSPENSION;
171
+ };
172
+ const beginHold = () => {
173
+ holds += 1;
174
+ };
175
+ const endHold = () => {
176
+ if (holds > 0) holds -= 1;
177
+ if (hasLanePending()) scheduleLane();
178
+ settleLane();
179
+ };
180
+ const wakeSuspended = () => {
181
+ const waiting = suspended.splice(0, suspended.length);
182
+ const previous = rt.inTransition;
183
+ rt.inTransition = true;
184
+ try {
185
+ for (const node of waiting) {
186
+ if ((node.flags & 4096) === 0 || node.disposed) continue;
187
+ node.flags &= ~FLAG_SUSPENDED;
188
+ node.state = 2;
189
+ if (node.kind === 2) place(node, true);
190
+ else markObservers(node);
191
+ }
192
+ } finally {
193
+ rt.inTransition = previous;
194
+ }
195
+ schedule();
196
+ };
197
+ const pause = (owner) => {
198
+ walk(owner, (node) => {
199
+ node.pauses += 1;
200
+ if (node instanceof Computation && node.kind === 2 && (node.flags & 16) === 0 && !node.disposed) node.runCleanups();
201
+ });
202
+ };
203
+ const createHold = (onSettled) => {
204
+ let count = 0;
205
+ let holding = false;
206
+ let engagedOnce = false;
207
+ const tracker = {
208
+ increment() {
209
+ count += 1;
210
+ },
211
+ decrement() {
212
+ count -= 1;
213
+ if (count !== 0) return;
214
+ if (holding) {
215
+ holding = false;
216
+ wakeSuspended();
217
+ endHold();
218
+ }
219
+ onSettled();
220
+ },
221
+ hold() {
222
+ engagedOnce = true;
223
+ if (!holding) {
224
+ holding = true;
225
+ beginHold();
226
+ }
227
+ return true;
228
+ }
229
+ };
230
+ return {
231
+ run: (fn) => runWithContext(SuspenseContext, tracker, fn),
232
+ count: () => count,
233
+ engaged: () => engagedOnce,
234
+ drop: () => {
235
+ if (!holding) return;
236
+ holding = false;
237
+ endHold();
238
+ }
239
+ };
240
+ };
241
+ const resume = (owner) => {
242
+ walk(owner, (node) => {
243
+ if (node.pauses > 0) node.pauses -= 1;
244
+ if (!(node instanceof Computation) || node.pauses !== 0 || node.disposed) return;
245
+ if (node.kind === 2) {
246
+ if ((node.flags & 16) !== 0 && (node.flags & 2048) === 0) return;
247
+ node.state = 2;
248
+ place(node, false);
249
+ } else if (node.state !== 0) markObservers(node);
250
+ });
251
+ schedule();
252
+ };
253
+ /** A Suspense boundary's hold: engaged by a transition read, released when its data arrived. */
254
+ const boundaryHold = () => {
255
+ let holding = false;
256
+ return {
257
+ engage: () => {
258
+ if (!holding) {
259
+ holding = true;
260
+ beginHold();
261
+ }
262
+ return true;
263
+ },
264
+ release: () => {
265
+ if (!holding) return;
266
+ holding = false;
267
+ wakeSuspended();
268
+ endHold();
269
+ },
270
+ holding: () => holding
271
+ };
272
+ };
273
+ /**
274
+ * The transition layer of one branch slot (Show, Switch). A change made during a transition, while a
275
+ * branch is on screen, builds the new branch under a hold and keeps the shown one until the hold
276
+ * settles; then it commits. The slot's output memo calls `step` first, so the usual path (its own
277
+ * teardown) only runs when no transition is involved. Its state lives in `state`, which the memo
278
+ * reads and writes.
279
+ */
280
+ const slotSwap = (state, build, same, parent) => {
281
+ /** A transition's branch waiting for its reads; the shown branch stays until it is ready. */
282
+ let pending;
283
+ /** Owns the branches built during transitions: they live as long as the slot's owner. */
284
+ const holder = new Owner(parent);
285
+ /** Counts the settled holds; the memo reads it, so it runs again when a pending branch is ready. */
286
+ const settled = new Signal(0, false, void 0);
287
+ const settle = () => {
288
+ settled.value += 1;
289
+ if (hasObservers(settled)) {
290
+ markObservers(settled);
291
+ schedule();
292
+ }
293
+ };
294
+ /** Tears a branch down. Its owner is marked `disposing` first (see the accessors of Show). */
295
+ const retireBranch = (branch) => {
296
+ branch.owned.disposing = true;
297
+ try {
298
+ branch.hold?.drop();
299
+ branch.dispose?.();
300
+ } finally {
301
+ branch.owned.disposing = false;
302
+ }
303
+ };
304
+ const commit = (branch) => {
305
+ const previous = state.live;
306
+ state.live = branch;
307
+ if (previous !== void 0) retireBranch(previous);
308
+ };
309
+ /** Builds a transition's branch under the holder. A held read leaves it pending, not shown. */
310
+ const buildPending = (choice) => {
311
+ const owned = {
312
+ index: choice.index,
313
+ value: choice.when,
314
+ disposing: false
315
+ };
316
+ const hold = createHold(() => {
317
+ if (pending !== void 0 && pending.hold === hold) settle();
318
+ });
319
+ const root = new Owner(holder);
320
+ const previousOwner = rt.owner;
321
+ const previousListener = rt.listener;
322
+ rt.owner = root;
323
+ rt.listener = null;
324
+ let result;
325
+ try {
326
+ try {
327
+ result = hold.run(() => build(choice, owned, true));
328
+ } catch (error) {
329
+ if (!isSuspension(error)) throw error;
330
+ }
331
+ const marker = new Owner(root);
332
+ addCleanup(marker, () => {
333
+ owned.disposing = true;
334
+ });
335
+ } finally {
336
+ rt.owner = previousOwner;
337
+ rt.listener = previousListener;
338
+ }
339
+ return {
340
+ choice,
341
+ owned,
342
+ result,
343
+ dispose: () => disposeTree(root),
344
+ hold: hold.engaged() ? hold : null
345
+ };
346
+ };
347
+ return { step(choice) {
348
+ readSignal(settled);
349
+ if (pending !== void 0) {
350
+ if (!same(pending.choice, choice)) {
351
+ const dropped = pending;
352
+ pending = void 0;
353
+ dropped.hold?.drop();
354
+ dropped.dispose?.();
355
+ } else if ((pending.hold?.count() ?? 0) > 0) return true;
356
+ else {
357
+ const ready = pending;
358
+ pending = void 0;
359
+ commit(ready);
360
+ return true;
361
+ }
362
+ }
363
+ if (state.live !== void 0 && rt.inTransition) {
364
+ const built = buildPending(choice);
365
+ if (built.hold === null) commit(built);
366
+ else pending = built;
367
+ return true;
368
+ }
369
+ const live = state.live;
370
+ state.live = void 0;
371
+ if (live !== void 0) retireBranch(live);
372
+ return false;
373
+ } };
374
+ };
375
+ return {
376
+ place: parkOrLane,
377
+ promote,
378
+ clear,
379
+ suspend,
380
+ holdReader,
381
+ startTransition,
382
+ beginHold,
383
+ endHold,
384
+ wakeSuspended,
385
+ pause,
386
+ resume,
387
+ createHold,
388
+ slotSwap,
389
+ boundaryHold
390
+ };
391
+ }
392
+ /** Installs the transition machinery on first use; later calls return the same hooks. */
393
+ function ensureHooks() {
394
+ const existing = rt.hooks;
395
+ if (existing !== null) return existing;
396
+ const created = createHooks();
397
+ rt.hooks = created;
398
+ return created;
399
+ }
400
+ /**
401
+ * Installs the transition machinery (the transition lane, Activity pauses and Suspense holds) now
402
+ * instead of at the first `startTransition`. The machinery is created on first use so that an
403
+ * application that never uses transitions does not carry its code; call this from a primitive whose
404
+ * later work needs the lane to exist, as `useDeferredValue` does. Calling it again does nothing.
405
+ *
406
+ * @example
407
+ * import { registerTransitionLane } from "@shadow-js/core/extend";
408
+ *
409
+ * export function useBackgroundValue(): void {
410
+ * registerTransitionLane(); // later lane-only effects of this hook find the lane
411
+ * }
412
+ * @see startTransition
413
+ * @since 1.0.0
414
+ */
415
+ function registerTransitionLane() {
416
+ ensureHooks();
417
+ }
418
+ /**
419
+ * Runs `fn` as a transition: the effects its writes wake wait in the transition lane, which runs
420
+ * after urgent work (in a macrotask, one chunk at a time). Reads see the writes at once; the DOM
421
+ * catches up when the lane runs. Use it for an update that may be slow to render or load, so input
422
+ * stays responsive and a Suspense boundary keeps its content instead of showing its fallback. `fn`
423
+ * runs untracked. The returned promise resolves when the lane is idle and no Suspense boundary holds
424
+ * the transition.
425
+ *
426
+ * On the server there are no effects, so `fn` simply runs and the promise is already resolved.
427
+ *
428
+ * @param fn Callback whose writes form the transition.
429
+ * @returns A promise that resolves when the transition has been applied.
430
+ * @throws What `fn` throws, synchronously; no transition is started then.
431
+ * @example
432
+ * import { startTransition, useSignal } from "@shadow-js/core";
433
+ *
434
+ * const [page, setPage] = useSignal("home");
435
+ * async function openReports(): Promise<void> {
436
+ * await startTransition(() => setPage("reports"));
437
+ * console.log(`${page()} is on screen`);
438
+ * }
439
+ * @see inTransition
440
+ * @since 1.0.0
441
+ */
442
+ function startTransition(fn) {
443
+ fn();
444
+ return Promise.resolve();
445
+ }
446
+ /**
447
+ * Starts a Suspense hold: the boundary keeps showing its current content while a transition waits
448
+ * for data. Holds are counted, and the running transitions stay pending (`isPending` of
449
+ * `useTransition`, the promise of `startTransition`) until every hold has ended. For renderers that
450
+ * implement Suspense; each call needs one {@link endHold}. Does nothing before the transition
451
+ * machinery exists (no transition has run).
452
+ *
453
+ * @example
454
+ * import { beginHold, endHold, wakeSuspended } from "@shadow-js/core/extend";
455
+ *
456
+ * export function holdUntil(data: Promise<unknown>): void {
457
+ * beginHold(); // the boundary keeps its content
458
+ * void data.finally(() => {
459
+ * wakeSuspended();
460
+ * endHold();
461
+ * });
462
+ * }
463
+ * @see endHold
464
+ * @since 1.0.0
465
+ */
466
+ function beginHold() {
467
+ rt.hooks?.beginHold();
468
+ }
469
+ /**
470
+ * Ends a Suspense hold started with {@link beginHold}. Call {@link wakeSuspended} first, so the
471
+ * memos and effects that waited are queued; this then schedules the lane for them and, once the lane
472
+ * is idle and no hold remains, resolves the transitions that were waiting. Extra calls never take the
473
+ * count below zero. Does nothing before the transition machinery exists.
474
+ *
475
+ * @example
476
+ * import { endHold, wakeSuspended } from "@shadow-js/core/extend";
477
+ *
478
+ * export function release(): void {
479
+ * wakeSuspended(); // the held readers run again with the data that arrived
480
+ * endHold();
481
+ * }
482
+ * @see beginHold
483
+ * @since 1.0.0
484
+ */
485
+ function endHold() {
486
+ rt.hooks?.endHold();
487
+ }
488
+ /**
489
+ * Wakes every memo and effect that kept its value for a transition (it caught {@link SUSPENSION}):
490
+ * each runs again in the transition lane, so it reads the data that arrived. A Suspense boundary
491
+ * calls it when it releases its hold, before {@link endHold}. Does nothing before the transition
492
+ * machinery exists.
493
+ *
494
+ * @example
495
+ * import { endHold, wakeSuspended } from "@shadow-js/core/extend";
496
+ *
497
+ * export function onDataArrived(): void {
498
+ * wakeSuspended();
499
+ * endHold();
500
+ * }
501
+ * @see endHold
502
+ * @since 1.0.0
503
+ */
504
+ function wakeSuspended() {
505
+ rt.hooks?.wakeSuspended();
506
+ }
507
+ /**
508
+ * Lets a pending read inside a transition keep the boundary's content: when the tracker's `hold()`
509
+ * returns true (the boundary holds its content for the transition), the reader throws
510
+ * {@link SUSPENSION} and keeps its previous value until the boundary wakes it. Call it from a data
511
+ * primitive's reader when its data is pending, the reader is tracked and {@link inTransition} is
512
+ * true, as `useResource` does. Does nothing before the transition machinery exists, or when the
513
+ * tracker has no `hold`.
514
+ *
515
+ * @param tracker The Suspense tracker of the nearest boundary (`SuspenseContext`).
516
+ * @throws {@link SUSPENSION} (not an error) when the boundary holds its content.
517
+ * @example
518
+ * import { useContext, SuspenseContext } from "@shadow-js/core";
519
+ * import { currentListener, holdReader, inTransition } from "@shadow-js/core/extend";
520
+ *
521
+ * export function readPending(): void {
522
+ * const tracker = useContext(SuspenseContext);
523
+ * if (tracker !== null && currentListener() !== null && inTransition()) holdReader(tracker);
524
+ * }
525
+ * @see isSuspension
526
+ * @since 1.0.0
527
+ */
528
+ function holdReader(tracker) {
529
+ rt.hooks?.holdReader(tracker);
530
+ }
531
+ /**
532
+ * Tells whether a transition callback or a transition-lane run is active, so the writes made now
533
+ * belong to the lane. Use it in a primitive that treats transition reads differently, such as a data
534
+ * reader that holds the boundary only in a transition.
535
+ *
536
+ * @returns True inside `startTransition`'s callback and while the lane runs.
537
+ * @example
538
+ * import { startTransition } from "@shadow-js/core";
539
+ * import { inTransition } from "@shadow-js/core/extend";
540
+ *
541
+ * void startTransition(() => {
542
+ * console.log(inTransition()); // true in the browser
543
+ * });
544
+ * console.log(inTransition()); // false
545
+ * @see startTransition
546
+ * @since 1.0.0
547
+ */
548
+ function inTransition() {
549
+ return rt.inTransition;
550
+ }
551
+ /**
552
+ * Creates the hold of a value a transition builds (see {@link TransitionHold}): the reads that wait
553
+ * for data inside `hold.run(...)` count against this hold instead of the Suspense boundary around the
554
+ * value, so the value on screen stays until the new one is ready. For renderers that build values
555
+ * during a transition.
556
+ *
557
+ * @param onSettled Called each time the number of waiting reads drops back to zero.
558
+ * @returns The hold, or null when the transition machinery does not exist yet (no transition has run,
559
+ * so nothing can be held).
560
+ * @example
561
+ * import { createTransitionHold } from "@shadow-js/core/extend";
562
+ *
563
+ * const hold = createTransitionHold(() => console.log("ready to commit"));
564
+ * const built = hold === null ? "now" : hold.run(() => "pending");
565
+ * @see transitionHooks
566
+ * @since 1.0.0
567
+ */
568
+ function createTransitionHold(onSettled) {
569
+ const hooks = rt.hooks;
570
+ return hooks === null ? null : hooks.createHold(onSettled);
571
+ }
572
+ /**
573
+ * Returns the transition machinery while a transition is running, otherwise null. Renderers reach
574
+ * the slot and boundary layers (`slotSwap`, `boundaryHold`) only through it: a transition can only be
575
+ * running once the machinery exists, so this never creates it (a static call that did would keep the
576
+ * whole machinery in every bundle that renders a Show).
577
+ *
578
+ * @returns The hooks during a transition callback or lane run, null otherwise.
579
+ * @example
580
+ * import { transitionHooks } from "@shadow-js/core/extend";
581
+ *
582
+ * export function boundaryHoldIfTransition() {
583
+ * return transitionHooks()?.boundaryHold() ?? null;
584
+ * }
585
+ * @see inTransition
586
+ * @since 1.0.0
587
+ */
588
+ function transitionHooks() {
589
+ return rt.inTransition ? rt.hooks : null;
590
+ }
591
+ /**
592
+ * Pauses `owner` and everything below it (Activity hidden). User effects run their cleanups and wait.
593
+ * DOM bindings (render effects) wait without a cleanup, so their nodes stay as they are. Memos keep their
594
+ * last value, and effects created below are parked until the owner resumes. Pauses nest: each
595
+ * `pauseOwner` needs one `resumeOwner`. Use it to hide a subtree while keeping its state.
596
+ *
597
+ * @param owner The owner to pause, with its whole subtree.
598
+ * @example
599
+ * import { createOwner, pauseOwner, resumeOwner } from "@shadow-js/core/extend";
600
+ *
601
+ * const hidden = createOwner(null);
602
+ * pauseOwner(hidden); // its effects stop; its memos keep their values
603
+ * resumeOwner(hidden); // its user effects run again with the latest values
604
+ * @see resumeOwner
605
+ * @since 1.0.0
606
+ */
607
+ function pauseOwner(owner) {
608
+ ensureHooks().pause(owner);
609
+ }
610
+ /**
611
+ * Resumes an owner paused with {@link pauseOwner}; the subtree runs again once its last pause ends.
612
+ * User effects below it run once more with the current values (their cleanups ran on pause). DOM
613
+ * bindings run only if something they read changed while paused, so a hidden subtree is not rebuilt
614
+ * on show. Memos that changed while paused wake their readers outside the owner. Call it once per
615
+ * `pauseOwner`, not on an owner that is not paused.
616
+ *
617
+ * @param owner The paused owner.
618
+ * @example
619
+ * import { createOwner, pauseOwner, resumeOwner } from "@shadow-js/core/extend";
620
+ *
621
+ * const panel = createOwner(null);
622
+ * pauseOwner(panel);
623
+ * resumeOwner(panel); // every user effect below runs once with the latest values
624
+ * @see pauseOwner
625
+ * @since 1.0.0
626
+ */
627
+ function resumeOwner(owner) {
628
+ rt.hooks?.resume(owner);
629
+ }
630
+ //#endregion
631
+ export { beginHold, createTransitionHold, endHold, holdReader, inTransition, pauseOwner, registerTransitionLane, resumeOwner, startTransition, transitionHooks, wakeSuspended };
632
+
633
+ //# sourceMappingURL=concurrency.js.map