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
@@ -0,0 +1,149 @@
1
+ "use client";
2
+
3
+ import { clsx } from "akanjs/client";
4
+ import { useEffect, useId, useRef, useState } from "react";
5
+
6
+ interface MermaidProps {
7
+ chart: string;
8
+ title?: string;
9
+ className?: string;
10
+ highlightNodes?: string[];
11
+ onSelectNode?: (nodeId: string) => void;
12
+ }
13
+
14
+ const lightThemeFallback = {
15
+ base100: "#ffffff",
16
+ base200: "#f5f5f5",
17
+ base300: "#d4d4d4",
18
+ baseContent: "#1f2937",
19
+ primary: "#3b82f6",
20
+ };
21
+
22
+ const darkThemeFallback = {
23
+ base100: "#1f2937",
24
+ base200: "#111827",
25
+ base300: "#374151",
26
+ baseContent: "#f9fafb",
27
+ primary: "#60a5fa",
28
+ };
29
+
30
+ export const Mermaid = ({ chart, title, className, highlightNodes = [], onSelectNode }: MermaidProps) => {
31
+ const reactId = useId();
32
+ const containerRef = useRef<HTMLDivElement>(null);
33
+ const [error, setError] = useState<string | null>(null);
34
+
35
+ useEffect(() => {
36
+ let cancelled = false;
37
+ const render = async () => {
38
+ try {
39
+ const { default: mermaid } = await import("mermaid");
40
+ const colors = getThemeColors();
41
+ mermaid.initialize({
42
+ startOnLoad: false,
43
+ securityLevel: "strict",
44
+ theme: "base",
45
+ themeVariables: {
46
+ background: colors.base100,
47
+ mainBkg: colors.base100,
48
+ primaryColor: colors.base100,
49
+ primaryTextColor: colors.baseContent,
50
+ primaryBorderColor: colors.baseContent,
51
+ lineColor: colors.baseContent,
52
+ secondaryColor: colors.base200,
53
+ tertiaryColor: colors.base300,
54
+ },
55
+ });
56
+ const id = `mermaid-${reactId.replace(/[^a-zA-Z0-9_-]/g, "")}`;
57
+ const result = await mermaid.render(id, chart.trim());
58
+ if (cancelled) return;
59
+ const parsed = new DOMParser().parseFromString(result.svg, "text/html");
60
+ const svg = parsed.querySelector("svg");
61
+ if (!svg) throw new Error("Mermaid did not return an SVG.");
62
+ applyHighlights(svg, highlightNodes, colors.primary);
63
+ applyNodeSelection(svg, onSelectNode);
64
+ const container = containerRef.current;
65
+ if (container) container.replaceChildren(document.importNode(svg, true));
66
+ setError(null);
67
+ } catch (err) {
68
+ if (cancelled) return;
69
+ containerRef.current?.replaceChildren();
70
+ setError(err instanceof Error ? err.message : String(err));
71
+ }
72
+ };
73
+ void render();
74
+ const observer = new MutationObserver(() => void render());
75
+ observer.observe(document.documentElement, { attributes: true, attributeFilter: ["class", "data-theme", "style"] });
76
+ return () => {
77
+ cancelled = true;
78
+ observer.disconnect();
79
+ };
80
+ }, [chart, highlightNodes, onSelectNode, reactId]);
81
+
82
+ return (
83
+ <div className={clsx("my-4 overflow-hidden rounded-xl border border-base-300 bg-base-200/40", className)}>
84
+ {title ? (
85
+ <div className="border-base-300 border-b px-4 py-2 font-bold text-base-content/70 text-sm">{title}</div>
86
+ ) : null}
87
+ <div className="overflow-x-auto p-4">
88
+ {error ? (
89
+ <pre className="whitespace-pre-wrap text-error text-sm">{error}</pre>
90
+ ) : (
91
+ <div ref={containerRef} className="min-w-fit text-base-content" />
92
+ )}
93
+ </div>
94
+ </div>
95
+ );
96
+ };
97
+
98
+ function getThemeColors() {
99
+ const root = document.documentElement;
100
+ const style = getComputedStyle(root);
101
+ const fallback = isDarkTheme(root) ? darkThemeFallback : lightThemeFallback;
102
+
103
+ return {
104
+ base100: getMermaidColor(style, "--color-base-100", fallback.base100),
105
+ base200: getMermaidColor(style, "--color-base-200", fallback.base200),
106
+ base300: getMermaidColor(style, "--color-base-300", fallback.base300),
107
+ baseContent: getMermaidColor(style, "--color-base-content", fallback.baseContent),
108
+ primary: getMermaidColor(style, "--color-primary", fallback.primary),
109
+ };
110
+ }
111
+
112
+ function getMermaidColor(style: CSSStyleDeclaration, token: string, fallback: string): string {
113
+ const color = style.getPropertyValue(token).trim();
114
+ if (!color) return fallback;
115
+ return isMermaidColor(color) ? color : fallback;
116
+ }
117
+
118
+ function isMermaidColor(color: string): boolean {
119
+ return /^(#[\da-f]{3,8}|rgba?\(|hsla?\(|[a-z]+$)/i.test(color);
120
+ }
121
+
122
+ function isDarkTheme(root: HTMLElement): boolean {
123
+ return root.dataset.theme === "dark" || root.classList.contains("dark");
124
+ }
125
+
126
+ function applyHighlights(svg: Element, nodeIds: string[], color: string): void {
127
+ if (nodeIds.length === 0) return;
128
+ const ids = new Set(nodeIds);
129
+ for (const node of svg.querySelectorAll<SVGGElement>(".node")) {
130
+ const id = getMermaidNodeId(node);
131
+ if (!ids.has(id)) continue;
132
+ node.querySelectorAll<SVGElement>("rect, circle, ellipse, polygon, path").forEach((shape) => {
133
+ shape.setAttribute("stroke", color);
134
+ shape.setAttribute("stroke-width", "3px");
135
+ });
136
+ }
137
+ }
138
+
139
+ function applyNodeSelection(svg: Element, onSelectNode?: (nodeId: string) => void): void {
140
+ if (!onSelectNode) return;
141
+ for (const node of svg.querySelectorAll<SVGGElement>(".node")) {
142
+ node.style.cursor = "pointer";
143
+ node.addEventListener("click", () => onSelectNode(getMermaidNodeId(node)));
144
+ }
145
+ }
146
+
147
+ function getMermaidNodeId(node: SVGGElement): string {
148
+ return node.id.replace(/^flowchart-/, "").replace(/-\d+$/, "");
149
+ }
@@ -0,0 +1,6 @@
1
+ import Doc from "./Doc";
2
+ import { Mermaid } from "./Mermaid";
3
+
4
+ export * from "./schemaDoc";
5
+
6
+ export const Constant = { Doc, Mermaid };
@@ -0,0 +1,324 @@
1
+ import {
2
+ type Cls,
3
+ type EnumInstance,
4
+ FIELD_META,
5
+ getNonArrayModel,
6
+ PrimitiveRegistry,
7
+ type PrimitiveScalar,
8
+ } from "akanjs/base";
9
+ import { capitalize } from "akanjs/common";
10
+ import { type ConstantCls, type ConstantField, type ConstantModel, ConstantRegistry } from "akanjs/constant";
11
+
12
+ export const databaseModelVariants = ["input", "object", "full", "light", "insight"] as const;
13
+ export type DatabaseModelVariant = (typeof databaseModelVariants)[number];
14
+
15
+ export interface ConstantSchemaOptions {
16
+ models?: string[];
17
+ scalars?: string[];
18
+ enums?: string[];
19
+ }
20
+
21
+ export interface ConstantSchemaDoc {
22
+ databases: DatabaseSchema[];
23
+ scalars: ScalarSchema[];
24
+ enums: EnumSchema[];
25
+ relations: RelationSchema[];
26
+ }
27
+
28
+ export interface DatabaseSchema {
29
+ kind: "database";
30
+ refName: string;
31
+ modelName: string;
32
+ variants: Record<DatabaseModelVariant, ModelVariantSchema>;
33
+ }
34
+
35
+ export interface ScalarSchema {
36
+ kind: "scalar";
37
+ refName: string;
38
+ modelName: string;
39
+ modelRef: ConstantCls;
40
+ fields: FieldSchema[];
41
+ }
42
+
43
+ export interface ModelVariantSchema {
44
+ refName: string;
45
+ variant: DatabaseModelVariant | "scalar";
46
+ modelName: string;
47
+ modelRef: ConstantCls;
48
+ fields: FieldSchema[];
49
+ }
50
+
51
+ export interface EnumSchema {
52
+ key: string;
53
+ refName: string;
54
+ typeName: string;
55
+ values: (string | number)[];
56
+ enumRef: EnumInstance;
57
+ usedBy: EnumUsage[];
58
+ }
59
+
60
+ export interface EnumUsage {
61
+ refName: string;
62
+ variant: DatabaseModelVariant | "scalar";
63
+ fieldKey: string;
64
+ }
65
+
66
+ export interface RelationSchema {
67
+ sourceRefName: string;
68
+ sourceVariant: DatabaseModelVariant | "scalar";
69
+ targetRefName: string;
70
+ targetKind: "database" | "scalar";
71
+ fieldKey: string;
72
+ relationType: string;
73
+ external: boolean;
74
+ }
75
+
76
+ export interface FieldSchema {
77
+ key: string;
78
+ typeLabel: string;
79
+ typeRefName?: string;
80
+ typeKind: "primitive" | "database" | "scalar" | "map" | "unknown";
81
+ required: boolean;
82
+ nullable: boolean;
83
+ arrDepth: number;
84
+ fieldType: "property" | "hidden" | "resolve";
85
+ select: boolean;
86
+ immutable: boolean;
87
+ ref?: string;
88
+ refPath?: string;
89
+ refType?: "child" | "parent" | "relation";
90
+ relationLabel?: string;
91
+ enumRefName?: string;
92
+ enumValues?: (string | number)[];
93
+ defaultLabel?: string;
94
+ exampleLabel?: string;
95
+ constraints: string[];
96
+ text?: "search" | "filter";
97
+ meta: Record<string, unknown>;
98
+ raw: ConstantField;
99
+ }
100
+
101
+ export const getConstantSchemaDoc = (options: ConstantSchemaOptions = {}): ConstantSchemaDoc => {
102
+ const databases = getSelectedEntries(ConstantRegistry.database, options.models).map(([refName, model]) =>
103
+ buildDatabaseSchema(refName, model),
104
+ );
105
+ const scalars = getSelectedEntries(ConstantRegistry.scalar, options.scalars).map(([refName, scalar]) => {
106
+ const modelRef = scalar.model;
107
+ return {
108
+ kind: "scalar" as const,
109
+ refName,
110
+ modelName: getModelName(modelRef, refName),
111
+ modelRef,
112
+ fields: getFields(modelRef, "scalar"),
113
+ };
114
+ });
115
+ const selectedEnums = getSelectedEntries(ConstantRegistry.enum, options.enums);
116
+ const enumUsages = collectEnumUsages(databases, scalars);
117
+ const enums = selectedEnums.map(([key, enumRef]) => ({
118
+ key,
119
+ refName: enumRef.refName,
120
+ typeName: PrimitiveRegistry.getName(enumRef.type as typeof PrimitiveScalar),
121
+ values: [...enumRef.values] as (string | number)[],
122
+ enumRef,
123
+ usedBy: enumUsages.get(enumRef) ?? [],
124
+ }));
125
+ const relations = collectRelations(databases, scalars);
126
+ return { databases, scalars, enums, relations };
127
+ };
128
+
129
+ export const getDefaultVariant = (database: DatabaseSchema): ModelVariantSchema => database.variants.full;
130
+
131
+ export const getVariantTitle = (variant: DatabaseModelVariant | "scalar") => {
132
+ if (variant === "scalar") return "Scalar";
133
+ return capitalize(variant);
134
+ };
135
+
136
+ const buildDatabaseSchema = (refName: string, model: ConstantModel): DatabaseSchema => {
137
+ const variants = Object.fromEntries(
138
+ databaseModelVariants.map((variant) => {
139
+ const modelRef = model[variant];
140
+ return [
141
+ variant,
142
+ {
143
+ refName,
144
+ variant,
145
+ modelName: ConstantRegistry.getModelName(modelRef),
146
+ modelRef,
147
+ fields: getFields(modelRef, variant),
148
+ },
149
+ ];
150
+ }),
151
+ ) as Record<DatabaseModelVariant, ModelVariantSchema>;
152
+ return { kind: "database", refName, modelName: ConstantRegistry.getModelName(model.full), variants };
153
+ };
154
+
155
+ const getFields = (modelRef: ConstantCls, variant: DatabaseModelVariant | "scalar"): FieldSchema[] =>
156
+ Object.entries(modelRef[FIELD_META]).map(([key, field]) => buildFieldSchema(key, field, variant));
157
+
158
+ const buildFieldSchema = (
159
+ key: string,
160
+ field: ConstantField,
161
+ _variant: DatabaseModelVariant | "scalar",
162
+ ): FieldSchema => {
163
+ const props = field.getProps();
164
+ const typeInfo = getTypeInfo(props.modelRef, props.arrDepth, props.isMap, props.of as Cls | Cls[] | undefined);
165
+ const enumValues = props.enum ? ([...props.enum.values] as (string | number)[]) : undefined;
166
+ const relationLabel = props.refType ?? (typeInfo.typeKind === "database" ? "reference" : undefined);
167
+ return {
168
+ key,
169
+ typeLabel: typeInfo.typeLabel,
170
+ typeRefName: typeInfo.typeRefName,
171
+ typeKind: typeInfo.typeKind,
172
+ required: !props.nullable,
173
+ nullable: props.nullable,
174
+ arrDepth: props.arrDepth,
175
+ fieldType: props.fieldType,
176
+ select: props.select,
177
+ immutable: props.immutable,
178
+ ref: props.ref,
179
+ refPath: props.refPath,
180
+ refType: props.refType,
181
+ relationLabel,
182
+ enumRefName: props.enum?.refName,
183
+ enumValues,
184
+ defaultLabel: stringifyMetaValue(props.default),
185
+ exampleLabel: stringifyMetaValue(props.example),
186
+ constraints: getConstraints(props),
187
+ text: props.text,
188
+ meta: props.meta as Record<string, unknown>,
189
+ raw: field,
190
+ };
191
+ };
192
+
193
+ const getTypeInfo = (
194
+ modelRef: Cls,
195
+ arrDepth: number,
196
+ isMap: boolean,
197
+ of?: Cls | Cls[],
198
+ ): Pick<FieldSchema, "typeKind" | "typeLabel" | "typeRefName"> => {
199
+ if (isMap) {
200
+ const mapValue = of ? getNestedTypeInfo(of) : { label: "Unknown", refName: undefined };
201
+ return { typeKind: "map", typeLabel: `Map<String, ${mapValue.label}>`, typeRefName: mapValue.refName };
202
+ }
203
+ const refName = ConstantRegistry.getRefName(modelRef, { allowEmpty: true });
204
+ if (PrimitiveRegistry.has(modelRef)) {
205
+ return {
206
+ typeKind: "primitive",
207
+ typeLabel: formatArrayType(PrimitiveRegistry.getName(modelRef as typeof PrimitiveScalar), arrDepth),
208
+ };
209
+ }
210
+ if (refName && ConstantRegistry.database.has(refName)) {
211
+ return {
212
+ typeKind: "database",
213
+ typeLabel: formatArrayType(ConstantRegistry.getModelName(modelRef), arrDepth),
214
+ typeRefName: refName,
215
+ };
216
+ }
217
+ if (refName && ConstantRegistry.scalar.has(refName)) {
218
+ return {
219
+ typeKind: "scalar",
220
+ typeLabel: formatArrayType(getModelName(modelRef, refName), arrDepth),
221
+ typeRefName: refName,
222
+ };
223
+ }
224
+ return { typeKind: "unknown", typeLabel: formatArrayType("Unknown", arrDepth), typeRefName: refName };
225
+ };
226
+
227
+ const getModelName = (modelRef: Cls, refName: string) => {
228
+ if ((modelRef as ConstantCls).modelType) return ConstantRegistry.getModelName(modelRef);
229
+ return capitalize(refName);
230
+ };
231
+
232
+ const getNestedTypeInfo = (model: Cls | Cls[]) => {
233
+ const [modelRef, arrDepth] = getNonArrayModel(model as Cls);
234
+ const info = getTypeInfo(modelRef as Cls, arrDepth, modelRef === Map);
235
+ return { label: info.typeLabel, refName: info.typeRefName };
236
+ };
237
+
238
+ const formatArrayType = (name: string, arrDepth: number) => `${"[".repeat(arrDepth)}${name}${"]".repeat(arrDepth)}`;
239
+
240
+ const stringifyMetaValue = (value: unknown): string | undefined => {
241
+ if (value === undefined) return undefined;
242
+ if (typeof value === "function") return "[function]";
243
+ if (typeof value === "string") return value;
244
+ try {
245
+ return JSON.stringify(value);
246
+ } catch {
247
+ return String(value);
248
+ }
249
+ };
250
+
251
+ const getConstraints = (props: ReturnType<ConstantField["getProps"]>) =>
252
+ [
253
+ props.min !== undefined ? `min ${props.min}` : null,
254
+ props.max !== undefined ? `max ${props.max}` : null,
255
+ props.minlength !== undefined ? `minlength ${props.minlength}` : null,
256
+ props.maxlength !== undefined ? `maxlength ${props.maxlength}` : null,
257
+ props.text ? `text:${props.text}` : null,
258
+ props.validate ? "custom validate" : null,
259
+ props.accumulate ? "accumulate" : null,
260
+ ].filter((constraint): constraint is string => !!constraint);
261
+
262
+ const getSelectedEntries = <Value>(map: Map<string, Value>, selected?: string[]): [string, Value][] => {
263
+ if (!selected?.length) return [...map.entries()].sort(([a], [b]) => a.localeCompare(b));
264
+ return selected.flatMap((key) => {
265
+ const value = map.get(key);
266
+ return value ? ([[key, value]] as [string, Value][]) : [];
267
+ });
268
+ };
269
+
270
+ const collectEnumUsages = (databases: DatabaseSchema[], scalars: ScalarSchema[]) => {
271
+ const usages = new Map<EnumInstance, EnumUsage[]>();
272
+ const addUsage = (field: FieldSchema, usage: EnumUsage) => {
273
+ const enumRef = field.raw.enum;
274
+ if (!enumRef) return;
275
+ usages.set(enumRef, [...(usages.get(enumRef) ?? []), usage]);
276
+ };
277
+ databases.forEach((database) => {
278
+ Object.values(database.variants).forEach((variant) => {
279
+ variant.fields.forEach((field) => {
280
+ addUsage(field, { refName: database.refName, variant: variant.variant, fieldKey: field.key });
281
+ });
282
+ });
283
+ });
284
+ scalars.forEach((scalar) => {
285
+ scalar.fields.forEach((field) => {
286
+ addUsage(field, { refName: scalar.refName, variant: "scalar", fieldKey: field.key });
287
+ });
288
+ });
289
+ return usages;
290
+ };
291
+
292
+ const collectRelations = (databases: DatabaseSchema[], scalars: ScalarSchema[]): RelationSchema[] => {
293
+ const selectedDatabases = new Set(databases.map((database) => database.refName));
294
+ const selectedScalars = new Set(scalars.map((scalar) => scalar.refName));
295
+ const relations: RelationSchema[] = [];
296
+ const addRelations = (refName: string, variant: DatabaseModelVariant | "scalar", fields: FieldSchema[]) => {
297
+ fields.forEach((field) => {
298
+ if (
299
+ !field.typeRefName ||
300
+ (field.typeKind !== "database" && field.typeKind !== "scalar" && field.typeKind !== "map")
301
+ )
302
+ return;
303
+ const targetKind = ConstantRegistry.database.has(field.typeRefName) ? "database" : "scalar";
304
+ const selected =
305
+ targetKind === "database" ? selectedDatabases.has(field.typeRefName) : selectedScalars.has(field.typeRefName);
306
+ relations.push({
307
+ sourceRefName: refName,
308
+ sourceVariant: variant,
309
+ targetRefName: field.typeRefName,
310
+ targetKind,
311
+ fieldKey: field.key,
312
+ relationType: field.relationLabel ?? field.typeKind,
313
+ external: !selected,
314
+ });
315
+ });
316
+ };
317
+ databases.forEach((database) => {
318
+ addRelations(database.refName, "full", database.variants.full.fields);
319
+ });
320
+ scalars.forEach((scalar) => {
321
+ addRelations(scalar.refName, "scalar", scalar.fields);
322
+ });
323
+ return relations;
324
+ };
package/ui/Copy.tsx ADDED
@@ -0,0 +1,27 @@
1
+ "use client";
2
+ import { usePage } from "akanjs/client";
3
+ import { st } from "akanjs/store";
4
+ import type { ReactNode } from "react";
5
+ import { CopyToClipboard } from "react-copy-to-clipboard";
6
+
7
+ export interface CopyProps {
8
+ /** Text copied to the clipboard. Defaults to an empty string. */
9
+ text?: string;
10
+ /** Success message shown through the global store message helper. */
11
+ copyMessage?: string;
12
+ /** Copy trigger element. */
13
+ children: ReactNode;
14
+ }
15
+ export const Copy = ({ text, copyMessage, children }: CopyProps) => {
16
+ const { l } = usePage();
17
+ return (
18
+ <CopyToClipboard
19
+ text={text ?? ""}
20
+ onCopy={() => {
21
+ st.do.showMessage({ content: copyMessage ?? l.trans({ en: "Copied", ko: "복사되었습니다" }), type: "success" });
22
+ }}
23
+ >
24
+ {children}
25
+ </CopyToClipboard>
26
+ );
27
+ };
@@ -0,0 +1,38 @@
1
+ "use client";
2
+ import type { ProtoFile } from "akanjs/constant";
3
+ import type { ImgHTMLAttributes } from "react";
4
+
5
+ type CsrImageProps = Omit<ImgHTMLAttributes<HTMLImageElement>, "alt" | "src"> & {
6
+ src?: string;
7
+ file?: ProtoFile | { url: string; imageSize: [number, number]; abstractData?: string | null } | null;
8
+ abstractData?: string;
9
+ priority?: boolean;
10
+ preload?: boolean;
11
+ quality?: number;
12
+ unoptimized?: boolean;
13
+ fill?: boolean;
14
+ };
15
+
16
+ export const CsrImage = ({ src, file, className, abstractData, ...props }: CsrImageProps) => {
17
+ const url = src ?? file?.url ?? "/empty.png";
18
+ const [width, height] = [props.width ?? file?.imageSize[0], props.height ?? file?.imageSize[1]];
19
+ const defaultAbstractData =
20
+ "data:image/gif;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAAFklEQVR42mN8//HLfwYiAOOoQvoqBABbWyZJf74GZgAAAABJRU5ErkJggg==";
21
+
22
+ const blurDataURL = abstractData ?? file?.abstractData ?? defaultAbstractData;
23
+
24
+ const { priority, preload, quality, unoptimized, fill, ...csrProps } = props;
25
+ return (
26
+ <img
27
+ src={url}
28
+ data-src={blurDataURL}
29
+ width={width}
30
+ height={height}
31
+
32
+ className={className}
33
+ alt="image"
34
+
35
+ {...csrProps}
36
+ />
37
+ );
38
+ };
@@ -0,0 +1,141 @@
1
+ "use client";
2
+ import type { DataList } from "akanjs/base";
3
+ import { clsx, type DataAction, type DataColumn } from "akanjs/client";
4
+ import { capitalize } from "akanjs/common";
5
+ import type { FilterInstance } from "akanjs/document";
6
+ import type { FetchInitForm, SliceMeta } from "akanjs/fetch";
7
+ import { st } from "akanjs/store";
8
+ import { type ReactNode, useEffect } from "react";
9
+ import { Loading } from "../Loading";
10
+ import { Model } from "../Model";
11
+ import DataItem from "./Item";
12
+ import DataPagination from "./Pagination";
13
+
14
+ type DataItemProps<T extends string, M extends { id: string }, L extends { id: string }> = {
15
+ [key in T]: L;
16
+ } & { slice: SliceMeta };
17
+
18
+ interface CardListProps<
19
+ T extends string,
20
+ Input,
21
+ Full extends { id: string },
22
+ Light extends { id: string },
23
+ Filter extends FilterInstance,
24
+ > {
25
+ className?: string;
26
+ cardListClassName?: string;
27
+ init?: FetchInitForm<Input, Filter>;
28
+ slice: SliceMeta;
29
+ columns: DataColumn<any>[];
30
+ actions?: DataAction[] | ((item: Light, idx: number) => DataAction[]);
31
+ renderItem: (args: DataItemProps<T, Full, Light>) => ReactNode;
32
+ renderLoading?: () => ReactNode;
33
+ renderTemplate?: (props: any) => ReactNode | null;
34
+ renderView?: (model: Full) => ReactNode | null;
35
+ renderTitle?: (model: Full) => string | ReactNode;
36
+ }
37
+ export default function CardList<
38
+ T extends string,
39
+ Input,
40
+ Full extends { id: string },
41
+ Light extends { id: string },
42
+ Filter extends FilterInstance,
43
+ >({
44
+ className,
45
+ cardListClassName = "",
46
+ init,
47
+ slice,
48
+ actions,
49
+ columns,
50
+ renderItem,
51
+ renderLoading,
52
+ renderTemplate,
53
+ renderView,
54
+ renderTitle,
55
+ }: CardListProps<T, Input, Full, Light, Filter>) {
56
+ const storeUse = st.use as { [key: string]: () => unknown };
57
+ const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => Promise<void> };
58
+ const storeGet = st.get as unknown as <T>() => { [key: string]: T };
59
+ const { refName, sliceName } = slice;
60
+ const [modelName, modelClassName] = [refName, capitalize(refName)];
61
+ const names = {
62
+ model: modelName,
63
+ modelId: `${modelName}Id`,
64
+ modelList: `${modelName}List`,
65
+ modelListLoading: `${modelName}ListLoading`,
66
+ limitOfModel: `limitOf${modelClassName}`,
67
+ initModel: `init${modelClassName}`,
68
+ };
69
+ const namesOfSlice = {
70
+ modelList: sliceName.replace(names.model, names.modelList),
71
+ modelListLoading: sliceName.replace(names.model, names.modelListLoading),
72
+ limitOfModel: sliceName.replace(names.model, names.limitOfModel),
73
+ initModel: sliceName.replace(names.model, names.initModel),
74
+ };
75
+ const modelList = storeUse[namesOfSlice.modelList]() as DataList<Light>;
76
+ const modelListLoading = storeUse[namesOfSlice.modelListLoading]() as string | boolean;
77
+ const limitOfModel = storeUse[namesOfSlice.limitOfModel]() as number;
78
+ const RenderItem: any = renderItem;
79
+ useEffect(() => {
80
+ if (init) void storeDo[namesOfSlice.initModel](init);
81
+ }, []);
82
+ const RenderTemplate = ({ id }: { id: string }) => {
83
+ const Edit = renderTemplate;
84
+ return Edit ? <Edit {...{ [names.modelId]: id }} /> : null;
85
+ };
86
+ return (
87
+ <div className={className}>
88
+ {modelListLoading ? (
89
+ <div className={clsx("grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4 xl:grid-cols-5", cardListClassName)}>
90
+ {new Array(limitOfModel || 20)
91
+ .fill(0)
92
+ .map((_, idx) => `skeleton-${idx}`)
93
+ .map((key) => (renderLoading ? renderLoading() : <Loading.Skeleton key={key} active />))}
94
+ </div>
95
+ ) : (
96
+ <div className={clsx("grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4 xl:grid-cols-5", cardListClassName)}>
97
+ {modelList.map((model, idx) => {
98
+ return (
99
+ <DataItem
100
+ key={model.id}
101
+ model={model}
102
+ slice={slice}
103
+ actions={typeof actions === "function" ? actions(model, idx) : actions}
104
+ columns={columns}
105
+ >
106
+ <RenderItem
107
+ {...({
108
+ [sliceName]: model,
109
+ slice,
110
+ actions: typeof actions === "function" ? actions(model, idx) : actions,
111
+ columns,
112
+ idx,
113
+ } as DataItemProps<T, Full, Light>)}
114
+ />
115
+ </DataItem>
116
+ );
117
+ })}
118
+ </div>
119
+ )}
120
+ <DataPagination slice={slice} />
121
+ {!modelListLoading
122
+ ? modelList.map((model) => (
123
+ <div key={model.id}>
124
+ <Model.EditModal key={model.id} id={model.id} slice={slice} renderTitle={renderTitle}>
125
+ <RenderTemplate id={model.id} />
126
+ </Model.EditModal>
127
+ {renderView ? (
128
+ <Model.ViewModal
129
+ key={`${model.id}-view`}
130
+ id={model.id}
131
+ slice={slice}
132
+ renderTitle={renderTitle}
133
+ renderView={renderView}
134
+ />
135
+ ) : null}
136
+ </div>
137
+ ))
138
+ : null}
139
+ </div>
140
+ );
141
+ }