fimo 0.7.0-experimental.3 → 0.7.0-experimental.5

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 (412) hide show
  1. package/README.md +2 -3
  2. package/assets/content-templates/hooks-template.eta +27 -73
  3. package/assets/content-templates/types-template.eta +1 -4
  4. package/assets/skills/fimo/SKILL.md +3 -3
  5. package/assets/skills/fimo/references/assets.md +2 -2
  6. package/assets/skills/fimo/references/content.md +43 -47
  7. package/assets/skills/fimo/references/design.md +1 -1
  8. package/assets/skills/fimo/references/locales.md +0 -8
  9. package/assets/skills/fimo/references/setup-react-router.md +2 -2
  10. package/assets/skills/fimo/references/ui.md +1 -1
  11. package/assets/skills/fimo-cli/SKILL.md +1 -1
  12. package/assets/skills/fimo-cli/references/assets.md +24 -7
  13. package/assets/skills/fimo-cli/references/content.md +16 -19
  14. package/assets/skills/fimo-cli/references/domains.md +1 -1
  15. package/assets/skills/fimo-cli/references/locales.md +0 -6
  16. package/assets/skills/fimo-cli/references/media.md +142 -132
  17. package/assets/skills/fimo-migration/SKILL.md +22 -2
  18. package/assets/skills/fimo-migration/references/content.md +8 -0
  19. package/assets/skills/fimo-migration/references/manifest.md +35 -0
  20. package/assets/skills/fimo-migration/references/qa.md +24 -2
  21. package/assets/skills/fimo-migration/references/workflow.md +12 -1
  22. package/assets/skills/fimo-migration/references/wrap.md +582 -0
  23. package/assets/skills/fimo-studio/references/custom-domains.md +1 -1
  24. package/assets/skills/fimo-studio/references/visual-editing.md +5 -3
  25. package/dist/build/vite/index.d.ts.map +1 -0
  26. package/dist/build/vite/plugins/content-sync.d.ts.map +1 -0
  27. package/dist/build/vite/plugins/content-sync.test.d.ts +2 -0
  28. package/dist/build/vite/plugins/content-sync.test.d.ts.map +1 -0
  29. package/dist/build/vite/plugins/content-sync.test.js +64 -0
  30. package/dist/build/vite/plugins/data-id.d.ts.map +1 -0
  31. package/dist/build/vite/plugins/fimo-config.d.ts.map +1 -0
  32. package/dist/build/vite/plugins/fimo-config.test.d.ts +2 -0
  33. package/dist/build/vite/plugins/fimo-config.test.d.ts.map +1 -0
  34. package/dist/build/vite/plugins/fimo-config.test.js +46 -0
  35. package/dist/build/vite/plugins/overlay.d.ts.map +1 -0
  36. package/dist/build/vite/plugins/robots.d.ts.map +1 -0
  37. package/dist/build/vite/plugins/seo.d.ts.map +1 -0
  38. package/dist/build/vite/plugins/server-config.d.ts.map +1 -0
  39. package/dist/build/vite/plugins/sitemap.d.ts.map +1 -0
  40. package/dist/build/vite/plugins/translations.d.ts +2 -8
  41. package/dist/build/vite/plugins/translations.d.ts.map +1 -0
  42. package/dist/build/vite/plugins/translations.js +3 -121
  43. package/dist/build/vite/plugins/translations.test.d.ts +2 -0
  44. package/dist/build/vite/plugins/translations.test.d.ts.map +1 -0
  45. package/dist/build/vite/plugins/translations.test.js +266 -0
  46. package/dist/cli/bundle.json +2 -3
  47. package/dist/cli/index.js +118296 -1186
  48. package/dist/runtime/app/FimoProviders.d.ts +1 -11
  49. package/dist/runtime/app/FimoProviders.d.ts.map +1 -0
  50. package/dist/runtime/app/FimoProviders.js +2 -23
  51. package/dist/runtime/app/FimoScripts.d.ts.map +1 -0
  52. package/dist/runtime/app/index.d.ts.map +1 -0
  53. package/dist/runtime/app/prefetch.d.ts.map +1 -0
  54. package/dist/runtime/astro/index.d.ts +2 -0
  55. package/dist/runtime/astro/index.d.ts.map +1 -0
  56. package/dist/runtime/astro/index.js +3 -0
  57. package/dist/runtime/astro/server.d.ts +3 -0
  58. package/dist/runtime/astro/server.d.ts.map +1 -0
  59. package/dist/runtime/astro/server.js +6 -0
  60. package/dist/runtime/content/DataSourcesProvider.d.ts.map +1 -0
  61. package/dist/runtime/content/RefreshContentProvider.d.ts.map +1 -0
  62. package/dist/runtime/content/RefreshContentProvider.test.d.ts +2 -0
  63. package/dist/runtime/content/RefreshContentProvider.test.d.ts.map +1 -0
  64. package/dist/runtime/content/RefreshContentProvider.test.js +33 -0
  65. package/dist/runtime/content/parseCollectionResponse.d.ts.map +1 -0
  66. package/dist/runtime/content/parseCollectionResponse.test.d.ts +2 -0
  67. package/dist/runtime/content/parseCollectionResponse.test.d.ts.map +1 -0
  68. package/dist/runtime/content/parseCollectionResponse.test.js +20 -0
  69. package/dist/runtime/content/utils/retrieve-data-sources.d.ts +0 -1
  70. package/dist/runtime/content/utils/retrieve-data-sources.d.ts.map +1 -0
  71. package/dist/runtime/content/utils/retrieve-data-sources.js +4 -27
  72. package/dist/runtime/core/AppErrorBoundary.d.ts.map +1 -0
  73. package/dist/runtime/core/ViteLifecycles.d.ts.map +1 -0
  74. package/dist/runtime/i18n/FimoLocaleContext.d.ts.map +1 -0
  75. package/dist/runtime/i18n/FimoLocaleContext.js +1 -0
  76. package/dist/runtime/i18n/locale.d.ts.map +1 -0
  77. package/dist/runtime/i18n/locale.test.d.ts +2 -0
  78. package/dist/runtime/i18n/locale.test.d.ts.map +1 -0
  79. package/dist/runtime/i18n/locale.test.js +58 -0
  80. package/dist/runtime/iframe/ConsoleErrorProvider.d.ts.map +1 -0
  81. package/dist/runtime/iframe/ScreenshotProvider.d.ts.map +1 -0
  82. package/dist/runtime/iframe/runtime/overlay-hmr.d.ts.map +1 -0
  83. package/dist/runtime/iframe/runtime/overlay-hmr.js +0 -3
  84. package/dist/runtime/iframe/runtime/overlay-runtime.d.ts.map +1 -0
  85. package/dist/runtime/index.d.ts +0 -3
  86. package/dist/runtime/index.d.ts.map +1 -0
  87. package/dist/runtime/index.js +0 -2
  88. package/dist/runtime/next/FimoNextProviders.d.ts +24 -0
  89. package/dist/runtime/next/FimoNextProviders.d.ts.map +1 -0
  90. package/dist/runtime/next/FimoNextProviders.js +20 -0
  91. package/dist/runtime/next/FimoNextScripts.d.ts +10 -0
  92. package/dist/runtime/next/FimoNextScripts.d.ts.map +1 -0
  93. package/dist/runtime/next/FimoNextScripts.js +19 -0
  94. package/dist/runtime/next/index.d.ts +14 -0
  95. package/dist/runtime/next/index.d.ts.map +1 -0
  96. package/dist/runtime/next/index.js +14 -0
  97. package/dist/runtime/next/server.d.ts +2 -0
  98. package/dist/runtime/next/server.d.ts.map +1 -0
  99. package/dist/runtime/next/server.js +4 -0
  100. package/dist/runtime/nuxt/composables.d.ts +9 -0
  101. package/dist/runtime/nuxt/composables.d.ts.map +1 -0
  102. package/dist/runtime/nuxt/composables.js +57 -0
  103. package/dist/runtime/nuxt/index.d.ts +3 -0
  104. package/dist/runtime/nuxt/index.d.ts.map +1 -0
  105. package/dist/runtime/nuxt/index.js +6 -0
  106. package/dist/runtime/nuxt/server.d.ts +3 -0
  107. package/dist/runtime/nuxt/server.d.ts.map +1 -0
  108. package/dist/runtime/nuxt/server.js +6 -0
  109. package/dist/runtime/paths/get-fimo-paths.d.ts.map +1 -0
  110. package/dist/runtime/paths/get-fimo-paths.js +5 -15
  111. package/dist/runtime/paths/index.d.ts.map +1 -0
  112. package/dist/runtime/paths/types.d.ts.map +1 -0
  113. package/dist/runtime/primitives/components/Boolean.d.ts.map +1 -0
  114. package/dist/runtime/primitives/components/Date.d.ts.map +1 -0
  115. package/dist/runtime/primitives/components/Image.d.ts.map +1 -0
  116. package/dist/runtime/primitives/components/RichText.d.ts.map +1 -0
  117. package/dist/runtime/primitives/components/StaticImage.d.ts.map +1 -0
  118. package/dist/runtime/primitives/components/Text.d.ts.map +1 -0
  119. package/dist/runtime/primitives/components/Video.d.ts.map +1 -0
  120. package/dist/runtime/primitives/components/index.d.ts.map +1 -0
  121. package/dist/runtime/primitives/index.d.ts.map +1 -0
  122. package/dist/runtime/primitives/labels-hook.d.ts +33 -0
  123. package/dist/runtime/primitives/labels-hook.d.ts.map +1 -0
  124. package/dist/runtime/primitives/labels-hook.js +41 -0
  125. package/dist/runtime/primitives/labels-store.d.ts +12 -0
  126. package/dist/runtime/primitives/labels-store.d.ts.map +1 -0
  127. package/dist/runtime/primitives/labels-store.js +60 -0
  128. package/dist/runtime/primitives/labels-store.test.d.ts +2 -0
  129. package/dist/runtime/primitives/labels-store.test.d.ts.map +1 -0
  130. package/dist/runtime/primitives/labels-store.test.js +66 -0
  131. package/dist/runtime/primitives/lib/image-optimization.d.ts.map +1 -0
  132. package/dist/runtime/primitives/lib/index.d.ts.map +1 -0
  133. package/dist/runtime/primitives/lib/primitives.d.ts +2 -2
  134. package/dist/runtime/primitives/lib/primitives.d.ts.map +1 -0
  135. package/dist/runtime/primitives/lib/query.d.ts +3 -5
  136. package/dist/runtime/primitives/lib/query.d.ts.map +1 -0
  137. package/dist/runtime/primitives/lib/template.d.ts.map +1 -0
  138. package/dist/runtime/primitives/lib/useFimoLiveValue.d.ts +5 -3
  139. package/dist/runtime/primitives/lib/useFimoLiveValue.d.ts.map +1 -0
  140. package/dist/runtime/primitives/lib/useFimoLiveValue.js +11 -4
  141. package/dist/runtime/primitives/public-surface.test.d.ts +2 -0
  142. package/dist/runtime/primitives/public-surface.test.d.ts.map +1 -0
  143. package/dist/runtime/primitives/public-surface.test.js +45 -0
  144. package/dist/runtime/primitives/translations.d.ts +1 -27
  145. package/dist/runtime/primitives/translations.d.ts.map +1 -0
  146. package/dist/runtime/primitives/translations.js +7 -85
  147. package/dist/runtime/react/FimoSpaProviders.d.ts +36 -0
  148. package/dist/runtime/react/FimoSpaProviders.d.ts.map +1 -0
  149. package/dist/runtime/react/FimoSpaProviders.js +63 -0
  150. package/dist/runtime/react/index.d.ts +33 -0
  151. package/dist/runtime/react/index.d.ts.map +1 -0
  152. package/dist/runtime/react/index.js +39 -0
  153. package/dist/runtime/react-router/index.d.ts.map +1 -0
  154. package/dist/runtime/react-router/navigation-utils.d.ts.map +1 -0
  155. package/dist/runtime/react-router/navigation.d.ts.map +1 -0
  156. package/dist/runtime/react-router/navigation.test.d.ts +2 -0
  157. package/dist/runtime/react-router/navigation.test.d.ts.map +1 -0
  158. package/dist/runtime/react-router/navigation.test.js +35 -0
  159. package/dist/runtime/react-router/routes.d.ts.map +1 -0
  160. package/dist/runtime/react-router/routes.test.d.ts +2 -0
  161. package/dist/runtime/react-router/routes.test.d.ts.map +1 -0
  162. package/dist/runtime/react-router/routes.test.js +67 -0
  163. package/dist/runtime/remix/FimoRemixProviders.d.ts +16 -0
  164. package/dist/runtime/remix/FimoRemixProviders.d.ts.map +1 -0
  165. package/dist/runtime/remix/FimoRemixProviders.js +12 -0
  166. package/dist/runtime/remix/FimoRemixScripts.d.ts +10 -0
  167. package/dist/runtime/remix/FimoRemixScripts.d.ts.map +1 -0
  168. package/dist/runtime/remix/FimoRemixScripts.js +19 -0
  169. package/dist/runtime/remix/index.d.ts +12 -0
  170. package/dist/runtime/remix/index.d.ts.map +1 -0
  171. package/dist/runtime/remix/index.js +11 -0
  172. package/dist/runtime/remix/server.d.ts +2 -0
  173. package/dist/runtime/remix/server.d.ts.map +1 -0
  174. package/dist/runtime/remix/server.js +2 -0
  175. package/dist/runtime/routing/AppResetScrollOnNavigate.d.ts.map +1 -0
  176. package/dist/runtime/routing/AppRoutesProvider.d.ts.map +1 -0
  177. package/dist/runtime/seo/buildSeoForPath.d.ts +3 -1
  178. package/dist/runtime/seo/buildSeoForPath.d.ts.map +1 -0
  179. package/dist/runtime/seo/buildSeoForPath.js +1 -4
  180. package/dist/runtime/seo/htmlProps.d.ts.map +1 -0
  181. package/dist/runtime/seo/index.d.ts.map +1 -0
  182. package/dist/runtime/seo/resolver.d.ts.map +1 -0
  183. package/dist/runtime/shared/display-routes.d.ts +14 -0
  184. package/dist/runtime/shared/display-routes.d.ts.map +1 -0
  185. package/dist/runtime/shared/display-routes.js +25 -0
  186. package/dist/runtime/shared/fimo-config.server.d.ts.map +1 -0
  187. package/dist/runtime/shared/fimo-config.server.js +1 -0
  188. package/dist/runtime/shared/fimo-config.types.d.ts +2 -0
  189. package/dist/runtime/shared/fimo-config.types.d.ts.map +1 -0
  190. package/dist/runtime/shared/i18n-messages.d.ts +29 -0
  191. package/dist/runtime/shared/i18n-messages.d.ts.map +1 -0
  192. package/dist/runtime/shared/i18n-messages.js +79 -0
  193. package/dist/runtime/shared/i18n-messages.test.d.ts +2 -0
  194. package/dist/runtime/shared/i18n-messages.test.d.ts.map +1 -0
  195. package/dist/runtime/shared/i18n-messages.test.js +39 -0
  196. package/dist/runtime/shared/labels-fetch.pure.d.ts +17 -0
  197. package/dist/runtime/shared/labels-fetch.pure.d.ts.map +1 -0
  198. package/dist/runtime/shared/labels-fetch.pure.js +71 -0
  199. package/dist/runtime/shared/labels-fetch.server.d.ts +7 -0
  200. package/dist/runtime/shared/labels-fetch.server.d.ts.map +1 -0
  201. package/dist/runtime/shared/labels-fetch.server.js +97 -0
  202. package/dist/runtime/shared/labels-t.pure.d.ts +2 -0
  203. package/dist/runtime/shared/labels-t.pure.d.ts.map +1 -0
  204. package/dist/runtime/shared/labels-t.pure.js +10 -0
  205. package/dist/runtime/strapi/client.d.ts +26 -0
  206. package/dist/runtime/strapi/client.d.ts.map +1 -0
  207. package/dist/runtime/strapi/client.js +88 -0
  208. package/dist/runtime/strapi/client.test.d.ts +2 -0
  209. package/dist/runtime/strapi/client.test.d.ts.map +1 -0
  210. package/dist/runtime/strapi/client.test.js +64 -0
  211. package/dist/runtime/strapi/index.d.ts +5 -0
  212. package/dist/runtime/strapi/index.d.ts.map +1 -0
  213. package/dist/runtime/strapi/index.js +6 -0
  214. package/dist/runtime/strapi/reshape.d.ts +28 -0
  215. package/dist/runtime/strapi/reshape.d.ts.map +1 -0
  216. package/dist/runtime/strapi/reshape.js +79 -0
  217. package/dist/runtime/strapi/reshape.test.d.ts +2 -0
  218. package/dist/runtime/strapi/reshape.test.d.ts.map +1 -0
  219. package/dist/runtime/strapi/reshape.test.js +33 -0
  220. package/dist/runtime/svelte/index.d.ts +3 -0
  221. package/dist/runtime/svelte/index.d.ts.map +1 -0
  222. package/dist/runtime/svelte/index.js +7 -0
  223. package/dist/runtime/svelte/server.d.ts +3 -0
  224. package/dist/runtime/svelte/server.d.ts.map +1 -0
  225. package/dist/runtime/svelte/server.js +6 -0
  226. package/dist/runtime/t/OptionalTracking.d.ts.map +1 -0
  227. package/dist/runtime/t/OptionalTracking.test.d.ts +2 -0
  228. package/dist/runtime/t/OptionalTracking.test.d.ts.map +1 -0
  229. package/dist/runtime/t/OptionalTracking.test.js +11 -0
  230. package/dist/runtime/t/Pageview.d.ts.map +1 -0
  231. package/dist/runtime/templates.d.ts.map +1 -0
  232. package/dist/runtime/vue/index.d.ts +3 -0
  233. package/dist/runtime/vue/index.d.ts.map +1 -0
  234. package/dist/runtime/vue/index.js +5 -0
  235. package/dist/runtime/vue/server.d.ts +3 -0
  236. package/dist/runtime/vue/server.d.ts.map +1 -0
  237. package/dist/runtime/vue/server.js +6 -0
  238. package/dist/runtime/wrapped/FimoFileLink.d.ts +17 -0
  239. package/dist/runtime/wrapped/FimoFileLink.d.ts.map +1 -0
  240. package/dist/runtime/wrapped/FimoFileLink.js +19 -0
  241. package/dist/runtime/wrapped/FimoMediaImage.d.ts +14 -0
  242. package/dist/runtime/wrapped/FimoMediaImage.d.ts.map +1 -0
  243. package/dist/runtime/wrapped/FimoMediaImage.js +20 -0
  244. package/dist/runtime/wrapped/FimoMediaVideo.d.ts +14 -0
  245. package/dist/runtime/wrapped/FimoMediaVideo.d.ts.map +1 -0
  246. package/dist/runtime/wrapped/FimoMediaVideo.js +20 -0
  247. package/dist/runtime/wrapped/FimoRichTextBlock.d.ts +23 -0
  248. package/dist/runtime/wrapped/FimoRichTextBlock.d.ts.map +1 -0
  249. package/dist/runtime/wrapped/FimoRichTextBlock.js +22 -0
  250. package/dist/runtime/wrapped/FimoText.d.ts +22 -0
  251. package/dist/runtime/wrapped/FimoText.d.ts.map +1 -0
  252. package/dist/runtime/wrapped/FimoText.js +20 -0
  253. package/dist/runtime/wrapped/WrappedContentContext.d.ts +28 -0
  254. package/dist/runtime/wrapped/WrappedContentContext.d.ts.map +1 -0
  255. package/dist/runtime/wrapped/WrappedContentContext.js +30 -0
  256. package/dist/runtime/wrapped/WrappedProviders.d.ts +33 -0
  257. package/dist/runtime/wrapped/WrappedProviders.d.ts.map +1 -0
  258. package/dist/runtime/wrapped/WrappedProviders.js +101 -0
  259. package/dist/runtime/wrapped/dom.d.ts +4 -0
  260. package/dist/runtime/wrapped/dom.d.ts.map +1 -0
  261. package/dist/runtime/wrapped/dom.js +23 -0
  262. package/dist/runtime/wrapped/dom.test.d.ts +2 -0
  263. package/dist/runtime/wrapped/dom.test.d.ts.map +1 -0
  264. package/dist/runtime/wrapped/dom.test.js +16 -0
  265. package/dist/runtime/wrapped/server.d.ts +77 -0
  266. package/dist/runtime/wrapped/server.d.ts.map +1 -0
  267. package/dist/runtime/wrapped/server.js +237 -0
  268. package/dist/runtime/wrapped/server.test.d.ts +2 -0
  269. package/dist/runtime/wrapped/server.test.d.ts.map +1 -0
  270. package/dist/runtime/wrapped/server.test.js +91 -0
  271. package/dist/scripts/apply-wrap-templates.d.ts +61 -0
  272. package/dist/scripts/apply-wrap-templates.js +132 -0
  273. package/dist/scripts/apply-wrap-templates.test.js +199 -0
  274. package/dist/scripts/apply-wrap.d.ts +46 -0
  275. package/dist/scripts/apply-wrap.js +278 -0
  276. package/dist/scripts/apply-wrap.test.d.ts +1 -0
  277. package/dist/scripts/apply-wrap.test.js +226 -0
  278. package/dist/scripts/cms/discover.d.ts +2 -0
  279. package/dist/scripts/cms/discover.js +17 -0
  280. package/dist/scripts/cms/example-content.d.ts +32 -0
  281. package/dist/scripts/cms/example-content.js +108 -0
  282. package/dist/scripts/cms/example-content.test.d.ts +1 -0
  283. package/dist/scripts/cms/example-content.test.js +66 -0
  284. package/dist/scripts/cms/strapi/detect.d.ts +2 -0
  285. package/dist/scripts/cms/strapi/detect.js +186 -0
  286. package/dist/scripts/cms/strapi/detect.test.d.ts +1 -0
  287. package/dist/scripts/cms/strapi/detect.test.js +56 -0
  288. package/dist/scripts/cms/strapi/index.d.ts +3 -0
  289. package/dist/scripts/cms/strapi/index.js +23 -0
  290. package/dist/scripts/cms/strapi/list-source.d.ts +17 -0
  291. package/dist/scripts/cms/strapi/list-source.js +90 -0
  292. package/dist/scripts/cms/strapi/list-source.test.d.ts +1 -0
  293. package/dist/scripts/cms/strapi/list-source.test.js +33 -0
  294. package/dist/scripts/cms/strapi/schema-map.d.ts +9 -0
  295. package/dist/scripts/cms/strapi/schema-map.js +149 -0
  296. package/dist/scripts/cms/strapi/schema-map.test.d.ts +1 -0
  297. package/dist/scripts/cms/strapi/schema-map.test.js +91 -0
  298. package/dist/scripts/cms/strapi/wire-client.d.ts +15 -0
  299. package/dist/scripts/cms/strapi/wire-client.js +107 -0
  300. package/dist/scripts/cms/strapi/wire-client.test.d.ts +1 -0
  301. package/dist/scripts/cms/strapi/wire-client.test.js +51 -0
  302. package/dist/scripts/cms/strapi/wiring.d.ts +17 -0
  303. package/dist/scripts/cms/strapi/wiring.js +36 -0
  304. package/dist/scripts/cms/strapi/wiring.test.d.ts +1 -0
  305. package/dist/scripts/cms/strapi/wiring.test.js +27 -0
  306. package/dist/scripts/cms/types.d.ts +94 -0
  307. package/dist/scripts/cms/types.js +11 -0
  308. package/dist/scripts/detect-framework.d.ts +39 -0
  309. package/dist/scripts/detect-framework.js +133 -0
  310. package/dist/scripts/detect-framework.test.d.ts +1 -0
  311. package/dist/scripts/detect-framework.test.js +122 -0
  312. package/dist/scripts/draft-rows.d.ts +19 -0
  313. package/dist/scripts/draft-rows.js +135 -0
  314. package/dist/scripts/draft-rows.test.d.ts +1 -0
  315. package/dist/scripts/draft-rows.test.js +113 -0
  316. package/dist/scripts/draft-schemas.d.ts +27 -0
  317. package/dist/scripts/draft-schemas.js +188 -0
  318. package/dist/scripts/draft-schemas.test.d.ts +1 -0
  319. package/dist/scripts/draft-schemas.test.js +152 -0
  320. package/dist/scripts/frameworks/astro/routes.d.ts +3 -0
  321. package/dist/scripts/frameworks/astro/routes.js +55 -0
  322. package/dist/scripts/frameworks/astro/template-style.d.ts +7 -0
  323. package/dist/scripts/frameworks/astro/template-style.js +19 -0
  324. package/dist/scripts/frameworks/discover.d.ts +70 -0
  325. package/dist/scripts/frameworks/discover.js +171 -0
  326. package/dist/scripts/frameworks/next/rewire.d.ts +30 -0
  327. package/dist/scripts/frameworks/next/rewire.js +258 -0
  328. package/dist/scripts/frameworks/next/rewire.test.d.ts +1 -0
  329. package/dist/scripts/frameworks/next/rewire.test.js +134 -0
  330. package/dist/scripts/frameworks/next/routes.d.ts +17 -0
  331. package/dist/scripts/frameworks/next/routes.js +134 -0
  332. package/dist/scripts/frameworks/next/routes.test.d.ts +1 -0
  333. package/dist/scripts/frameworks/next/routes.test.js +64 -0
  334. package/dist/scripts/frameworks/next/wiring.d.ts +26 -0
  335. package/dist/scripts/frameworks/next/wiring.js +163 -0
  336. package/dist/scripts/frameworks/next/wiring.test.d.ts +1 -0
  337. package/dist/scripts/frameworks/next/wiring.test.js +146 -0
  338. package/dist/scripts/frameworks/nuxt/routes.d.ts +3 -0
  339. package/dist/scripts/frameworks/nuxt/routes.js +54 -0
  340. package/dist/scripts/frameworks/nuxt/template-style.d.ts +9 -0
  341. package/dist/scripts/frameworks/nuxt/template-style.js +27 -0
  342. package/dist/scripts/frameworks/remix/routes.d.ts +3 -0
  343. package/dist/scripts/frameworks/remix/routes.js +50 -0
  344. package/dist/scripts/frameworks/sveltekit/routes.d.ts +3 -0
  345. package/dist/scripts/frameworks/sveltekit/routes.js +50 -0
  346. package/dist/scripts/frameworks/sveltekit/template-style.d.ts +9 -0
  347. package/dist/scripts/frameworks/sveltekit/template-style.js +54 -0
  348. package/dist/scripts/frameworks/vite/routes.d.ts +15 -0
  349. package/dist/scripts/frameworks/vite/routes.js +93 -0
  350. package/dist/scripts/frameworks/vite/routes.test.d.ts +1 -0
  351. package/dist/scripts/frameworks/vite/routes.test.js +73 -0
  352. package/dist/scripts/frameworks/vite/wiring.d.ts +10 -0
  353. package/dist/scripts/frameworks/vite/wiring.js +99 -0
  354. package/dist/scripts/frameworks/vite/wiring.test.d.ts +1 -0
  355. package/dist/scripts/frameworks/vite/wiring.test.js +88 -0
  356. package/dist/scripts/generated-types.test.d.ts +1 -0
  357. package/dist/scripts/generated-types.test.js +212 -0
  358. package/dist/scripts/lib/validation-report.d.ts +1 -0
  359. package/dist/scripts/lib/validation-report.js +3 -0
  360. package/dist/scripts/lint-translation-keys.test.d.ts +1 -0
  361. package/dist/scripts/lint-translation-keys.test.js +16 -0
  362. package/dist/scripts/render-parity/capture.d.ts +56 -0
  363. package/dist/scripts/render-parity/capture.js +366 -0
  364. package/dist/scripts/render-parity/capture.test.d.ts +1 -0
  365. package/dist/scripts/render-parity/capture.test.js +306 -0
  366. package/dist/scripts/render-parity/compare.d.ts +59 -0
  367. package/dist/scripts/render-parity/compare.js +0 -0
  368. package/dist/scripts/render-parity/compare.test.d.ts +1 -0
  369. package/dist/scripts/render-parity/compare.test.js +98 -0
  370. package/dist/scripts/render-parity/normalize-html.d.ts +13 -0
  371. package/dist/scripts/render-parity/normalize-html.js +223 -0
  372. package/dist/scripts/render-parity/normalize-html.test.d.ts +1 -0
  373. package/dist/scripts/render-parity/normalize-html.test.js +58 -0
  374. package/dist/scripts/render-parity/types.d.ts +41 -0
  375. package/dist/scripts/render-parity/types.js +1 -0
  376. package/dist/scripts/resolve-routes.js +1 -1
  377. package/dist/scripts/scan-wrappable.d.ts +196 -0
  378. package/dist/scripts/scan-wrappable.js +1221 -0
  379. package/dist/scripts/scan-wrappable.test.d.ts +1 -0
  380. package/dist/scripts/scan-wrappable.test.js +502 -0
  381. package/dist/scripts/sync-schemas.test.d.ts +1 -0
  382. package/dist/scripts/sync-schemas.test.js +124 -0
  383. package/dist/scripts/validate-route-metadata.js +11 -0
  384. package/dist/scripts/validate-route-metadata.test.d.ts +1 -0
  385. package/dist/scripts/validate-route-metadata.test.js +116 -0
  386. package/dist/scripts/validate-schemas.test.d.ts +1 -0
  387. package/dist/scripts/validate-schemas.test.js +263 -0
  388. package/package.json +89 -20
  389. package/scripts/add-ext.mjs +47 -0
  390. package/scripts/bump-version.mjs +58 -0
  391. package/scripts/bundle-cli.mjs +123 -0
  392. package/scripts/install-cli.mjs +36 -0
  393. package/scripts/lib/channels.mjs +70 -0
  394. package/scripts/lib/dev-release-state.mjs +44 -0
  395. package/scripts/lib/dev-release-state.test.ts +36 -0
  396. package/scripts/lib/postinstall-onboarding.test.ts +82 -0
  397. package/scripts/lib/release-core.mjs +225 -0
  398. package/scripts/lib/release-core.test.ts +147 -0
  399. package/scripts/migration-qa-gate.test.ts +155 -0
  400. package/scripts/publish-npm.mjs +180 -0
  401. package/templates/react-router/package.json +7 -10
  402. package/templates/react-router/src/pages/Index.tsx +1 -1
  403. package/dist/runtime/content/client/createContentClient.d.ts +0 -5
  404. package/dist/runtime/content/client/createContentClient.js +0 -300
  405. package/dist/runtime/content/client/createSingletonClient.d.ts +0 -5
  406. package/dist/runtime/content/client/createSingletonClient.js +0 -108
  407. package/dist/runtime/content/client/internal.d.ts +0 -44
  408. package/dist/runtime/content/client/internal.js +0 -236
  409. package/dist/runtime/content/client/types.d.ts +0 -136
  410. package/dist/runtime/content/client/useQueryLocale.d.ts +0 -2
  411. package/dist/runtime/content/client/useQueryLocale.js +0 -6
  412. /package/dist/{runtime/content/client/types.js → scripts/apply-wrap-templates.test.d.ts} +0 -0
