create-foldkit-app 0.27.3 → 0.28.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 (460) hide show
  1. package/dist/index.js +1 -5
  2. package/{templates → dist/templates}/base/AGENTS.md +17 -19
  3. package/dist/templates/examples/api-cache/package.json +29 -0
  4. package/dist/templates/examples/api-cache/src/data.test.ts +28 -0
  5. package/dist/templates/examples/api-cache/src/data.ts +126 -0
  6. package/dist/templates/examples/api-cache/src/entry.ts +17 -0
  7. package/dist/templates/examples/api-cache/src/main.fixtures.ts +70 -0
  8. package/dist/templates/examples/api-cache/src/main.ts +744 -0
  9. package/dist/templates/examples/api-cache/src/scene.test.ts +120 -0
  10. package/dist/templates/examples/api-cache/src/story.test.ts +288 -0
  11. package/dist/templates/examples/api-cache/src/styles.css +1 -0
  12. package/dist/templates/examples/api-cache/src/vitest-setup.ts +3 -0
  13. package/dist/templates/examples/auth/package.json +30 -0
  14. package/dist/templates/examples/auth/src/command.ts +49 -0
  15. package/dist/templates/examples/auth/src/constant.ts +1 -0
  16. package/dist/templates/examples/auth/src/domain/session.ts +9 -0
  17. package/dist/templates/examples/auth/src/entry.ts +25 -0
  18. package/dist/templates/examples/auth/src/main.ts +75 -0
  19. package/dist/templates/examples/auth/src/message.ts +22 -0
  20. package/dist/templates/examples/auth/src/model.ts +9 -0
  21. package/dist/templates/examples/auth/src/notFoundView.ts +25 -0
  22. package/dist/templates/examples/auth/src/page/index.ts +2 -0
  23. package/dist/templates/examples/auth/src/page/loggedIn/index.ts +4 -0
  24. package/dist/templates/examples/auth/src/page/loggedIn/message.ts +17 -0
  25. package/dist/templates/examples/auth/src/page/loggedIn/model.ts +21 -0
  26. package/dist/templates/examples/auth/src/page/loggedIn/page/dashboard.ts +40 -0
  27. package/dist/templates/examples/auth/src/page/loggedIn/page/settings.ts +71 -0
  28. package/dist/templates/examples/auth/src/page/loggedIn/update.ts +16 -0
  29. package/dist/templates/examples/auth/src/page/loggedIn/view.ts +87 -0
  30. package/dist/templates/examples/auth/src/page/loggedOut/index.ts +4 -0
  31. package/dist/templates/examples/auth/src/page/loggedOut/message.ts +20 -0
  32. package/dist/templates/examples/auth/src/page/loggedOut/model.ts +21 -0
  33. package/dist/templates/examples/auth/src/page/loggedOut/page/home.ts +68 -0
  34. package/dist/templates/examples/auth/src/page/loggedOut/page/login.scene.test.ts +116 -0
  35. package/dist/templates/examples/auth/src/page/loggedOut/page/login.story.test.ts +112 -0
  36. package/dist/templates/examples/auth/src/page/loggedOut/page/login.ts +346 -0
  37. package/dist/templates/examples/auth/src/page/loggedOut/update.ts +32 -0
  38. package/dist/templates/examples/auth/src/page/loggedOut/view.ts +31 -0
  39. package/dist/templates/examples/auth/src/route.ts +56 -0
  40. package/dist/templates/examples/auth/src/scene.test.ts +61 -0
  41. package/dist/templates/examples/auth/src/styles.css +1 -0
  42. package/dist/templates/examples/auth/src/update.ts +179 -0
  43. package/dist/templates/examples/auth/src/view.ts +40 -0
  44. package/dist/templates/examples/auth/src/vitest-setup.ts +3 -0
  45. package/dist/templates/examples/canvas-art/package.json +29 -0
  46. package/dist/templates/examples/canvas-art/src/entry.ts +17 -0
  47. package/dist/templates/examples/canvas-art/src/main.ts +274 -0
  48. package/dist/templates/examples/canvas-art/src/scene.test.ts +70 -0
  49. package/dist/templates/examples/canvas-art/src/story.test.ts +155 -0
  50. package/dist/templates/examples/canvas-art/src/styles.css +1 -0
  51. package/dist/templates/examples/canvas-art/src/vitest-setup.ts +3 -0
  52. package/dist/templates/examples/charting/package.json +31 -0
  53. package/dist/templates/examples/charting/src/chartHost.ts +20 -0
  54. package/dist/templates/examples/charting/src/command.ts +62 -0
  55. package/dist/templates/examples/charting/src/domain.ts +175 -0
  56. package/dist/templates/examples/charting/src/echarts.ts +408 -0
  57. package/dist/templates/examples/charting/src/entry.ts +25 -0
  58. package/dist/templates/examples/charting/src/githubApi.ts +271 -0
  59. package/dist/templates/examples/charting/src/http.ts +50 -0
  60. package/dist/templates/examples/charting/src/init.test.ts +14 -0
  61. package/dist/templates/examples/charting/src/init.ts +29 -0
  62. package/dist/templates/examples/charting/src/main.fixtures.ts +162 -0
  63. package/dist/templates/examples/charting/src/message.ts +23 -0
  64. package/dist/templates/examples/charting/src/model.ts +22 -0
  65. package/dist/templates/examples/charting/src/npmApi.ts +75 -0
  66. package/dist/templates/examples/charting/src/radioGroups.ts +11 -0
  67. package/dist/templates/examples/charting/src/scene.test.ts +103 -0
  68. package/dist/templates/examples/charting/src/story.test.ts +145 -0
  69. package/dist/templates/examples/charting/src/styles.css +1 -0
  70. package/dist/templates/examples/charting/src/subscription.ts +70 -0
  71. package/dist/templates/examples/charting/src/telemetry.test.ts +64 -0
  72. package/dist/templates/examples/charting/src/telemetry.ts +432 -0
  73. package/dist/templates/examples/charting/src/update.ts +217 -0
  74. package/dist/templates/examples/charting/src/view/chart.ts +129 -0
  75. package/dist/templates/examples/charting/src/view/format.ts +23 -0
  76. package/dist/templates/examples/charting/src/view/index.ts +1 -0
  77. package/dist/templates/examples/charting/src/view/layout.ts +175 -0
  78. package/dist/templates/examples/charting/src/view/sidebar.ts +309 -0
  79. package/dist/templates/examples/charting/src/view/view.ts +23 -0
  80. package/dist/templates/examples/charting/src/vitest-setup.ts +3 -0
  81. package/dist/templates/examples/charting/src/weeks.ts +105 -0
  82. package/dist/templates/examples/counter/package.json +29 -0
  83. package/dist/templates/examples/counter/src/entry.ts +16 -0
  84. package/dist/templates/examples/counter/src/main.ts +95 -0
  85. package/dist/templates/examples/counter/src/scene.test.ts +57 -0
  86. package/dist/templates/examples/counter/src/story.test.ts +71 -0
  87. package/dist/templates/examples/counter/src/styles.css +1 -0
  88. package/dist/templates/examples/counter/src/vitest-setup.ts +3 -0
  89. package/dist/templates/examples/counters/package.json +29 -0
  90. package/dist/templates/examples/counters/src/counter.ts +70 -0
  91. package/dist/templates/examples/counters/src/entry.ts +16 -0
  92. package/dist/templates/examples/counters/src/main.ts +171 -0
  93. package/dist/templates/examples/counters/src/scene.test.ts +90 -0
  94. package/dist/templates/examples/counters/src/story.test.ts +127 -0
  95. package/dist/templates/examples/counters/src/styles.css +1 -0
  96. package/dist/templates/examples/counters/src/vitest-setup.ts +3 -0
  97. package/dist/templates/examples/crash-view/package.json +29 -0
  98. package/dist/templates/examples/crash-view/src/entry.ts +28 -0
  99. package/dist/templates/examples/crash-view/src/main.ts +104 -0
  100. package/dist/templates/examples/crash-view/src/scene.test.ts +14 -0
  101. package/dist/templates/examples/crash-view/src/story.test.ts +11 -0
  102. package/dist/templates/examples/crash-view/src/styles.css +1 -0
  103. package/dist/templates/examples/crash-view/src/vitest-setup.ts +3 -0
  104. package/dist/templates/examples/embedding/package.json +29 -0
  105. package/dist/templates/examples/embedding/src/entry.ts +3 -0
  106. package/dist/templates/examples/embedding/src/host.ts +108 -0
  107. package/dist/templates/examples/embedding/src/main.ts +144 -0
  108. package/dist/templates/examples/embedding/src/scene.test.ts +28 -0
  109. package/dist/templates/examples/embedding/src/story.test.ts +64 -0
  110. package/dist/templates/examples/embedding/src/styles.css +1 -0
  111. package/dist/templates/examples/embedding/src/vitest-setup.ts +3 -0
  112. package/dist/templates/examples/form/package.json +30 -0
  113. package/dist/templates/examples/form/src/entry.ts +16 -0
  114. package/dist/templates/examples/form/src/main.ts +493 -0
  115. package/dist/templates/examples/form/src/scene.test.ts +165 -0
  116. package/dist/templates/examples/form/src/story.test.ts +190 -0
  117. package/dist/templates/examples/form/src/styles.css +1 -0
  118. package/dist/templates/examples/form/src/vitest-setup.ts +3 -0
  119. package/dist/templates/examples/generative-art/package.json +29 -0
  120. package/dist/templates/examples/generative-art/src/command.ts +109 -0
  121. package/dist/templates/examples/generative-art/src/constant.ts +68 -0
  122. package/dist/templates/examples/generative-art/src/entry.ts +22 -0
  123. package/dist/templates/examples/generative-art/src/main.ts +59 -0
  124. package/dist/templates/examples/generative-art/src/message.ts +35 -0
  125. package/dist/templates/examples/generative-art/src/model.ts +33 -0
  126. package/dist/templates/examples/generative-art/src/noise.ts +93 -0
  127. package/dist/templates/examples/generative-art/src/scene.test.ts +103 -0
  128. package/dist/templates/examples/generative-art/src/story.test.ts +203 -0
  129. package/dist/templates/examples/generative-art/src/styles.css +1 -0
  130. package/dist/templates/examples/generative-art/src/subscription.ts +35 -0
  131. package/dist/templates/examples/generative-art/src/update.ts +319 -0
  132. package/dist/templates/examples/generative-art/src/view.ts +451 -0
  133. package/dist/templates/examples/generative-art/src/vitest-setup.ts +3 -0
  134. package/dist/templates/examples/interrupting-commands/package.json +29 -0
  135. package/dist/templates/examples/interrupting-commands/src/entry.ts +16 -0
  136. package/dist/templates/examples/interrupting-commands/src/main.ts +354 -0
  137. package/dist/templates/examples/interrupting-commands/src/scene.test.ts +89 -0
  138. package/dist/templates/examples/interrupting-commands/src/story.test.ts +224 -0
  139. package/dist/templates/examples/interrupting-commands/src/styles.css +1 -0
  140. package/dist/templates/examples/interrupting-commands/src/vitest-setup.ts +3 -0
  141. package/dist/templates/examples/job-application/package.json +30 -0
  142. package/dist/templates/examples/job-application/src/command.ts +23 -0
  143. package/dist/templates/examples/job-application/src/domain/index.ts +3 -0
  144. package/dist/templates/examples/job-application/src/domain/proficiencyLevel.ts +11 -0
  145. package/dist/templates/examples/job-application/src/domain/pronounOption.ts +13 -0
  146. package/dist/templates/examples/job-application/src/domain/step.ts +28 -0
  147. package/dist/templates/examples/job-application/src/entry.ts +17 -0
  148. package/dist/templates/examples/job-application/src/main.ts +69 -0
  149. package/dist/templates/examples/job-application/src/message.ts +44 -0
  150. package/dist/templates/examples/job-application/src/model.ts +47 -0
  151. package/dist/templates/examples/job-application/src/scene.test.ts +269 -0
  152. package/dist/templates/examples/job-application/src/step/attachments.ts +111 -0
  153. package/dist/templates/examples/job-application/src/step/coverLetter.ts +34 -0
  154. package/dist/templates/examples/job-application/src/step/education/education.ts +121 -0
  155. package/dist/templates/examples/job-application/src/step/education/entry.ts +168 -0
  156. package/dist/templates/examples/job-application/src/step/education/index.ts +2 -0
  157. package/dist/templates/examples/job-application/src/step/index.ts +6 -0
  158. package/dist/templates/examples/job-application/src/step/personalInfo.ts +305 -0
  159. package/dist/templates/examples/job-application/src/step/skills/entry.ts +126 -0
  160. package/dist/templates/examples/job-application/src/step/skills/index.ts +2 -0
  161. package/dist/templates/examples/job-application/src/step/skills/skills.ts +118 -0
  162. package/dist/templates/examples/job-application/src/step/validation.ts +6 -0
  163. package/dist/templates/examples/job-application/src/step/workHistory/entry.ts +206 -0
  164. package/dist/templates/examples/job-application/src/step/workHistory/index.ts +2 -0
  165. package/dist/templates/examples/job-application/src/step/workHistory/workHistory.ts +121 -0
  166. package/dist/templates/examples/job-application/src/story.test.ts +775 -0
  167. package/dist/templates/examples/job-application/src/styles.css +1 -0
  168. package/dist/templates/examples/job-application/src/update.ts +183 -0
  169. package/dist/templates/examples/job-application/src/view/attachments.ts +215 -0
  170. package/dist/templates/examples/job-application/src/view/coverLetter.ts +73 -0
  171. package/dist/templates/examples/job-application/src/view/datePicker.ts +207 -0
  172. package/dist/templates/examples/job-application/src/view/education.ts +63 -0
  173. package/dist/templates/examples/job-application/src/view/educationEntry.ts +165 -0
  174. package/dist/templates/examples/job-application/src/view/field.ts +183 -0
  175. package/dist/templates/examples/job-application/src/view/format.ts +50 -0
  176. package/dist/templates/examples/job-application/src/view/icon.ts +21 -0
  177. package/dist/templates/examples/job-application/src/view/index.ts +352 -0
  178. package/dist/templates/examples/job-application/src/view/personalInfo.ts +224 -0
  179. package/dist/templates/examples/job-application/src/view/preview.ts +265 -0
  180. package/dist/templates/examples/job-application/src/view/review.ts +388 -0
  181. package/dist/templates/examples/job-application/src/view/skillEntry.ts +102 -0
  182. package/dist/templates/examples/job-application/src/view/skills.ts +49 -0
  183. package/dist/templates/examples/job-application/src/view/stepNav.ts +181 -0
  184. package/dist/templates/examples/job-application/src/view/workEntry.ts +159 -0
  185. package/dist/templates/examples/job-application/src/view/workHistory.ts +55 -0
  186. package/dist/templates/examples/job-application/src/vitest-setup.ts +3 -0
  187. package/dist/templates/examples/kanban/package.json +31 -0
  188. package/dist/templates/examples/kanban/src/command.ts +46 -0
  189. package/dist/templates/examples/kanban/src/constant.ts +149 -0
  190. package/dist/templates/examples/kanban/src/domain/card.ts +10 -0
  191. package/dist/templates/examples/kanban/src/domain/column.ts +115 -0
  192. package/dist/templates/examples/kanban/src/domain/index.ts +2 -0
  193. package/dist/templates/examples/kanban/src/entry.ts +27 -0
  194. package/dist/templates/examples/kanban/src/main.ts +56 -0
  195. package/dist/templates/examples/kanban/src/message.ts +21 -0
  196. package/dist/templates/examples/kanban/src/model.ts +21 -0
  197. package/dist/templates/examples/kanban/src/scene.test.ts +161 -0
  198. package/dist/templates/examples/kanban/src/story.test.ts +461 -0
  199. package/dist/templates/examples/kanban/src/styles.css +1 -0
  200. package/dist/templates/examples/kanban/src/subscription.ts +16 -0
  201. package/dist/templates/examples/kanban/src/update.ts +205 -0
  202. package/dist/templates/examples/kanban/src/view/card.ts +79 -0
  203. package/dist/templates/examples/kanban/src/view/column.ts +283 -0
  204. package/dist/templates/examples/kanban/src/view/index.ts +71 -0
  205. package/dist/templates/examples/kanban/src/vitest-setup.ts +3 -0
  206. package/dist/templates/examples/managed-resource-layer/package.json +29 -0
  207. package/dist/templates/examples/managed-resource-layer/src/entry.ts +17 -0
  208. package/dist/templates/examples/managed-resource-layer/src/main.ts +309 -0
  209. package/dist/templates/examples/managed-resource-layer/src/scene.test.ts +117 -0
  210. package/dist/templates/examples/managed-resource-layer/src/story.test.ts +118 -0
  211. package/dist/templates/examples/managed-resource-layer/src/styles.css +1 -0
  212. package/dist/templates/examples/managed-resource-layer/src/vitest-setup.ts +3 -0
  213. package/dist/templates/examples/map/package.json +31 -0
  214. package/dist/templates/examples/map/src/entry.ts +17 -0
  215. package/dist/templates/examples/map/src/locations.ts +69 -0
  216. package/dist/templates/examples/map/src/main.fixtures.ts +28 -0
  217. package/dist/templates/examples/map/src/main.ts +781 -0
  218. package/dist/templates/examples/map/src/mapHost.ts +23 -0
  219. package/dist/templates/examples/map/src/scene.test.ts +136 -0
  220. package/dist/templates/examples/map/src/story.test.ts +190 -0
  221. package/dist/templates/examples/map/src/styles.css +2 -0
  222. package/dist/templates/examples/map/src/vitest-setup.ts +3 -0
  223. package/dist/templates/examples/pixel-art/package.json +31 -0
  224. package/dist/templates/examples/pixel-art/src/command.ts +87 -0
  225. package/dist/templates/examples/pixel-art/src/comparison.bench.test.ts +204 -0
  226. package/dist/templates/examples/pixel-art/src/constant.ts +21 -0
  227. package/dist/templates/examples/pixel-art/src/entry.ts +27 -0
  228. package/dist/templates/examples/pixel-art/src/grid.ts +134 -0
  229. package/dist/templates/examples/pixel-art/src/main.bench.ts +133 -0
  230. package/dist/templates/examples/pixel-art/src/main.ts +85 -0
  231. package/dist/templates/examples/pixel-art/src/message.ts +36 -0
  232. package/dist/templates/examples/pixel-art/src/model.ts +79 -0
  233. package/dist/templates/examples/pixel-art/src/palette.ts +134 -0
  234. package/dist/templates/examples/pixel-art/src/scene.test.ts +250 -0
  235. package/dist/templates/examples/pixel-art/src/story.test.ts +482 -0
  236. package/dist/templates/examples/pixel-art/src/styles.css +1 -0
  237. package/dist/templates/examples/pixel-art/src/subscription.ts +61 -0
  238. package/dist/templates/examples/pixel-art/src/update.ts +469 -0
  239. package/dist/templates/examples/pixel-art/src/view/canvas.ts +134 -0
  240. package/dist/templates/examples/pixel-art/src/view/dialog.ts +152 -0
  241. package/dist/templates/examples/pixel-art/src/view/history.ts +214 -0
  242. package/dist/templates/examples/pixel-art/src/view/index.ts +1 -0
  243. package/dist/templates/examples/pixel-art/src/view/toolbar.ts +452 -0
  244. package/dist/templates/examples/pixel-art/src/view/view.ts +183 -0
  245. package/dist/templates/examples/pixel-art/src/vitest-setup.ts +3 -0
  246. package/dist/templates/examples/query-sync/package.json +30 -0
  247. package/dist/templates/examples/query-sync/src/data.ts +166 -0
  248. package/dist/templates/examples/query-sync/src/entry.ts +20 -0
  249. package/dist/templates/examples/query-sync/src/main.ts +898 -0
  250. package/dist/templates/examples/query-sync/src/scene.test.ts +89 -0
  251. package/dist/templates/examples/query-sync/src/story.test.ts +151 -0
  252. package/dist/templates/examples/query-sync/src/styles.css +1 -0
  253. package/dist/templates/examples/query-sync/src/vitest-setup.ts +3 -0
  254. package/dist/templates/examples/route-transitions/package.json +28 -0
  255. package/dist/templates/examples/route-transitions/src/data.ts +61 -0
  256. package/dist/templates/examples/route-transitions/src/entry.ts +20 -0
  257. package/dist/templates/examples/route-transitions/src/main.ts +798 -0
  258. package/dist/templates/examples/route-transitions/src/route.ts +48 -0
  259. package/dist/templates/examples/route-transitions/src/story.test.ts +225 -0
  260. package/dist/templates/examples/route-transitions/src/styles.css +1 -0
  261. package/dist/templates/examples/route-transitions/src/vitest-setup.ts +3 -0
  262. package/dist/templates/examples/routing/package.json +29 -0
  263. package/dist/templates/examples/routing/src/entry.ts +20 -0
  264. package/dist/templates/examples/routing/src/fileTree.ts +98 -0
  265. package/dist/templates/examples/routing/src/main.ts +573 -0
  266. package/dist/templates/examples/routing/src/page/index.ts +1 -0
  267. package/dist/templates/examples/routing/src/page/people.ts +349 -0
  268. package/dist/templates/examples/routing/src/route.ts +82 -0
  269. package/dist/templates/examples/routing/src/scene.test.ts +180 -0
  270. package/dist/templates/examples/routing/src/story.test.ts +242 -0
  271. package/dist/templates/examples/routing/src/styles.css +1 -0
  272. package/dist/templates/examples/routing/src/vitest-setup.ts +3 -0
  273. package/dist/templates/examples/shopping-cart/package.json +29 -0
  274. package/dist/templates/examples/shopping-cart/src/data/products.ts +10 -0
  275. package/dist/templates/examples/shopping-cart/src/domain/cart.ts +77 -0
  276. package/dist/templates/examples/shopping-cart/src/domain/index.ts +2 -0
  277. package/dist/templates/examples/shopping-cart/src/domain/item.ts +16 -0
  278. package/dist/templates/examples/shopping-cart/src/entry.ts +20 -0
  279. package/dist/templates/examples/shopping-cart/src/main.ts +307 -0
  280. package/dist/templates/examples/shopping-cart/src/page/cart.ts +203 -0
  281. package/dist/templates/examples/shopping-cart/src/page/checkout.ts +205 -0
  282. package/dist/templates/examples/shopping-cart/src/page/index.ts +3 -0
  283. package/dist/templates/examples/shopping-cart/src/page/products.ts +267 -0
  284. package/dist/templates/examples/shopping-cart/src/route.ts +43 -0
  285. package/dist/templates/examples/shopping-cart/src/scene.test.ts +138 -0
  286. package/dist/templates/examples/shopping-cart/src/story.test.ts +233 -0
  287. package/dist/templates/examples/shopping-cart/src/styles.css +1 -0
  288. package/dist/templates/examples/shopping-cart/src/vitest-setup.ts +3 -0
  289. package/dist/templates/examples/slow-warnings/package.json +28 -0
  290. package/dist/templates/examples/slow-warnings/src/entry.ts +29 -0
  291. package/dist/templates/examples/slow-warnings/src/handleSlow.test.ts +43 -0
  292. package/dist/templates/examples/slow-warnings/src/main.ts +574 -0
  293. package/dist/templates/examples/slow-warnings/src/scene.test.ts +57 -0
  294. package/dist/templates/examples/slow-warnings/src/story.test.ts +118 -0
  295. package/dist/templates/examples/slow-warnings/src/styles.css +1 -0
  296. package/dist/templates/examples/slow-warnings/src/vitest-setup.ts +3 -0
  297. package/dist/templates/examples/snake/package.json +28 -0
  298. package/dist/templates/examples/snake/src/constants.ts +11 -0
  299. package/dist/templates/examples/snake/src/domain/apple.ts +22 -0
  300. package/dist/templates/examples/snake/src/domain/direction.ts +17 -0
  301. package/dist/templates/examples/snake/src/domain/index.ts +4 -0
  302. package/dist/templates/examples/snake/src/domain/position.ts +32 -0
  303. package/dist/templates/examples/snake/src/domain/snake.ts +43 -0
  304. package/dist/templates/examples/snake/src/entry.ts +17 -0
  305. package/dist/templates/examples/snake/src/main.ts +345 -0
  306. package/dist/templates/examples/snake/src/scene.test.ts +77 -0
  307. package/dist/templates/examples/snake/src/story.test.ts +165 -0
  308. package/dist/templates/examples/snake/src/styles.css +1 -0
  309. package/dist/templates/examples/snake/src/vitest-setup.ts +3 -0
  310. package/dist/templates/examples/ssg/package.json +29 -0
  311. package/dist/templates/examples/ssg/src/entry.server.ts +14 -0
  312. package/{templates/rendering → dist/templates/examples}/ssg/src/entry.ts +3 -11
  313. package/dist/templates/examples/ssg/src/main.ts +163 -0
  314. package/dist/templates/examples/ssg/src/styles.css +1 -0
  315. package/dist/templates/examples/ssr/package.json +33 -0
  316. package/dist/templates/examples/ssr/src/cookie.ts +13 -0
  317. package/dist/templates/examples/ssr/src/entry.server.ts +51 -0
  318. package/dist/templates/examples/ssr/src/main.ts +170 -0
  319. package/{templates/rendering → dist/templates/examples}/ssr/src/scene.test.ts +5 -8
  320. package/dist/templates/examples/ssr/src/styles.css +1 -0
  321. package/dist/templates/examples/ssr/src/vitest-setup.ts +3 -0
  322. package/dist/templates/examples/state-machine/package.json +30 -0
  323. package/dist/templates/examples/state-machine/src/entry.ts +17 -0
  324. package/dist/templates/examples/state-machine/src/icon.ts +51 -0
  325. package/dist/templates/examples/state-machine/src/main.ts +420 -0
  326. package/dist/templates/examples/state-machine/src/scene.test.ts +85 -0
  327. package/dist/templates/examples/state-machine/src/story.test.ts +199 -0
  328. package/dist/templates/examples/state-machine/src/styles.css +53 -0
  329. package/dist/templates/examples/state-machine/src/view.ts +1675 -0
  330. package/dist/templates/examples/state-machine/src/vitest-setup.ts +3 -0
  331. package/dist/templates/examples/stopwatch/package.json +29 -0
  332. package/dist/templates/examples/stopwatch/src/entry.ts +17 -0
  333. package/dist/templates/examples/stopwatch/src/main.ts +237 -0
  334. package/dist/templates/examples/stopwatch/src/scene.test.ts +124 -0
  335. package/dist/templates/examples/stopwatch/src/story.test.ts +126 -0
  336. package/dist/templates/examples/stopwatch/src/styles.css +1 -0
  337. package/dist/templates/examples/stopwatch/src/vitest-setup.ts +3 -0
  338. package/dist/templates/examples/todo/package.json +30 -0
  339. package/dist/templates/examples/todo/src/entry.ts +17 -0
  340. package/dist/templates/examples/todo/src/main.ts +682 -0
  341. package/dist/templates/examples/todo/src/scene.test.ts +177 -0
  342. package/dist/templates/examples/todo/src/story.test.ts +374 -0
  343. package/dist/templates/examples/todo/src/styles.css +1 -0
  344. package/dist/templates/examples/todo/src/vitest-setup.ts +3 -0
  345. package/dist/templates/examples/ui-showcase/package.json +30 -0
  346. package/dist/templates/examples/ui-showcase/src/entry.ts +31 -0
  347. package/dist/templates/examples/ui-showcase/src/icon.ts +64 -0
  348. package/dist/templates/examples/ui-showcase/src/main.ts +673 -0
  349. package/dist/templates/examples/ui-showcase/src/scene.test.ts +102 -0
  350. package/dist/templates/examples/ui-showcase/src/story.test.ts +128 -0
  351. package/dist/templates/examples/ui-showcase/src/styles.css +21 -0
  352. package/dist/templates/examples/ui-showcase/src/ui/init.ts +185 -0
  353. package/dist/templates/examples/ui-showcase/src/ui/message.ts +164 -0
  354. package/dist/templates/examples/ui-showcase/src/ui/model.ts +138 -0
  355. package/dist/templates/examples/ui-showcase/src/ui/subscriptions.ts +55 -0
  356. package/dist/templates/examples/ui-showcase/src/ui/toast.ts +13 -0
  357. package/dist/templates/examples/ui-showcase/src/ui/update.ts +1234 -0
  358. package/dist/templates/examples/ui-showcase/src/ui/view/animation.ts +58 -0
  359. package/dist/templates/examples/ui-showcase/src/ui/view/button.ts +64 -0
  360. package/dist/templates/examples/ui-showcase/src/ui/view/calendar.ts +202 -0
  361. package/dist/templates/examples/ui-showcase/src/ui/view/checkbox.ts +185 -0
  362. package/dist/templates/examples/ui-showcase/src/ui/view/combobox.ts +326 -0
  363. package/dist/templates/examples/ui-showcase/src/ui/view/datePicker.ts +263 -0
  364. package/dist/templates/examples/ui-showcase/src/ui/view/dialog.ts +427 -0
  365. package/dist/templates/examples/ui-showcase/src/ui/view/disclosure.ts +142 -0
  366. package/dist/templates/examples/ui-showcase/src/ui/view/dragAndDrop.ts +230 -0
  367. package/dist/templates/examples/ui-showcase/src/ui/view/fieldset.ts +284 -0
  368. package/dist/templates/examples/ui-showcase/src/ui/view/fileDrop.ts +119 -0
  369. package/dist/templates/examples/ui-showcase/src/ui/view/index.ts +24 -0
  370. package/dist/templates/examples/ui-showcase/src/ui/view/input.ts +90 -0
  371. package/dist/templates/examples/ui-showcase/src/ui/view/listbox.ts +263 -0
  372. package/dist/templates/examples/ui-showcase/src/ui/view/menu.ts +172 -0
  373. package/dist/templates/examples/ui-showcase/src/ui/view/popover.ts +262 -0
  374. package/dist/templates/examples/ui-showcase/src/ui/view/radioGroup.ts +192 -0
  375. package/dist/templates/examples/ui-showcase/src/ui/view/select.ts +129 -0
  376. package/dist/templates/examples/ui-showcase/src/ui/view/slider.ts +135 -0
  377. package/dist/templates/examples/ui-showcase/src/ui/view/switch.ts +82 -0
  378. package/dist/templates/examples/ui-showcase/src/ui/view/tabs.ts +187 -0
  379. package/dist/templates/examples/ui-showcase/src/ui/view/textarea.ts +99 -0
  380. package/dist/templates/examples/ui-showcase/src/ui/view/toast.ts +165 -0
  381. package/dist/templates/examples/ui-showcase/src/ui/view/tooltip.ts +123 -0
  382. package/dist/templates/examples/ui-showcase/src/ui/view/virtualList.ts +361 -0
  383. package/dist/templates/examples/ui-showcase/src/vitest-setup.ts +3 -0
  384. package/dist/templates/examples/view-transitions/package.json +28 -0
  385. package/dist/templates/examples/view-transitions/src/artwork.ts +80 -0
  386. package/dist/templates/examples/view-transitions/src/entry.ts +21 -0
  387. package/dist/templates/examples/view-transitions/src/main.ts +348 -0
  388. package/dist/templates/examples/view-transitions/src/route.ts +29 -0
  389. package/dist/templates/examples/view-transitions/src/scene.test.ts +130 -0
  390. package/dist/templates/examples/view-transitions/src/styles.css +66 -0
  391. package/dist/templates/examples/view-transitions/src/vitest-setup.ts +3 -0
  392. package/dist/templates/examples/weather/package.json +29 -0
  393. package/dist/templates/examples/weather/src/entry.ts +16 -0
  394. package/dist/templates/examples/weather/src/main.fixtures.ts +59 -0
  395. package/dist/templates/examples/weather/src/main.ts +356 -0
  396. package/dist/templates/examples/weather/src/scene.test.ts +109 -0
  397. package/dist/templates/examples/weather/src/story.test.ts +125 -0
  398. package/dist/templates/examples/weather/src/styles.css +1 -0
  399. package/dist/templates/examples/weather/src/vitest-setup.ts +3 -0
  400. package/dist/templates/examples/web-components/package.json +32 -0
  401. package/dist/templates/examples/web-components/src/entry.ts +16 -0
  402. package/dist/templates/examples/web-components/src/main.ts +327 -0
  403. package/dist/templates/examples/web-components/src/scene.test.ts +90 -0
  404. package/dist/templates/examples/web-components/src/story.test.ts +90 -0
  405. package/dist/templates/examples/web-components/src/styles.css +1 -0
  406. package/dist/templates/examples/web-components/src/vitest-setup.ts +3 -0
  407. package/dist/templates/examples/websocket-chat/package.json +29 -0
  408. package/dist/templates/examples/websocket-chat/src/entry.ts +26 -0
  409. package/dist/templates/examples/websocket-chat/src/main.ts +626 -0
  410. package/dist/templates/examples/websocket-chat/src/scene.test.ts +166 -0
  411. package/dist/templates/examples/websocket-chat/src/story.test.ts +183 -0
  412. package/dist/templates/examples/websocket-chat/src/styles.css +1 -0
  413. package/dist/templates/examples/websocket-chat/src/vitest-setup.ts +3 -0
  414. package/dist/templates/release.json +27 -0
  415. package/dist/templates/rendering/ssg/src/entry.ts +20 -0
  416. package/{templates → dist/templates}/rendering/ssg/src/main.ts +36 -43
  417. package/dist/templates/rendering/ssg/src/route.ts +20 -0
  418. package/dist/templates/rendering/ssg/src/vite-env.d.ts +19 -0
  419. package/dist/templates/rendering/ssr/src/entry.ts +17 -0
  420. package/{templates → dist/templates}/rendering/ssr/src/main.ts +17 -25
  421. package/dist/templates/rendering/ssr/src/scene.test.ts +40 -0
  422. package/dist/templates/rendering/ssr/src/vite-env.d.ts +19 -0
  423. package/dist/utils/files.js +23 -71
  424. package/dist/utils/packages.js +63 -44
  425. package/package.json +3 -4
  426. /package/{templates → dist/templates}/base/.mcp.json +0 -0
  427. /package/{templates → dist/templates}/base/.oxlintrc.json +0 -0
  428. /package/{templates → dist/templates}/base/.prettierignore +0 -0
  429. /package/{templates → dist/templates}/base/.prettierrc +0 -0
  430. /package/{templates → dist/templates}/base/README.md +0 -0
  431. /package/{templates → dist/templates}/base/gitignore +0 -0
  432. /package/{templates → dist/templates}/base/ignore +0 -0
  433. /package/{templates → dist/templates}/base/index.html +0 -0
  434. /package/{templates → dist/templates}/base/package.json +0 -0
  435. /package/{templates → dist/templates}/base/src/styles.css +0 -0
  436. /package/{templates → dist/templates}/base/src/vitest-setup.ts +0 -0
  437. /package/{templates → dist/templates}/base/tsconfig.json +0 -0
  438. /package/{templates → dist/templates}/base/vite.config.ts +0 -0
  439. /package/{templates → dist/templates}/base/vitest.config.ts +0 -0
  440. /package/{templates/rendering → dist/templates/examples}/ssg/src/route.ts +0 -0
  441. /package/{templates/rendering → dist/templates/examples}/ssg/src/vite-env.d.ts +0 -0
  442. /package/{templates/rendering → dist/templates/examples}/ssr/src/entry.ts +0 -0
  443. /package/{templates/rendering → dist/templates/examples}/ssr/src/vite-env.d.ts +0 -0
  444. /package/{templates → dist/templates}/package-managers/pnpm/pnpm-workspace.yaml +0 -0
  445. /package/{templates → dist/templates}/rendering/ssg/README.md +0 -0
  446. /package/{templates → dist/templates}/rendering/ssg/package.json +0 -0
  447. /package/{templates → dist/templates}/rendering/ssg/scripts/build.mjs +0 -0
  448. /package/{templates → dist/templates}/rendering/ssg/scripts/prerender.ts +0 -0
  449. /package/{templates → dist/templates}/rendering/ssg/src/entry.server.ts +0 -0
  450. /package/{templates → dist/templates}/rendering/ssg/src/scene.test.ts +0 -0
  451. /package/{templates → dist/templates}/rendering/ssg/tsconfig.json +0 -0
  452. /package/{templates → dist/templates}/rendering/ssg/vite.config.ts +0 -0
  453. /package/{templates → dist/templates}/rendering/ssr/README.md +0 -0
  454. /package/{templates → dist/templates}/rendering/ssr/package.json +0 -0
  455. /package/{templates → dist/templates}/rendering/ssr/scripts/build.mjs +0 -0
  456. /package/{templates → dist/templates}/rendering/ssr/server/main.ts +0 -0
  457. /package/{templates → dist/templates}/rendering/ssr/src/cookie.ts +0 -0
  458. /package/{templates → dist/templates}/rendering/ssr/src/entry.server.ts +0 -0
  459. /package/{templates → dist/templates}/rendering/ssr/tsconfig.json +0 -0
  460. /package/{templates → dist/templates}/rendering/ssr/vite.config.ts +0 -0
