akanjs 0.0.1 → 2.0.0-beta.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 (682) hide show
  1. package/CODE_OF_CONDUCT.md +54 -0
  2. package/CONTRIBUTING.md +83 -0
  3. package/LICENSE +21 -0
  4. package/README.ko.md +244 -0
  5. package/README.md +237 -6
  6. package/base/base.ts +194 -0
  7. package/base/baseEnv.ts +162 -0
  8. package/base/index.ts +6 -0
  9. package/base/primitiveRegistry.ts +342 -0
  10. package/base/symbols.ts +11 -0
  11. package/base/types.ts +137 -0
  12. package/base/utils.ts +30 -0
  13. package/cli/application/application.command.ts +213 -0
  14. package/cli/application/application.interface.tsx +225 -0
  15. package/cli/application/application.runner.ts +359 -0
  16. package/cli/application/application.script.ts +244 -0
  17. package/cli/build.ts +25 -0
  18. package/cli/cloud/cloud.command.ts +48 -0
  19. package/cli/cloud/cloud.runner.ts +158 -0
  20. package/cli/cloud/cloud.script.ts +40 -0
  21. package/cli/guideline/guideline.command.ts +31 -0
  22. package/cli/guideline/guideline.prompt.ts +212 -0
  23. package/cli/guideline/guideline.runner.ts +53 -0
  24. package/cli/guideline/guideline.script.ts +33 -0
  25. package/cli/guidelines/___library/sharedUiStructureDescription.en.md +767 -0
  26. package/cli/guidelines/___library/utilUiStructureDescription.en.md +395 -0
  27. package/cli/guidelines/___lint/lintRuleDescription.en.md +64 -0
  28. package/cli/guidelines/___module/moduleStructureDescription.en.md +80 -0
  29. package/cli/guidelines/componentRule/componentRule.generate.json +131 -0
  30. package/cli/guidelines/componentRule/componentRule.instruction.md +637 -0
  31. package/cli/guidelines/cssRule/cssRule.generate.json +93 -0
  32. package/cli/guidelines/cssRule/cssRule.instruction.md +435 -0
  33. package/cli/guidelines/databaseModule/databaseModule.generate.json +51 -0
  34. package/cli/guidelines/databaseModule/databaseModule.instruction.md +612 -0
  35. package/cli/guidelines/docPageRule/docPageRule.generate.json +72 -0
  36. package/cli/guidelines/docPageRule/docPageRule.instruction.md +389 -0
  37. package/cli/guidelines/enumConstant/enumConstant.generate.json +24 -0
  38. package/cli/guidelines/enumConstant/enumConstant.instruction.md +232 -0
  39. package/cli/guidelines/framework/framework.generate.json +119 -0
  40. package/cli/guidelines/framework/framework.instruction.md +1110 -0
  41. package/cli/guidelines/howToUseStore/howToUseStore.generate.json +0 -0
  42. package/cli/guidelines/modelConstant/modelConstant.generate.json +128 -0
  43. package/cli/guidelines/modelConstant/modelConstant.instruction.md +506 -0
  44. package/cli/guidelines/modelDictionary/modelDictionary.generate.json +108 -0
  45. package/cli/guidelines/modelDictionary/modelDictionary.instruction.md +547 -0
  46. package/cli/guidelines/modelDocument/modelDocument.generate.json +129 -0
  47. package/cli/guidelines/modelDocument/modelDocument.instruction.md +536 -0
  48. package/cli/guidelines/modelService/modelService.generate.json +135 -0
  49. package/cli/guidelines/modelService/modelService.instruction.md +708 -0
  50. package/cli/guidelines/modelSignal/modelSignal.generate.json +201 -0
  51. package/cli/guidelines/modelSignal/modelSignal.instruction.md +552 -0
  52. package/cli/guidelines/modelStore/modelStore.generate.json +130 -0
  53. package/cli/guidelines/modelStore/modelStore.instruction.md +585 -0
  54. package/cli/guidelines/modelTemplate/modelTemplate.generate.json +104 -0
  55. package/cli/guidelines/modelTemplate/modelTemplate.instruction.md +604 -0
  56. package/cli/guidelines/modelUnit/modelUnit.generate.json +92 -0
  57. package/cli/guidelines/modelUnit/modelUnit.instruction.md +541 -0
  58. package/cli/guidelines/modelUtil/modelUtil.generate.json +93 -0
  59. package/cli/guidelines/modelUtil/modelUtil.instruction.md +752 -0
  60. package/cli/guidelines/modelView/modelView.generate.json +80 -0
  61. package/cli/guidelines/modelView/modelView.instruction.md +1005 -0
  62. package/cli/guidelines/modelZone/modelZone.generate.json +126 -0
  63. package/cli/guidelines/modelZone/modelZone.instruction.md +528 -0
  64. package/cli/guidelines/scalarConstant/scalarConstant.generate.json +106 -0
  65. package/cli/guidelines/scalarConstant/scalarConstant.instruction.md +442 -0
  66. package/cli/guidelines/scalarDictionary/scalarDictionary.generate.json +83 -0
  67. package/cli/guidelines/scalarDictionary/scalarDictionary.instruction.md +273 -0
  68. package/cli/guidelines/scalarModule/scalarModule.generate.json +35 -0
  69. package/cli/guidelines/scalarModule/scalarModule.instruction.md +81 -0
  70. package/cli/guidelines/sharedUiUsage/sharedUiUsage.generate.json +108 -0
  71. package/cli/guidelines/sharedUiUsage/sharedUiUsage.instruction.md +310 -0
  72. package/cli/guidelines/utilUiUsage/utilUiUsage.generate.json +140 -0
  73. package/cli/guidelines/utilUiUsage/utilUiUsage.instruction.md +339 -0
  74. package/cli/index.js +11401 -0
  75. package/cli/index.ts +24 -0
  76. package/cli/library/library.command.ts +28 -0
  77. package/cli/library/library.runner.ts +69 -0
  78. package/cli/library/library.script.ts +39 -0
  79. package/cli/module/module.command.ts +35 -0
  80. package/cli/module/module.prompt.ts +18 -0
  81. package/cli/module/module.request.ts +319 -0
  82. package/cli/module/module.runner.ts +76 -0
  83. package/cli/module/module.script.ts +161 -0
  84. package/cli/package/package.command.ts +32 -0
  85. package/cli/package/package.runner.ts +64 -0
  86. package/cli/package/package.script.ts +35 -0
  87. package/cli/page/page.command.ts +14 -0
  88. package/cli/page/page.runner.ts +14 -0
  89. package/cli/page/page.script.ts +12 -0
  90. package/cli/scalar/scalar.command.ts +21 -0
  91. package/cli/scalar/scalar.prompt.ts +131 -0
  92. package/cli/scalar/scalar.runner.ts +38 -0
  93. package/cli/scalar/scalar.script.ts +16 -0
  94. package/cli/templates/__scalar/__model__/__model__.constant.ts +15 -0
  95. package/cli/templates/__scalar/__model__/__model__.dictionary.ts +19 -0
  96. package/cli/templates/__scalar/__model__/__model__.document.ts +15 -0
  97. package/cli/templates/app/akan.config.ts +14 -0
  98. package/cli/templates/app/capacitor.config.ts.template +8 -0
  99. package/cli/templates/app/common/commonLogic.ts +12 -0
  100. package/cli/templates/app/common/index.ts +10 -0
  101. package/cli/templates/app/env/env.client.debug.ts.template +7 -0
  102. package/cli/templates/app/env/env.client.develop.ts.template +7 -0
  103. package/cli/templates/app/env/env.client.local.ts.template +7 -0
  104. package/cli/templates/app/env/env.client.main.ts.template +7 -0
  105. package/cli/templates/app/env/env.client.testing.ts.template +7 -0
  106. package/cli/templates/app/env/env.client.ts +21 -0
  107. package/cli/templates/app/env/env.client.type.ts +16 -0
  108. package/cli/templates/app/env/env.server.debug.ts.template +7 -0
  109. package/cli/templates/app/env/env.server.develop.ts.template +9 -0
  110. package/cli/templates/app/env/env.server.local.ts.template +14 -0
  111. package/cli/templates/app/env/env.server.main.ts.template +9 -0
  112. package/cli/templates/app/env/env.server.testing.ts.template +6 -0
  113. package/cli/templates/app/env/env.server.ts +20 -0
  114. package/cli/templates/app/lib/___appName__/__appName__.dictionary.ts +17 -0
  115. package/cli/templates/app/lib/___appName__/__appName__.service.ts +13 -0
  116. package/cli/templates/app/lib/___appName__/__appName__.signal.ts +17 -0
  117. package/cli/templates/app/lib/___appName__/__appName__.store.ts +15 -0
  118. package/cli/templates/app/lib/option.ts +17 -0
  119. package/cli/templates/app/main.ts +16 -0
  120. package/cli/templates/app/package.json.template +5 -0
  121. package/cli/templates/app/page/_index.tsx +172 -0
  122. package/cli/templates/app/page/_layout.tsx +32 -0
  123. package/cli/templates/app/page/styles.css.template +53 -0
  124. package/cli/templates/app/public/favicon.ico +0 -0
  125. package/cli/templates/app/public/logo.png +0 -0
  126. package/cli/templates/app/srvkit/backendLogic.ts +12 -0
  127. package/cli/templates/app/srvkit/index.ts +10 -0
  128. package/cli/templates/app/tsconfig.json.template +21 -0
  129. package/cli/templates/app/ui/UiComponent.ts +16 -0
  130. package/cli/templates/app/ui/index.ts +10 -0
  131. package/cli/templates/app/webkit/frontendLogic.ts +12 -0
  132. package/cli/templates/app/webkit/index.ts +10 -0
  133. package/cli/templates/client.ts +46 -0
  134. package/cli/templates/crudPages/[__model__Id]/edit/page.tsx +47 -0
  135. package/cli/templates/crudPages/[__model__Id]/page.tsx +52 -0
  136. package/cli/templates/crudPages/new/page.tsx +42 -0
  137. package/cli/templates/crudPages/page.tsx +43 -0
  138. package/cli/templates/crudSinglePage/page.tsx +37 -0
  139. package/cli/templates/env/_env.server.type.ts +16 -0
  140. package/cli/templates/facetIndex/index.ts +32 -0
  141. package/cli/templates/index.ts +10 -0
  142. package/cli/templates/lib/__lib/lib.constant.ts +38 -0
  143. package/cli/templates/lib/__lib/lib.dictionary.ts +33 -0
  144. package/cli/templates/lib/__lib/lib.document.ts +35 -0
  145. package/cli/templates/lib/__lib/lib.service.ts +33 -0
  146. package/cli/templates/lib/__lib/lib.signal.ts +34 -0
  147. package/cli/templates/lib/__lib/lib.store.ts +33 -0
  148. package/cli/templates/lib/cnst.ts +29 -0
  149. package/cli/templates/lib/db.ts +32 -0
  150. package/cli/templates/lib/dict.ts +49 -0
  151. package/cli/templates/lib/sig.ts +60 -0
  152. package/cli/templates/lib/srv.ts +34 -0
  153. package/cli/templates/lib/st.ts +31 -0
  154. package/cli/templates/lib/useClient.ts +19 -0
  155. package/cli/templates/lib/useServer.ts +7 -0
  156. package/cli/templates/libRoot/.gitignore.template +16 -0
  157. package/cli/templates/libRoot/akan.config.ts +12 -0
  158. package/cli/templates/libRoot/base/baseLogic.ts +10 -0
  159. package/cli/templates/libRoot/base/index.ts +8 -0
  160. package/cli/templates/libRoot/common/commonLogic.ts +10 -0
  161. package/cli/templates/libRoot/common/index.ts +8 -0
  162. package/cli/templates/libRoot/env/env.server.example.ts.template +6 -0
  163. package/cli/templates/libRoot/env/env.server.testing.ts.template +6 -0
  164. package/cli/templates/libRoot/lib/___libName__/__libName__.dictionary.ts +15 -0
  165. package/cli/templates/libRoot/lib/___libName__/__libName__.service.ts +11 -0
  166. package/cli/templates/libRoot/lib/___libName__/__libName__.store.ts +13 -0
  167. package/cli/templates/libRoot/lib/option.ts +17 -0
  168. package/cli/templates/libRoot/package.json.template +5 -0
  169. package/cli/templates/libRoot/srvkit/backendLogic.ts +10 -0
  170. package/cli/templates/libRoot/srvkit/index.ts +8 -0
  171. package/cli/templates/libRoot/tsconfig.json.template +11 -0
  172. package/cli/templates/libRoot/ui/index.ts +7 -0
  173. package/cli/templates/libRoot/webkit/frontendLogic.ts +10 -0
  174. package/cli/templates/libRoot/webkit/index.ts +8 -0
  175. package/cli/templates/localDev/docker-compose.yaml.template +37 -0
  176. package/cli/templates/module/__Model__.Template.tsx +36 -0
  177. package/cli/templates/module/__Model__.Unit.tsx +26 -0
  178. package/cli/templates/module/__Model__.Util.tsx +30 -0
  179. package/cli/templates/module/__Model__.View.tsx +29 -0
  180. package/cli/templates/module/__Model__.Zone.tsx +43 -0
  181. package/cli/templates/module/__model__.constant.ts +24 -0
  182. package/cli/templates/module/__model__.dictionary.ts +30 -0
  183. package/cli/templates/module/__model__.document.ts +23 -0
  184. package/cli/templates/module/__model__.service.ts +16 -0
  185. package/cli/templates/module/__model__.signal.ts +27 -0
  186. package/cli/templates/module/__model__.store.ts +19 -0
  187. package/cli/templates/module/index.tsx +44 -0
  188. package/cli/templates/moduleRoot/index.tsx +31 -0
  189. package/cli/templates/pkgRoot/tsconfig.json.template +10 -0
  190. package/cli/templates/server.ts +45 -0
  191. package/cli/templates/workspaceRoot/.env.template +14 -0
  192. package/cli/templates/workspaceRoot/.gitignore.template +130 -0
  193. package/cli/templates/workspaceRoot/.vscode/settings.json.template +23 -0
  194. package/cli/templates/workspaceRoot/biome.json.template +175 -0
  195. package/cli/templates/workspaceRoot/bunfig.toml +4 -0
  196. package/cli/templates/workspaceRoot/infra/app/Chart.yaml.template +6 -0
  197. package/cli/templates/workspaceRoot/infra/app/templates/frontend.yaml.template +182 -0
  198. package/cli/templates/workspaceRoot/infra/app/values/_common-values.yaml.template +183 -0
  199. package/cli/templates/workspaceRoot/package.json.template +7 -0
  200. package/cli/templates/workspaceRoot/tsconfig.json.template +26 -0
  201. package/cli/testHelpers.ts +171 -0
  202. package/cli/workspace/workspace.command.ts +60 -0
  203. package/cli/workspace/workspace.runner.ts +57 -0
  204. package/cli/workspace/workspace.script.ts +68 -0
  205. package/client/capacitor.ts +68 -0
  206. package/client/clientRuntime.ts +141 -0
  207. package/client/cookie.ts +121 -0
  208. package/client/createFont.ts +8 -0
  209. package/client/csrTypes.ts +259 -0
  210. package/client/decorators.ts +25 -0
  211. package/client/device.ts +147 -0
  212. package/client/fetch.ts +1 -0
  213. package/client/index.ts +15 -0
  214. package/client/locale.ts +4 -0
  215. package/client/makePageProto.tsx +178 -0
  216. package/client/router.ts +286 -0
  217. package/client/rscNavigation.ts +19 -0
  218. package/client/storage.ts +33 -0
  219. package/client/translator.ts +43 -0
  220. package/client/types.ts +228 -0
  221. package/client/useClient.ts +1 -0
  222. package/common/Logger.ts +177 -0
  223. package/common/applyMixins.ts +14 -0
  224. package/common/capitalize.ts +4 -0
  225. package/common/deepObjectify.ts +27 -0
  226. package/common/formatNumber.ts +14 -0
  227. package/common/formatPhone.ts +7 -0
  228. package/common/getAllPropertyDescriptors.ts +13 -0
  229. package/common/hmrPhase.ts +17 -0
  230. package/common/httpClient.ts +101 -0
  231. package/common/index.ts +50 -0
  232. package/common/isDayjs.ts +3 -0
  233. package/common/isEmail.ts +2 -0
  234. package/common/isPhoneNumber.ts +8 -0
  235. package/common/isQueryEqual.ts +23 -0
  236. package/common/isValidDate.ts +14 -0
  237. package/common/localeConfig.ts +41 -0
  238. package/common/lowerlize.ts +4 -0
  239. package/common/mergeVersion.ts +10 -0
  240. package/common/objectify.ts +7 -0
  241. package/common/pathGet.ts +13 -0
  242. package/common/pathSet.ts +16 -0
  243. package/common/randomPick.ts +1 -0
  244. package/common/randomPicks.ts +12 -0
  245. package/common/routeConvention.ts +203 -0
  246. package/common/sleep.ts +8 -0
  247. package/common/splitVersion.ts +11 -0
  248. package/common/subRoute.ts +34 -0
  249. package/common/types.ts +15 -0
  250. package/constant/constantRegistry.ts +334 -0
  251. package/constant/crystalize.ts +45 -0
  252. package/constant/deserialize.ts +70 -0
  253. package/constant/fieldInfo.ts +415 -0
  254. package/constant/getDefault.ts +18 -0
  255. package/constant/immerify.ts +16 -0
  256. package/constant/index.ts +10 -0
  257. package/constant/purify.ts +118 -0
  258. package/constant/serialize.ts +87 -0
  259. package/constant/types.ts +105 -0
  260. package/constant/via.ts +360 -0
  261. package/devkit/aiEditor.ts +299 -0
  262. package/devkit/akanApp/akanApp.host.ts +356 -0
  263. package/devkit/akanApp/index.ts +1 -0
  264. package/devkit/akanConfig/akanConfig.ts +332 -0
  265. package/devkit/akanConfig/index.ts +2 -0
  266. package/devkit/akanConfig/types.ts +187 -0
  267. package/devkit/applicationBuildReporter.ts +69 -0
  268. package/devkit/applicationBuildRunner.ts +302 -0
  269. package/devkit/applicationReleasePackager.ts +205 -0
  270. package/devkit/artifact/implicitRootLayout.ts +155 -0
  271. package/devkit/artifact/index.ts +1 -0
  272. package/devkit/artifact/routeSeedIndex.ts +128 -0
  273. package/devkit/auth.ts +41 -0
  274. package/devkit/builder.ts +164 -0
  275. package/devkit/capacitor.base.config.ts +74 -0
  276. package/devkit/capacitorApp.ts +385 -0
  277. package/devkit/commandDecorators/argMeta.ts +88 -0
  278. package/devkit/commandDecorators/command.ts +314 -0
  279. package/devkit/commandDecorators/commandBuilder.ts +188 -0
  280. package/devkit/commandDecorators/commandMeta.ts +6 -0
  281. package/devkit/commandDecorators/dependencyBuilder.ts +100 -0
  282. package/devkit/commandDecorators/helpFormatter.ts +217 -0
  283. package/devkit/commandDecorators/index.ts +8 -0
  284. package/devkit/commandDecorators/targetMeta.ts +31 -0
  285. package/devkit/commandDecorators/types.ts +10 -0
  286. package/devkit/constants.ts +25 -0
  287. package/devkit/createTunnel.ts +36 -0
  288. package/devkit/dependencyScanner.ts +339 -0
  289. package/devkit/executors.ts +1326 -0
  290. package/devkit/extractDeps.ts +85 -0
  291. package/devkit/fileEditor.ts +106 -0
  292. package/devkit/fileSys.ts +39 -0
  293. package/devkit/frontendBuild/allRoutesBuilder.ts +103 -0
  294. package/devkit/frontendBuild/clientBuildTypes.ts +114 -0
  295. package/devkit/frontendBuild/clientEntriesBundler.ts +300 -0
  296. package/devkit/frontendBuild/clientEntryDiscovery.ts +196 -0
  297. package/devkit/frontendBuild/csrArtifactBuilder.ts +237 -0
  298. package/devkit/frontendBuild/cssCompiler.ts +279 -0
  299. package/devkit/frontendBuild/cssImportResolver.ts +116 -0
  300. package/devkit/frontendBuild/fontOptimizer.ts +427 -0
  301. package/devkit/frontendBuild/hmrChangeClassifier.ts +28 -0
  302. package/devkit/frontendBuild/hmrWatcher.ts +101 -0
  303. package/devkit/frontendBuild/index.ts +18 -0
  304. package/devkit/frontendBuild/pagesBundleBuilder.ts +137 -0
  305. package/devkit/frontendBuild/pagesEntrySourceGenerator.ts +37 -0
  306. package/devkit/frontendBuild/precompressArtifacts.ts +59 -0
  307. package/devkit/frontendBuild/routeClientBuilder.ts +290 -0
  308. package/devkit/frontendBuild/routesManifestArtifactSerializer.ts +62 -0
  309. package/devkit/frontendBuild/ssrBaseArtifactBuilder.ts +139 -0
  310. package/devkit/frontendBuild/vendorSpecifiers.ts +16 -0
  311. package/devkit/frontendBuild/watchRootResolver.ts +28 -0
  312. package/devkit/getCredentials.ts +19 -0
  313. package/devkit/getDirname.ts +3 -0
  314. package/devkit/getModelFileData.ts +59 -0
  315. package/devkit/getRelatedCnsts.ts +300 -0
  316. package/devkit/guideline.ts +19 -0
  317. package/devkit/incrementalBuilder/incrementalBuilder.host.ts +78 -0
  318. package/devkit/incrementalBuilder/incrementalBuilder.proc.ts +330 -0
  319. package/devkit/incrementalBuilder/index.ts +1 -0
  320. package/devkit/index.ts +36 -0
  321. package/devkit/lint/no-import-client-functions.grit +32 -0
  322. package/devkit/lint/no-import-external-library.grit +21 -0
  323. package/devkit/lint/no-js-private-class-method.grit +42 -0
  324. package/devkit/lint/no-use-client-in-server.grit +7 -0
  325. package/devkit/lint/non-scalar-props-restricted.grit +13 -0
  326. package/devkit/linter.ts +248 -0
  327. package/devkit/mobile/index.ts +1 -0
  328. package/devkit/mobile/mobileTarget.ts +47 -0
  329. package/devkit/prompter.ts +71 -0
  330. package/devkit/scanInfo.ts +605 -0
  331. package/devkit/selectModel.ts +11 -0
  332. package/devkit/spinner.ts +54 -0
  333. package/devkit/sshTunnel.ts +151 -0
  334. package/devkit/streamAi.ts +45 -0
  335. package/devkit/transforms/barrelAnalyzer.ts +249 -0
  336. package/devkit/transforms/barrelImportsPlugin.ts +451 -0
  337. package/devkit/transforms/externalizeFrameworkPlugin.ts +159 -0
  338. package/devkit/transforms/index.ts +5 -0
  339. package/devkit/transforms/rscUseClientTransform.ts +52 -0
  340. package/devkit/transforms/useClientBundlePlugin.ts +47 -0
  341. package/devkit/typeChecker.ts +260 -0
  342. package/devkit/types.ts +42 -0
  343. package/devkit/ui/MultiScrollList.tsx +228 -0
  344. package/devkit/ui/ScrollList.tsx +106 -0
  345. package/devkit/ui/index.ts +2 -0
  346. package/devkit/uploadRelease.ts +95 -0
  347. package/devkit/useStdoutDimensions.ts +20 -0
  348. package/dictionary/base.dictionary.ts +91 -0
  349. package/dictionary/dictInfo.ts +1079 -0
  350. package/dictionary/dictionary.ts +10 -0
  351. package/dictionary/index.ts +12 -0
  352. package/dictionary/locale.ts +230 -0
  353. package/dictionary/trans.ts +196 -0
  354. package/document/by.ts +39 -0
  355. package/document/dataLoader.ts +91 -0
  356. package/document/database.ts +168 -0
  357. package/document/databaseRegistry.ts +113 -0
  358. package/document/documentQuery.ts +143 -0
  359. package/document/documentSchema.ts +91 -0
  360. package/document/filterMeta.ts +210 -0
  361. package/document/index.ts +11 -0
  362. package/document/into.ts +169 -0
  363. package/document/loaderInfo.ts +50 -0
  364. package/document/schema.ts +24 -0
  365. package/document/types.ts +41 -0
  366. package/fetch/client/fetchClient.ts +600 -0
  367. package/fetch/client/httpClient.ts +157 -0
  368. package/fetch/client/index.ts +3 -0
  369. package/fetch/client/wsClient.ts +246 -0
  370. package/fetch/fetchType/appliedReturn.type.ts +108 -0
  371. package/fetch/fetchType/buildFetch.type.ts +24 -0
  372. package/fetch/fetchType/clientSignal.type.ts +22 -0
  373. package/fetch/fetchType/endpointFetch.type.ts +56 -0
  374. package/fetch/fetchType/index.ts +5 -0
  375. package/fetch/fetchType/sliceFetch.type.ts +173 -0
  376. package/fetch/index.ts +4 -0
  377. package/fetch/requestStorage.ts +127 -0
  378. package/fetch/serializer/fetch.serializer.ts +131 -0
  379. package/fetch/serializer/index.ts +1 -0
  380. package/fetch/types.ts +28 -0
  381. package/package.json +202 -5
  382. package/server/SSR_MEMORY_DIAGNOSIS.md +107 -0
  383. package/server/akanApp.ts +855 -0
  384. package/server/akanLib.ts +43 -0
  385. package/server/akanOption.ts +42 -0
  386. package/server/akanServer.ts +369 -0
  387. package/server/artifact/builderRpc.ts +124 -0
  388. package/server/artifact/index.ts +6 -0
  389. package/server/artifact/ipcTypes.ts +46 -0
  390. package/server/artifact/manifestTypes.ts +19 -0
  391. package/server/artifact/routeClientCache.ts +224 -0
  392. package/server/artifact/routeSeedIndexStore.ts +89 -0
  393. package/server/artifact/routesManifestStore.ts +120 -0
  394. package/server/decorators.ts +95 -0
  395. package/server/di/diLifecycle.ts +520 -0
  396. package/server/di/index.ts +4 -0
  397. package/server/di/predefinedAdaptor.ts +77 -0
  398. package/server/di/resolveAdaptorHierarchy.ts +82 -0
  399. package/server/di/resolveHierarchy.ts +89 -0
  400. package/server/di/resolveServiceHierarchy.ts +47 -0
  401. package/server/di/utils.ts +40 -0
  402. package/server/hmr/changeBatch.ts +14 -0
  403. package/server/hmr/clientScript.ts +310 -0
  404. package/server/hmr/devHmrController.ts +395 -0
  405. package/server/hmr/index.ts +4 -0
  406. package/server/hmr/wsHub.ts +56 -0
  407. package/server/imageOptimizer.ts +427 -0
  408. package/server/imageOptimizerError.ts +8 -0
  409. package/server/index.ts +14 -0
  410. package/server/lifecycle/shutdownManager.ts +52 -0
  411. package/server/logging/rotatingLogWriter.ts +190 -0
  412. package/server/processMetricsCollector.ts +78 -0
  413. package/server/proxy/akanResponse.ts +16 -0
  414. package/server/proxy/bunRequestFields.ts +12 -0
  415. package/server/proxy/hostBasePathWebProxy.ts +112 -0
  416. package/server/proxy/index.ts +15 -0
  417. package/server/proxy/localeWebProxy.ts +71 -0
  418. package/server/proxy/types.ts +41 -0
  419. package/server/proxy/webProxyRunner.ts +90 -0
  420. package/server/resolver/database.resolver.ts +340 -0
  421. package/server/resolver/index.ts +3 -0
  422. package/server/resolver/resolver.contract.fixture.ts +222 -0
  423. package/server/resolver/service.resolver.ts +176 -0
  424. package/server/resolver/signal.resolver.ts +386 -0
  425. package/server/robots.ts +32 -0
  426. package/server/routeElementComposer.tsx +91 -0
  427. package/server/routeTreeBuilder.ts +279 -0
  428. package/server/routing/apiRouter.ts +226 -0
  429. package/server/rscClient.tsx +140 -0
  430. package/server/rscWorker.tsx +625 -0
  431. package/server/rscWorkerHost.ts +616 -0
  432. package/server/sitemap.ts +90 -0
  433. package/server/ssrFromRscRenderer.tsx +285 -0
  434. package/server/ssrTypes.ts +48 -0
  435. package/server/types/react-server-dom-webpack.d.ts +91 -0
  436. package/server/types.tsx +109 -0
  437. package/server/vendor/akanjs-base.ts +1 -0
  438. package/server/vendor/akanjs-common.ts +1 -0
  439. package/server/vendor/akanjs-constant.ts +1 -0
  440. package/server/vendor/akanjs-store.ts +1 -0
  441. package/server/vendor/react-dom-client.ts +5 -0
  442. package/server/vendor/react-dom.ts +21 -0
  443. package/server/vendor/react-jsx-dev-runtime.ts +5 -0
  444. package/server/vendor/react-jsx-runtime.ts +5 -0
  445. package/server/vendor/react-refresh-runtime.ts +6 -0
  446. package/server/vendor/react-server-dom-webpack-client-browser.ts +12 -0
  447. package/server/vendor/react.ts +51 -0
  448. package/server/vendor/scheduler.ts +23 -0
  449. package/server/webRouter.ts +712 -0
  450. package/service/adapt.ts +47 -0
  451. package/service/base.service.ts +18 -0
  452. package/service/index.ts +10 -0
  453. package/service/injectInfo.ts +393 -0
  454. package/service/ipcTypes.ts +127 -0
  455. package/service/predefinedAdaptor/cache.adaptor.ts +105 -0
  456. package/service/predefinedAdaptor/compress.adaptor.ts +357 -0
  457. package/service/predefinedAdaptor/database.adaptor.ts +1310 -0
  458. package/service/predefinedAdaptor/index.ts +13 -0
  459. package/service/predefinedAdaptor/logging.adaptor.ts +36 -0
  460. package/service/predefinedAdaptor/queue.adaptor.ts +42 -0
  461. package/service/predefinedAdaptor/role.adaptor.ts +18 -0
  462. package/service/predefinedAdaptor/schedule.adaptor.ts +188 -0
  463. package/service/predefinedAdaptor/solidCache.adaptor.ts +143 -0
  464. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +98 -0
  465. package/service/predefinedAdaptor/solidQueue.adaptor.ts +203 -0
  466. package/service/predefinedAdaptor/solidSqlite.ts +85 -0
  467. package/service/predefinedAdaptor/sqlitePath.ts +20 -0
  468. package/service/predefinedAdaptor/storage.adaptor.ts +121 -0
  469. package/service/predefinedAdaptor/websocket.adaptor.ts +313 -0
  470. package/service/serve.ts +223 -0
  471. package/service/serviceModule.ts +221 -0
  472. package/service/serviceRegistry.ts +26 -0
  473. package/service/types.ts +113 -0
  474. package/signal/base.signal.ts +46 -0
  475. package/signal/endpoint.ts +122 -0
  476. package/signal/endpointInfo.ts +374 -0
  477. package/signal/exception.ts +50 -0
  478. package/signal/guard.ts +18 -0
  479. package/signal/guards.ts +16 -0
  480. package/signal/index.ts +18 -0
  481. package/signal/intercept.ts +39 -0
  482. package/signal/internal.ts +56 -0
  483. package/signal/internalArg.ts +38 -0
  484. package/signal/internalInfo.ts +208 -0
  485. package/signal/middleware.ts +108 -0
  486. package/signal/serializer/fetch.serializer.ts +128 -0
  487. package/signal/serializer/index.ts +1 -0
  488. package/signal/serverSignal.ts +114 -0
  489. package/signal/signalContext.ts +446 -0
  490. package/signal/signalRegistry.ts +82 -0
  491. package/signal/slice.ts +158 -0
  492. package/signal/sliceInfo.ts +254 -0
  493. package/signal/types.ts +131 -0
  494. package/store/action.ts +1067 -0
  495. package/store/baseSt.ts +81 -0
  496. package/store/hooks.ts +2 -0
  497. package/store/index.ts +8 -0
  498. package/store/rootStore.ts +26 -0
  499. package/store/state.ts +226 -0
  500. package/store/stateBuilder.ts +429 -0
  501. package/store/stateInfo.ts +66 -0
  502. package/store/store.ts +194 -0
  503. package/store/storeInstance.ts +382 -0
  504. package/store/storeRegistry.ts +84 -0
  505. package/store/types.ts +69 -0
  506. package/store/withSelector.ts +62 -0
  507. package/test/index.ts +16 -0
  508. package/test/playwright.config.base.ts +48 -0
  509. package/test/playwright.pageAgent.ts +41 -0
  510. package/test/sample.ts +19 -0
  511. package/test/sampleOf.ts +70 -0
  512. package/test/signalTest.preload.ts +10 -0
  513. package/test/signalTestRuntime.ts +126 -0
  514. package/test/testServer.ts +187 -0
  515. package/ui/BottomSheet.tsx +103 -0
  516. package/ui/Button.tsx +70 -0
  517. package/ui/ClientSide.tsx +11 -0
  518. package/ui/Clipboard.tsx +49 -0
  519. package/ui/Constant/Doc.tsx +696 -0
  520. package/ui/Constant/Mermaid.tsx +149 -0
  521. package/ui/Constant/index.ts +6 -0
  522. package/ui/Constant/schemaDoc.ts +324 -0
  523. package/ui/Copy.tsx +27 -0
  524. package/ui/CsrImage.tsx +38 -0
  525. package/ui/Data/CardList.tsx +141 -0
  526. package/ui/Data/Dashboard.tsx +72 -0
  527. package/ui/Data/Insight.tsx +35 -0
  528. package/ui/Data/Item.tsx +285 -0
  529. package/ui/Data/ListContainer.tsx +320 -0
  530. package/ui/Data/Pagination.tsx +54 -0
  531. package/ui/Data/QueryMaker.tsx +21 -0
  532. package/ui/Data/TableList.tsx +161 -0
  533. package/ui/Data/index.ts +11 -0
  534. package/ui/Data/index_.tsx +11 -0
  535. package/ui/DatePicker.tsx +184 -0
  536. package/ui/Dialog/Action.tsx +15 -0
  537. package/ui/Dialog/Close.tsx +22 -0
  538. package/ui/Dialog/Content.tsx +11 -0
  539. package/ui/Dialog/Modal.tsx +137 -0
  540. package/ui/Dialog/Provider.tsx +33 -0
  541. package/ui/Dialog/Title.tsx +15 -0
  542. package/ui/Dialog/Trigger.tsx +22 -0
  543. package/ui/Dialog/context.ts +20 -0
  544. package/ui/Dialog/index.tsx +15 -0
  545. package/ui/DragAction.tsx +129 -0
  546. package/ui/DraggableList.tsx +230 -0
  547. package/ui/Dropdown.tsx +51 -0
  548. package/ui/Empty.tsx +32 -0
  549. package/ui/Field.tsx +1556 -0
  550. package/ui/FontFace.tsx +26 -0
  551. package/ui/Image.tsx +185 -0
  552. package/ui/InfiniteScroll.tsx +67 -0
  553. package/ui/Input.tsx +636 -0
  554. package/ui/KeyboardAvoiding.tsx +62 -0
  555. package/ui/Layout/BottomAction.tsx +15 -0
  556. package/ui/Layout/BottomInset.tsx +42 -0
  557. package/ui/Layout/BottomTab.tsx +71 -0
  558. package/ui/Layout/Header.tsx +38 -0
  559. package/ui/Layout/LeftSider.tsx +34 -0
  560. package/ui/Layout/Navbar.tsx +46 -0
  561. package/ui/Layout/RightSider.tsx +41 -0
  562. package/ui/Layout/Sider.tsx +69 -0
  563. package/ui/Layout/Template.tsx +11 -0
  564. package/ui/Layout/TopLeftAction.tsx +28 -0
  565. package/ui/Layout/Unit.tsx +19 -0
  566. package/ui/Layout/View.tsx +12 -0
  567. package/ui/Layout/Zone.tsx +10 -0
  568. package/ui/Layout/index.ts +27 -0
  569. package/ui/Link/Back.tsx +15 -0
  570. package/ui/Link/Close.tsx +20 -0
  571. package/ui/Link/CsrLink.tsx +41 -0
  572. package/ui/Link/Lang.tsx +16 -0
  573. package/ui/Link/SsrLink.tsx +68 -0
  574. package/ui/Link/index.tsx +32 -0
  575. package/ui/Link/types.ts +47 -0
  576. package/ui/Load/Edit.tsx +19 -0
  577. package/ui/Load/Edit_Client.tsx +120 -0
  578. package/ui/Load/Page.tsx +40 -0
  579. package/ui/Load/PageCSR.tsx +39 -0
  580. package/ui/Load/Pagination.tsx +89 -0
  581. package/ui/Load/Units.tsx +330 -0
  582. package/ui/Load/View.tsx +115 -0
  583. package/ui/Load/index.ts +11 -0
  584. package/ui/Load/index_.tsx +6 -0
  585. package/ui/Loading/Area.tsx +10 -0
  586. package/ui/Loading/Button.tsx +17 -0
  587. package/ui/Loading/Input.tsx +17 -0
  588. package/ui/Loading/ProgressBar.tsx +14 -0
  589. package/ui/Loading/Skeleton.tsx +22 -0
  590. package/ui/Loading/Spin.tsx +22 -0
  591. package/ui/Loading/index.tsx +8 -0
  592. package/ui/Menu.tsx +273 -0
  593. package/ui/Modal.tsx +87 -0
  594. package/ui/Model/AdminPanel.tsx +51 -0
  595. package/ui/Model/Edit.tsx +46 -0
  596. package/ui/Model/EditModal.tsx +301 -0
  597. package/ui/Model/EditWrapper.tsx +48 -0
  598. package/ui/Model/LoadInit.tsx +11 -0
  599. package/ui/Model/New.tsx +46 -0
  600. package/ui/Model/NewWrapper.tsx +20 -0
  601. package/ui/Model/NewWrapper_Client.tsx +57 -0
  602. package/ui/Model/Remove.tsx +75 -0
  603. package/ui/Model/RemoveWrapper.tsx +38 -0
  604. package/ui/Model/SureToRemove.tsx +108 -0
  605. package/ui/Model/View.tsx +65 -0
  606. package/ui/Model/ViewEditModal.tsx +125 -0
  607. package/ui/Model/ViewModal.tsx +71 -0
  608. package/ui/Model/ViewWrapper.tsx +38 -0
  609. package/ui/Model/index.ts +33 -0
  610. package/ui/Model/index_.tsx +16 -0
  611. package/ui/More.tsx +56 -0
  612. package/ui/ObjectId.tsx +29 -0
  613. package/ui/Pagination.tsx +120 -0
  614. package/ui/Popconfirm.tsx +135 -0
  615. package/ui/Portal.tsx +10 -0
  616. package/ui/Radio.tsx +53 -0
  617. package/ui/RecentTime.tsx +123 -0
  618. package/ui/Refresh.tsx +24 -0
  619. package/ui/ScreenNavigator.tsx +129 -0
  620. package/ui/Select.tsx +322 -0
  621. package/ui/Signal/Arg.tsx +352 -0
  622. package/ui/Signal/Doc.tsx +231 -0
  623. package/ui/Signal/Listener.tsx +74 -0
  624. package/ui/Signal/Message.tsx +267 -0
  625. package/ui/Signal/Object.tsx +131 -0
  626. package/ui/Signal/PubSub.tsx +247 -0
  627. package/ui/Signal/Request.tsx +30 -0
  628. package/ui/Signal/Response.tsx +76 -0
  629. package/ui/Signal/RestApi.tsx +390 -0
  630. package/ui/Signal/WebSocket.tsx +47 -0
  631. package/ui/Signal/index.ts +10 -0
  632. package/ui/Signal/makeExample.ts +75 -0
  633. package/ui/System/CSR.tsx +420 -0
  634. package/ui/System/Client.tsx +296 -0
  635. package/ui/System/Common.tsx +83 -0
  636. package/ui/System/DevModeToggle.tsx +21 -0
  637. package/ui/System/Gtag.tsx +69 -0
  638. package/ui/System/Messages.tsx +175 -0
  639. package/ui/System/Reconnect.tsx +156 -0
  640. package/ui/System/Root.tsx +10 -0
  641. package/ui/System/SSR.tsx +163 -0
  642. package/ui/System/SelectLanguage.tsx +47 -0
  643. package/ui/System/ThemeToggle.tsx +98 -0
  644. package/ui/System/index.tsx +23 -0
  645. package/ui/Tab/Menu.tsx +56 -0
  646. package/ui/Tab/Menus.tsx +10 -0
  647. package/ui/Tab/Panel.tsx +25 -0
  648. package/ui/Tab/Provider.tsx +25 -0
  649. package/ui/Tab/context.ts +16 -0
  650. package/ui/Tab/index.tsx +11 -0
  651. package/ui/Table.tsx +131 -0
  652. package/ui/ToggleSelect.tsx +144 -0
  653. package/ui/Unauthorized.tsx +29 -0
  654. package/ui/animated.tsx +8 -0
  655. package/ui/fontCss.ts +86 -0
  656. package/ui/index.ts +44 -0
  657. package/ui/styles.css +617 -0
  658. package/webkit/bootCsr.tsx +275 -0
  659. package/webkit/createRobotPage.ts +15 -0
  660. package/webkit/createSitemapPage.ts +4 -0
  661. package/webkit/index.ts +19 -0
  662. package/webkit/lazy.tsx +37 -0
  663. package/webkit/types.ts +7 -0
  664. package/webkit/useCamera.tsx +99 -0
  665. package/webkit/useCodepush.tsx +99 -0
  666. package/webkit/useContact.tsx +48 -0
  667. package/webkit/useCsrValues.ts +661 -0
  668. package/webkit/useDebounce.ts +24 -0
  669. package/webkit/useFetch.ts +48 -0
  670. package/webkit/useGeoLocation.tsx +24 -0
  671. package/webkit/useHistory.ts +76 -0
  672. package/webkit/useInterval.ts +21 -0
  673. package/webkit/useLocation.ts +69 -0
  674. package/webkit/usePurchase.tsx +156 -0
  675. package/webkit/usePushNoti.tsx +48 -0
  676. package/webkit/useThrottle.ts +22 -0
  677. package/src/index.js +0 -2
  678. package/src/index.js.map +0 -1
  679. package/src/lib/akan2.js +0 -4
  680. package/src/lib/akan2.js.map +0 -1
  681. package/src/run.js +0 -4
  682. package/src/run.js.map +0 -1
