@underpostnet/cyberia 3.3.0 → 3.3.76

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 (568) hide show
  1. package/.dockerignore +1 -0
  2. package/.env.example +17 -5
  3. package/.github/workflows/coverall.cyberia.ci.yml +39 -14
  4. package/.github/workflows/cyberia-client.cd.yml +5 -0
  5. package/.github/workflows/cyberia-server.cd.yml +5 -0
  6. package/.github/workflows/docker-image.cyberia-client.ci.yml +8 -5
  7. package/.github/workflows/docker-image.cyberia-client.dev.ci.yml +8 -3
  8. package/.github/workflows/docker-image.cyberia-server.ci.yml +8 -5
  9. package/.github/workflows/docker-image.cyberia-server.dev.ci.yml +8 -5
  10. package/.github/workflows/docker-image.engine-cyberia.ci.yml +15 -1
  11. package/.github/workflows/docker-image.engine-cyberia.dev.ci.yml +15 -1
  12. package/.github/workflows/engine-cyberia.cd.yml +3 -0
  13. package/.github/workflows/engine-cyberia.ci.yml +4 -5
  14. package/.github/workflows/ghpkg.ci.yml +35 -20
  15. package/.github/workflows/hardhat.ci.yml +12 -11
  16. package/.github/workflows/npmpkg.ci.yml +17 -15
  17. package/.github/workflows/publish.cyberia.ci.yml +44 -0
  18. package/.github/workflows/pwa-microservices-template-test.ci.yml +2 -2
  19. package/.github/workflows/release.cd.yml +1 -0
  20. package/.prettierignore +1 -0
  21. package/AGENTS.md +96 -0
  22. package/CHANGELOG.md +653 -2513
  23. package/CLI-HELP.md +323 -157
  24. package/Dockerfile +25 -9
  25. package/Dockerfile.dev +25 -9
  26. package/Dockerfile.test +5 -5
  27. package/README.md +48 -28
  28. package/bin/build.js +86 -41
  29. package/bin/build.template.js +8 -3
  30. package/bin/cyberia.js +1494 -1403
  31. package/bin/deploy.js +18 -104
  32. package/bin/index.js +1494 -1403
  33. package/compose.env +17 -5
  34. package/conf.js +98 -7
  35. package/deploy/cyberia-client/deploy.sh +46 -0
  36. package/deploy/cyberia-client/package.sh +17 -0
  37. package/deploy/cyberia-client/state.sh +15 -0
  38. package/deploy/cyberia-server/deploy.sh +46 -0
  39. package/deploy/cyberia-server/package.sh +17 -0
  40. package/deploy/cyberia-server/state.sh +15 -0
  41. package/deploy/dd-cyberia/deploy.sh +9 -29
  42. package/deploy/dd-cyberia/init.sh +38 -45
  43. package/deploy/dd-cyberia/package.sh +16 -0
  44. package/deploy/dd-cyberia/state.sh +14 -0
  45. package/deploy/dd-cyberia/sync-deploy.sh +133 -147
  46. package/deploy/lib/config.sh +29 -0
  47. package/deploy/lib/github-actions-logging.sh +610 -0
  48. package/deploy/lib/host.sh +194 -0
  49. package/deploy/lib/state.sh +65 -0
  50. package/deploy/pwa-microservices-template/deploy.sh +17 -42
  51. package/deploy/release/deploy.sh +9 -41
  52. package/deployment.yaml +7 -2
  53. package/docker-compose.yml +23 -17
  54. package/examples/static-page/README.md +19 -19
  55. package/examples/static-page/ssr-components/CustomPage.js +2 -2
  56. package/hardhat/hardhat.config.js +1 -6
  57. package/hardhat/package-lock.json +101 -40
  58. package/hardhat/package.json +2 -2
  59. package/manifests/alertmanager/deployment.yaml +81 -0
  60. package/manifests/blackbox-exporter/deployment.yaml +75 -0
  61. package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml +32 -7
  62. package/manifests/cronjobs/dd-cron/dd-cron-vultr.yaml +32 -7
  63. package/manifests/deployment/dd-cyberia-development/deployment.yaml +7 -2
  64. package/manifests/deployment/dd-default-development/deployment.yaml +2 -2
  65. package/manifests/deployment/mongo-express/deployment.yaml +46 -27
  66. package/manifests/deployment/mongo-express/kustomization.yaml +9 -0
  67. package/manifests/deployment/mongo-express/mongo-express-nodeport.yaml +18 -0
  68. package/manifests/deployment/mongo-express/service.yaml +16 -0
  69. package/manifests/deployment/mongo-express-no-auth/disable-mongodb-auth.yaml +16 -0
  70. package/manifests/deployment/mongo-express-no-auth/kustomization.yaml +16 -0
  71. package/manifests/grafana/deployment.yaml +26 -7
  72. package/manifests/grafana/kustomization.yaml +1 -0
  73. package/manifests/grafana/service.yaml +6 -1
  74. package/manifests/mariadb/pv.yaml +1 -0
  75. package/manifests/mongodb/statefulset.yaml +9 -2
  76. package/manifests/mysql/pv-pvc.yaml +14 -1
  77. package/manifests/postgresql/pv.yaml +12 -1
  78. package/manifests/postgresql/pvc.yaml +1 -0
  79. package/manifests/prometheus/deployment.yaml +18 -22
  80. package/package.json +87 -12
  81. package/scripts/event-monitor.sh +56 -0
  82. package/scripts/k3s-node-setup.sh +27 -14
  83. package/scripts/kubeadm-node-setup.sh +31 -11
  84. package/scripts/maas-setup.sh +8 -8
  85. package/scripts/selinux-normalize.sh +907 -0
  86. package/scripts/shutdown-machine.sh +843 -0
  87. package/scripts/test-monitor.sh +5 -5
  88. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.controller.js +15 -10
  89. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.model.js +36 -5
  90. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.router.js +7 -2
  91. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.service.js +90 -186
  92. package/src/api/core/core.controller.js +1 -1
  93. package/src/api/core/core.router.js +2 -2
  94. package/src/api/core/core.service.js +2 -2
  95. package/src/api/crypto/crypto.controller.js +1 -1
  96. package/src/api/crypto/crypto.service.js +1 -1
  97. package/src/api/cyberia-action/cyberia-action.controller.js +1 -1
  98. package/src/api/cyberia-action/cyberia-action.router.js +3 -3
  99. package/src/api/cyberia-action/cyberia-action.service.js +5 -6
  100. package/src/api/cyberia-audio/cyberia-audio.controller.js +6 -0
  101. package/src/api/cyberia-audio/cyberia-audio.model.js +61 -0
  102. package/src/api/cyberia-audio/cyberia-audio.router.js +21 -0
  103. package/src/api/cyberia-audio/cyberia-audio.service.js +220 -0
  104. package/src/api/cyberia-client-hints/cyberia-client-hints.controller.js +2 -4
  105. package/src/api/cyberia-client-hints/cyberia-client-hints.model.js +10 -19
  106. package/src/api/cyberia-client-hints/cyberia-client-hints.router.js +13 -35
  107. package/src/api/cyberia-client-hints/cyberia-client-hints.service.js +17 -34
  108. package/src/api/cyberia-dialogue/cyberia-dialogue.controller.js +1 -1
  109. package/src/api/cyberia-dialogue/cyberia-dialogue.model.js +1 -1
  110. package/src/api/cyberia-dialogue/cyberia-dialogue.router.js +2 -2
  111. package/src/api/cyberia-dialogue/cyberia-dialogue.service.js +2 -2
  112. package/src/api/cyberia-entity/cyberia-entity.controller.js +1 -1
  113. package/src/api/cyberia-entity/cyberia-entity.model.js +2 -0
  114. package/src/api/cyberia-entity/cyberia-entity.router.js +1 -1
  115. package/src/api/cyberia-entity/cyberia-entity.service.js +3 -3
  116. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.controller.js +8 -2
  117. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.model.js +31 -20
  118. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.router.js +17 -2
  119. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.service.js +468 -5
  120. package/src/api/cyberia-instance/cyberia-fallback-capture.js +502 -0
  121. package/src/api/cyberia-instance/cyberia-fallback-world.js +29 -40
  122. package/src/api/cyberia-instance/cyberia-instance-boot.service.js +5 -5
  123. package/src/api/cyberia-instance/cyberia-instance-items.js +98 -0
  124. package/src/api/cyberia-instance/cyberia-instance-map.service.js +35 -142
  125. package/src/api/cyberia-instance/cyberia-instance.controller.js +2 -5
  126. package/src/api/cyberia-instance/cyberia-instance.model.js +0 -14
  127. package/src/api/cyberia-instance/cyberia-instance.router.js +5 -18
  128. package/src/api/cyberia-instance/cyberia-instance.service.js +5 -45
  129. package/src/api/cyberia-instance/cyberia-world-generator.js +8 -13
  130. package/src/api/cyberia-instance-conf/cyberia-instance-conf.controller.js +1 -1
  131. package/src/api/cyberia-instance-conf/cyberia-instance-conf.model.js +49 -75
  132. package/src/api/cyberia-instance-conf/cyberia-instance-conf.router.js +1 -1
  133. package/src/api/cyberia-instance-conf/cyberia-instance-conf.service.js +76 -3
  134. package/src/api/cyberia-map/cyberia-map.controller.js +1 -1
  135. package/src/api/cyberia-map/cyberia-map.router.js +1 -1
  136. package/src/api/cyberia-map/cyberia-map.service.js +8 -4
  137. package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.controller.js +31 -0
  138. package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.model.js +56 -0
  139. package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.router.js +33 -0
  140. package/src/api/cyberia-map-audio-conf/cyberia-map-audio-conf.service.js +189 -0
  141. package/src/api/cyberia-quest/cyberia-quest.controller.js +1 -1
  142. package/src/api/cyberia-quest/cyberia-quest.router.js +4 -4
  143. package/src/api/cyberia-quest/cyberia-quest.service.js +5 -5
  144. package/src/api/cyberia-quest-progress/cyberia-quest-progress.controller.js +1 -1
  145. package/src/api/cyberia-quest-progress/cyberia-quest-progress.model.js +1 -1
  146. package/src/api/cyberia-quest-progress/cyberia-quest-progress.router.js +1 -1
  147. package/src/api/cyberia-quest-progress/cyberia-quest-progress.service.js +2 -2
  148. package/src/api/cyberia-saga/cyberia-saga.controller.js +1 -1
  149. package/src/api/cyberia-saga/cyberia-saga.router.js +1 -1
  150. package/src/api/cyberia-saga/cyberia-saga.service.js +2 -2
  151. package/src/api/cyberia-server-defaults/cyberia-server-defaults.js +403 -214
  152. package/src/api/cyberia-skill/cyberia-skill.controller.js +1 -1
  153. package/src/api/cyberia-skill/cyberia-skill.model.js +6 -6
  154. package/src/api/cyberia-skill/cyberia-skill.router.js +1 -1
  155. package/src/api/cyberia-skill/cyberia-skill.service.js +2 -2
  156. package/src/api/default/default.controller.js +1 -1
  157. package/src/api/default/default.router.js +1 -1
  158. package/src/api/default/default.service.js +2 -2
  159. package/src/api/document/document.controller.js +1 -1
  160. package/src/api/document/document.router.js +1 -1
  161. package/src/api/document/document.service.js +2 -2
  162. package/src/api/file/file.controller.js +1 -1
  163. package/src/api/file/file.ref.js +153 -0
  164. package/src/api/file/file.ref.json +11 -2
  165. package/src/api/file/file.router.js +1 -1
  166. package/src/api/file/file.service.js +2 -2
  167. package/src/api/instance/instance.controller.js +1 -1
  168. package/src/api/instance/instance.router.js +1 -1
  169. package/src/api/instance/instance.service.js +2 -2
  170. package/src/api/ipfs/ipfs.controller.js +1 -1
  171. package/src/api/ipfs/ipfs.router.js +2 -2
  172. package/src/api/ipfs/ipfs.service.js +2 -2
  173. package/src/api/object-layer/object-layer.controller.js +1 -1
  174. package/src/api/object-layer/object-layer.model.js +47 -12
  175. package/src/api/object-layer/object-layer.router.js +12 -5
  176. package/src/api/object-layer/object-layer.service.js +116 -123
  177. package/src/api/object-layer-render-frames/object-layer-render-frames.controller.js +1 -1
  178. package/src/api/object-layer-render-frames/object-layer-render-frames.router.js +1 -1
  179. package/src/api/object-layer-render-frames/object-layer-render-frames.service.js +2 -2
  180. package/src/api/test/test.controller.js +1 -1
  181. package/src/api/test/test.service.js +1 -1
  182. package/src/api/user/guest.service.js +3 -3
  183. package/src/api/user/user.controller.js +1 -1
  184. package/src/api/user/user.router.js +2 -2
  185. package/src/api/user/user.service.js +4 -4
  186. package/src/api.js +5 -9
  187. package/src/cli/app.js +402 -0
  188. package/src/cli/baremetal.js +30 -35
  189. package/src/cli/client.js +306 -0
  190. package/src/cli/cloud-init.js +3 -3
  191. package/src/cli/cluster.js +191 -82
  192. package/src/cli/db.js +120 -68
  193. package/src/cli/deploy.js +157 -75
  194. package/src/cli/docker-compose.js +5 -5
  195. package/src/cli/domains.js +184 -0
  196. package/src/cli/dotenv-store.js +143 -0
  197. package/src/cli/event.js +2281 -0
  198. package/src/cli/fs-selection.js +115 -0
  199. package/src/cli/fs.js +159 -343
  200. package/src/cli/host.js +672 -0
  201. package/src/cli/image.js +4 -6
  202. package/src/cli/index.js +343 -151
  203. package/src/cli/ipfs.js +34 -30
  204. package/src/cli/kickstart.js +1 -1
  205. package/src/cli/kubectl.js +218 -41
  206. package/src/cli/lxd.js +3 -3
  207. package/src/cli/monitor.js +1359 -26
  208. package/src/cli/package.js +90 -0
  209. package/src/cli/release.js +16 -12
  210. package/src/cli/repository.js +586 -363
  211. package/src/cli/run.js +398 -843
  212. package/src/cli/secrets.js +2158 -964
  213. package/src/cli/ssh.js +478 -279
  214. package/src/cli/state.js +394 -0
  215. package/src/cli/static.js +2 -2
  216. package/src/cli/system.js +1 -1
  217. package/src/cli/test.js +203 -125
  218. package/src/cli/vultr.js +61 -21
  219. package/src/cli/wireguard.js +1112 -306
  220. package/src/client/components/core/CalendarCore.js +53 -96
  221. package/src/client/components/core/Docs.js +327 -303
  222. package/src/client/components/core/FileExplorer.js +0 -21
  223. package/src/client/components/core/Modal.js +56 -1
  224. package/src/client/components/core/PanelForm.js +4 -4
  225. package/src/client/components/core/Repository.js +56 -0
  226. package/src/client/components/core/Translate.js +7 -0
  227. package/src/client/components/core/{FullScreen.js → ViewModeController.js} +42 -39
  228. package/src/client/components/core/Wallet.js +0 -11
  229. package/src/client/components/core/Worker.js +7 -1
  230. package/src/client/components/cryptokoyn/SettingsCryptokoyn.js +2 -2
  231. package/src/client/components/cyberia/ActionEngineCyberia.js +12 -36
  232. package/src/client/components/cyberia/EntityEngineCyberia.js +492 -121
  233. package/src/client/components/cyberia/InstanceEngineCyberia.js +129 -160
  234. package/src/client/components/cyberia/InstanceSelectionView.js +7 -1
  235. package/src/client/components/cyberia/MapEngineCyberia.js +175 -69
  236. package/src/client/components/cyberia/ObjectLayerEngine.js +1011 -97
  237. package/src/client/components/cyberia/ObjectLayerEngineModal.js +81 -155
  238. package/src/client/components/cyberia/ObjectLayerEngineViewer.js +113 -98
  239. package/src/client/components/cyberia/SharedDefaultsCyberia.js +215 -56
  240. package/src/client/components/cyberia-portal/AppShellCyberiaPortal.js +2 -35
  241. package/src/client/components/cyberia-portal/CssCyberiaPortal.js +1 -1
  242. package/src/client/components/cyberia-portal/MainBodyCyberiaPortal.js +712 -76
  243. package/src/client/components/cyberia-portal/SettingsCyberiaPortal.js +2 -2
  244. package/src/client/components/cyberia-portal/TranslateCyberiaPortal.js +0 -4
  245. package/src/client/components/default/AppShellDefault.js +1 -1
  246. package/src/client/components/default/SettingsDefault.js +2 -2
  247. package/src/client/components/itemledger/SettingsItemledger.js +2 -2
  248. package/src/client/components/underpost/AppShellUnderpost.js +3 -2
  249. package/src/client/components/underpost/SettingsUnderpost.js +2 -2
  250. package/src/client/public/cyberia-docs/ARCHITECTURE.md +15 -15
  251. package/src/client/public/cyberia-docs/CYBERIA-CLI.md +313 -30
  252. package/src/client/public/cyberia-docs/CYBERIA-CLIENT.md +51 -29
  253. package/src/client/public/cyberia-docs/CYBERIA-SAGA.md +52 -53
  254. package/src/client/public/cyberia-docs/CYBERIA-SERVER.md +16 -11
  255. package/src/client/public/cyberia-docs/CYBERIA.md +48 -28
  256. package/src/client/public/cyberia-docs/ENTITY-PROFILE.md +11 -5
  257. package/src/client/public/cyberia-docs/HARDHAT-MODULE.md +23 -6
  258. package/src/client/public/cyberia-docs/ROADMAP.md +1 -1
  259. package/src/client/public/cyberia-docs/STATS-PROGRESSION.md +217 -0
  260. package/src/client/public/cyberia-docs/WHITE-PAPER.md +20 -12
  261. package/src/client/public/default/android-chrome-144x144.png +0 -0
  262. package/src/client/public/default/android-chrome-192x192.png +0 -0
  263. package/src/client/public/default/android-chrome-256x256.png +0 -0
  264. package/src/client/public/default/android-chrome-36x36.png +0 -0
  265. package/src/client/public/default/android-chrome-384x384.png +0 -0
  266. package/src/client/public/default/android-chrome-48x48.png +0 -0
  267. package/src/client/public/default/android-chrome-512x512.png +0 -0
  268. package/src/client/public/default/android-chrome-72x72.png +0 -0
  269. package/src/client/public/default/android-chrome-96x96.png +0 -0
  270. package/src/client/public/default/apple-touch-icon-1024x1024.png +0 -0
  271. package/src/client/public/default/apple-touch-icon-114x114.png +0 -0
  272. package/src/client/public/default/apple-touch-icon-120x120.png +0 -0
  273. package/src/client/public/default/apple-touch-icon-144x144.png +0 -0
  274. package/src/client/public/default/apple-touch-icon-152x152.png +0 -0
  275. package/src/client/public/default/apple-touch-icon-167x167.png +0 -0
  276. package/src/client/public/default/apple-touch-icon-180x180.png +0 -0
  277. package/src/client/public/default/apple-touch-icon-57x57.png +0 -0
  278. package/src/client/public/default/apple-touch-icon-60x60.png +0 -0
  279. package/src/client/public/default/apple-touch-icon-72x72.png +0 -0
  280. package/src/client/public/default/apple-touch-icon-76x76.png +0 -0
  281. package/src/client/public/default/apple-touch-icon-precomposed.png +0 -0
  282. package/src/client/public/default/apple-touch-icon.png +0 -0
  283. package/src/client/public/default/apple-touch-startup-image-1125x2436.png +0 -0
  284. package/src/client/public/default/apple-touch-startup-image-1136x640.png +0 -0
  285. package/src/client/public/default/apple-touch-startup-image-1170x2532.png +0 -0
  286. package/src/client/public/default/apple-touch-startup-image-1179x2556.png +0 -0
  287. package/src/client/public/default/apple-touch-startup-image-1242x2208.png +0 -0
  288. package/src/client/public/default/apple-touch-startup-image-1242x2688.png +0 -0
  289. package/src/client/public/default/apple-touch-startup-image-1284x2778.png +0 -0
  290. package/src/client/public/default/apple-touch-startup-image-1290x2796.png +0 -0
  291. package/src/client/public/default/apple-touch-startup-image-1334x750.png +0 -0
  292. package/src/client/public/default/apple-touch-startup-image-1488x2266.png +0 -0
  293. package/src/client/public/default/apple-touch-startup-image-1536x2048.png +0 -0
  294. package/src/client/public/default/apple-touch-startup-image-1620x2160.png +0 -0
  295. package/src/client/public/default/apple-touch-startup-image-1640x2160.png +0 -0
  296. package/src/client/public/default/apple-touch-startup-image-1668x2224.png +0 -0
  297. package/src/client/public/default/apple-touch-startup-image-1668x2388.png +0 -0
  298. package/src/client/public/default/apple-touch-startup-image-1792x828.png +0 -0
  299. package/src/client/public/default/apple-touch-startup-image-2048x1536.png +0 -0
  300. package/src/client/public/default/apple-touch-startup-image-2048x2732.png +0 -0
  301. package/src/client/public/default/apple-touch-startup-image-2160x1620.png +0 -0
  302. package/src/client/public/default/apple-touch-startup-image-2160x1640.png +0 -0
  303. package/src/client/public/default/apple-touch-startup-image-2208x1242.png +0 -0
  304. package/src/client/public/default/apple-touch-startup-image-2224x1668.png +0 -0
  305. package/src/client/public/default/apple-touch-startup-image-2266x1488.png +0 -0
  306. package/src/client/public/default/apple-touch-startup-image-2388x1668.png +0 -0
  307. package/src/client/public/default/apple-touch-startup-image-2436x1125.png +0 -0
  308. package/src/client/public/default/apple-touch-startup-image-2532x1170.png +0 -0
  309. package/src/client/public/default/apple-touch-startup-image-2556x1179.png +0 -0
  310. package/src/client/public/default/apple-touch-startup-image-2688x1242.png +0 -0
  311. package/src/client/public/default/apple-touch-startup-image-2732x2048.png +0 -0
  312. package/src/client/public/default/apple-touch-startup-image-2778x1284.png +0 -0
  313. package/src/client/public/default/apple-touch-startup-image-2796x1290.png +0 -0
  314. package/src/client/public/default/apple-touch-startup-image-640x1136.png +0 -0
  315. package/src/client/public/default/apple-touch-startup-image-750x1334.png +0 -0
  316. package/src/client/public/default/apple-touch-startup-image-828x1792.png +0 -0
  317. package/src/client/public/default/assets/background/white.jpg +0 -0
  318. package/src/client/public/default/browserconfig.xml +1 -1
  319. package/src/client/public/default/favicon-16x16.png +0 -0
  320. package/src/client/public/default/favicon-32x32.png +0 -0
  321. package/src/client/public/default/favicon-48x48.png +0 -0
  322. package/src/client/public/default/favicon.ico +0 -0
  323. package/src/client/public/default/manifest.webmanifest +5 -5
  324. package/src/client/public/default/mstile-144x144.png +0 -0
  325. package/src/client/public/default/mstile-150x150.png +0 -0
  326. package/src/client/public/default/mstile-310x150.png +0 -0
  327. package/src/client/public/default/mstile-310x310.png +0 -0
  328. package/src/client/public/default/mstile-70x70.png +0 -0
  329. package/src/client/public/default/yandex-browser-50x50.png +0 -0
  330. package/src/client/public/default/yandex-browser-manifest.json +1 -1
  331. package/src/client/services/cyberia-audio/cyberia-audio.service.js +99 -0
  332. package/src/client/services/cyberia-entity-type-default/cyberia-entity-type-default.service.js +38 -0
  333. package/src/client/services/cyberia-instance/cyberia-instance.management.js +5 -4
  334. package/src/client/services/cyberia-instance/cyberia-instance.service.js +0 -40
  335. package/src/client/services/cyberia-map/cyberia-map.management.js +5 -4
  336. package/src/client/services/cyberia-map-audio-conf/cyberia-map-audio-conf.service.js +138 -0
  337. package/src/client/services/object-layer/object-layer.management.js +6 -10
  338. package/src/client/services/object-layer/object-layer.service.js +3 -1
  339. package/src/client/ssr/RootDocument.js +1 -1
  340. package/src/client/ssr/body/404.js +1 -1
  341. package/src/client/ssr/body/500.js +1 -1
  342. package/src/client/ssr/body/CacheControl.js +1 -1
  343. package/src/client/ssr/body/CyberiaDefaultSplashScreen.js +1 -1
  344. package/src/client/ssr/body/DefaultSplashScreen.js +1 -1
  345. package/src/client/ssr/body/SwaggerDarkMode.js +1 -1
  346. package/src/client/ssr/body/UnderpostDefaultSplashScreen.js +1 -1
  347. package/src/client/ssr/head/CryptokoynScripts.js +1 -1
  348. package/src/client/ssr/head/Css.js +1 -1
  349. package/src/client/ssr/head/CyberiaPortalScripts.js +1 -1
  350. package/src/client/ssr/head/DefaultScripts.js +1 -1
  351. package/src/client/ssr/head/ItemledgerScripts.js +1 -1
  352. package/src/client/ssr/head/Microdata.js +1 -1
  353. package/src/client/ssr/head/Production.js +1 -1
  354. package/src/client/ssr/head/Pwa.js +1 -1
  355. package/src/client/ssr/head/PwaItemledger.js +1 -1
  356. package/src/client/ssr/head/Seo.js +1 -1
  357. package/src/client/ssr/head/UnderpostScripts.js +1 -1
  358. package/src/client/ssr/mailer/DefaultRecoverEmail.js +1 -1
  359. package/src/client/ssr/mailer/DefaultVerifyEmail.js +1 -1
  360. package/src/client/ssr/views/Cyberia404.js +7 -5
  361. package/src/client/ssr/views/CyberiaServerMetrics.js +1 -1
  362. package/src/client/ssr/views/Maintenance.js +1 -1
  363. package/src/client/ssr/views/NoNetworkConnection.js +1 -1
  364. package/src/client/ssr/views/Test.js +1 -1
  365. package/src/client/sw/core.sw.js +20 -14
  366. package/src/client-builder/client-build-docs.js +92 -77
  367. package/src/client-builder/client-build-live.js +2 -2
  368. package/src/client-builder/client-build.js +105 -74
  369. package/src/client-builder/client-bundle.js +347 -0
  370. package/src/client-builder/client-dev-server.js +3 -3
  371. package/src/client-builder/client-icons.js +2 -2
  372. package/src/client-builder/ssr.js +3 -3
  373. package/src/client.build.js +3 -6
  374. package/src/client.dev.js +3 -6
  375. package/src/db/DataBaseProvider.js +186 -3
  376. package/src/db/mariadb/MariaDB.js +3 -2
  377. package/src/db/mongo/MongoBootstrap.js +273 -101
  378. package/src/db/mongo/MongoExpress.js +187 -0
  379. package/src/db/mongo/MongooseDB.js +7 -8
  380. package/src/{server/valkey.js → db/valkey/Valkey.js} +5 -4
  381. package/src/grpc/cyberia/grpc-server.js +6 -8
  382. package/src/index.js +79 -23
  383. package/src/mailer/EmailRender.js +2 -2
  384. package/src/mailer/MailerInterceptor.js +87 -0
  385. package/src/mailer/MailerProvider.js +50 -6
  386. package/src/projects/cyberia/atlas-sprite-sheet-generator.js +144 -147
  387. package/src/projects/cyberia/atlas-sprite-sheet-store.js +391 -0
  388. package/src/projects/cyberia/besu-genesis-generator.js +8 -17
  389. package/src/projects/cyberia/boot-contract-fixtures.js +32 -0
  390. package/src/projects/cyberia/catalog-cyberia.js +54 -10
  391. package/src/projects/cyberia/gemini-client.js +4 -4
  392. package/src/projects/cyberia/generate-saga.js +5 -12
  393. package/src/projects/cyberia/hot-reload-trigger.js +18 -29
  394. package/src/projects/cyberia/instance-backup.js +210 -0
  395. package/src/projects/cyberia/instance-data.js +178 -258
  396. package/src/projects/cyberia/ipfs-client.js +4 -4
  397. package/src/projects/cyberia/map-preview-generator.js +33 -69
  398. package/src/projects/cyberia/object-layer.js +153 -320
  399. package/src/projects/cyberia/seed-audio.js +139 -0
  400. package/src/projects/cyberia/semantic-layer-generator-skin.js +2 -8
  401. package/src/projects/cyberia/semantic-layer-generator.js +3 -19
  402. package/src/projects/cyberia/stat-balance.js +81 -0
  403. package/src/projects/cyberia/stat-commands.js +23 -0
  404. package/src/projects/cyberia/stat-contract-generator.js +101 -0
  405. package/src/projects/underpost/catalog-underpost.js +9 -1
  406. package/src/proxy.js +4 -7
  407. package/src/runtime/cyberia-client/Dockerfile +17 -8
  408. package/src/runtime/cyberia-client/Dockerfile.dev +13 -4
  409. package/src/runtime/cyberia-server/Dockerfile +18 -6
  410. package/src/runtime/cyberia-server/Dockerfile.dev +16 -3
  411. package/src/runtime/engine-cyberia/Dockerfile +25 -9
  412. package/src/runtime/engine-cyberia/Dockerfile.dev +25 -9
  413. package/src/runtime/engine-cyberia/Dockerfile.test +5 -5
  414. package/src/runtime/engine-cyberia/compose.env +17 -5
  415. package/src/runtime/engine-cyberia/docker-compose.yml +23 -17
  416. package/src/runtime/express/Express.js +32 -27
  417. package/src/runtime/lampp/Lampp.js +22 -70
  418. package/src/runtime/nginx/Nginx.js +1 -1
  419. package/src/runtime/wp/Wp.js +16 -48
  420. package/src/server/{catalog.js → build/catalog.js} +15 -5
  421. package/src/server/build/coverage.js +188 -0
  422. package/src/server/build/execution.js +402 -0
  423. package/src/server/build/package.js +508 -0
  424. package/src/server/build/testing.js +578 -0
  425. package/src/server/{dns.js → network/dns.js} +144 -11
  426. package/src/server/{forward-proxy.js → network/forward-proxy.js} +10 -18
  427. package/src/server/{middlewares.js → network/middlewares.js} +11 -5
  428. package/src/server/network/node-capability.js +98 -0
  429. package/src/server/{peer.js → network/peer.js} +3 -3
  430. package/src/server/{proxy.js → network/proxy.js} +7 -13
  431. package/src/server/network/router.js +356 -0
  432. package/src/server/{tls.js → network/tls.js} +2 -2
  433. package/src/server/{underpost-compression.js → network/underpost-compression.js} +1 -1
  434. package/src/server/{underpost-gateway.js → network/underpost-gateway.js} +7 -7
  435. package/src/server/{underpost-ingress.js → network/underpost-ingress.js} +2 -2
  436. package/src/server/{cri.js → ops/cri.js} +2 -2
  437. package/src/server/{cron.js → ops/cron.js} +349 -74
  438. package/src/server/ops/event-notification.js +284 -0
  439. package/src/server/{logger.js → ops/logger.js} +143 -23
  440. package/src/server/ops/monitoring.js +1724 -0
  441. package/src/server/{systemd.js → ops/systemd.js} +55 -1
  442. package/src/server/{conf.js → runtime/conf.js} +516 -423
  443. package/src/server/runtime/config-scope.js +215 -0
  444. package/src/server/runtime/environment.js +149 -0
  445. package/src/server/{process.js → runtime/process.js} +153 -12
  446. package/src/server/{runtime-status.js → runtime/runtime-status.js} +155 -16
  447. package/src/server/{runtime.js → runtime/runtime.js} +12 -8
  448. package/src/server/{start.js → runtime/start.js} +128 -39
  449. package/src/server/{auth.js → security/auth.js} +7 -8
  450. package/src/server/security/container-storage.js +382 -0
  451. package/src/server/{crypto.js → security/crypto.js} +1 -1
  452. package/src/server/{selinux.js → security/selinux.js} +1 -1
  453. package/src/server/{backup.js → storage/backup.js} +17 -8
  454. package/src/server/{data-query.js → storage/data-query.js} +17 -1
  455. package/src/server/storage/downloader.js +121 -0
  456. package/src/server/storage/repository.js +68 -0
  457. package/src/server/storage/zip.js +153 -0
  458. package/src/server.js +4 -7
  459. package/src/ws/IoInterface.js +1 -1
  460. package/src/ws/IoServer.js +1 -1
  461. package/src/ws/core/core.ws.connection.js +1 -1
  462. package/src/ws/core/core.ws.emit.js +1 -1
  463. package/src/ws/core/core.ws.server.js +1 -1
  464. package/src/ws/default/default.ws.connection.js +1 -1
  465. package/src/ws/default/default.ws.emit.js +1 -1
  466. package/src/ws/default/default.ws.server.js +1 -1
  467. package/test/e2e/event-e2e-public-ingress-down.js +45 -0
  468. package/test/e2e/event-e2e-wireguard-server-down.js +38 -0
  469. package/test/e2e/event-e2e-wireguard-spoke-down.js +40 -0
  470. package/test/{api.test.js → integration/app/api.test.js} +33 -14
  471. package/test/integration/app/cyberia/atlas-sprite-sheet-store.test.js +402 -0
  472. package/test/integration/app/cyberia/atlas-sprite-sheet.test.js +86 -0
  473. package/test/integration/app/cyberia/cyberia-cli-plain-reads.test.js +64 -0
  474. package/test/integration/app/cyberia/cyberia-entity-type-default.test.js +842 -0
  475. package/test/integration/app/cyberia/cyberia-instance-conf-coerce.test.js +53 -0
  476. package/test/{cyberia-instance-conf-defaults.test.js → integration/app/cyberia/cyberia-instance-conf-defaults.test.js} +17 -23
  477. package/test/integration/app/cyberia/cyberia-instance-items.test.js +90 -0
  478. package/test/integration/app/cyberia/cyberia-load.test.js +466 -0
  479. package/test/integration/app/cyberia/cyberia-map-audio-conf.test.js +256 -0
  480. package/test/integration/app/cyberia/cyberia-stats.test.js +150 -0
  481. package/test/integration/app/cyberia/fallback-world-capture.test.js +338 -0
  482. package/test/integration/app/cyberia/object-layer-item-id.test.js +327 -0
  483. package/test/integration/app/cyberia/object-layer-item-selection.test.js +56 -0
  484. package/test/integration/app/cyberia/object-layer-natural-key.test.js +32 -0
  485. package/test/integration/app/cyberia/seed-audio.test.js +275 -0
  486. package/test/{shape-generator.test.js → integration/app/cyberia/shape-generator.test.js} +1 -1
  487. package/test/integration/infra/1-security/config-scope.test.js +305 -0
  488. package/test/integration/infra/1-security/container-storage.test.js +356 -0
  489. package/test/integration/infra/1-security/in-pod-cli-surface.test.js +86 -0
  490. package/test/integration/infra/1-security/secret-onboarding.test.js +930 -0
  491. package/test/{selinux.test.js → integration/infra/1-security/selinux.test.js} +2 -4
  492. package/test/{sops-secret-store.test.js → integration/infra/1-security/sops-secret-store.test.js} +415 -61
  493. package/test/integration/infra/1-security/systemd-service.test.js +70 -0
  494. package/test/integration/infra/1-security/underpost-config-secret.test.js +367 -0
  495. package/test/integration/infra/2-network/dns-firewall.test.js +566 -0
  496. package/test/integration/infra/2-network/node-capability.test.js +182 -0
  497. package/test/integration/infra/2-network/wireguard-cli.test.js +1187 -0
  498. package/test/{wireguard-edge.test.js → integration/infra/2-network/wireguard-edge.test.js} +649 -55
  499. package/test/{cluster-instances.test.js → integration/infra/3-cluster/cluster-instances.test.js} +11 -15
  500. package/test/{deploy-node-placement.test.js → integration/infra/3-cluster/deploy-node-placement.test.js} +3 -3
  501. package/test/integration/infra/3-cluster/docker-compose-stack.test.js +313 -0
  502. package/test/integration/infra/3-cluster/mongo-express-deploy.test.js +156 -0
  503. package/test/integration/infra/4-ingress/api-cross-origin.test.js +79 -0
  504. package/test/integration/infra/4-ingress/deploy-routes.test.js +379 -0
  505. package/test/integration/infra/4-ingress/gateway-static-assets.test.js +453 -0
  506. package/test/{instance-traffic-plan.test.js → integration/infra/4-ingress/instance-traffic-plan.test.js} +10 -6
  507. package/test/{underpost-gateway.test.js → integration/infra/4-ingress/underpost-gateway.test.js} +6 -6
  508. package/test/{underpost-ingress.test.js → integration/infra/4-ingress/underpost-ingress.test.js} +4 -4
  509. package/test/integration/infra/5-observability/cron-jobs.test.js +652 -0
  510. package/test/{deploy-monitor.test.js → integration/infra/5-observability/deploy-monitor.test.js} +29 -31
  511. package/test/integration/infra/5-observability/event-notification.test.js +197 -0
  512. package/test/integration/infra/5-observability/event-remediation.test.js +502 -0
  513. package/test/integration/infra/5-observability/event-targets.test.js +1174 -0
  514. package/test/integration/infra/5-observability/monitoring-stack.test.js +902 -0
  515. package/test/support/shell-harness.js +73 -0
  516. package/test/unit/build-template.test.js +97 -0
  517. package/test/unit/build-workflow-offline.test.js +132 -0
  518. package/test/unit/catalog.test.js +71 -0
  519. package/test/unit/client-build-docs.test.js +361 -0
  520. package/test/unit/client-bundle.test.js +313 -0
  521. package/test/unit/conf-loading.test.js +303 -0
  522. package/test/unit/conf-resolution.test.js +996 -0
  523. package/test/unit/coverage-artifact.test.js +221 -0
  524. package/test/{crypto.test.js → unit/crypto.test.js} +1 -1
  525. package/test/unit/cyberia/instance-backup.test.js +183 -0
  526. package/test/unit/cyberia/instance-object-layer-items.test.js +46 -0
  527. package/test/unit/cyberia/publish-workflow.test.js +22 -0
  528. package/test/unit/cyberia/stat-balance.test.js +69 -0
  529. package/test/unit/deploy-env-resolution.test.js +38 -0
  530. package/test/unit/deploy-log-table.test.js +518 -0
  531. package/test/unit/downloader-integrity.test.js +98 -0
  532. package/test/unit/execution-profiles.test.js +219 -0
  533. package/test/unit/file-reference-registry.test.js +141 -0
  534. package/test/unit/fleet-sync-source.test.js +149 -0
  535. package/test/unit/fs-storage-paths.test.js +596 -0
  536. package/test/unit/logger-redaction.test.js +141 -0
  537. package/test/unit/package.test.js +457 -0
  538. package/test/unit/prepare-host.test.js +382 -0
  539. package/test/unit/process-environment.test.js +18 -0
  540. package/test/unit/propagation-message.test.js +78 -0
  541. package/test/unit/redeploy-plan.test.js +24 -0
  542. package/test/unit/release-bump.test.js +474 -0
  543. package/test/unit/ssh-output-redaction.test.js +28 -0
  544. package/test/unit/start-options.test.js +46 -0
  545. package/test/unit/test-tiers.test.js +220 -0
  546. package/test/unit/zip-archive.test.js +142 -0
  547. package/vitest.config.js +66 -0
  548. package/.nycrc +0 -9
  549. package/deploy/lib/logging.sh +0 -96
  550. package/manifests/cronjobs/dd-cron/dd-cron-dns.yaml +0 -48
  551. package/manifests/mongodb/pv-pvc.yaml +0 -59
  552. package/scripts/coverall-test-cyberia.sh +0 -24
  553. package/scripts/coverall-test.sh +0 -24
  554. package/scripts/link-local-underpost-cli.sh +0 -6
  555. package/src/api/cyberia-instance/cyberia-fallback-default-items.js +0 -63
  556. package/src/api/user/user.build.js +0 -16
  557. package/src/cli/env.js +0 -177
  558. package/src/client/components/core/Blockchain.js +0 -41
  559. package/src/client/components/core/Blog.js +0 -9
  560. package/src/client/components/core/KeyboardAvoidance.js +0 -145
  561. package/src/client/components/cyberia/FallbackWorldEngineCyberia.js +0 -368
  562. package/src/client/public/default/assets/background/dark.jpg +0 -0
  563. package/src/client/public/default/assets/background/white0-min.jpg +0 -0
  564. package/src/client/public/default/assets/background/white0.jpg +0 -0
  565. package/src/client/public/doc/favicon.ico +0 -0
  566. package/src/client/public/doc/sitemap +0 -148
  567. package/src/server/downloader.js +0 -73
  568. package/src/server/environment.js +0 -98