@@ -0,0 +1,798 @@
1
+ import {
2
+ Array,
3
+ Duration,
4
+ Effect,
5
+ Match as M,
6
+ Option,
7
+ Schema as S,
8
+ pipe,
9
+ } from 'effect'
10
+ import { Command, Runtime, Update } from 'foldkit'
11
+ import { Document, Html, HtmlBuilder } from 'foldkit/html'
12
+ import { defineMessageUnion } from 'foldkit/message'
13
+ import { UrlRequest, load, pushUrl } from 'foldkit/navigation'
14
+ import { Transition } from 'foldkit/route'
15
+ import { ts } from 'foldkit/schema'
16
+ import { evo } from 'foldkit/struct'
17
+ import { Url, toString as urlToString } from 'foldkit/url'
18
+
19
+ import { type Painting, findPaintingWithIndex, paintings } from './data'
20
+ import {
21
+ AppRoute,
22
+ galleryRouter,
23
+ homeRouter,
24
+ paintingRouter,
25
+ studioRouter,
26
+ urlToAppRoute,
27
+ } from './route'
28
+
29
+ export {
30
+ AppRoute,
31
+ GalleryRoute,
32
+ HomeRoute,
33
+ NotFoundRoute,
34
+ PaintingRoute,
35
+ StudioRoute,
36
+ } from './route'
37
+
38
+ const CATALOG_LATENCY = Duration.millis(600)
39
+ const PAINTING_LATENCY = Duration.millis(400)
40
+ const SAVE_LATENCY = Duration.millis(300)
41
+ const MAX_LOGGED_TRANSITIONS = 20
42
+
43
+ // MODEL
44
+
45
+ export const CatalogStatus = S.Literals(['Idle', 'Loading', 'Ready'])
46
+ export type CatalogStatus = typeof CatalogStatus.Type
47
+
48
+ export const PaintingIdle = ts('PaintingIdle')
49
+ export const PaintingLoading = ts('PaintingLoading', { paintingId: S.Number })
50
+ export const PaintingReady = ts('PaintingReady', { paintingId: S.Number })
51
+
52
+ export const PaintingStatus = S.Union([
53
+ PaintingIdle,
54
+ PaintingLoading,
55
+ PaintingReady,
56
+ ])
57
+ export type PaintingStatus = typeof PaintingStatus.Type
58
+
59
+ export const LoggedTransition = S.Struct({
60
+ sequenceNumber: S.Number,
61
+ maybePreviousRoute: S.Option(AppRoute),
62
+ nextRoute: AppRoute,
63
+ })
64
+ export type LoggedTransition = typeof LoggedTransition.Type
65
+
66
+ export const Model = S.Struct({
67
+ route: AppRoute,
68
+ transitionLog: S.Array(LoggedTransition),
69
+ catalogStatus: CatalogStatus,
70
+ paintingStatus: PaintingStatus,
71
+ studioDraft: S.String,
72
+ maybeSavedDraft: S.Option(S.String),
73
+ })
74
+ export type Model = typeof Model.Type
75
+
76
+ // MESSAGE
77
+
78
+ export const Message = defineMessageUnion({
79
+ CompletedNavigateInternal: {},
80
+ CompletedLoadExternal: {},
81
+ ClickedLink: { request: UrlRequest },
82
+ ChangedUrl: { url: Url },
83
+ SucceededLoadCatalog: {},
84
+ SucceededLoadPainting: { paintingId: S.Number },
85
+ UpdatedStudioDraft: { value: S.String },
86
+ SucceededSaveDraft: { draft: S.String },
87
+ })
88
+
89
+ export type Message = typeof Message.Type
90
+
91
+ // COMMAND
92
+
93
+ const NavigateInternal = Command.define('NavigateInternal', {
94
+ args: { url: S.String },
95
+ messages: [Message.CompletedNavigateInternal],
96
+ execute: ({ url }) =>
97
+ pushUrl(url).pipe(Effect.as(Message.CompletedNavigateInternal())),
98
+ })
99
+
100
+ const LoadExternal = Command.define('LoadExternal', {
101
+ args: { href: S.String },
102
+ messages: [Message.CompletedLoadExternal],
103
+ execute: ({ href }) =>
104
+ load(href).pipe(Effect.as(Message.CompletedLoadExternal())),
105
+ })
106
+
107
+ export const LoadCatalog = Command.define('LoadCatalog', {
108
+ messages: [Message.SucceededLoadCatalog],
109
+ execute: Effect.sleep(CATALOG_LATENCY).pipe(
110
+ Effect.as(Message.SucceededLoadCatalog()),
111
+ ),
112
+ })
113
+
114
+ export const LoadPainting = Command.define('LoadPainting', {
115
+ args: { paintingId: S.Number },
116
+ messages: [Message.SucceededLoadPainting],
117
+ execute: ({ paintingId }) =>
118
+ Effect.sleep(PAINTING_LATENCY).pipe(
119
+ Effect.as(Message.SucceededLoadPainting({ paintingId })),
120
+ ),
121
+ })
122
+
123
+ export const SaveDraft = Command.define('SaveDraft', {
124
+ args: { draft: S.String },
125
+ messages: [Message.SucceededSaveDraft],
126
+ execute: ({ draft }) =>
127
+ Effect.sleep(SAVE_LATENCY).pipe(
128
+ Effect.as(Message.SucceededSaveDraft({ draft })),
129
+ ),
130
+ })
131
+
132
+ // UPDATE
133
+
134
+ type UpdateReturn = Update.Return<Model, Message>
135
+ type Step = Update.Step<Model, Message>
136
+ const withUpdateReturn = M.withReturnType<UpdateReturn>()
137
+
138
+ export type AppTransition = Transition.Transition<AppRoute>
139
+
140
+ const nextSequenceNumber = (
141
+ transitionLog: ReadonlyArray<LoggedTransition>,
142
+ ): number =>
143
+ Option.match(Array.head(transitionLog), {
144
+ onNone: () => 1,
145
+ onSome: newestEntry => newestEntry.sequenceNumber + 1,
146
+ })
147
+
148
+ const logTransition =
149
+ (transition: AppTransition): Step =>
150
+ model => [
151
+ evo(model, {
152
+ transitionLog: transitionLog =>
153
+ pipe(
154
+ transitionLog,
155
+ Array.prepend({
156
+ sequenceNumber: nextSequenceNumber(transitionLog),
157
+ maybePreviousRoute: transition.maybePreviousRoute,
158
+ nextRoute: transition.nextRoute,
159
+ }),
160
+ Array.take(MAX_LOGGED_TRANSITIONS),
161
+ ),
162
+ }),
163
+ [],
164
+ ]
165
+
166
+ const loadCatalogOnGalleryEntry =
167
+ (transition: AppTransition): Step =>
168
+ model =>
169
+ Transition.isEntering(transition, 'Gallery') &&
170
+ model.catalogStatus !== 'Loading'
171
+ ? [evo(model, { catalogStatus: () => 'Loading' }), [LoadCatalog()]]
172
+ : [model, []]
173
+
174
+ const loadPaintingOnEntry =
175
+ (transition: AppTransition): Step =>
176
+ model =>
177
+ Option.match(Transition.entered(transition, 'Painting'), {
178
+ onNone: () => [model, []],
179
+ onSome: ({ paintingId }) => [
180
+ evo(model, { paintingStatus: () => PaintingLoading({ paintingId }) }),
181
+ [LoadPainting({ paintingId })],
182
+ ],
183
+ })
184
+
185
+ const reloadPaintingOnIdChange =
186
+ (transition: AppTransition): Step =>
187
+ model =>
188
+ Option.match(Transition.stayed(transition, 'Painting'), {
189
+ onNone: () => [model, []],
190
+ onSome: ({ previousRoute, nextRoute }) =>
191
+ previousRoute.paintingId === nextRoute.paintingId
192
+ ? [model, []]
193
+ : [
194
+ evo(model, {
195
+ paintingStatus: () =>
196
+ PaintingLoading({ paintingId: nextRoute.paintingId }),
197
+ }),
198
+ [LoadPainting({ paintingId: nextRoute.paintingId })],
199
+ ],
200
+ })
201
+
202
+ const saveDraftOnStudioExit =
203
+ (transition: AppTransition): Step =>
204
+ model =>
205
+ Option.match(Transition.exited(transition, 'Studio'), {
206
+ onNone: () => [model, []],
207
+ onSome: () =>
208
+ model.studioDraft === ''
209
+ ? [model, []]
210
+ : [model, [SaveDraft({ draft: model.studioDraft })]],
211
+ })
212
+
213
+ const handleTransition = (
214
+ model: Model,
215
+ transition: AppTransition,
216
+ ): UpdateReturn =>
217
+ Update.combine(model, [
218
+ logTransition(transition),
219
+ loadCatalogOnGalleryEntry(transition),
220
+ loadPaintingOnEntry(transition),
221
+ reloadPaintingOnIdChange(transition),
222
+ saveDraftOnStudioExit(transition),
223
+ ])
224
+
225
+ export const update = (model: Model, message: Message) =>
226
+ Message.match<UpdateReturn>(message, {
227
+ CompletedNavigateInternal: () => [model, []],
228
+ CompletedLoadExternal: () => [model, []],
229
+
230
+ ClickedLink: ({ request }) =>
231
+ M.value(request).pipe(
232
+ withUpdateReturn,
233
+ M.tagsExhaustive({
234
+ Internal: ({ url }) => [
235
+ model,
236
+ [NavigateInternal({ url: urlToString(url) })],
237
+ ],
238
+ External: ({ href }) => [model, [LoadExternal({ href })]],
239
+ }),
240
+ ),
241
+
242
+ ChangedUrl: ({ url }) => {
243
+ const nextRoute = urlToAppRoute(url)
244
+ const transition = Transition.make(model.route, nextRoute)
245
+ return handleTransition(
246
+ evo(model, { route: () => nextRoute }),
247
+ transition,
248
+ )
249
+ },
250
+
251
+ SucceededLoadCatalog: () => [
252
+ evo(model, { catalogStatus: () => 'Ready' }),
253
+ [],
254
+ ],
255
+
256
+ SucceededLoadPainting: ({ paintingId }) =>
257
+ model.paintingStatus._tag === 'PaintingLoading' &&
258
+ model.paintingStatus.paintingId === paintingId
259
+ ? [
260
+ evo(model, {
261
+ paintingStatus: () => PaintingReady({ paintingId }),
262
+ }),
263
+ [],
264
+ ]
265
+ : [model, []],
266
+
267
+ UpdatedStudioDraft: ({ value }) => [
268
+ evo(model, { studioDraft: () => value }),
269
+ [],
270
+ ],
271
+
272
+ SucceededSaveDraft: ({ draft }) => [
273
+ evo(model, { maybeSavedDraft: () => Option.some(draft) }),
274
+ [],
275
+ ],
276
+ })
277
+
278
+ // INIT
279
+
280
+ export const init: Runtime.RoutingApplicationInit<Model, Message> = (
281
+ url: Url,
282
+ ) => {
283
+ const route = urlToAppRoute(url)
284
+ const initialModel = Model.make({
285
+ route,
286
+ transitionLog: [],
287
+ catalogStatus: 'Idle',
288
+ paintingStatus: PaintingIdle(),
289
+ studioDraft: '',
290
+ maybeSavedDraft: Option.none(),
291
+ })
292
+ return handleTransition(initialModel, Transition.coldLoad(route))
293
+ }
294
+
295
+ // VIEW
296
+
297
+ const routeLabel = (route: AppRoute): string =>
298
+ M.value(route).pipe(
299
+ M.tagsExhaustive({
300
+ Home: () => 'Home',
301
+ Gallery: () => 'Gallery',
302
+ Painting: ({ paintingId }) => `Painting ${paintingId}`,
303
+ Studio: () => 'Studio',
304
+ NotFound: () => 'Not found',
305
+ }),
306
+ )
307
+
308
+ const navigationView = (
309
+ currentRoute: AppRoute,
310
+ h: HtmlBuilder<Message>,
311
+ ): Html => {
312
+ const navLinkClassName = (isActive: boolean) =>
313
+ `font-medium px-3 py-1 rounded transition hover:bg-indigo-500 ${isActive ? 'bg-indigo-700' : ''}`
314
+
315
+ return h.nav(
316
+ [h.Class('bg-indigo-600 text-white p-4')],
317
+ [
318
+ h.ul(
319
+ [h.Class('max-w-6xl mx-auto flex gap-4 list-none')],
320
+ [
321
+ h.li(
322
+ [],
323
+ [
324
+ h.a(
325
+ [
326
+ h.Href(homeRouter()),
327
+ h.Class(navLinkClassName(currentRoute._tag === 'Home')),
328
+ ],
329
+ ['Home'],
330
+ ),
331
+ ],
332
+ ),
333
+ h.li(
334
+ [],
335
+ [
336
+ h.a(
337
+ [
338
+ h.Href(galleryRouter()),
339
+ h.Class(
340
+ navLinkClassName(
341
+ currentRoute._tag === 'Gallery' ||
342
+ currentRoute._tag === 'Painting',
343
+ ),
344
+ ),
345
+ ],
346
+ ['Gallery'],
347
+ ),
348
+ ],
349
+ ),
350
+ h.li(
351
+ [],
352
+ [
353
+ h.a(
354
+ [
355
+ h.Href(studioRouter()),
356
+ h.Class(navLinkClassName(currentRoute._tag === 'Studio')),
357
+ ],
358
+ ['Studio'],
359
+ ),
360
+ ],
361
+ ),
362
+ ],
363
+ ),
364
+ ],
365
+ )
366
+ }
367
+
368
+ const homeView = (h: HtmlBuilder<Message>): Html =>
369
+ h.div(
370
+ [],
371
+ [
372
+ h.h1(
373
+ [h.Class('text-4xl font-bold text-gray-800 mb-6')],
374
+ ['Route Transitions'],
375
+ ),
376
+ h.p(
377
+ [h.Class('text-lg text-gray-600 mb-4')],
378
+ [
379
+ 'Every navigation in this app is described by the Transition helpers from foldkit/route, and the log on the right narrates what each one said. The cold load that brought you here is already in it.',
380
+ ],
381
+ ),
382
+ h.p([h.Class('text-gray-600 mb-2')], ['Things to try:']),
383
+ h.ul(
384
+ [h.Class('list-disc pl-6 text-gray-600 space-y-2')],
385
+ [
386
+ h.li(
387
+ [],
388
+ [
389
+ 'Open the Gallery. Entering it fires a catalog load once; navigating back and forth fires it again only on each fresh entry.',
390
+ ],
391
+ ),
392
+ h.li(
393
+ [],
394
+ [
395
+ 'Open a painting and flip to the next one. Staying on the Painting route is not an entry, so the log shows a stayed transition and only the changed id refetches.',
396
+ ],
397
+ ),
398
+ h.li(
399
+ [],
400
+ [
401
+ 'Write a draft in the Studio and leave. Exiting the route is a fact, and it becomes a one-shot save Command.',
402
+ ],
403
+ ),
404
+ h.li(
405
+ [],
406
+ [
407
+ 'Reload the page anywhere. A cold load has no previous route and still counts as an entry.',
408
+ ],
409
+ ),
410
+ ],
411
+ ),
412
+ ],
413
+ )
414
+
415
+ const loadingView = (label: string, h: HtmlBuilder<Message>): Html =>
416
+ h.div(
417
+ [
418
+ h.Class(
419
+ 'border border-dashed border-gray-300 rounded-lg p-12 text-center text-gray-500',
420
+ ),
421
+ ],
422
+ [label],
423
+ )
424
+
425
+ const paintingGridView = (h: HtmlBuilder<Message>): Html =>
426
+ h.ul(
427
+ [h.Class('grid gap-4 sm:grid-cols-2 list-none')],
428
+ Array.map(paintings, painting =>
429
+ h.keyed('li')(
430
+ String(painting.id),
431
+ [],
432
+ [
433
+ h.a(
434
+ [
435
+ h.Href(paintingRouter({ paintingId: painting.id })),
436
+ h.Class(
437
+ 'block bg-white rounded-lg shadow hover:shadow-md transition overflow-hidden',
438
+ ),
439
+ ],
440
+ [
441
+ h.div([h.Class(`h-28 bg-gradient-to-br ${painting.gradient}`)]),
442
+ h.div(
443
+ [h.Class('p-4')],
444
+ [
445
+ h.h3(
446
+ [h.Class('font-semibold text-gray-800')],
447
+ [painting.title],
448
+ ),
449
+ h.p([h.Class('text-sm text-gray-500')], [painting.artist]),
450
+ ],
451
+ ),
452
+ ],
453
+ ),
454
+ ],
455
+ ),
456
+ ),
457
+ )
458
+
459
+ const galleryView = (
460
+ catalogStatus: CatalogStatus,
461
+ h: HtmlBuilder<Message>,
462
+ ): Html => {
463
+ const isCatalogReady = catalogStatus === 'Ready'
464
+
465
+ return h.div(
466
+ [],
467
+ [
468
+ h.h1([h.Class('text-4xl font-bold text-gray-800 mb-2')], ['Gallery']),
469
+ h.p(
470
+ [h.Class('text-gray-600 mb-6')],
471
+ [
472
+ 'The catalog loads when a transition enters this route, whether by navigation or by cold load.',
473
+ ],
474
+ ),
475
+ isCatalogReady
476
+ ? paintingGridView(h)
477
+ : loadingView('Hanging the paintings…', h),
478
+ ],
479
+ )
480
+ }
481
+
482
+ const neighborView = (
483
+ label: string,
484
+ maybeNeighbor: Option.Option<Painting>,
485
+ h: HtmlBuilder<Message>,
486
+ ): Html =>
487
+ Option.match(maybeNeighbor, {
488
+ onNone: () => h.span([h.Class('text-gray-300')], [label]),
489
+ onSome: neighbor =>
490
+ h.a(
491
+ [
492
+ h.Href(paintingRouter({ paintingId: neighbor.id })),
493
+ h.Class('text-indigo-600 hover:underline font-medium'),
494
+ ],
495
+ [label],
496
+ ),
497
+ })
498
+
499
+ const paintingNeighborsView = (
500
+ paintingIndex: number,
501
+ h: HtmlBuilder<Message>,
502
+ ): Html =>
503
+ h.div(
504
+ [h.Class('flex items-center justify-between mt-6')],
505
+ [
506
+ neighborView('← Previous', Array.get(paintings, paintingIndex - 1), h),
507
+ h.span(
508
+ [h.Class('text-sm text-gray-500')],
509
+ [`${paintingIndex + 1} of ${paintings.length}`],
510
+ ),
511
+ neighborView('Next →', Array.get(paintings, paintingIndex + 1), h),
512
+ ],
513
+ )
514
+
515
+ const missingPaintingView = (
516
+ paintingId: number,
517
+ h: HtmlBuilder<Message>,
518
+ ): Html =>
519
+ h.div(
520
+ [],
521
+ [
522
+ h.h1(
523
+ [h.Class('text-4xl font-bold text-red-600 mb-6')],
524
+ ['Painting Not Found'],
525
+ ),
526
+ h.p(
527
+ [h.Class('text-lg text-gray-600 mb-4')],
528
+ [`No painting with id ${paintingId} hangs in this gallery.`],
529
+ ),
530
+ h.a(
531
+ [h.Href(galleryRouter()), h.Class('text-indigo-600 hover:underline')],
532
+ ['← Back to Gallery'],
533
+ ),
534
+ ],
535
+ )
536
+
537
+ const foundPaintingView = (
538
+ painting: Painting,
539
+ paintingIndex: number,
540
+ paintingStatus: PaintingStatus,
541
+ h: HtmlBuilder<Message>,
542
+ ): Html => {
543
+ const isPaintingReady =
544
+ paintingStatus._tag === 'PaintingReady' &&
545
+ paintingStatus.paintingId === painting.id
546
+
547
+ return h.div(
548
+ [],
549
+ [
550
+ h.a(
551
+ [
552
+ h.Href(galleryRouter()),
553
+ h.Class('text-indigo-600 hover:underline mb-4 inline-block'),
554
+ ],
555
+ ['← Back to Gallery'],
556
+ ),
557
+ isPaintingReady
558
+ ? h.article(
559
+ [h.Class('bg-white rounded-lg shadow overflow-hidden')],
560
+ [
561
+ h.div([h.Class(`h-56 bg-gradient-to-br ${painting.gradient}`)]),
562
+ h.div(
563
+ [h.Class('p-6')],
564
+ [
565
+ h.h1(
566
+ [h.Class('text-3xl font-bold text-gray-800 mb-1')],
567
+ [painting.title],
568
+ ),
569
+ h.p([h.Class('text-gray-500')], [painting.artist]),
570
+ ],
571
+ ),
572
+ ],
573
+ )
574
+ : loadingView('Unpacking the painting…', h),
575
+ paintingNeighborsView(paintingIndex, h),
576
+ ],
577
+ )
578
+ }
579
+
580
+ const paintingView = (
581
+ paintingId: number,
582
+ paintingStatus: PaintingStatus,
583
+ h: HtmlBuilder<Message>,
584
+ ): Html =>
585
+ Option.match(findPaintingWithIndex(paintingId), {
586
+ onNone: () => missingPaintingView(paintingId, h),
587
+ onSome: ({ painting, paintingIndex }) =>
588
+ foundPaintingView(painting, paintingIndex, paintingStatus, h),
589
+ })
590
+
591
+ const studioView = (
592
+ studioDraft: string,
593
+ maybeSavedDraft: Option.Option<string>,
594
+ h: HtmlBuilder<Message>,
595
+ ): Html =>
596
+ h.div(
597
+ [],
598
+ [
599
+ h.h1([h.Class('text-4xl font-bold text-gray-800 mb-2')], ['Studio']),
600
+ h.p(
601
+ [h.Class('text-gray-600 mb-6')],
602
+ [
603
+ 'Write something, then leave. Exiting this route fires a one-shot SaveDraft Command with whatever is here.',
604
+ ],
605
+ ),
606
+ h.textarea([
607
+ h.Value(studioDraft),
608
+ h.OnInput(value => Message.UpdatedStudioDraft({ value })),
609
+ h.Placeholder('A half-finished thought…'),
610
+ h.Class(
611
+ 'w-full h-40 bg-white border border-gray-300 rounded-lg p-4 focus:outline-none focus:ring-2 focus:ring-indigo-500',
612
+ ),
613
+ ]),
614
+ h.div(
615
+ [h.Class('mt-6')],
616
+ [
617
+ Option.match(maybeSavedDraft, {
618
+ onNone: () =>
619
+ h.p([h.Class('text-sm text-gray-500')], ['Nothing saved yet.']),
620
+ onSome: savedDraft =>
621
+ h.div(
622
+ [h.Class('bg-white border border-gray-200 rounded-lg p-4')],
623
+ [
624
+ h.h2(
625
+ [
626
+ h.Class(
627
+ 'text-sm font-medium text-gray-500 uppercase tracking-wide mb-1',
628
+ ),
629
+ ],
630
+ ['Last saved draft'],
631
+ ),
632
+ h.p([h.Class('text-gray-800')], [savedDraft]),
633
+ ],
634
+ ),
635
+ }),
636
+ ],
637
+ ),
638
+ ],
639
+ )
640
+
641
+ const notFoundView = (path: string, h: HtmlBuilder<Message>): Html =>
642
+ h.div(
643
+ [],
644
+ [
645
+ h.h1(
646
+ [h.Class('text-4xl font-bold text-red-600 mb-6')],
647
+ ['404 - Page Not Found'],
648
+ ),
649
+ h.p(
650
+ [h.Class('text-lg text-gray-600 mb-4')],
651
+ [`The path "${path}" was not found.`],
652
+ ),
653
+ h.a(
654
+ [h.Href(homeRouter()), h.Class('text-indigo-600 hover:underline')],
655
+ ['← Go Home'],
656
+ ),
657
+ ],
658
+ )
659
+
660
+ const badgeView = (
661
+ className: string,
662
+ label: string,
663
+ h: HtmlBuilder<Message>,
664
+ ): Html =>
665
+ h.span(
666
+ [
667
+ h.Class(
668
+ `text-xs font-medium px-2 py-0.5 rounded-full whitespace-nowrap ${className}`,
669
+ ),
670
+ ],
671
+ [label],
672
+ )
673
+
674
+ const logEntryBadges = (
675
+ transition: AppTransition,
676
+ h: HtmlBuilder<Message>,
677
+ ): ReadonlyArray<Html> => {
678
+ const coldLoadBadges = Option.match(transition.maybePreviousRoute, {
679
+ onNone: () => [badgeView('bg-violet-100 text-violet-700', 'Cold load', h)],
680
+ onSome: () => [],
681
+ })
682
+
683
+ const maybeEnteredBadge = Option.map(
684
+ Transition.enteredAny(transition),
685
+ route =>
686
+ badgeView('bg-emerald-100 text-emerald-700', `Entered ${route._tag}`, h),
687
+ )
688
+
689
+ const maybeExitedBadge = Option.map(Transition.exitedAny(transition), route =>
690
+ badgeView('bg-amber-100 text-amber-700', `Exited ${route._tag}`, h),
691
+ )
692
+
693
+ const maybeStayedBadge = Option.map(
694
+ Transition.stayed(transition, 'Painting'),
695
+ ({ previousRoute, nextRoute }) =>
696
+ badgeView(
697
+ 'bg-sky-100 text-sky-700',
698
+ `Stayed on Painting: ${previousRoute.paintingId} → ${nextRoute.paintingId}`,
699
+ h,
700
+ ),
701
+ )
702
+
703
+ const helperBadges = Array.getSomes([
704
+ maybeEnteredBadge,
705
+ maybeExitedBadge,
706
+ maybeStayedBadge,
707
+ ])
708
+
709
+ return Array.match([...coldLoadBadges, ...helperBadges], {
710
+ onEmpty: () => [
711
+ badgeView('bg-gray-100 text-gray-600', 'Stayed within route', h),
712
+ ],
713
+ onNonEmpty: badges => badges,
714
+ })
715
+ }
716
+
717
+ const logEntryView = (
718
+ entry: LoggedTransition,
719
+ h: HtmlBuilder<Message>,
720
+ ): Html => {
721
+ const sourceLabel = Option.match(entry.maybePreviousRoute, {
722
+ onNone: () => 'Cold load',
723
+ onSome: routeLabel,
724
+ })
725
+
726
+ return h.keyed('li')(
727
+ String(entry.sequenceNumber),
728
+ [h.Class('border border-gray-200 rounded-md p-3')],
729
+ [
730
+ h.p(
731
+ [h.Class('text-xs text-gray-500 mb-2')],
732
+ [
733
+ `#${entry.sequenceNumber} ${sourceLabel} → ${routeLabel(entry.nextRoute)}`,
734
+ ],
735
+ ),
736
+ h.div([h.Class('flex flex-wrap gap-1.5')], logEntryBadges(entry, h)),
737
+ ],
738
+ )
739
+ }
740
+
741
+ const transitionLogView = (
742
+ transitionLog: ReadonlyArray<LoggedTransition>,
743
+ h: HtmlBuilder<Message>,
744
+ ): Html =>
745
+ h.aside(
746
+ [h.Class('bg-white rounded-lg shadow p-4 h-fit lg:sticky lg:top-8')],
747
+ [
748
+ h.h2(
749
+ [h.Class('text-lg font-bold text-gray-800 mb-1')],
750
+ ['Transition Log'],
751
+ ),
752
+ h.p(
753
+ [h.Class('text-sm text-gray-500 mb-4')],
754
+ ['The most recent navigations, described by the Transition helpers.'],
755
+ ),
756
+ h.ul(
757
+ [h.Class('space-y-3 list-none')],
758
+ Array.map(transitionLog, entry => logEntryView(entry, h)),
759
+ ),
760
+ ],
761
+ )
762
+
763
+ const routeTitle = (route: AppRoute): string =>
764
+ M.value(route).pipe(
765
+ M.tag('Home', () => 'Route Transitions'),
766
+ M.orElse(currentRoute => `${routeLabel(currentRoute)} | Route Transitions`),
767
+ )
768
+
769
+ export const view = (model: Model, h: HtmlBuilder<Message>): Document => {
770
+ const routeContent = M.value(model.route).pipe(
771
+ M.tagsExhaustive({
772
+ Home: () => homeView(h),
773
+ Gallery: () => galleryView(model.catalogStatus, h),
774
+ Painting: ({ paintingId }) =>
775
+ paintingView(paintingId, model.paintingStatus, h),
776
+ Studio: () => studioView(model.studioDraft, model.maybeSavedDraft, h),
777
+ NotFound: ({ path }) => notFoundView(path, h),
778
+ }),
779
+ )
780
+
781
+ return {
782
+ title: routeTitle(model.route),
783
+ body: h.div(
784
+ [h.Class('min-h-screen bg-gray-100')],
785
+ [
786
+ h.header([], [navigationView(model.route, h)]),
787
+ h.main(
788
+ [
789
+ h.Class(
790
+ 'max-w-6xl mx-auto px-4 py-8 grid gap-8 lg:grid-cols-[minmax(0,1fr)_360px] items-start',
791
+ ),
792
+ ],
793
+ [routeContent, transitionLogView(model.transitionLog, h)],
794
+ ),
795
+ ],
796
+ ),
797
+ }
798
+ }