package/devkit/frontendBuild/csrArtifactBuilder.ts ADDED
@@ -0,0 +1,237 @@
1
+ import { mkdir, rm, unlink } from "node:fs/promises";
2
+ import path from "node:path";
3
+ import type { BaseBuildArtifact } from "akanjs/server";
4
+ import { resolveSsrPageEntriesForApp } from "../artifact/implicitRootLayout";
5
+ import type { App } from "../commandDecorators";
6
+ import { PagesEntrySourceGenerator } from "./pagesEntrySourceGenerator";
7
+
8
+ export interface BuildCsrArtifactResult {
9
+ outputDir: string;
10
+ }
11
+
12
+ export class CsrArtifactBuilder {
13
+ #app: App;
14
+ #command: "build" | "start";
15
+ #lang: string;
16
+
17
+ constructor(app: App, command: "build" | "start" = "start", lang = "en") {
18
+ this.#app = app;
19
+ this.#command = command;
20
+ this.#lang = lang;
21
+ }
22
+
23
+ async build(): Promise<BuildCsrArtifactResult | null> {
24
+ const pageKeys = await this.#app.getPageKeys();
25
+ if (pageKeys.length === 0) {
26
+ this.#app.log(`[cli] no route files under ${this.#app.cwdPath}/page — skipping CSR build`);
27
+ return null;
28
+ }
29
+
30
+ const pageEntries = await resolveSsrPageEntriesForApp(this.#app, pageKeys);
31
+ const akanConfig = await this.#app.getConfig();
32
+ const artifact = await this.#loadCsrArtifact();
33
+ const csrBasePaths = [...akanConfig.basePaths];
34
+ const htmlEntries = csrBasePaths.length > 0 ? csrBasePaths : ["index"];
35
+ await rm(this.#outputDir, { recursive: true, force: true });
36
+ await mkdir(path.join(this.#app.cwdPath, ".akan/generated/csr"), { recursive: true });
37
+ const generatedHtmlFiles = Object.fromEntries(htmlEntries.map((basePath) => this.#createHtmlFile(basePath)));
38
+
39
+ const result = await Bun.build({
40
+ target: "browser",
41
+ entrypoints: Object.keys(generatedHtmlFiles),
42
+ files: {
43
+ ...generatedHtmlFiles,
44
+ [`${this.#app.cwdPath}/.akan/generated/csr/csr.tsx`]: `
45
+ import { bootCsr } from "akanjs/webkit";
46
+ ${PagesEntrySourceGenerator.generateStatic(pageEntries)}
47
+ void bootCsr(pages);
48
+ `,
49
+ },
50
+ root: `${this.#app.cwdPath}/.akan/generated/csr`,
51
+ outdir: this.#outputDir,
52
+ splitting: false,
53
+ minify: true,
54
+ env: "AKAN_PUBLIC_*",
55
+ define: this.#define(),
56
+ optimizeImports: akanConfig.optimizeImports,
57
+ });
58
+
59
+ if (!result.success) {
60
+ const logs = result.logs.map((log) => log.message).join("\n");
61
+ throw new Error(`[csr-build] failed${logs ? `\n${logs}` : ""}`);
62
+ }
63
+
64
+ await this.#inlineCsrArtifacts(artifact.cssAssets ?? {});
65
+ this.#app.verbose(`[csr-build] output -> ${this.#outputDir}`);
66
+ return { outputDir: this.#outputDir };
67
+ }
68
+
69
+ get #outputDir(): string {
70
+ return path.join(
71
+ this.#command === "build" ? this.#app.dist.cwdPath : this.#app.cwdPath,
72
+ this.#command === "build" ? "csr" : ".akan/artifact/csr",
73
+ );
74
+ }
75
+
76
+ #define(): Record<string, string> {
77
+ const nodeEnv = this.#command === "build" ? "production" : (process.env.NODE_ENV ?? "development");
78
+ return {
79
+ "process.env.NODE_ENV": JSON.stringify(nodeEnv),
80
+ "process.env.AKAN_PUBLIC_RENDER_ENV": JSON.stringify("csr"),
81
+ ...Object.fromEntries(
82
+ Object.entries(this.#app.getPublicEnv()).map(([key, value]) => [`process.env.${key}`, JSON.stringify(value)]),
83
+ ),
84
+ };
85
+ }
86
+
87
+ #createHtmlFile(basePath: string): readonly [string, string] {
88
+ const filename = `${basePath}.html`;
89
+ return [
90
+ `${this.#app.cwdPath}/.akan/generated/csr/${filename}`,
91
+ `<!doctype html>
92
+ <html lang="${this.#lang}">
93
+ <head>
94
+ <meta charset="utf-8" />
95
+ <title>${this.#app.name}</title>
96
+ <base href="/" />
97
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
98
+ </head>
99
+ <body>
100
+ <div id="root"></div>
101
+ <script type="module" src="./csr.tsx"></script>
102
+ </body>
103
+ </html>
104
+ `,
105
+ ] as const;
106
+ }
107
+
108
+ async #loadCsrArtifact(): Promise<Pick<BaseBuildArtifact, "cssAssets">> {
109
+ const artifactDir = path.join(
110
+ this.#command === "build" ? this.#app.dist.cwdPath : this.#app.cwdPath,
111
+ ".akan/artifact",
112
+ );
113
+ const artifactFile = Bun.file(path.join(artifactDir, "base-artifact.json"));
114
+ if (!(await artifactFile.exists())) return { cssAssets: {} };
115
+ const artifact = (await artifactFile.json()) as Pick<BaseBuildArtifact, "cssAssets">;
116
+ return { cssAssets: artifact.cssAssets ?? {} };
117
+ }
118
+
119
+ async #inlineCsrArtifacts(cssAssets: Record<string, { cssUrl: string; cssRelPath: string }>): Promise<void> {
120
+ const jsFiles = new Set<string>();
121
+ const cssFiles = new Set<string>();
122
+ for (const htmlPath of await this.#htmlOutputPaths()) {
123
+ const htmlFile = Bun.file(htmlPath);
124
+ if (!(await htmlFile.exists())) continue;
125
+ const basePath = path.basename(htmlPath, ".html") === "index" ? "" : path.basename(htmlPath, ".html");
126
+ const inlined = await this.#inlineHtmlAssets(await htmlFile.text(), htmlPath, cssAssets[basePath]);
127
+ for (const filePath of inlined.jsFiles) jsFiles.add(filePath);
128
+ for (const filePath of inlined.cssFiles) cssFiles.add(filePath);
129
+ await Bun.write(htmlPath, inlined.html);
130
+ }
131
+ for (const filePath of jsFiles) await unlink(filePath).catch(() => undefined);
132
+ for (const filePath of cssFiles) await unlink(filePath).catch(() => undefined);
133
+ const remainingJs = await this.#listOutputFiles((filePath) => filePath.endsWith(".js"));
134
+ const remainingCss = await this.#listOutputFiles((filePath) => filePath.endsWith(".css"));
135
+ const remainingAssets = [...remainingJs, ...remainingCss];
136
+ if (remainingAssets.length > 0) {
137
+ throw new Error(`[csr-build] expected single-file HTML, but CSR assets remain:\n${remainingAssets.join("\n")}`);
138
+ }
139
+ }
140
+
141
+ async #inlineHtmlAssets(
142
+ html: string,
143
+ htmlPath: string,
144
+ cssAsset?: { cssUrl: string; cssRelPath: string },
145
+ ): Promise<{ html: string; jsFiles: string[]; cssFiles: string[] }> {
146
+ const jsFiles: string[] = [];
147
+ const cssFiles = CsrArtifactBuilder.collectStylesheetHrefs(html).map((href) =>
148
+ CsrArtifactBuilder.resolveHtmlAssetPath(htmlPath, href),
149
+ );
150
+ let next = CsrArtifactBuilder.stripBundledStylesheetLinks(html);
151
+ next = await CsrArtifactBuilder.replaceModuleScriptSrc(next, async (src) => {
152
+ const jsPath = CsrArtifactBuilder.resolveHtmlAssetPath(htmlPath, src);
153
+ jsFiles.push(jsPath);
154
+ return await Bun.file(jsPath).text();
155
+ });
156
+ if (cssAsset) {
157
+ const cssPath = path.join(
158
+ this.#command === "build" ? this.#app.dist.cwdPath : this.#app.cwdPath,
159
+ ".akan/artifact",
160
+ cssAsset.cssRelPath,
161
+ );
162
+ const css = await Bun.file(cssPath).text();
163
+ const style = CsrArtifactBuilder.createInlineStyle(css);
164
+ if (!next.includes(style)) next = CsrArtifactBuilder.injectBeforeHeadEnd(next, style);
165
+ }
166
+ return { html: next, jsFiles, cssFiles };
167
+ }
168
+
169
+ async #htmlOutputPaths(): Promise<string[]> {
170
+ return await this.#listOutputFiles((filePath) => filePath.endsWith(".html"));
171
+ }
172
+
173
+ async #listOutputFiles(predicate: (filePath: string) => boolean): Promise<string[]> {
174
+ const glob = new Bun.Glob("**/*");
175
+ const files: string[] = [];
176
+ for await (const filePath of glob.scan({ cwd: this.#outputDir, absolute: true })) {
177
+ if (predicate(filePath)) files.push(filePath);
178
+ }
179
+ return files.sort();
180
+ }
181
+
182
+ static injectBeforeHeadEnd(html: string, snippet: string): string {
183
+ const matches = [...html.matchAll(/<\/head\s*>/gi)];
184
+ const bodyStart = html.search(/<body(?:\s|>)/i);
185
+ const headEnd = matches
186
+ .filter((match) => match.index !== undefined && (bodyStart === -1 || match.index < bodyStart))
187
+ .at(-1);
188
+ if (!headEnd || headEnd.index === undefined) return `${snippet}\n${html}`;
189
+ return `${html.slice(0, headEnd.index)}${snippet}\n${html.slice(headEnd.index)}`;
190
+ }
191
+
192
+ static stripBundledStylesheetLinks(html: string): string {
193
+ return html.replace(/<link\b(?=[^>]*\brel=["']stylesheet["'])[^>]*>\s*/gi, "");
194
+ }
195
+
196
+ static collectStylesheetHrefs(html: string): string[] {
197
+ const linkRe = /<link\b(?=[^>]*\brel=["']stylesheet["'])(?=[^>]*\bhref=["']([^"']+)["'])[^>]*>/gi;
198
+ return [...html.matchAll(linkRe)].map((match) => match[1]).filter((href): href is string => !!href);
199
+ }
200
+
201
+ static createInlineStyle(css: string): string {
202
+ return `<style data-akan-css="active">\n${css.replace(/<\/style/gi, "<\\/style")}\n</style>`;
203
+ }
204
+
205
+ static async replaceModuleScriptSrc(
206
+ html: string,
207
+ loadScript: (src: string) => Promise<string> | string,
208
+ ): Promise<string> {
209
+ const scriptRe = /<script\b(?=[^>]*\btype=["']module["'])(?=[^>]*\bsrc=["']([^"']+)["'])[^>]*>\s*<\/script>/gi;
210
+ let result = "";
211
+ let lastIndex = 0;
212
+ let matched = false;
213
+ for (const match of html.matchAll(scriptRe)) {
214
+ const full = match[0];
215
+ const src = match[1];
216
+ if (match.index === undefined || !src) continue;
217
+ matched = true;
218
+ result += html.slice(lastIndex, match.index);
219
+ result += `<script type="module">\n${CsrArtifactBuilder.escapeInlineScript(await loadScript(src))}\n</script>`;
220
+ lastIndex = match.index + full.length;
221
+ }
222
+ if (!matched) return html;
223
+ return result + html.slice(lastIndex);
224
+ }
225
+
226
+ static escapeInlineScript(source: string): string {
227
+ return source.replace(/<\/script/gi, "<\\/script");
228
+ }
229
+
230
+ static resolveHtmlAssetPath(htmlPath: string, src: string): string {
231
+ if (/^[a-z][a-z0-9+.-]*:/i.test(src) || src.startsWith("//")) {
232
+ throw new Error(`[csr-build] cannot inline external script: ${src}`);
233
+ }
234
+ const normalized = src.startsWith("/") ? src.slice(1) : src;
235
+ return path.resolve(path.dirname(htmlPath), normalized);
236
+ }
237
+ }
package/devkit/frontendBuild/cssCompiler.ts ADDED
@@ -0,0 +1,279 @@
1
+ import path from "node:path";
2
+ import { Logger } from "akanjs/common";
3
+ import { compile } from "tailwindcss";
4
+ import type { App } from "../commandDecorators";
5
+ import { BarrelAnalyzer } from "../transforms/barrelAnalyzer";
6
+ import { createTsconfigPackageResolver, rewriteBarrelImports } from "../transforms/barrelImportsPlugin";
7
+ import { CssImportResolver } from "./cssImportResolver";
8
+
9
+ const SOURCE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"] as const;
10
+ const NON_SOURCE_EXT_RE = /\.(json|svg|png|jpe?g|webp|gif|avif|ico|woff2?|ttf|otf|mp3|mp4|wav)$/i;
11
+
12
+ interface CssDiscovery {
13
+ cssPaths: string[];
14
+ sourcePaths: string[];
15
+ }
16
+
17
+ export class CssCompiler {
18
+ #logger = new Logger("CssCompiler");
19
+ #transpiler = new Bun.Transpiler({ loader: "tsx" });
20
+ #app: App;
21
+ #cssImportResolver: CssImportResolver | null = null;
22
+ constructor(app: App) {
23
+ this.#app = app;
24
+ }
25
+
26
+ #cssText: string | null = null;
27
+ #cssTextByBasePath: Record<string, string> | null = null;
28
+ async getCss({ refresh }: { refresh?: boolean } = {}) {
29
+ if (this.#cssText !== null && !refresh) return this.#cssText;
30
+ const { cssPaths, sourcePaths } = await this.discoverCssAndSources({ refresh });
31
+ this.#cssText = await this.compileCss(cssPaths, sourcePaths);
32
+ return this.#cssText;
33
+ }
34
+
35
+ async getCssByBasePath({ refresh }: { refresh?: boolean } = {}): Promise<Record<string, string>> {
36
+ if (this.#cssTextByBasePath !== null && !refresh) return this.#cssTextByBasePath;
37
+ const akanConfig = await this.#app.getConfig({ refresh });
38
+ const pageKeys = await this.#app.getPageKeys({ refresh });
39
+ const basePaths = [...akanConfig.basePaths];
40
+ const rootPageKeys = pageKeys.filter((pageKey) => getPageKeyBasePath(pageKey, basePaths) === null);
41
+ const cssEntries = await Promise.all([
42
+ (async () => {
43
+ if (rootPageKeys.length === 0) return ["", ""] as const;
44
+ const started = Date.now();
45
+ const { cssPaths, sourcePaths } = await this.discoverCssAndSources({ refresh, pageKeys: rootPageKeys });
46
+ const css = await this.compileCss(cssPaths, sourcePaths);
47
+ this.#logger.verbose(
48
+ `css base=root paths=${cssPaths.length} sources=${sourcePaths.length} in ${Date.now() - started}ms`,
49
+ );
50
+ return ["", css] as const;
51
+ })(),
52
+ ...basePaths.map(async (basePath) => {
53
+ const basePathPageKeys = pageKeys.filter((pageKey) => getPageKeyBasePath(pageKey, basePaths) === basePath);
54
+ if (basePathPageKeys.length === 0) return [basePath, ""] as const;
55
+ const started = Date.now();
56
+ const { cssPaths, sourcePaths } = await this.discoverCssAndSources({ refresh, pageKeys: basePathPageKeys });
57
+ const css = await this.compileCss(cssPaths, sourcePaths);
58
+ this.#logger.verbose(
59
+ `css base=${basePath} paths=${cssPaths.length} sources=${sourcePaths.length} in ${Date.now() - started}ms`,
60
+ );
61
+ return [basePath, css] as const;
62
+ }),
63
+ ]);
64
+ this.#cssTextByBasePath = Object.fromEntries(cssEntries);
65
+ return this.#cssTextByBasePath;
66
+ }
67
+
68
+ async discoverCss({ refresh }: { refresh?: boolean } = {}): Promise<string[]> {
69
+ const { cssPaths } = await this.discoverCssAndSources({ refresh });
70
+ return cssPaths;
71
+ }
72
+
73
+ async discoverCssAndSources({
74
+ refresh,
75
+ pageKeys,
76
+ }: {
77
+ refresh?: boolean;
78
+ pageKeys?: string[];
79
+ } = {}): Promise<CssDiscovery> {
80
+ pageKeys ??= await this.#app.getPageKeys({ refresh });
81
+ const seeds = pageKeys.map((key) => path.resolve(this.#app.cwdPath, "page", key));
82
+ const cssFiles = new Set<string>();
83
+ const sourceFiles = new Set<string>();
84
+ const queue = [...seeds];
85
+ const resolvePackage = await createTsconfigPackageResolver(this.#app);
86
+ const analyzer = new BarrelAnalyzer({ resolvePackage });
87
+ const akanConfig = await this.#app.getConfig({ refresh });
88
+
89
+ while (queue.length > 0) {
90
+ const filePath = queue.shift();
91
+ if (!filePath || sourceFiles.has(filePath) || filePath.includes("node_modules")) continue;
92
+ sourceFiles.add(filePath);
93
+
94
+ let content: string;
95
+ try {
96
+ content = await Bun.file(filePath).text();
97
+ } catch {
98
+ continue;
99
+ }
100
+
101
+ let source = content;
102
+ if (akanConfig.barrelImports.length > 0) {
103
+ try {
104
+ const rewritten = await rewriteBarrelImports(content, akanConfig.barrelImports, analyzer);
105
+ if (rewritten !== null) source = rewritten;
106
+ } catch {
107
+ }
108
+ }
109
+
110
+ let imports: Bun.Import[];
111
+ try {
112
+ imports = this.#transpiler.scanImports(source);
113
+ } catch {
114
+ continue;
115
+ }
116
+
117
+ const importerDir = path.dirname(filePath);
118
+ for (const imp of imports) {
119
+ const spec = imp.path;
120
+ if (!spec) continue;
121
+ if (spec.endsWith(".css")) {
122
+ const cssPath = await this.#resolveCssImport(spec, importerDir);
123
+ cssFiles.add(cssPath);
124
+ continue;
125
+ }
126
+ if (NON_SOURCE_EXT_RE.test(spec)) continue;
127
+ const resolved = await this.#resolveSourceImport(spec, importerDir, resolvePackage);
128
+ if (!resolved || sourceFiles.has(resolved) || resolved.includes("node_modules")) continue;
129
+ queue.push(resolved);
130
+ }
131
+ }
132
+
133
+ return { cssPaths: [...cssFiles], sourcePaths: [...sourceFiles] };
134
+ }
135
+ async compileCss(cssPaths: string[], sourcePaths: string[]): Promise<string> {
136
+ if (cssPaths.length === 0) return "";
137
+
138
+ const compileStarted = Date.now();
139
+ const compilers = await Promise.all(
140
+ cssPaths.map(async (cssPath) => {
141
+ const css = await Bun.file(cssPath).text();
142
+ const base = path.dirname(cssPath);
143
+ const compiler = await compile(css, {
144
+ base,
145
+ loadStylesheet: (id, fromBase) => this.#loadStylesheet(id, fromBase),
146
+ loadModule: (id, fromBase) => this.#loadModule(id, fromBase),
147
+ });
148
+ return { cssPath, compiler };
149
+ }),
150
+ );
151
+
152
+ const sourceDirs = new Set<string>();
153
+ for (const entry of compilers) {
154
+ if (!entry) continue;
155
+ for (const s of entry.compiler.sources as { base: string }[]) sourceDirs.add(s.base);
156
+ }
157
+ const scanStarted = Date.now();
158
+ const candidates = await this.#scanCandidates(sourcePaths, [...sourceDirs]);
159
+ this.#logger.verbose(
160
+ `css candidates scanned count=${candidates.length} sources=${sourcePaths.length} dirs=${sourceDirs.size} in ${Date.now() - scanStarted}ms`,
161
+ );
162
+ const parts: string[] = [];
163
+ for (const entry of compilers) {
164
+ if (!entry) continue;
165
+ parts.push(entry.compiler.build(candidates));
166
+ }
167
+ this.#logger.verbose(
168
+ `css compiled paths=${cssPaths.length} candidates=${candidates.length} in ${Date.now() - compileStarted}ms`,
169
+ );
170
+ return parts.join("\n");
171
+ }
172
+
173
+ async #loadStylesheet(id: string, fromBase: string) {
174
+ const p = await this.#resolveCssImport(id, fromBase);
175
+ const content = await Bun.file(p).text();
176
+ return { path: p, base: path.dirname(p), content };
177
+ }
178
+
179
+ async #resolveCssImport(id: string, fromBase: string): Promise<string> {
180
+ if (id.startsWith(".") || id.startsWith("/")) return path.resolve(fromBase, id);
181
+ const resolver = await this.#getCssImportResolver();
182
+ const resolved = await resolver.resolve(id, fromBase);
183
+ if (resolved) return resolved;
184
+ throw new Error(`[css] failed to resolve stylesheet import "${id}" from ${fromBase}`);
185
+ }
186
+
187
+ async #getCssImportResolver() {
188
+ if (this.#cssImportResolver) return this.#cssImportResolver;
189
+ this.#cssImportResolver = await CssImportResolver.create(this.#app);
190
+ return this.#cssImportResolver;
191
+ }
192
+ async #loadModule(id: string, fromBase: string) {
193
+ const p = require.resolve(id, { paths: [fromBase] });
194
+ const mod = await import(p);
195
+ return { path: p, base: path.dirname(p), module: mod.default ?? mod };
196
+ }
197
+ async #resolveSourceImport(
198
+ id: string,
199
+ fromBase: string,
200
+ resolvePackage: Awaited<ReturnType<typeof createTsconfigPackageResolver>>,
201
+ ): Promise<string | null> {
202
+ if (id.startsWith(".") || id.startsWith("/")) {
203
+ const abs = id.startsWith("/") ? id : path.resolve(fromBase, id);
204
+ return resolveSourceFileCandidate(abs);
205
+ }
206
+
207
+ const pkg = await resolvePackage(id);
208
+ if (pkg) return pkg.entryFile;
209
+
210
+ for (const resolve of [() => resolveSourceWithBun(id, fromBase), () => resolveSourceWithRequire(id, fromBase)]) {
211
+ const resolved = await resolve();
212
+ if (resolved) return resolved;
213
+ }
214
+ return null;
215
+ }
216
+ async #scanCandidates(sourcePaths: string[], dirs: string[]): Promise<string[]> {
217
+ const CANDIDATE_RE = /-?[\w@][\w:/.-]*(?:\[[^\]]+\][\w:/.-]*)*/g;
218
+ const candidates = new Set<string>();
219
+ const glob = new Bun.Glob("**/*.{tsx,ts,jsx,js,html}");
220
+ const files = new Set<string>(sourcePaths);
221
+ await Promise.all(
222
+ dirs.map(async (dir) => {
223
+ for await (const file of glob.scan({ cwd: dir, absolute: true })) {
224
+ if (file.includes("node_modules")) continue;
225
+ files.add(file);
226
+ }
227
+ }),
228
+ );
229
+ await Promise.all(
230
+ [...files].map(async (file) => {
231
+ const content = await Bun.file(file).text();
232
+ for (const m of content.matchAll(CANDIDATE_RE)) candidates.add(m[0]);
233
+ }),
234
+ );
235
+ return [...candidates];
236
+ }
237
+ }
238
+
239
+ async function resolveSourceFileCandidate(absPathNoExt: string): Promise<string | null> {
240
+ if (await Bun.file(absPathNoExt).exists()) return isSourceFile(absPathNoExt) ? absPathNoExt : null;
241
+ for (const ext of SOURCE_EXTS) {
242
+ const filePath = `${absPathNoExt}${ext}`;
243
+ if (await Bun.file(filePath).exists()) return filePath;
244
+ }
245
+ for (const ext of SOURCE_EXTS) {
246
+ const filePath = path.join(absPathNoExt, `index${ext}`);
247
+ if (await Bun.file(filePath).exists()) return filePath;
248
+ }
249
+ return null;
250
+ }
251
+
252
+ function resolveSourceWithBun(id: string, fromBase: string): string | null {
253
+ try {
254
+ const resolved = Bun.resolveSync(id, fromBase);
255
+ return isSourceFile(resolved) ? resolved : null;
256
+ } catch {
257
+ return null;
258
+ }
259
+ }
260
+
261
+ function resolveSourceWithRequire(id: string, fromBase: string): string | null {
262
+ try {
263
+ const resolved = require.resolve(id, { paths: [fromBase] });
264
+ return isSourceFile(resolved) ? resolved : null;
265
+ } catch {
266
+ return null;
267
+ }
268
+ }
269
+
270
+ function isSourceFile(filePath: string) {
271
+ return SOURCE_EXTS.includes(path.extname(filePath) as (typeof SOURCE_EXTS)[number]);
272
+ }
273
+
274
+ function getPageKeyBasePath(pageKey: string, basePaths: string[]): string | null {
275
+ const normalized = pageKey.split(path.sep).join("/").replace(/^\.\//, "");
276
+ const segments = normalized.split("/");
277
+ const firstPublicSegment = segments.find((segment) => segment !== "[lang]" && !/^\(.+\)$/.test(segment));
278
+ return firstPublicSegment && basePaths.includes(firstPublicSegment) ? firstPublicSegment : null;
279
+ }
package/devkit/frontendBuild/cssImportResolver.ts ADDED
@@ -0,0 +1,116 @@
1
+ import path from "node:path";
2
+ import type { App } from "../commandDecorators";
3
+
4
+ const CSS_IMPORT_EXTS = ["", ".css", "/styles.css", "/index.css"] as const;
5
+
6
+ export class CssImportResolver {
7
+ #workspaceRoot: string;
8
+ #paths: Record<string, string[]>;
9
+ #wildcardEntries: { prefix: string; replacements: string[] }[];
10
+
11
+ constructor(workspaceRoot: string, paths: Record<string, string[]> = {}) {
12
+ this.#workspaceRoot = workspaceRoot;
13
+ this.#paths = paths;
14
+ this.#wildcardEntries = Object.entries(paths)
15
+ .filter(([key]) => key.endsWith("/*"))
16
+ .map(([key, replacements]) => ({ prefix: key.slice(0, -1), replacements }))
17
+ .sort((a, b) => b.prefix.length - a.prefix.length);
18
+ }
19
+
20
+ static async create(app: App): Promise<CssImportResolver> {
21
+ const tsconfig = await app.getTsConfig();
22
+ return new CssImportResolver(app.workspace.workspaceRoot, tsconfig.compilerOptions.paths ?? {});
23
+ }
24
+
25
+ async resolve(id: string, fromBase: string): Promise<string | null> {
26
+ for (const resolve of [
27
+ () => this.#resolveWithBun(id, fromBase),
28
+ () => this.#resolveWithRequire(id, fromBase),
29
+ () => this.#resolveWithTsconfig(id),
30
+ () => this.#resolvePackageStyle(id, fromBase),
31
+ ]) {
32
+ const resolved = await resolve();
33
+ if (resolved) return resolved;
34
+ }
35
+ return null;
36
+ }
37
+
38
+ #resolveWithBun(id: string, fromBase: string): string | null {
39
+ try {
40
+ const resolved = Bun.resolveSync(id, fromBase);
41
+ return CssImportResolver.isCssFile(resolved) ? resolved : null;
42
+ } catch {
43
+ return null;
44
+ }
45
+ }
46
+
47
+ #resolveWithRequire(id: string, fromBase: string): string | null {
48
+ try {
49
+ const resolved = require.resolve(id, { paths: [fromBase] });
50
+ return CssImportResolver.isCssFile(resolved) ? resolved : null;
51
+ } catch {
52
+ return null;
53
+ }
54
+ }
55
+
56
+ async #resolveWithTsconfig(id: string): Promise<string | null> {
57
+ const exact = this.#paths[id];
58
+ if (exact) {
59
+ for (const repl of exact) {
60
+ const resolved = await this.#firstExisting(path.resolve(this.#workspaceRoot, repl));
61
+ if (resolved) return resolved;
62
+ }
63
+ }
64
+
65
+ for (const { prefix, replacements } of this.#wildcardEntries) {
66
+ if (!id.startsWith(prefix)) continue;
67
+ const suffix = id.slice(prefix.length);
68
+ for (const repl of replacements) {
69
+ const replPath = repl.endsWith("/*") ? repl.slice(0, -1) : repl;
70
+ const resolved = await this.#firstExisting(path.resolve(this.#workspaceRoot, replPath + suffix));
71
+ if (resolved) return resolved;
72
+ }
73
+ }
74
+ return null;
75
+ }
76
+
77
+ async #resolvePackageStyle(id: string, fromBase: string): Promise<string | null> {
78
+ const pkgName = CssImportResolver.getPackageName(id);
79
+ if (!pkgName) return null;
80
+ try {
81
+ const pkgPath = require.resolve(`${pkgName}/package.json`, { paths: [fromBase] });
82
+ const pkgDir = path.dirname(pkgPath);
83
+ const pkg = await Bun.file(pkgPath).json();
84
+ const subpath = id === pkgName ? "." : `.${id.slice(pkgName.length)}`;
85
+ const exportValue = pkg.exports?.[subpath];
86
+ const styleEntry =
87
+ (typeof exportValue === "string"
88
+ ? exportValue
89
+ : exportValue?.style || exportValue?.import || exportValue?.default) ||
90
+ pkg.exports?.["."]?.style ||
91
+ pkg.style ||
92
+ "index.css";
93
+ return await this.#firstExisting(path.resolve(pkgDir, styleEntry));
94
+ } catch {
95
+ return null;
96
+ }
97
+ }
98
+
99
+ async #firstExisting(basePath: string): Promise<string | null> {
100
+ for (const suffix of CSS_IMPORT_EXTS) {
101
+ const candidate = `${basePath}${suffix}`;
102
+ if (await Bun.file(candidate).exists()) return candidate;
103
+ }
104
+ return null;
105
+ }
106
+
107
+ static getPackageName(id: string): string | null {
108
+ const parts = id.split("/");
109
+ if (id.startsWith("@")) return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : null;
110
+ return parts[0] ?? null;
111
+ }
112
+
113
+ static isCssFile(filePath: string): boolean {
114
+ return path.extname(filePath) === ".css";
115
+ }
116
+ }