@@ -1,17 +1,18 @@
1
1
  import { Css, darkTheme, simpleIconsRender, ThemeEvents, Themes } from './Css.js';
2
2
  import { Modal, renderViewTitle } from './Modal.js';
3
+ import { coverallsUrl, githubPagesUrl, githubUrl, packageRepository } from './Repository.js';
4
+ import { Responsive } from './Responsive.js';
3
5
  import { listenQueryPathInstance, setQueryPath, closeModalRouteChangeEvent, getProxyPath } from './Router.js';
4
6
  import { s, sIframe } from './VanillaJs.js';
5
7
  // https://mintlify.com/docs/quickstart
6
8
  class Docs {
7
- static async RenderModal(type) {
9
+ static async RenderModal(type, parentModalId = 'modal-docs') {
8
10
  const docData = Docs.Data.find((d) => d.type === type);
11
+ const parentModal = Modal.Data[parentModalId];
12
+ if (!docData || !parentModal?.options) return;
9
13
  const ModalId = `modal-docs-${docData.type}`;
10
14
  const { barConfig } = await Themes[Css.currentTheme]();
11
- const parentBarMode =
12
- Modal.Data['modal-docs'] && Modal.Data['modal-docs'].options.barMode
13
- ? Modal.Data['modal-docs'].options.barMode
14
- : undefined;
15
+ const parentBarMode = parentModal.options.barMode;
15
16
  await Modal.instance({
16
17
  barConfig,
17
18
  title: renderViewTitle(docData),
@@ -25,14 +26,12 @@ class Docs {
25
26
  border: none;
26
27
  background: white;
27
28
  display: block;
29
+ /* The frame is the only scroll container; the modal body must not
30
+ gain one of its own from the height set on load. */
31
+ overflow: auto;
28
32
  }
29
33
  </style>
30
- <iframe
31
- class="in iframe-${ModalId}"
32
- src="${docData.url()}"
33
- sandbox="allow-same-origin allow-scripts allow-popups allow-forms allow-popups-to-escape-sandbox allow-top-navigation"
34
- >
35
- </iframe>
34
+ <iframe class="in iframe-${ModalId}" src="${docData.url()}"> </iframe>
36
35
  `;
37
36
  },
38
37
  maximize: true,
@@ -42,7 +41,7 @@ class Docs {
42
41
  observer: true,
43
42
  barMode: parentBarMode,
44
43
  query: true,
45
- RouterInstance: Modal.Data['modal-docs'].options.RouterInstance,
44
+ RouterInstance: parentModal.options.RouterInstance,
46
45
  });
47
46
  const iframeEl = s(`.iframe-${ModalId}`);
48
47
  let swaggerThemeEventKey = null;
@@ -65,48 +64,49 @@ class Docs {
65
64
  } catch (e) {
66
65
  // cross-origin or security restriction — safe to ignore
67
66
  }
68
- // Keep the parent window scroll untouched.
69
- // These modals are fixed-position; scrolling the parent on iframe navigation
70
- // shifts Chrome layout calculations and leaves view modals offset by 50px.
71
- // Bind Shift+K inside the iframe to focus the parent SearchBox (mirrors app-wide shortcut)
67
+ // These modals are fixed-position; scrolling the parent on iframe
68
+ // navigation shifts Chrome layout calculations and leaves view modals
69
+ // offset by 50px, so deep links re-sync the layout instead.
72
70
  try {
73
71
  const iframeWin = iframeEl.contentWindow;
74
72
  const iframeDoc = iframeEl.contentDocument || iframeEl.contentWindow?.document;
75
73
  if (iframeDoc) {
74
+ // The frame re-runs this on every in-frame navigation; without
75
+ // releasing the previous document's listeners they accumulate for
76
+ // the lifetime of the modal.
76
77
  if (unbindIframeLayoutSync) unbindIframeLayoutSync();
77
78
  const onIframeAnchorClick = (e) => {
78
- if (e.target && e.target.closest && e.target.closest('a')) {
79
- scheduleViewLayoutSync();
80
- }
79
+ if (e.target?.closest?.('a')) scheduleViewLayoutSync();
81
80
  };
82
81
  const onIframeHashChange = () => scheduleViewLayoutSync();
83
82
  const onIframePopState = () => scheduleViewLayoutSync();
83
+ // Mirrors the app-wide shortcut: the frame owns focus, so the parent
84
+ // never sees the keystroke unless the frame forwards it.
85
+ const onIframeSearchShortcut = (e) => {
86
+ if (!e.shiftKey || e.key?.toLowerCase() !== 'k') return;
87
+ const searchBox = s(`.top-bar-search-box`);
88
+ if (!searchBox) return;
89
+ e.preventDefault();
90
+ e.stopPropagation();
91
+ if (s(`.main-body-btn-ui-close`)?.classList.contains('hide')) s(`.main-body-btn-ui-open`).click();
92
+ searchBox.blur();
93
+ searchBox.focus();
94
+ searchBox.select();
95
+ };
84
96
  iframeDoc.addEventListener('click', onIframeAnchorClick, true);
97
+ iframeDoc.addEventListener('keydown', onIframeSearchShortcut);
85
98
  if (iframeWin) {
86
99
  iframeWin.addEventListener('hashchange', onIframeHashChange);
87
100
  iframeWin.addEventListener('popstate', onIframePopState);
88
101
  }
89
102
  unbindIframeLayoutSync = () => {
90
103
  iframeDoc.removeEventListener('click', onIframeAnchorClick, true);
104
+ iframeDoc.removeEventListener('keydown', onIframeSearchShortcut);
91
105
  if (iframeWin) {
92
106
  iframeWin.removeEventListener('hashchange', onIframeHashChange);
93
107
  iframeWin.removeEventListener('popstate', onIframePopState);
94
108
  }
95
109
  };
96
- iframeDoc.addEventListener('keydown', (e) => {
97
- if (e.shiftKey && e.key.toLowerCase() === 'k') {
98
- e.preventDefault();
99
- e.stopPropagation();
100
- if (s(`.top-bar-search-box`)) {
101
- if (s(`.main-body-btn-ui-close`) && s(`.main-body-btn-ui-close`).classList.contains('hide')) {
102
- s(`.main-body-btn-ui-open`).click();
103
- }
104
- s(`.top-bar-search-box`).blur();
105
- s(`.top-bar-search-box`).focus();
106
- s(`.top-bar-search-box`).select();
107
- }
108
- }
109
- });
110
110
  }
111
111
  } catch (e) {
112
112
  // cross-origin or security restriction — safe to ignore
@@ -159,121 +159,114 @@ class Docs {
159
159
  };
160
160
  }
161
161
  }
162
+ // The iframe is sized to the modal body rather than left to grow: an
163
+ // auto-height iframe inside a fixed-height modal scrolls the modal and the
164
+ // document it holds, which is where the double scrollbar comes from.
165
+ const resizeIframe = () => {
166
+ const frame = s(`.iframe-${ModalId}`);
167
+ const modalEl = s(`.${ModalId}`);
168
+ if (!frame || !modalEl) return;
169
+ const barEl = s(`.bar-default-modal-${ModalId}`);
170
+ const barHeight = barEl ? barEl.offsetHeight : Modal.headerTitleHeight;
171
+ frame.style.height = `${Math.max(modalEl.offsetHeight - barHeight, 0)}px`;
172
+ };
173
+
162
174
  Modal.Data[ModalId].onObserverListener[ModalId] = () => {
163
- if (s(`.iframe-${ModalId}`)) {
164
- const barEl = s(`.bar-default-modal-${ModalId}`);
165
- const barHeight = barEl ? barEl.offsetHeight : Modal.headerTitleHeight;
166
- s(`.iframe-${ModalId}`).style.height = `${s(`.${ModalId}`).offsetHeight - barHeight}px`;
167
- }
168
- if (type.match('coverage')) {
169
- simpleIconsRender(`.doc-icon-coverage`);
170
- simpleIconsRender(`.doc-icon-coverage-link`);
171
- }
175
+ resizeIframe();
176
+ if (type.match('coverage')) simpleIconsRender(`.doc-icon-coverage`);
172
177
  };
173
178
  Modal.Data[ModalId].onObserverListener[ModalId]();
179
+ // The observer fires on modal mutations, not on viewport changes; a rotate
180
+ // or a window drag leaves the frame at its old height without this.
181
+ Responsive.onChanged(resizeIframe, { key: ModalId });
174
182
  Modal.Data[ModalId].onCloseListener[ModalId] = () => {
183
+ Responsive.offChanged(ModalId);
175
184
  if (unbindIframeLayoutSync) unbindIframeLayoutSync();
176
185
  if (swaggerThemeEventKey) delete ThemeEvents[swaggerThemeEventKey];
177
186
  closeModalRouteChangeEvent({ closedId: ModalId });
178
187
  };
179
188
  }
180
- static Data = [
181
- {
182
- type: 'repo',
183
- icon: html`<i class="fab fa-github"></i>`,
184
- text: `Last Release`,
185
- url: function () {
186
- const tokenOpts = Docs.Tokens['modal-docs'];
187
- if (tokenOpts && tokenOpts.lastReleaseUrl) return tokenOpts.lastReleaseUrl();
188
- return `https://github.com/underpostnet/pwa-microservices-template-ghpkg/`;
189
- },
190
- },
191
- {
192
- type: 'demo',
193
- icon: html`<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 32 32">
194
- <path fill="currentColor" d="M20 2v12l10-6z" />
195
- <path
196
- fill="currentColor"
197
- d="M28 14v8H4V6h10V4H4a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h8v4H8v2h16v-2h-4v-4h8a2 2 0 0 0 2-2v-8zM18 28h-4v-4h4z"
198
- />
199
- </svg>`,
200
- text: html`Demo`,
201
- url: function () {
202
- const tokenOpts = Docs.Tokens['modal-docs'];
203
- if (tokenOpts && tokenOpts.demoUrl) return tokenOpts.demoUrl();
204
- return `https://underpostnet.github.io/pwa-microservices-template-ghpkg/`;
205
- },
206
- },
207
- {
208
- type: 'src',
209
- icon: html`<i class="fa-brands fa-osi"></i>`,
210
- text: 'Source Docs',
211
- url: function () {
212
- return `${getProxyPath()}docs/engine/${window.renderPayload.version.replace('v', '')}`;
213
- },
214
- },
215
- {
216
- type: 'api',
217
- icon: html`<i class="fa-solid fa-arrows-turn-to-dots"></i>`,
218
- text: `Api Docs`,
219
- url: function () {
220
- return `${getProxyPath()}api-docs`;
221
- },
222
- },
223
- {
224
- type: 'coverage',
189
+ // One entry per coverage report the build declared, each framed from /docs/coverage/<id>.
190
+ static coverageReports = () =>
191
+ (window.renderPayload.coverage ?? []).map(({ id, label }) => ({
192
+ type: `coverage-${id}`,
225
193
  icon: html`<img height="20" width="20" class="doc-icon-coverage" />`,
226
- text: `Coverage report`,
227
- url: function () {
228
- const tokenOpts = Docs.Tokens['modal-docs'];
229
- if (tokenOpts && tokenOpts.coverageUrl) return tokenOpts.coverageUrl();
230
- return `${getProxyPath()}docs/coverage`;
194
+ text: label,
195
+ url: () => `${getProxyPath()}docs/coverage/${id}`,
196
+ }));
197
+ static get Data() {
198
+ return [
199
+ {
200
+ type: 'repo',
201
+ external: true,
202
+ icon: html`<i class="fab fa-github"></i>`,
203
+ text: `Last Release`,
204
+ url: function () {
205
+ const tokenOpts = Docs.Tokens['modal-docs'];
206
+ if (tokenOpts && tokenOpts.lastReleaseUrl) return tokenOpts.lastReleaseUrl();
207
+ return githubUrl(packageRepository());
208
+ },
231
209
  },
232
- themeEvent: () => {
233
- if (s(`.doc-icon-coverage`)) setTimeout(() => simpleIconsRender(`.doc-icon-coverage`));
210
+ {
211
+ type: 'demo',
212
+ external: true,
213
+ icon: html`<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 32 32">
214
+ <path fill="currentColor" d="M20 2v12l10-6z" />
215
+ <path
216
+ fill="currentColor"
217
+ d="M28 14v8H4V6h10V4H4a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h8v4H8v2h16v-2h-4v-4h8a2 2 0 0 0 2-2v-8zM18 28h-4v-4h4z"
218
+ />
219
+ </svg>`,
220
+ text: html`Demo`,
221
+ url: function () {
222
+ const tokenOpts = Docs.Tokens['modal-docs'];
223
+ if (tokenOpts && tokenOpts.demoUrl) return tokenOpts.demoUrl();
224
+ return githubPagesUrl(packageRepository());
225
+ },
234
226
  },
235
- },
236
- {
237
- type: 'coverage-link',
238
- icon: html`<img height="20" width="20" class="doc-icon-coverage-link" />`,
239
- text: `Coverage`,
240
- url: function () {
241
- return `https://coveralls.io/github/underpostnet/engine`;
227
+ {
228
+ type: 'src',
229
+ icon: html`<i class="fa-brands fa-osi"></i>`,
230
+ text: 'Source Docs',
231
+ url: function () {
232
+ return `${getProxyPath()}docs/engine/${window.renderPayload.version.replace('v', '')}`;
233
+ },
242
234
  },
243
- themeEvent: () => {
244
- if (s(`.doc-icon-coverage-link`)) setTimeout(() => simpleIconsRender(`.doc-icon-coverage-link`));
235
+ {
236
+ type: 'api',
237
+ icon: html`<i class="fa-solid fa-arrows-turn-to-dots"></i>`,
238
+ text: `Api Docs`,
239
+ url: function () {
240
+ return `${getProxyPath()}api-docs`;
241
+ },
245
242
  },
246
- },
247
- ];
243
+ ...Docs.coverageReports(),
244
+ {
245
+ type: 'coverage-link',
246
+ external: true,
247
+ icon: html`<img height="20" width="20" class="doc-icon-coverage" />`,
248
+ text: `Coverage`,
249
+ url: function () {
250
+ const tokenOpts = Docs.Tokens['modal-docs'];
251
+ if (tokenOpts && tokenOpts.coverageLinkUrl) return tokenOpts.coverageLinkUrl();
252
+ return coverallsUrl();
253
+ },
254
+ },
255
+ ];
256
+ }
248
257
  static Tokens = {};
249
258
  static async instance(options = {}) {
250
259
  const { idModal } = options;
251
260
  Docs.Tokens[idModal] = options;
252
261
  setTimeout(() => {
253
- s(`.btn-docs-src`).onclick = async () => {
254
- setQueryPath({ path: 'docs', queryPath: 'src' });
255
- await Docs.RenderModal('src');
256
- };
257
- s(`.btn-docs-api`).onclick = async () => {
258
- setQueryPath({ path: 'docs', queryPath: 'api' });
259
- await Docs.RenderModal('api');
260
- };
261
- s(`.btn-docs-coverage`).onclick = async () => {
262
- setQueryPath({ path: 'docs', queryPath: 'coverage' });
263
- await Docs.RenderModal('coverage');
264
- };
265
- s(`.btn-docs-coverage-link`).onclick = () => {
266
- const docData = Docs.Data.find((d) => d.type === 'coverage-link');
267
- location.href = docData.url();
268
- };
269
- s(`.btn-docs-repo`).onclick = () => {
270
- const docData = Docs.Data.find((d) => d.type === 'repo');
271
- location.href = docData.url();
272
- };
273
- s(`.btn-docs-demo`).onclick = () => {
274
- const docData = Docs.Data.find((d) => d.type === 'demo');
275
- location.href = docData.url();
276
- };
262
+ // An external entry leaves the app; the rest open in a framed modal on their own route.
263
+ for (const docData of Docs.Data) {
264
+ s(`.btn-docs-${docData.type}`).onclick = async () => {
265
+ if (docData.external) return (location.href = docData.url());
266
+ setQueryPath({ path: 'docs', queryPath: docData.type });
267
+ await Docs.RenderModal(docData.type, idModal);
268
+ };
269
+ }
277
270
  listenQueryPathInstance({
278
271
  id: options.idModal,
279
272
  routeId: 'docs',
@@ -287,192 +280,223 @@ class Docs {
287
280
  },
288
281
  });
289
282
  });
290
- // Register theme events for items that have them (Docs-specific concern)
291
- for (const docData of Docs.Data) {
292
- if (docData.themeEvent) {
293
- ThemeEvents[`doc-icon-${docData.type}`] = docData.themeEvent;
294
- setTimeout(ThemeEvents[`doc-icon-${docData.type}`]);
295
- }
296
- }
283
+ // The coverage icons are tinted to the theme's text colour, so they follow theme changes.
284
+ ThemeEvents['doc-icon-coverage'] = () => {
285
+ if (s(`.doc-icon-coverage`)) setTimeout(() => simpleIconsRender(`.doc-icon-coverage`));
286
+ };
287
+ setTimeout(ThemeEvents['doc-icon-coverage']);
297
288
  // Build submenu items and populate — submenu system is owned by Modal
298
289
  Modal.subMenuPopulate('docs', await Modal.buildSubMenuItemsHtml('docs', Docs.Data, options));
299
- {
300
- const docsData = [
301
- {
302
- id: 'getting-started',
303
- icon: 'rocket',
304
- title: 'Getting Started',
305
- description: 'Learn the basics and get started with our platform',
306
- },
307
- {
308
- id: 'api-docs',
309
- icon: 'code',
310
- title: 'API Reference',
311
- description: 'Detailed documentation of our API endpoints',
312
- },
313
- {
314
- id: 'guides',
315
- icon: 'book',
316
- title: 'Guides',
317
- description: 'Step-by-step tutorials and how-to guides',
318
- },
319
- {
320
- id: 'demo',
321
- icon: 'laptop-code',
322
- title: 'Demo',
323
- description: 'Practical examples and code snippets',
324
- },
325
- {
326
- id: 'faq',
327
- icon: 'question-circle',
328
- title: 'FAQ',
329
- description: 'Frequently asked questions',
330
- },
331
- {
332
- id: 'community',
333
- icon: 'users',
334
- title: 'Community',
335
- description: 'Join our developer community',
336
- },
337
- ];
338
- return html`
339
- <style>
340
- .docs-landing {
341
- padding: 2rem;
342
- max-width: 1200px;
343
- margin: 0 auto;
344
- height: 100%;
345
- box-sizing: border-box;
346
- }
347
- .docs-header {
348
- text-align: center;
349
- margin-bottom: 3rem;
350
- opacity: 0;
351
- animation: fadeInUp 0.6s ease-out forwards;
352
- }
353
- .docs-header h1 {
354
- font-size: 2.5rem;
355
- margin: 0 0 1rem;
356
- line-height: 1.2;
357
- }
358
- .docs-header p {
359
- font-size: 1.2rem;
360
- max-width: 700px;
361
- margin: 0 auto 2rem;
362
- line-height: 1.6;
363
- }
364
- .docs-grid {
365
- display: grid;
366
- grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
367
- gap: 1.5rem;
368
- margin: 0;
369
- padding: 0;
370
- list-style: none;
371
- }
372
- .docs-card-container {
373
- cursor: pointer;
374
- opacity: 0;
375
- margin-bottom: 3rem;
376
- animation: fadeInUp 0.6s ease-out forwards;
377
- }
378
- .docs-card {
379
- border-radius: 8px;
380
- padding: 1.5rem;
381
- display: flex;
382
- flex-direction: column;
383
- height: 100%;
384
- position: relative;
385
- transition: all 0.3s ease-in-out;
386
- }
387
290
 
388
- .card-icon {
389
- font-size: 1.75rem;
390
- width: 56px;
391
- height: 56px;
392
- border-radius: 12px;
393
- display: flex;
394
- align-items: center;
395
- justify-content: center;
396
- margin: 0 0 1.25rem;
397
- transition: transform 0.2s ease;
398
- }
291
+ const landingCards = [
292
+ {
293
+ id: 'getting-started',
294
+ icon: 'rocket',
295
+ title: 'Getting Started',
296
+ description: 'Learn the basics and get started with our platform',
297
+ docType: 'src',
298
+ },
299
+ {
300
+ id: 'api-docs',
301
+ icon: 'code',
302
+ title: 'API Reference',
303
+ description: 'Detailed documentation of our API endpoints',
304
+ docType: 'api',
305
+ },
306
+ {
307
+ id: 'guides',
308
+ icon: 'book',
309
+ title: 'Guides',
310
+ description: 'Step-by-step tutorials and how-to guides',
311
+ docType: 'src',
312
+ },
313
+ {
314
+ id: 'demo',
315
+ icon: 'laptop-code',
316
+ title: 'Demo',
317
+ description: 'Practical examples and code snippets',
318
+ docType: 'demo',
319
+ },
320
+ {
321
+ id: 'faq',
322
+ icon: 'question-circle',
323
+ title: 'FAQ',
324
+ description: 'Frequently asked questions',
325
+ docType: 'src',
326
+ },
327
+ {
328
+ id: 'community',
329
+ icon: 'users',
330
+ title: 'Community',
331
+ description: 'Join our developer community',
332
+ docType: 'repo',
333
+ },
334
+ ];
335
+
336
+ // A card resolves to a documented entry, never to a URL of its own: the
337
+ // submenu button and the card must open the same place.
338
+ const openLandingCard = (docType) => {
339
+ const btn = s(`.btn-docs-${docType}`);
340
+ if (btn) return btn.click();
341
+ location.href = Docs.Data.find((d) => d.type === docType).url();
342
+ };
399
343
 
400
- .card-content {
401
- flex: 1;
344
+ setTimeout(() => {
345
+ for (const { id, docType } of landingCards) {
346
+ const cardEl = s(`.docs-card-container-${id}`);
347
+ if (!cardEl) continue;
348
+ cardEl.onclick = () => openLandingCard(docType);
349
+ // The card is a div, so the keyboard affordances a button would carry
350
+ // have to be declared and handled explicitly.
351
+ cardEl.onkeydown = (e) => {
352
+ if (e.key !== 'Enter' && e.key !== ' ') return;
353
+ e.preventDefault();
354
+ openLandingCard(docType);
355
+ };
356
+ }
357
+ });
358
+
359
+ return html`
360
+ <style>
361
+ .docs-landing {
362
+ padding: 2rem;
363
+ max-width: 1200px;
364
+ margin: 0 auto;
365
+ box-sizing: border-box;
366
+ }
367
+ .docs-header {
368
+ text-align: center;
369
+ margin-bottom: 3rem;
370
+ opacity: 0;
371
+ animation: fadeInUp 0.6s ease-out forwards;
372
+ }
373
+ .docs-header h1 {
374
+ font-size: 2.5rem;
375
+ margin: 0 0 1rem;
376
+ line-height: 1.2;
377
+ }
378
+ .docs-grid {
379
+ display: grid;
380
+ grid-template-columns: repeat(auto-fit, minmax(min(100%, 260px), 1fr));
381
+ gap: 1.5rem;
382
+ margin: 0;
383
+ padding: 0;
384
+ list-style: none;
385
+ }
386
+ .docs-card-container {
387
+ cursor: pointer;
388
+ opacity: 0;
389
+ animation: fadeInUp 0.6s ease-out forwards;
390
+ border-radius: 8px;
391
+ }
392
+ .docs-card-container:focus-visible {
393
+ outline: 2px solid currentColor;
394
+ outline-offset: 3px;
395
+ }
396
+ .docs-card {
397
+ border-radius: 8px;
398
+ padding: 1.5rem;
399
+ display: flex;
400
+ flex-direction: column;
401
+ height: 100%;
402
+ box-sizing: border-box;
403
+ transition:
404
+ transform 0.25s ease,
405
+ background 0.25s ease,
406
+ border-color 0.25s ease;
407
+ }
408
+ .docs-card-container:hover .docs-card,
409
+ .docs-card-container:focus-visible .docs-card {
410
+ transform: translateY(-4px);
411
+ }
412
+ .card-icon {
413
+ font-size: 1.75rem;
414
+ width: 56px;
415
+ height: 56px;
416
+ border-radius: 12px;
417
+ display: flex;
418
+ align-items: center;
419
+ justify-content: center;
420
+ margin: 0 0 1.25rem;
421
+ transition: transform 0.25s ease;
422
+ }
423
+ .docs-card-container:hover .card-icon {
424
+ transform: scale(1.08);
425
+ }
426
+ .card-content {
427
+ flex: 1;
428
+ }
429
+ .card-content h3 {
430
+ margin: 0 0 0.5rem;
431
+ font-size: 1.25rem;
432
+ font-weight: 600;
433
+ }
434
+ .card-content p {
435
+ margin: 0;
436
+ font-size: 0.95rem;
437
+ line-height: 1.5;
438
+ opacity: 0.85;
439
+ }
440
+ @media (prefers-reduced-motion: reduce) {
441
+ .docs-header,
442
+ .docs-card-container {
443
+ animation: none;
444
+ opacity: 1;
402
445
  }
403
- .card-content h3 {
404
- margin: 0 0 0.5rem;
405
- font-size: 1.25rem;
406
- font-weight: 600;
446
+ .docs-card,
447
+ .card-icon {
448
+ transition: none;
407
449
  }
408
- .card-content p {
409
- margin: 0;
410
- font-size: 0.95rem;
411
- transition: color 0.3s ease;
450
+ .docs-card-container:hover .docs-card,
451
+ .docs-card-container:hover .card-icon {
452
+ transform: none;
412
453
  }
413
- </style>
454
+ }
455
+ </style>
414
456
 
415
- <style>
416
- ${docsData
457
+ <style>
458
+ ${landingCards
459
+ .map(
460
+ (_, index) => css`
461
+ .docs-card-container:nth-child(${index + 1}) {
462
+ animation-delay: ${0.1 * (index + 1)}s;
463
+ }
464
+ `,
465
+ )
466
+ .join('')}
467
+ </style>
468
+
469
+ <div class="docs-landing">
470
+ <div class="docs-header">
471
+ <h1>Documentation</h1>
472
+ </div>
473
+
474
+ <ul class="docs-grid">
475
+ ${landingCards
417
476
  .map(
418
- (_, index) => css`
419
- .docs-card-container:nth-child(${index + 1}) {
420
- animation-delay: ${0.1 * (index + 1)}s;
421
- }
477
+ ({ id, icon, title, description }) => html`
478
+ <div
479
+ class="in docs-card-container docs-card-container-${id}"
480
+ role="link"
481
+ tabindex="0"
482
+ aria-label="${title}: ${description}"
483
+ >
484
+ <li class="docs-card box-content-border hover">
485
+ <div class="card-icon">
486
+ <i class="fas fa-${icon}" aria-hidden="true"></i>
487
+ </div>
488
+ <div class="card-content">
489
+ <h3>${title}</h3>
490
+ <p>${description}</p>
491
+ </div>
492
+ </li>
493
+ </div>
422
494
  `,
423
495
  )
424
496
  .join('')}
425
- </style>
426
-
427
- <div class="docs-landing">
428
- <div class="docs-header">
429
- <h1>Documentation</h1>
430
- <!--
431
- <div class="search-bar">
432
- <i class="fas fa-search"></i>
433
- <input type="text" placeholder="Search documentation..." id="docs-search">
434
- </div>
435
- -->
436
- </div>
437
-
438
- <ul class="docs-grid">
439
- ${docsData
440
- .map((item) => {
441
- setTimeout(() => {
442
- if (s(`.docs-card-container-${item.id}`)) {
443
- s(`.docs-card-container-${item.id}`).onclick = () => {
444
- if (item.id.match('demo')) {
445
- const demoData = Docs.Data.find((d) => d.type === 'demo');
446
- location.href = demoData
447
- ? demoData.url()
448
- : 'https://underpostnet.github.io/pwa-microservices-template-ghpkg/';
449
- } else if (item.id.match('api')) {
450
- if (s(`.btn-docs-api`)) s(`.btn-docs-api`).click();
451
- } else {
452
- if (s(`.btn-docs-src`)) s(`.btn-docs-src`).click();
453
- }
454
- };
455
- }
456
- });
457
- return html`
458
- <div class="in docs-card-container docs-card-container-${item.id}">
459
- <li class="docs-card">
460
- <div class="card-icon">
461
- <i class="fas fa-${item.icon}"></i>
462
- </div>
463
- <div class="card-content">
464
- <h3>${item.title}</h3>
465
- <p>${item.description}</p>
466
- </div>
467
- </li>
468
- </div>
469
- `;
470
- })
471
- .join('')}
472
- </ul>
473
- </div>
474
- `;
475
- }
497
+ </ul>
498
+ </div>
499
+ `;
476
500
  }
477
501
  }
478
502
  export { Docs };