@@ -0,0 +1,50 @@
1
+ import { readdirSync } from 'node:fs';
2
+ const titleCase = (seg) => seg
3
+ .replace(/[_\-]+/g, ' ')
4
+ .replace(/([a-z])([A-Z])/g, '$1 $2')
5
+ .split(/\s+/)
6
+ .filter(Boolean)
7
+ .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
8
+ .join(' ');
9
+ function pushRoute(routes, parts) {
10
+ const routePath = `/${parts.join('/')}`.replace(/\/+/g, '/');
11
+ const lastStatic = [...parts].reverse().find((part) => !part.startsWith(':'));
12
+ routes.push({
13
+ id: routePath === '/' ? 'home' : parts.map((part) => part.replace(/^:/, '')).join('-'),
14
+ path: routePath,
15
+ label: routePath === '/' ? 'Home' : titleCase(lastStatic ?? parts[parts.length - 1] ?? routePath),
16
+ });
17
+ }
18
+ const FILE_EXT = /\.(tsx|jsx|ts|js|mdx)$/;
19
+ /** Remix v2 flat routes under app/routes: dots are slashes, $param is dynamic. */
20
+ export function discoverRemixRoutes(routesDir) {
21
+ const routes = [];
22
+ let entries;
23
+ try {
24
+ entries = readdirSync(routesDir);
25
+ }
26
+ catch {
27
+ return routes;
28
+ }
29
+ for (const entry of entries) {
30
+ if (!FILE_EXT.test(entry)) {
31
+ continue;
32
+ }
33
+ const base = entry.replace(FILE_EXT, '');
34
+ if (base === '_index') {
35
+ pushRoute(routes, []);
36
+ continue;
37
+ }
38
+ // Pathless layout segments start with _ ; trailing ._index maps to the parent.
39
+ const parts = base
40
+ .replace(/\._index$/, '')
41
+ .split('.')
42
+ .filter((seg) => !seg.startsWith('_'))
43
+ .map((seg) => (seg.startsWith('$') ? `:${seg.slice(1) || 'splat'}` : seg));
44
+ if (parts.length > 0) {
45
+ pushRoute(routes, parts);
46
+ }
47
+ }
48
+ routes.sort((a, b) => a.path.localeCompare(b.path));
49
+ return routes;
50
+ }
@@ -0,0 +1,3 @@
1
+ import type { DiscoveredRoute } from '../next/routes.js';
2
+ /** SvelteKit routes: every directory under src/routes holding a +page file. */
3
+ export declare function discoverSvelteKitRoutes(routesDir: string): DiscoveredRoute[];
@@ -0,0 +1,50 @@
1
+ import { readdirSync, statSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ const titleCase = (seg) => seg
4
+ .replace(/[_\-]+/g, ' ')
5
+ .replace(/([a-z])([A-Z])/g, '$1 $2')
6
+ .split(/\s+/)
7
+ .filter(Boolean)
8
+ .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
9
+ .join(' ');
10
+ function pushRoute(routes, parts) {
11
+ const routePath = `/${parts.join('/')}`.replace(/\/+/g, '/');
12
+ const lastStatic = [...parts].reverse().find((part) => !part.startsWith(':'));
13
+ routes.push({
14
+ id: routePath === '/' ? 'home' : parts.map((part) => part.replace(/^:/, '')).join('-'),
15
+ path: routePath,
16
+ label: routePath === '/' ? 'Home' : titleCase(lastStatic ?? parts[parts.length - 1] ?? routePath),
17
+ });
18
+ }
19
+ const toSegment = (name) => name.replace(/^\[\.\.\.(.+)\]$/, ':$1').replace(/^\[(.+)\]$/, ':$1');
20
+ /** SvelteKit routes: every directory under src/routes holding a +page file. */
21
+ export function discoverSvelteKitRoutes(routesDir) {
22
+ const routes = [];
23
+ const walk = (dir, segments) => {
24
+ let entries;
25
+ try {
26
+ entries = readdirSync(dir);
27
+ }
28
+ catch {
29
+ return;
30
+ }
31
+ if (entries.some((entry) => /^\+page\.(svelte|md)$/.test(entry))) {
32
+ // Route groups (parens) are layout-only segments.
33
+ pushRoute(routes, segments.filter((seg) => !seg.startsWith('(')));
34
+ }
35
+ for (const entry of entries) {
36
+ const full = join(dir, entry);
37
+ try {
38
+ if (statSync(full).isDirectory()) {
39
+ walk(full, [...segments, toSegment(entry)]);
40
+ }
41
+ }
42
+ catch {
43
+ continue;
44
+ }
45
+ }
46
+ };
47
+ walk(routesDir, []);
48
+ routes.sort((a, b) => a.path.localeCompare(b.path));
49
+ return routes;
50
+ }
@@ -0,0 +1,9 @@
1
+ import { type TemplateWrapStyle } from '../../apply-wrap-templates.js';
2
+ /**
3
+ * SvelteKit template wraps. The t binding is deliberately a mode-agnostic
4
+ * `const` — a `$derived` flips a legacy component into runes mode (breaking
5
+ * its own `$:` statements) and a `$:` reactive runs after init (arrays built
6
+ * at init see undefined). Labels only change with a reload in edit mode,
7
+ * which the wrap contract accepts.
8
+ */
9
+ export declare const svelteTemplateWrapStyle: TemplateWrapStyle;
@@ -0,0 +1,54 @@
1
+ import { existsSync, writeFileSync } from 'node:fs';
2
+ import { basename, dirname, join } from 'node:path';
3
+ import { injectIntoInstanceScript } from '../../apply-wrap-templates.js';
4
+ import { slugify } from '../../apply-wrap.js';
5
+ /**
6
+ * SvelteKit template wraps. The t binding is deliberately a mode-agnostic
7
+ * `const` — a `$derived` flips a legacy component into runes mode (breaking
8
+ * its own `$:` statements) and a `$:` reactive runs after init (arrays built
9
+ * at init see undefined). Labels only change with a reload in edit mode,
10
+ * which the wrap contract accepts.
11
+ */
12
+ export const svelteTemplateWrapStyle = {
13
+ ext: '.svelte',
14
+ head: "import { page } from '$app/stores';\n\timport { makeFimoT } from 'fimo/svelte';\n\tconst t = makeFimoT($page.data.fimoLabels);",
15
+ headMarker: /makeFimoT/,
16
+ open: '{t(',
17
+ close: ')}',
18
+ injectHead: (code, head) => injectIntoInstanceScript(code, head, '<script>'),
19
+ // Route-convention filenames carry no meaning: scope +page/+layout keys by
20
+ // their route directory (src/routes/pricing/+page.svelte -> "pricing").
21
+ fileScope: (file) => {
22
+ const stem = basename(file).replace(/\.svelte$/, '');
23
+ if (!stem.startsWith('+')) {
24
+ return null;
25
+ }
26
+ const dir = basename(dirname(file));
27
+ if (!dir || dir === 'routes' || dir === 'src') {
28
+ return stem === '+layout' ? 'layout' : 'home';
29
+ }
30
+ return slugify(dir) || 'home';
31
+ },
32
+ // The store form reads $page.data.fimoLabels: wire the root server load
33
+ // once when the project has none. An existing +layout.server.* is agent
34
+ // work (merging into a user load function is judgment, and until then the
35
+ // inline fallbacks keep rendering identical).
36
+ ensureWiring: (rootDir) => {
37
+ const routesDir = join(rootDir, 'src', 'routes');
38
+ const existing = ['+layout.server.js', '+layout.server.ts'].some((name) => existsSync(join(routesDir, name)));
39
+ if (existing || !existsSync(routesDir)) {
40
+ return [];
41
+ }
42
+ const layoutPath = join(routesDir, '+layout.server.js');
43
+ writeFileSync(layoutPath, [
44
+ "import { loadFimoLabels } from 'fimo/svelte/server';",
45
+ '',
46
+ 'export const load = async () => {',
47
+ '\tconst labels = await loadFimoLabels();',
48
+ '\treturn { fimoLabels: labels.dictionaries[labels.defaultLocale] ?? {} };',
49
+ '};',
50
+ '',
51
+ ].join('\n'));
52
+ return ['src/routes/+layout.server.js'];
53
+ },
54
+ };
@@ -0,0 +1,15 @@
1
+ import type { DiscoveredRoute } from '../next/routes.js';
2
+ /**
3
+ * Route discovery for Vite React SPAs: there is no file convention, so the
4
+ * routes live in react-router code. v1 reads LITERAL, ABSOLUTE paths from the
5
+ * two mainstream declaration shapes —
6
+ *
7
+ * <Route path="/pricing" element={…} /> (JSX tree)
8
+ * createBrowserRouter([{ path: '/pricing', … }]) (object form)
9
+ *
10
+ * — in files that import react-router. Relative child paths and index routes
11
+ * need the router's nesting semantics to resolve; they (and `*` wildcards)
12
+ * stay out of v1: the fimo-config route registry accepts manual entries for
13
+ * anything the scan cannot see, and scanned routes only ever ADD to it.
14
+ */
15
+ export declare function discoverReactRouterDomRoutes(rootDir: string): DiscoveredRoute[];
@@ -0,0 +1,93 @@
1
+ import { readdirSync, readFileSync, statSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ const titleCase = (seg) => seg
4
+ .replace(/[_\-]+/g, ' ')
5
+ .replace(/([a-z])([A-Z])/g, '$1 $2')
6
+ .split(/\s+/)
7
+ .filter(Boolean)
8
+ .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
9
+ .join(' ');
10
+ const ROUTE_SOURCE = /\.(tsx|jsx|ts|js)$/;
11
+ const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', '.git']);
12
+ /**
13
+ * Route discovery for Vite React SPAs: there is no file convention, so the
14
+ * routes live in react-router code. v1 reads LITERAL, ABSOLUTE paths from the
15
+ * two mainstream declaration shapes —
16
+ *
17
+ * <Route path="/pricing" element={…} /> (JSX tree)
18
+ * createBrowserRouter([{ path: '/pricing', … }]) (object form)
19
+ *
20
+ * — in files that import react-router. Relative child paths and index routes
21
+ * need the router's nesting semantics to resolve; they (and `*` wildcards)
22
+ * stay out of v1: the fimo-config route registry accepts manual entries for
23
+ * anything the scan cannot see, and scanned routes only ever ADD to it.
24
+ */
25
+ export function discoverReactRouterDomRoutes(rootDir) {
26
+ const srcDir = join(rootDir, 'src');
27
+ const files = [];
28
+ const walk = (dir) => {
29
+ let entries;
30
+ try {
31
+ entries = readdirSync(dir);
32
+ }
33
+ catch {
34
+ return;
35
+ }
36
+ for (const entry of entries) {
37
+ if (SKIP_DIRS.has(entry)) {
38
+ continue;
39
+ }
40
+ const full = join(dir, entry);
41
+ let isDir = false;
42
+ try {
43
+ isDir = statSync(full).isDirectory();
44
+ }
45
+ catch {
46
+ continue;
47
+ }
48
+ if (isDir) {
49
+ walk(full);
50
+ }
51
+ else if (ROUTE_SOURCE.test(entry)) {
52
+ files.push(full);
53
+ }
54
+ }
55
+ };
56
+ walk(srcDir);
57
+ const routes = new Map();
58
+ for (const file of files) {
59
+ let code;
60
+ try {
61
+ code = readFileSync(file, 'utf8');
62
+ }
63
+ catch {
64
+ continue;
65
+ }
66
+ if (!/from\s+['"]react-router(?:-dom)?['"]/.test(code)) {
67
+ continue;
68
+ }
69
+ const paths = [
70
+ ...[...code.matchAll(/<Route\b[^>]*\bpath\s*=\s*(?:"([^"]+)"|'([^']+)'|\{\s*(?:"([^"]+)"|'([^']+)')\s*\})/g)],
71
+ ...[...code.matchAll(/\bpath\s*:\s*(?:"([^"]+)"|'([^']+)')/g)],
72
+ ]
73
+ .map((match) => match.slice(1).find(Boolean))
74
+ .filter((path) => typeof path === 'string');
75
+ for (const raw of paths) {
76
+ if (!raw.startsWith('/') || raw.includes('*')) {
77
+ continue;
78
+ }
79
+ const path = raw !== '/' && raw.endsWith('/') ? raw.slice(0, -1) : raw;
80
+ if (routes.has(path)) {
81
+ continue;
82
+ }
83
+ const parts = path.split('/').filter(Boolean);
84
+ const lastStatic = [...parts].reverse().find((part) => !part.startsWith(':'));
85
+ routes.set(path, {
86
+ id: path === '/' ? 'home' : parts.map((part) => part.replace(/^:/, '')).join('-'),
87
+ path,
88
+ label: path === '/' ? 'Home' : titleCase(lastStatic ?? parts[parts.length - 1] ?? path),
89
+ });
90
+ }
91
+ }
92
+ return [...routes.values()].sort((a, b) => a.path.localeCompare(b.path));
93
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,73 @@
1
+ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { afterEach, describe, expect, it } from 'vitest';
5
+ import { discoverReactRouterDomRoutes } from './routes.js';
6
+ let dir;
7
+ const project = (files) => {
8
+ dir = mkdtempSync(join(tmpdir(), 'vite-routes-'));
9
+ for (const [rel, content] of Object.entries(files)) {
10
+ const full = join(dir, rel);
11
+ mkdirSync(join(full, '..'), { recursive: true });
12
+ writeFileSync(full, content);
13
+ }
14
+ return dir;
15
+ };
16
+ afterEach(() => {
17
+ if (dir) {
18
+ rmSync(dir, { recursive: true, force: true });
19
+ }
20
+ });
21
+ describe('discoverReactRouterDomRoutes', () => {
22
+ it('reads literal absolute paths from JSX Route trees', () => {
23
+ const root = project({
24
+ 'src/App.tsx': `import { BrowserRouter, Route, Routes } from 'react-router-dom';
25
+ export function App() {
26
+ return (
27
+ <BrowserRouter>
28
+ <Routes>
29
+ <Route path="/" element={<Home />} />
30
+ <Route path="/about" element={<About />} />
31
+ <Route path="/features/pricing" element={<Pricing />} />
32
+ <Route path={'/contact'} element={<Contact />} />
33
+ </Routes>
34
+ </BrowserRouter>
35
+ );
36
+ }
37
+ `,
38
+ });
39
+ const routes = discoverReactRouterDomRoutes(root);
40
+ expect(routes.map((route) => route.path)).toEqual(['/', '/about', '/contact', '/features/pricing']);
41
+ expect(routes[0]).toEqual({ id: 'home', path: '/', label: 'Home' });
42
+ expect(routes.find((route) => route.path === '/features/pricing')).toEqual({
43
+ id: 'features-pricing',
44
+ path: '/features/pricing',
45
+ label: 'Pricing',
46
+ });
47
+ });
48
+ it('reads object-form routers and keeps :params, skipping wildcards and relative paths', () => {
49
+ const root = project({
50
+ 'src/router.ts': `import { createBrowserRouter } from 'react-router-dom';
51
+ export const router = createBrowserRouter([
52
+ { path: '/', element: null },
53
+ { path: '/posts/:slug', element: null },
54
+ { path: '*', element: null },
55
+ { path: 'relative-child', element: null },
56
+ ]);
57
+ `,
58
+ });
59
+ const routes = discoverReactRouterDomRoutes(root);
60
+ expect(routes.map((route) => route.path)).toEqual(['/', '/posts/:slug']);
61
+ expect(routes.find((route) => route.path === '/posts/:slug')).toEqual({
62
+ id: 'posts-slug',
63
+ path: '/posts/:slug',
64
+ label: 'Posts',
65
+ });
66
+ });
67
+ it('ignores path-shaped literals in files that do not import react-router', () => {
68
+ const root = project({
69
+ 'src/config.ts': `export const nav = [{ path: '/dashboard', label: 'Dashboard' }];\n`,
70
+ });
71
+ expect(discoverReactRouterDomRoutes(root)).toEqual([]);
72
+ });
73
+ });
@@ -0,0 +1,10 @@
1
+ import type { RootWiringResult } from '../next/wiring.js';
2
+ /**
3
+ * Vite React SPA root wiring: wrap the root render argument with
4
+ * `FimoSpaProviders` (client-side label fetch; inline fallbacks until it
5
+ * resolves) and import the project's fimo-config.json. Only the mainstream
6
+ * entry shape is touched — a `createRoot(…).render(<JSX/>)` (or legacy
7
+ * `ReactDOM.render(<JSX/>, …)`) call whose first argument is a JSX element.
8
+ * Anything else bails with the reason and stays agent work via the recipe.
9
+ */
10
+ export declare function ensureSpaEntryWiring(cwd: string): RootWiringResult;
@@ -0,0 +1,99 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { parseSync } from 'oxc-parser';
4
+ /**
5
+ * Vite React SPA root wiring: wrap the root render argument with
6
+ * `FimoSpaProviders` (client-side label fetch; inline fallbacks until it
7
+ * resolves) and import the project's fimo-config.json. Only the mainstream
8
+ * entry shape is touched — a `createRoot(…).render(<JSX/>)` (or legacy
9
+ * `ReactDOM.render(<JSX/>, …)`) call whose first argument is a JSX element.
10
+ * Anything else bails with the reason and stays agent work via the recipe.
11
+ */
12
+ export function ensureSpaEntryWiring(cwd) {
13
+ const entryFile = ['src/main.tsx', 'src/main.jsx', 'src/index.tsx', 'src/index.jsx']
14
+ .map((candidate) => path.join(cwd, candidate))
15
+ .find((candidate) => fs.existsSync(candidate));
16
+ const bail = (reason, rel = 'src/main.tsx') => ({
17
+ changes: [],
18
+ warnings: [`Root wiring not applied: ${reason} — follow the SPA recipe in the agent prompt (${rel}).`],
19
+ wired: false,
20
+ });
21
+ if (!entryFile) {
22
+ return bail('no src/main or src/index entry file found');
23
+ }
24
+ const rel = path.relative(cwd, entryFile);
25
+ const code = fs.readFileSync(entryFile, 'utf8');
26
+ if (code.includes('FimoSpaProviders')) {
27
+ return { changes: [], warnings: [], wired: true };
28
+ }
29
+ let program;
30
+ try {
31
+ program = parseSync(entryFile, code).program;
32
+ }
33
+ catch {
34
+ return bail('entry file could not be parsed', rel);
35
+ }
36
+ // The JSX argument of the root render call, found structurally: a call
37
+ // whose callee property is `render` with a JSX element first argument
38
+ // (covers `createRoot(…).render(<X/>)` and `ReactDOM.render(<X/>, node)`).
39
+ const renderArg = (function find(node) {
40
+ if (!node || typeof node !== 'object') {
41
+ return null;
42
+ }
43
+ const candidate = node;
44
+ if (candidate.type === 'CallExpression' &&
45
+ candidate.callee?.type === 'MemberExpression' &&
46
+ candidate.callee?.property?.name === 'render' &&
47
+ (candidate.arguments?.[0]?.type === 'JSXElement' || candidate.arguments?.[0]?.type === 'JSXFragment')) {
48
+ return candidate.arguments[0];
49
+ }
50
+ for (const value of Object.values(candidate)) {
51
+ if (Array.isArray(value)) {
52
+ for (const entry of value) {
53
+ const found = find(entry);
54
+ if (found) {
55
+ return found;
56
+ }
57
+ }
58
+ }
59
+ else if (value && typeof value === 'object') {
60
+ const found = find(value);
61
+ if (found) {
62
+ return found;
63
+ }
64
+ }
65
+ }
66
+ return null;
67
+ })(program);
68
+ if (!renderArg) {
69
+ return bail('no root render call with a JSX argument found', rel);
70
+ }
71
+ const configImportPath = path
72
+ .relative(path.dirname(entryFile), path.join(cwd, 'fimo-config.json'))
73
+ .split(path.sep)
74
+ .join('/');
75
+ const jsx = code.slice(renderArg.start, renderArg.end);
76
+ const open = '<FimoSpaProviders\n' +
77
+ ' config={fimoConfig}\n' +
78
+ ' apiUrl={import.meta.env.VITE_API_URL}\n' +
79
+ ' previewScriptUrl={import.meta.env.DEV ? import.meta.env.VITE_FIMO_PREVIEW_SCRIPT_URL : undefined}\n' +
80
+ ' >';
81
+ let next = code.slice(0, renderArg.start) + `${open}\n ${jsx}\n </FimoSpaProviders>` + code.slice(renderArg.end);
82
+ // AST-positioned like ensureFimoImport: a multiline import's first line is
83
+ // not the end of the imports.
84
+ const importBlock = `import { FimoSpaProviders } from 'fimo/react';\nimport fimoConfig from '${configImportPath.startsWith('.') ? configImportPath : `./${configImportPath}`}';`;
85
+ let lastImportEnd = -1;
86
+ for (const node of program.body ?? []) {
87
+ if (node.type === 'ImportDeclaration') {
88
+ lastImportEnd = node.end;
89
+ }
90
+ }
91
+ // The wrap edit above only touched positions at/after renderArg.start,
92
+ // which is always beyond the import block, so import spans still hold.
93
+ next =
94
+ lastImportEnd >= 0
95
+ ? `${next.slice(0, lastImportEnd)}\n${importBlock}${next.slice(lastImportEnd)}`
96
+ : `${importBlock}\n${next}`;
97
+ fs.writeFileSync(entryFile, next);
98
+ return { changes: [`wired FimoSpaProviders into ${rel}`], warnings: [], wired: true };
99
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,88 @@
1
+ import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { afterEach, describe, expect, it } from 'vitest';
5
+ import { ensureSpaEntryWiring } from './wiring.js';
6
+ let dir;
7
+ const project = (files) => {
8
+ dir = mkdtempSync(join(tmpdir(), 'vite-wiring-'));
9
+ for (const [rel, content] of Object.entries(files)) {
10
+ const full = join(dir, rel);
11
+ mkdirSync(join(full, '..'), { recursive: true });
12
+ writeFileSync(full, content);
13
+ }
14
+ return dir;
15
+ };
16
+ afterEach(() => {
17
+ if (dir) {
18
+ rmSync(dir, { recursive: true, force: true });
19
+ }
20
+ });
21
+ describe('ensureSpaEntryWiring', () => {
22
+ it('wraps the StrictMode root render and imports the config', () => {
23
+ const root = project({
24
+ 'src/main.tsx': `import { StrictMode } from 'react';
25
+ import { createRoot } from 'react-dom/client';
26
+ import { App } from './App';
27
+
28
+ createRoot(document.getElementById('root')!).render(
29
+ <StrictMode>
30
+ <App />
31
+ </StrictMode>
32
+ );
33
+ `,
34
+ });
35
+ const result = ensureSpaEntryWiring(root);
36
+ const code = readFileSync(join(root, 'src/main.tsx'), 'utf8');
37
+ expect(result.wired).toBe(true);
38
+ expect(result.changes).toEqual(['wired FimoSpaProviders into src/main.tsx']);
39
+ expect(code).toContain("import { FimoSpaProviders } from 'fimo/react';");
40
+ expect(code).toContain("import fimoConfig from '../fimo-config.json';");
41
+ expect(code).toContain('<FimoSpaProviders');
42
+ expect(code).toContain('config={fimoConfig}');
43
+ expect(code).toContain('apiUrl={import.meta.env.VITE_API_URL}');
44
+ expect(code).toContain('previewScriptUrl={import.meta.env.DEV ? import.meta.env.VITE_FIMO_PREVIEW_SCRIPT_URL : undefined}');
45
+ // The original tree stays inside the provider.
46
+ expect(code.indexOf('<StrictMode>')).toBeGreaterThan(code.indexOf('<FimoSpaProviders'));
47
+ expect(code.indexOf('</StrictMode>')).toBeLessThan(code.indexOf('</FimoSpaProviders>'));
48
+ // The config import lands AFTER the last original import, not inside one.
49
+ expect(code.indexOf("from './App'")).toBeLessThan(code.indexOf('fimo-config.json'));
50
+ });
51
+ it('handles a bare render argument and src/index fallback', () => {
52
+ const root = project({
53
+ 'src/index.jsx': `import ReactDOM from 'react-dom/client';
54
+ import App from './App';
55
+
56
+ ReactDOM.createRoot(document.getElementById('root')).render(<App />);
57
+ `,
58
+ });
59
+ const result = ensureSpaEntryWiring(root);
60
+ const code = readFileSync(join(root, 'src/index.jsx'), 'utf8');
61
+ expect(result.wired).toBe(true);
62
+ expect(code).toContain('<FimoSpaProviders');
63
+ expect(code).toContain('<App />');
64
+ });
65
+ it('is a no-op when the entry is already wired', () => {
66
+ const wired = `import { FimoSpaProviders } from 'fimo/react';
67
+ import { createRoot } from 'react-dom/client';
68
+
69
+ createRoot(document.getElementById('root')).render(<FimoSpaProviders config={{}}><p>hi</p></FimoSpaProviders>);
70
+ `;
71
+ const root = project({ 'src/main.tsx': wired });
72
+ const result = ensureSpaEntryWiring(root);
73
+ expect(result.wired).toBe(true);
74
+ expect(result.changes).toEqual([]);
75
+ expect(readFileSync(join(root, 'src/main.tsx'), 'utf8')).toBe(wired);
76
+ });
77
+ it('bails when there is no entry file or no JSX render call', () => {
78
+ const empty = project({ 'src/app.ts': 'export {};\n' });
79
+ expect(ensureSpaEntryWiring(empty).wired).toBe(false);
80
+ rmSync(empty, { recursive: true, force: true });
81
+ const noJsx = project({
82
+ 'src/main.tsx': `import { mount } from './mount';\nmount(document.getElementById('root'));\n`,
83
+ });
84
+ const result = ensureSpaEntryWiring(noJsx);
85
+ expect(result.wired).toBe(false);
86
+ expect(result.warnings[0]).toContain('no root render call');
87
+ });
88
+ });
@@ -0,0 +1 @@
1
+ export {};