@gtkx/cli 1.0.0 → 1.2.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 (458) hide show
  1. package/README.md +1 -1
  2. package/dist/builder.d.ts +1 -1
  3. package/dist/builder.d.ts.map +1 -1
  4. package/dist/builder.js +20 -3
  5. package/dist/builder.js.map +1 -1
  6. package/dist/cli.js +6 -2
  7. package/dist/cli.js.map +1 -1
  8. package/dist/codegen/freshness.js +2 -2
  9. package/dist/codegen/freshness.js.map +1 -1
  10. package/dist/codegen/report.d.ts.map +1 -1
  11. package/dist/codegen/report.js +3 -0
  12. package/dist/codegen/report.js.map +1 -1
  13. package/dist/codegen/run-codegen.d.ts +9 -5
  14. package/dist/codegen/run-codegen.d.ts.map +1 -1
  15. package/dist/codegen/run-codegen.js +31 -20
  16. package/dist/codegen/run-codegen.js.map +1 -1
  17. package/dist/codegen/store-resolver.d.ts +1 -1
  18. package/dist/codegen/store-resolver.d.ts.map +1 -1
  19. package/dist/codegen/store-resolver.js.map +1 -1
  20. package/dist/commands/build.d.ts.map +1 -1
  21. package/dist/commands/build.js +5 -6
  22. package/dist/commands/build.js.map +1 -1
  23. package/dist/commands/codegen.d.ts.map +1 -1
  24. package/dist/commands/codegen.js +11 -1
  25. package/dist/commands/codegen.js.map +1 -1
  26. package/dist/commands/deploy.d.ts +22 -0
  27. package/dist/commands/deploy.d.ts.map +1 -0
  28. package/dist/commands/deploy.js +44 -0
  29. package/dist/commands/deploy.js.map +1 -0
  30. package/dist/commands/dev.d.ts.map +1 -1
  31. package/dist/commands/dev.js +4 -4
  32. package/dist/commands/dev.js.map +1 -1
  33. package/dist/commands/docs.d.ts +2 -2
  34. package/dist/commands/docs.d.ts.map +1 -1
  35. package/dist/commands/docs.js +28 -4
  36. package/dist/commands/docs.js.map +1 -1
  37. package/dist/deploy/depends.d.ts +8 -0
  38. package/dist/deploy/depends.d.ts.map +1 -0
  39. package/dist/deploy/depends.js +27 -0
  40. package/dist/deploy/depends.js.map +1 -0
  41. package/dist/deploy/download.d.ts +20 -0
  42. package/dist/deploy/download.d.ts.map +1 -0
  43. package/dist/deploy/download.js +98 -0
  44. package/dist/deploy/download.js.map +1 -0
  45. package/dist/deploy/freedesktop/copyright.d.ts +4 -0
  46. package/dist/deploy/freedesktop/copyright.d.ts.map +1 -0
  47. package/dist/deploy/freedesktop/copyright.js +33 -0
  48. package/dist/deploy/freedesktop/copyright.js.map +1 -0
  49. package/dist/deploy/freedesktop/dbus-service.d.ts +4 -0
  50. package/dist/deploy/freedesktop/dbus-service.d.ts.map +1 -0
  51. package/dist/deploy/freedesktop/dbus-service.js +15 -0
  52. package/dist/deploy/freedesktop/dbus-service.js.map +1 -0
  53. package/dist/deploy/freedesktop/desktop-entry.d.ts +4 -0
  54. package/dist/deploy/freedesktop/desktop-entry.d.ts.map +1 -0
  55. package/dist/deploy/freedesktop/desktop-entry.js +73 -0
  56. package/dist/deploy/freedesktop/desktop-entry.js.map +1 -0
  57. package/dist/deploy/freedesktop/ini.d.ts +7 -0
  58. package/dist/deploy/freedesktop/ini.d.ts.map +1 -0
  59. package/dist/deploy/freedesktop/ini.js +22 -0
  60. package/dist/deploy/freedesktop/ini.js.map +1 -0
  61. package/dist/deploy/freedesktop/metainfo-sections.d.ts +13 -0
  62. package/dist/deploy/freedesktop/metainfo-sections.d.ts.map +1 -0
  63. package/dist/deploy/freedesktop/metainfo-sections.js +73 -0
  64. package/dist/deploy/freedesktop/metainfo-sections.js.map +1 -0
  65. package/dist/deploy/freedesktop/metainfo.d.ts +4 -0
  66. package/dist/deploy/freedesktop/metainfo.d.ts.map +1 -0
  67. package/dist/deploy/freedesktop/metainfo.js +29 -0
  68. package/dist/deploy/freedesktop/metainfo.js.map +1 -0
  69. package/dist/deploy/freedesktop/mime-package.d.ts +4 -0
  70. package/dist/deploy/freedesktop/mime-package.d.ts.map +1 -0
  71. package/dist/deploy/freedesktop/mime-package.js +16 -0
  72. package/dist/deploy/freedesktop/mime-package.js.map +1 -0
  73. package/dist/deploy/freedesktop/validate.d.ts +4 -0
  74. package/dist/deploy/freedesktop/validate.d.ts.map +1 -0
  75. package/dist/deploy/freedesktop/validate.js +81 -0
  76. package/dist/deploy/freedesktop/validate.js.map +1 -0
  77. package/dist/deploy/freedesktop/xml.d.ts +11 -0
  78. package/dist/deploy/freedesktop/xml.d.ts.map +1 -0
  79. package/dist/deploy/freedesktop/xml.js +33 -0
  80. package/dist/deploy/freedesktop/xml.js.map +1 -0
  81. package/dist/deploy/git.d.ts +4 -0
  82. package/dist/deploy/git.d.ts.map +1 -0
  83. package/dist/deploy/git.js +17 -0
  84. package/dist/deploy/git.js.map +1 -0
  85. package/dist/deploy/install-hints.d.ts +5 -0
  86. package/dist/deploy/install-hints.d.ts.map +1 -0
  87. package/dist/deploy/install-hints.js +88 -0
  88. package/dist/deploy/install-hints.js.map +1 -0
  89. package/dist/deploy/nfpm/config.d.ts +8 -0
  90. package/dist/deploy/nfpm/config.d.ts.map +1 -0
  91. package/dist/deploy/nfpm/config.js +119 -0
  92. package/dist/deploy/nfpm/config.js.map +1 -0
  93. package/dist/deploy/nfpm/contents.d.ts +12 -0
  94. package/dist/deploy/nfpm/contents.d.ts.map +1 -0
  95. package/dist/deploy/nfpm/contents.js +48 -0
  96. package/dist/deploy/nfpm/contents.js.map +1 -0
  97. package/dist/deploy/nfpm/description.d.ts +5 -0
  98. package/dist/deploy/nfpm/description.d.ts.map +1 -0
  99. package/dist/deploy/nfpm/description.js +5 -0
  100. package/dist/deploy/nfpm/description.js.map +1 -0
  101. package/dist/deploy/nfpm/optional.d.ts +5 -0
  102. package/dist/deploy/nfpm/optional.d.ts.map +1 -0
  103. package/dist/deploy/nfpm/optional.js +4 -0
  104. package/dist/deploy/nfpm/optional.js.map +1 -0
  105. package/dist/deploy/nfpm/pack.d.ts +5 -0
  106. package/dist/deploy/nfpm/pack.d.ts.map +1 -0
  107. package/dist/deploy/nfpm/pack.js +32 -0
  108. package/dist/deploy/nfpm/pack.js.map +1 -0
  109. package/dist/deploy/node-runtime/download.d.ts +3 -0
  110. package/dist/deploy/node-runtime/download.d.ts.map +1 -0
  111. package/dist/deploy/node-runtime/download.js +39 -0
  112. package/dist/deploy/node-runtime/download.js.map +1 -0
  113. package/dist/deploy/node-runtime/elf.d.ts +7 -0
  114. package/dist/deploy/node-runtime/elf.d.ts.map +1 -0
  115. package/dist/deploy/node-runtime/elf.js +100 -0
  116. package/dist/deploy/node-runtime/elf.js.map +1 -0
  117. package/dist/deploy/node-runtime/guard.d.ts +4 -0
  118. package/dist/deploy/node-runtime/guard.d.ts.map +1 -0
  119. package/dist/deploy/node-runtime/guard.js +22 -0
  120. package/dist/deploy/node-runtime/guard.js.map +1 -0
  121. package/dist/deploy/node-runtime/index.d.ts +4 -0
  122. package/dist/deploy/node-runtime/index.d.ts.map +1 -0
  123. package/dist/deploy/node-runtime/index.js +61 -0
  124. package/dist/deploy/node-runtime/index.js.map +1 -0
  125. package/dist/deploy/payload/copy-tree.d.ts +7 -0
  126. package/dist/deploy/payload/copy-tree.d.ts.map +1 -0
  127. package/dist/deploy/payload/copy-tree.js +36 -0
  128. package/dist/deploy/payload/copy-tree.js.map +1 -0
  129. package/dist/deploy/payload/icons.d.ts +6 -0
  130. package/dist/deploy/payload/icons.d.ts.map +1 -0
  131. package/dist/deploy/payload/icons.js +53 -0
  132. package/dist/deploy/payload/icons.js.map +1 -0
  133. package/dist/deploy/payload/launcher.d.ts +5 -0
  134. package/dist/deploy/payload/launcher.d.ts.map +1 -0
  135. package/dist/deploy/payload/launcher.js +22 -0
  136. package/dist/deploy/payload/launcher.js.map +1 -0
  137. package/dist/deploy/payload/schemas.d.ts +4 -0
  138. package/dist/deploy/payload/schemas.d.ts.map +1 -0
  139. package/dist/deploy/payload/schemas.js +17 -0
  140. package/dist/deploy/payload/schemas.js.map +1 -0
  141. package/dist/deploy/payload/stage.d.ts +15 -0
  142. package/dist/deploy/payload/stage.d.ts.map +1 -0
  143. package/dist/deploy/payload/stage.js +100 -0
  144. package/dist/deploy/payload/stage.js.map +1 -0
  145. package/dist/deploy/registry.d.ts +7 -0
  146. package/dist/deploy/registry.d.ts.map +1 -0
  147. package/dist/deploy/registry.js +30 -0
  148. package/dist/deploy/registry.js.map +1 -0
  149. package/dist/deploy/run-deploy.d.ts +11 -0
  150. package/dist/deploy/run-deploy.d.ts.map +1 -0
  151. package/dist/deploy/run-deploy.js +157 -0
  152. package/dist/deploy/run-deploy.js.map +1 -0
  153. package/dist/deploy/settings/arch.d.ts +4 -0
  154. package/dist/deploy/settings/arch.d.ts.map +1 -0
  155. package/dist/deploy/settings/arch.js +13 -0
  156. package/dist/deploy/settings/arch.js.map +1 -0
  157. package/dist/deploy/settings/categories.d.ts +4 -0
  158. package/dist/deploy/settings/categories.d.ts.map +1 -0
  159. package/dist/deploy/settings/categories.js +29 -0
  160. package/dist/deploy/settings/categories.js.map +1 -0
  161. package/dist/deploy/settings/exec.d.ts +6 -0
  162. package/dist/deploy/settings/exec.d.ts.map +1 -0
  163. package/dist/deploy/settings/exec.js +20 -0
  164. package/dist/deploy/settings/exec.js.map +1 -0
  165. package/dist/deploy/settings/identity.d.ts +18 -0
  166. package/dist/deploy/settings/identity.d.ts.map +1 -0
  167. package/dist/deploy/settings/identity.js +73 -0
  168. package/dist/deploy/settings/identity.js.map +1 -0
  169. package/dist/deploy/settings/index.d.ts +11 -0
  170. package/dist/deploy/settings/index.d.ts.map +1 -0
  171. package/dist/deploy/settings/index.js +103 -0
  172. package/dist/deploy/settings/index.js.map +1 -0
  173. package/dist/deploy/settings/package-manifest.d.ts +16 -0
  174. package/dist/deploy/settings/package-manifest.d.ts.map +1 -0
  175. package/dist/deploy/settings/package-manifest.js +42 -0
  176. package/dist/deploy/settings/package-manifest.js.map +1 -0
  177. package/dist/deploy/settings/paths.d.ts +9 -0
  178. package/dist/deploy/settings/paths.d.ts.map +1 -0
  179. package/dist/deploy/settings/paths.js +82 -0
  180. package/dist/deploy/settings/paths.js.map +1 -0
  181. package/dist/deploy/settings/screenshots.d.ts +8 -0
  182. package/dist/deploy/settings/screenshots.d.ts.map +1 -0
  183. package/dist/deploy/settings/screenshots.js +79 -0
  184. package/dist/deploy/settings/screenshots.js.map +1 -0
  185. package/dist/deploy/settings/starter.d.ts +4 -0
  186. package/dist/deploy/settings/starter.d.ts.map +1 -0
  187. package/dist/deploy/settings/starter.js +28 -0
  188. package/dist/deploy/settings/starter.js.map +1 -0
  189. package/dist/deploy/settings/version.d.ts +9 -0
  190. package/dist/deploy/settings/version.d.ts.map +1 -0
  191. package/dist/deploy/settings/version.js +37 -0
  192. package/dist/deploy/settings/version.js.map +1 -0
  193. package/dist/deploy/targets/appimage.d.ts +4 -0
  194. package/dist/deploy/targets/appimage.d.ts.map +1 -0
  195. package/dist/deploy/targets/appimage.js +105 -0
  196. package/dist/deploy/targets/appimage.js.map +1 -0
  197. package/dist/deploy/targets/deb.d.ts +4 -0
  198. package/dist/deploy/targets/deb.d.ts.map +1 -0
  199. package/dist/deploy/targets/deb.js +4 -0
  200. package/dist/deploy/targets/deb.js.map +1 -0
  201. package/dist/deploy/targets/flatpak-manifest.d.ts +6 -0
  202. package/dist/deploy/targets/flatpak-manifest.d.ts.map +1 -0
  203. package/dist/deploy/targets/flatpak-manifest.js +48 -0
  204. package/dist/deploy/targets/flatpak-manifest.js.map +1 -0
  205. package/dist/deploy/targets/flatpak-pnpm.d.ts +15 -0
  206. package/dist/deploy/targets/flatpak-pnpm.d.ts.map +1 -0
  207. package/dist/deploy/targets/flatpak-pnpm.js +69 -0
  208. package/dist/deploy/targets/flatpak-pnpm.js.map +1 -0
  209. package/dist/deploy/targets/flatpak-prebuilt.d.ts +8 -0
  210. package/dist/deploy/targets/flatpak-prebuilt.d.ts.map +1 -0
  211. package/dist/deploy/targets/flatpak-prebuilt.js +43 -0
  212. package/dist/deploy/targets/flatpak-prebuilt.js.map +1 -0
  213. package/dist/deploy/targets/flatpak-source.d.ts +5 -0
  214. package/dist/deploy/targets/flatpak-source.d.ts.map +1 -0
  215. package/dist/deploy/targets/flatpak-source.js +119 -0
  216. package/dist/deploy/targets/flatpak-source.js.map +1 -0
  217. package/dist/deploy/targets/flatpak-sources.d.ts +19 -0
  218. package/dist/deploy/targets/flatpak-sources.d.ts.map +1 -0
  219. package/dist/deploy/targets/flatpak-sources.js +122 -0
  220. package/dist/deploy/targets/flatpak-sources.js.map +1 -0
  221. package/dist/deploy/targets/flatpak.d.ts +4 -0
  222. package/dist/deploy/targets/flatpak.d.ts.map +1 -0
  223. package/dist/deploy/targets/flatpak.js +113 -0
  224. package/dist/deploy/targets/flatpak.js.map +1 -0
  225. package/dist/deploy/targets/nfpm-target.d.ts +5 -0
  226. package/dist/deploy/targets/nfpm-target.d.ts.map +1 -0
  227. package/dist/deploy/targets/nfpm-target.js +26 -0
  228. package/dist/deploy/targets/nfpm-target.js.map +1 -0
  229. package/dist/deploy/targets/rpm.d.ts +4 -0
  230. package/dist/deploy/targets/rpm.d.ts.map +1 -0
  231. package/dist/deploy/targets/rpm.js +4 -0
  232. package/dist/deploy/targets/rpm.js.map +1 -0
  233. package/dist/deploy/tools.d.ts +20 -0
  234. package/dist/deploy/tools.d.ts.map +1 -0
  235. package/dist/deploy/tools.js +106 -0
  236. package/dist/deploy/tools.js.map +1 -0
  237. package/dist/deploy/types.d.ts +140 -0
  238. package/dist/deploy/types.d.ts.map +1 -0
  239. package/dist/deploy/types.js +2 -0
  240. package/dist/deploy/types.js.map +1 -0
  241. package/dist/deploy/vendored/appimagetool.d.ts +7 -0
  242. package/dist/deploy/vendored/appimagetool.d.ts.map +1 -0
  243. package/dist/deploy/vendored/appimagetool.js +42 -0
  244. package/dist/deploy/vendored/appimagetool.js.map +1 -0
  245. package/dist/deploy/vendored/nfpm.d.ts +3 -0
  246. package/dist/deploy/vendored/nfpm.d.ts.map +1 -0
  247. package/dist/deploy/vendored/nfpm.js +60 -0
  248. package/dist/deploy/vendored/nfpm.js.map +1 -0
  249. package/dist/dev/change-queue.d.ts +11 -0
  250. package/dist/dev/change-queue.d.ts.map +1 -0
  251. package/dist/dev/change-queue.js +34 -0
  252. package/dist/dev/change-queue.js.map +1 -0
  253. package/dist/dev/failure-tracker.d.ts +10 -0
  254. package/dist/dev/failure-tracker.d.ts.map +1 -0
  255. package/dist/dev/failure-tracker.js +61 -0
  256. package/dist/dev/failure-tracker.js.map +1 -0
  257. package/dist/dev/missing-import.d.ts +4 -0
  258. package/dist/dev/missing-import.d.ts.map +1 -0
  259. package/dist/dev/missing-import.js +23 -0
  260. package/dist/dev/missing-import.js.map +1 -0
  261. package/dist/dev/runner-deps.d.ts.map +1 -1
  262. package/dist/dev/runner-deps.js +25 -6
  263. package/dist/dev/runner-deps.js.map +1 -1
  264. package/dist/dev/runner.d.ts +8 -4
  265. package/dist/dev/runner.d.ts.map +1 -1
  266. package/dist/dev/runner.js +334 -66
  267. package/dist/dev/runner.js.map +1 -1
  268. package/dist/dev/supervisor.d.ts +1 -2
  269. package/dist/dev/supervisor.d.ts.map +1 -1
  270. package/dist/dev/supervisor.js +1 -1
  271. package/dist/dev/supervisor.js.map +1 -1
  272. package/dist/dev/vite-dev-server.d.ts +13 -2
  273. package/dist/dev/vite-dev-server.d.ts.map +1 -1
  274. package/dist/dev/vite-dev-server.js +30 -2
  275. package/dist/dev/vite-dev-server.js.map +1 -1
  276. package/dist/internal/entry-arg.d.ts +1 -7
  277. package/dist/internal/entry-arg.d.ts.map +1 -1
  278. package/dist/internal/entry-arg.js +18 -11
  279. package/dist/internal/entry-arg.js.map +1 -1
  280. package/dist/internal/module-loads.d.ts +7 -0
  281. package/dist/internal/module-loads.d.ts.map +1 -0
  282. package/dist/internal/module-loads.js +21 -0
  283. package/dist/internal/module-loads.js.map +1 -0
  284. package/dist/internal/prepare-project.d.ts +16 -0
  285. package/dist/internal/prepare-project.d.ts.map +1 -0
  286. package/dist/internal/prepare-project.js +15 -0
  287. package/dist/internal/prepare-project.js.map +1 -0
  288. package/dist/internal/run-cli-tool.d.ts +2 -1
  289. package/dist/internal/run-cli-tool.d.ts.map +1 -1
  290. package/dist/internal/run-cli-tool.js +15 -6
  291. package/dist/internal/run-cli-tool.js.map +1 -1
  292. package/dist/internal/staging-dir.d.ts +8 -1
  293. package/dist/internal/staging-dir.d.ts.map +1 -1
  294. package/dist/internal/staging-dir.js +38 -2
  295. package/dist/internal/staging-dir.js.map +1 -1
  296. package/dist/mcp/serialize-widget.d.ts +2 -1
  297. package/dist/mcp/serialize-widget.d.ts.map +1 -1
  298. package/dist/mcp/serialize-widget.js +1 -1
  299. package/dist/mcp/serialize-widget.js.map +1 -1
  300. package/dist/mcp/testing-loader.d.ts +5 -2
  301. package/dist/mcp/testing-loader.d.ts.map +1 -1
  302. package/dist/mcp/testing-loader.js +7 -3
  303. package/dist/mcp/testing-loader.js.map +1 -1
  304. package/dist/refresh-runtime.d.ts +2 -1
  305. package/dist/refresh-runtime.d.ts.map +1 -1
  306. package/dist/refresh-runtime.js +32 -2
  307. package/dist/refresh-runtime.js.map +1 -1
  308. package/dist/settings/schema.d.ts +1 -2
  309. package/dist/settings/schema.d.ts.map +1 -1
  310. package/dist/settings/schema.js +1 -1
  311. package/dist/settings/schema.js.map +1 -1
  312. package/dist/vite-plugins/asset-extensions.d.ts +2 -1
  313. package/dist/vite-plugins/asset-extensions.d.ts.map +1 -1
  314. package/dist/vite-plugins/asset-extensions.js +2 -1
  315. package/dist/vite-plugins/asset-extensions.js.map +1 -1
  316. package/dist/vite-plugins/asset-imports.d.ts +4 -0
  317. package/dist/vite-plugins/asset-imports.d.ts.map +1 -0
  318. package/dist/vite-plugins/asset-imports.js +88 -0
  319. package/dist/vite-plugins/asset-imports.js.map +1 -0
  320. package/dist/vite-plugins/asset-specifier.d.ts +5 -0
  321. package/dist/vite-plugins/asset-specifier.d.ts.map +1 -0
  322. package/dist/vite-plugins/asset-specifier.js +7 -0
  323. package/dist/vite-plugins/asset-specifier.js.map +1 -0
  324. package/dist/vite-plugins/esm-extension.d.ts +4 -0
  325. package/dist/vite-plugins/esm-extension.d.ts.map +1 -0
  326. package/dist/vite-plugins/esm-extension.js +4 -0
  327. package/dist/vite-plugins/esm-extension.js.map +1 -0
  328. package/dist/vite-plugins/fast-refresh/swc-refresh.d.ts +1 -3
  329. package/dist/vite-plugins/fast-refresh/swc-refresh.d.ts.map +1 -1
  330. package/dist/vite-plugins/fast-refresh/swc-refresh.js +1 -1
  331. package/dist/vite-plugins/fast-refresh/swc-refresh.js.map +1 -1
  332. package/dist/vite-plugins/index.d.ts.map +1 -1
  333. package/dist/vite-plugins/index.js +4 -0
  334. package/dist/vite-plugins/index.js.map +1 -1
  335. package/dist/vite-plugins/resource-shared.d.ts +2 -1
  336. package/dist/vite-plugins/resource-shared.d.ts.map +1 -1
  337. package/dist/vite-plugins/resource-shared.js +2 -1
  338. package/dist/vite-plugins/resource-shared.js.map +1 -1
  339. package/dist/vite-plugins/resources.d.ts.map +1 -1
  340. package/dist/vite-plugins/resources.js +30 -29
  341. package/dist/vite-plugins/resources.js.map +1 -1
  342. package/dist/vite-plugins/self-contained.d.ts +4 -0
  343. package/dist/vite-plugins/self-contained.d.ts.map +1 -0
  344. package/dist/vite-plugins/self-contained.js +244 -0
  345. package/dist/vite-plugins/self-contained.js.map +1 -0
  346. package/dist/vite-plugins/settings.d.ts.map +1 -1
  347. package/dist/vite-plugins/settings.js +19 -40
  348. package/dist/vite-plugins/settings.js.map +1 -1
  349. package/dist/vite-plugins/store-links.d.ts +4 -0
  350. package/dist/vite-plugins/store-links.d.ts.map +1 -0
  351. package/dist/vite-plugins/store-links.js +19 -0
  352. package/dist/vite-plugins/store-links.js.map +1 -0
  353. package/dist/vite-plugins/undeclared-library.d.ts.map +1 -1
  354. package/dist/vite-plugins/undeclared-library.js +51 -12
  355. package/dist/vite-plugins/undeclared-library.js.map +1 -1
  356. package/dist/vite-plugins/worker.d.ts.map +1 -1
  357. package/dist/vite-plugins/worker.js +3 -1
  358. package/dist/vite-plugins/worker.js.map +1 -1
  359. package/env.d.ts +106 -25
  360. package/package.json +20 -13
  361. package/src/builder.ts +22 -4
  362. package/src/cli.ts +7 -2
  363. package/src/codegen/freshness.ts +2 -2
  364. package/src/codegen/report.ts +4 -0
  365. package/src/codegen/run-codegen.ts +48 -24
  366. package/src/codegen/store-resolver.ts +1 -1
  367. package/src/commands/build.ts +5 -6
  368. package/src/commands/codegen.ts +14 -1
  369. package/src/commands/deploy.ts +47 -0
  370. package/src/commands/dev.ts +4 -4
  371. package/src/commands/docs.ts +40 -4
  372. package/src/deploy/depends.ts +42 -0
  373. package/src/deploy/download.ts +148 -0
  374. package/src/deploy/freedesktop/copyright.ts +41 -0
  375. package/src/deploy/freedesktop/dbus-service.ts +19 -0
  376. package/src/deploy/freedesktop/desktop-entry.ts +102 -0
  377. package/src/deploy/freedesktop/ini.ts +39 -0
  378. package/src/deploy/freedesktop/metainfo-sections.ts +116 -0
  379. package/src/deploy/freedesktop/metainfo.ts +46 -0
  380. package/src/deploy/freedesktop/mime-package.ts +28 -0
  381. package/src/deploy/freedesktop/validate.ts +124 -0
  382. package/src/deploy/freedesktop/xml.ts +53 -0
  383. package/src/deploy/git.ts +20 -0
  384. package/src/deploy/install-hints.ts +111 -0
  385. package/src/deploy/nfpm/config.ts +153 -0
  386. package/src/deploy/nfpm/contents.ts +69 -0
  387. package/src/deploy/nfpm/description.ts +11 -0
  388. package/src/deploy/nfpm/optional.ts +8 -0
  389. package/src/deploy/nfpm/pack.ts +44 -0
  390. package/src/deploy/node-runtime/download.ts +48 -0
  391. package/src/deploy/node-runtime/elf.ts +145 -0
  392. package/src/deploy/node-runtime/guard.ts +29 -0
  393. package/src/deploy/node-runtime/index.ts +80 -0
  394. package/src/deploy/payload/copy-tree.ts +51 -0
  395. package/src/deploy/payload/icons.ts +80 -0
  396. package/src/deploy/payload/launcher.ts +27 -0
  397. package/src/deploy/payload/schemas.ts +27 -0
  398. package/src/deploy/payload/stage.ts +145 -0
  399. package/src/deploy/registry.ts +40 -0
  400. package/src/deploy/run-deploy.ts +241 -0
  401. package/src/deploy/settings/arch.ts +18 -0
  402. package/src/deploy/settings/categories.ts +39 -0
  403. package/src/deploy/settings/exec.ts +29 -0
  404. package/src/deploy/settings/identity.ts +133 -0
  405. package/src/deploy/settings/index.ts +189 -0
  406. package/src/deploy/settings/package-manifest.ts +68 -0
  407. package/src/deploy/settings/paths.ts +115 -0
  408. package/src/deploy/settings/screenshots.ts +125 -0
  409. package/src/deploy/settings/starter.ts +41 -0
  410. package/src/deploy/settings/version.ts +59 -0
  411. package/src/deploy/targets/appimage.ts +140 -0
  412. package/src/deploy/targets/deb.ts +6 -0
  413. package/src/deploy/targets/flatpak-manifest.ts +61 -0
  414. package/src/deploy/targets/flatpak-pnpm.ts +115 -0
  415. package/src/deploy/targets/flatpak-prebuilt.ts +59 -0
  416. package/src/deploy/targets/flatpak-source.ts +181 -0
  417. package/src/deploy/targets/flatpak-sources.ts +198 -0
  418. package/src/deploy/targets/flatpak.ts +144 -0
  419. package/src/deploy/targets/nfpm-target.ts +33 -0
  420. package/src/deploy/targets/rpm.ts +6 -0
  421. package/src/deploy/tools.ts +156 -0
  422. package/src/deploy/types.ts +174 -0
  423. package/src/deploy/vendored/appimagetool.ts +57 -0
  424. package/src/deploy/vendored/nfpm.ts +79 -0
  425. package/src/dev/change-queue.ts +59 -0
  426. package/src/dev/failure-tracker.ts +92 -0
  427. package/src/dev/missing-import.ts +32 -0
  428. package/src/dev/runner-deps.ts +34 -6
  429. package/src/dev/runner.ts +506 -102
  430. package/src/dev/supervisor.ts +0 -3
  431. package/src/dev/vite-dev-server.ts +54 -3
  432. package/src/internal/entry-arg.ts +25 -11
  433. package/src/internal/module-loads.ts +32 -0
  434. package/src/internal/prepare-project.ts +23 -0
  435. package/src/internal/run-cli-tool.ts +22 -6
  436. package/src/internal/staging-dir.ts +57 -2
  437. package/src/mcp/serialize-widget.ts +3 -2
  438. package/src/mcp/testing-loader.ts +19 -4
  439. package/src/refresh-runtime.ts +48 -2
  440. package/src/settings/schema.ts +0 -1
  441. package/src/vite-plugins/asset-extensions.ts +2 -1
  442. package/src/vite-plugins/asset-imports.ts +134 -0
  443. package/src/vite-plugins/asset-specifier.ts +9 -0
  444. package/src/vite-plugins/esm-extension.ts +4 -0
  445. package/src/vite-plugins/fast-refresh/swc-refresh.ts +1 -1
  446. package/src/vite-plugins/index.ts +4 -0
  447. package/src/vite-plugins/resource-shared.ts +2 -0
  448. package/src/vite-plugins/resources.ts +33 -33
  449. package/src/vite-plugins/self-contained.ts +352 -0
  450. package/src/vite-plugins/settings.ts +21 -48
  451. package/src/vite-plugins/store-links.ts +25 -0
  452. package/src/vite-plugins/undeclared-library.ts +74 -12
  453. package/src/vite-plugins/worker.ts +4 -1
  454. package/dist/internal.d.ts +0 -3
  455. package/dist/internal.d.ts.map +0 -1
  456. package/dist/internal.js +0 -3
  457. package/dist/internal.js.map +0 -1
  458. package/src/internal.ts +0 -2
@@ -0,0 +1,241 @@
1
+ import { loadConfig } from "@gtkx/config";
2
+ import { info, warn } from "@gtkx/utils";
3
+ import { mkdirSync, writeFileSync } from "node:fs";
4
+ import { dirname, join, relative } from "node:path";
5
+ import type {
6
+ DeployArtifact,
7
+ DeployManifest,
8
+ DeployPayload,
9
+ DeploySettings,
10
+ DeployTarget,
11
+ DeployTool,
12
+ } from "./types.js";
13
+ import { build as buildApp } from "../builder.js";
14
+ import { ensureGenerated } from "../codegen/run-codegen.js";
15
+ import { renderDesktopEntry } from "./freedesktop/desktop-entry.js";
16
+ import { renderMetainfo } from "./freedesktop/metainfo.js";
17
+ import { renderMimePackage } from "./freedesktop/mime-package.js";
18
+ import { validateDesktopEntry, validateMetainfo } from "./freedesktop/validate.js";
19
+ import { resolveNodeRuntime } from "./node-runtime/index.js";
20
+ import { type StagedMetadata, stageOverlays, stagePayload } from "./payload/stage.js";
21
+ import { DEFAULT_TARGETS, parseTargetList, targetsFor } from "./registry.js";
22
+ import { resolveDeploySettings } from "./settings/index.js";
23
+ import { readPackageManifest } from "./settings/package-manifest.js";
24
+ import { missingDeployError } from "./settings/starter.js";
25
+ import { detectPackageManager } from "./targets/flatpak-sources.js";
26
+ import {
27
+ APPSTREAMCLI,
28
+ assertTools,
29
+ DESKTOP_FILE_VALIDATE,
30
+ FLATPAK_NODE_GENERATOR,
31
+ FLATPAK_NODE_GENERATOR_PNPM,
32
+ probeTools,
33
+ STRIP,
34
+ TAR,
35
+ warnMissingOptional,
36
+ } from "./tools.js";
37
+
38
+ type DeployOptions = {
39
+ entry: string;
40
+ cwd: string;
41
+ targets?: string | undefined;
42
+ outDir?: string | undefined;
43
+ shouldPrintManifests: boolean;
44
+ shouldSkipBuild: boolean;
45
+ };
46
+
47
+ const BUILD_MODE = "production";
48
+ const BYTES_PER_MIB = 1024 * 1024;
49
+ const WEBKIT_LIBRARY = "WebKit-6.0";
50
+ const NETWORK_ARG = "--share=network";
51
+
52
+ const displayPath = (settings: DeploySettings, path: string): string => relative(settings.paths.root, path);
53
+ const megabytes = (size: number): string => (size / BYTES_PER_MIB).toFixed(1);
54
+
55
+ const writeManifest = (manifest: DeployManifest): void => {
56
+ mkdirSync(dirname(manifest.path), { recursive: true });
57
+ writeFileSync(manifest.path, manifest.contents);
58
+ };
59
+
60
+ const renderMetadata = (settings: DeploySettings): StagedMetadata => ({
61
+ desktopEntry: renderDesktopEntry(settings),
62
+ metainfo: renderMetainfo(settings),
63
+ mimePackage: renderMimePackage(settings),
64
+ });
65
+
66
+ const isFlathubSubmission = (settings: DeploySettings, targets: DeployTarget[]): boolean =>
67
+ settings.deploy.flatpak?.mode === "source" && targets.some((target) => target.name === "flatpak");
68
+
69
+ const validateMetadata = (settings: DeploySettings, metadata: StagedMetadata, areWarningsFatal: boolean): void => {
70
+ const dir = settings.paths.metadata;
71
+ mkdirSync(dir, { recursive: true });
72
+ const desktopPath = join(dir, `${settings.applicationId}.desktop`);
73
+ const metainfoPath = join(dir, `${settings.applicationId}.metainfo.xml`);
74
+ writeFileSync(desktopPath, metadata.desktopEntry);
75
+ writeFileSync(metainfoPath, metadata.metainfo);
76
+ validateDesktopEntry(desktopPath);
77
+ validateMetainfo(metainfoPath, areWarningsFatal);
78
+ info("Validated the desktop entry and the metainfo");
79
+ };
80
+
81
+ const warnMissingNetwork = (settings: DeploySettings): void => {
82
+ const finishArgs = settings.deploy.flatpak?.finishArgs;
83
+
84
+ if (finishArgs === undefined || finishArgs.includes(NETWORK_ARG)) {
85
+ return;
86
+ }
87
+
88
+ if (!settings.libraries.includes(WEBKIT_LIBRARY)) {
89
+ return;
90
+ }
91
+
92
+ warn(`This app declares ${WEBKIT_LIBRARY} but its flatpak permissions omit ${NETWORK_ARG}, so pages will not load`);
93
+ };
94
+
95
+ const sourceModeTools = (targets: DeployTarget[], settings: DeploySettings): DeployTool[] => {
96
+ const isFlatpakSource = settings.deploy.flatpak?.mode === "source";
97
+
98
+ if (!isFlatpakSource || targets.every((target) => target.name !== "flatpak")) {
99
+ return [];
100
+ }
101
+
102
+ return detectPackageManager(settings) === "pnpm" ? [FLATPAK_NODE_GENERATOR_PNPM] : [FLATPAK_NODE_GENERATOR];
103
+ };
104
+
105
+ const isNodeRequired = (targets: DeployTarget[], settings: DeploySettings): boolean =>
106
+ !(settings.deploy.flatpak?.mode === "source" && targets.every((target) => target.name === "flatpak"));
107
+
108
+ const runtimeToolsFor = (targets: DeployTarget[], settings: DeploySettings): DeployTool[] => {
109
+ if (!isNodeRequired(targets, settings)) {
110
+ return [];
111
+ }
112
+
113
+ const node = settings.deploy.node ?? {};
114
+ const archiveTools = (node.source ?? "download") === "download" ? [TAR] : [];
115
+
116
+ return node.shouldStrip === false ? archiveTools : [...archiveTools, STRIP];
117
+ };
118
+
119
+ const preflight = (targets: DeployTarget[], settings: DeploySettings, shouldPrintManifests: boolean): void => {
120
+ const packagerTools = shouldPrintManifests
121
+ ? []
122
+ : [...runtimeToolsFor(targets, settings), ...targets.flatMap((target) => target.tools)];
123
+
124
+ const required = [DESKTOP_FILE_VALIDATE, APPSTREAMCLI, ...sourceModeTools(targets, settings)];
125
+ const report = probeTools([...required, ...packagerTools]);
126
+ assertTools(report);
127
+ warnMissingOptional(report);
128
+ warnMissingNetwork(settings);
129
+ };
130
+
131
+ const resolveTargetNames = (options: DeployOptions, settings: DeploySettings): string[] => {
132
+ if (options.targets !== undefined) {
133
+ return parseTargetList(options.targets);
134
+ }
135
+
136
+ return settings.deploy.targets ?? DEFAULT_TARGETS;
137
+ };
138
+
139
+ const loadSettings = async (options: DeployOptions): Promise<DeploySettings> => {
140
+ const { config, root } = await loadConfig(options.cwd, { mode: BUILD_MODE });
141
+
142
+ if (config.deploy === undefined) {
143
+ throw missingDeployError(config.applicationId, readPackageManifest(root));
144
+ }
145
+
146
+ return resolveDeploySettings({ root, config, outDirOverride: options.outDir });
147
+ };
148
+
149
+ const buildPayload = async (
150
+ options: DeployOptions,
151
+ settings: DeploySettings,
152
+ targets: DeployTarget[],
153
+ ): Promise<DeployPayload> => {
154
+ const metadata = renderMetadata(settings);
155
+ validateMetadata(settings, metadata, isFlathubSubmission(settings, targets));
156
+
157
+ if (!options.shouldSkipBuild) {
158
+ info(`Building ${options.entry}`);
159
+ await buildApp({ entry: options.entry, vite: { root: options.cwd } });
160
+ }
161
+
162
+ const node = options.shouldPrintManifests || !isNodeRequired(targets, settings)
163
+ ? null
164
+ : await resolveNodeRuntime(settings);
165
+
166
+ const stage = stagePayload({ settings, node, metadata });
167
+ info(`Staged ${String(stage.length)} files into ${displayPath(settings, settings.paths.stage)}`);
168
+
169
+ return { settings, node, stage, overlays: stageOverlays(settings) };
170
+ };
171
+
172
+ const renderTargetManifests = (
173
+ targets: DeployTarget[],
174
+ payload: DeployPayload,
175
+ ): Map<DeployTarget, DeployManifest[]> => {
176
+ const rendered: Map<DeployTarget, DeployManifest[]> = new Map();
177
+
178
+ for (const target of targets) {
179
+ const manifests = target.render(payload);
180
+
181
+ for (const manifest of manifests) {
182
+ writeManifest(manifest);
183
+ info(`Wrote ${displayPath(payload.settings, manifest.path)}`);
184
+ }
185
+
186
+ rendered.set(target, manifests);
187
+ }
188
+
189
+ return rendered;
190
+ };
191
+
192
+ const packTargets = async (
193
+ rendered: Map<DeployTarget, DeployManifest[]>,
194
+ payload: DeployPayload,
195
+ ): Promise<DeployArtifact[]> => {
196
+ const artifacts: DeployArtifact[] = [];
197
+
198
+ for (const [target, manifests] of rendered) {
199
+ const built = await target.pack(payload, manifests);
200
+
201
+ for (const artifact of built) {
202
+ info(`Built ${displayPath(payload.settings, artifact.path)} (${megabytes(artifact.size)} MiB)`);
203
+ }
204
+
205
+ artifacts.push(...built);
206
+ }
207
+
208
+ return artifacts;
209
+ };
210
+
211
+ const announce = (settings: DeploySettings, targets: DeployTarget[]): void => {
212
+ const names = targets.map((target) => target.name).join(", ");
213
+ const version = `${settings.versions.packageVersion}-${settings.versions.debRevision}`;
214
+ info(`Deploying ${settings.name} ${version} as ${settings.binaryName} (${settings.arch.rpm}) to ${names}`);
215
+ };
216
+
217
+ const runDeploy = async (options: DeployOptions): Promise<void> => {
218
+ if (!options.shouldSkipBuild) {
219
+ await ensureGenerated(options.cwd, { shouldAnnounce: true, mode: BUILD_MODE });
220
+ }
221
+
222
+ const settings = await loadSettings(options);
223
+ const targets = targetsFor(resolveTargetNames(options, settings));
224
+ announce(settings, targets);
225
+ preflight(targets, settings, options.shouldPrintManifests);
226
+ const payload = await buildPayload(options, settings, targets);
227
+ const rendered = renderTargetManifests(targets, payload);
228
+
229
+ if (options.shouldPrintManifests) {
230
+ const count = rendered.values().toArray().flat().length;
231
+ info(`Wrote ${String(count)} manifests, 0 packages built`);
232
+
233
+ return;
234
+ }
235
+
236
+ const artifacts = await packTargets(rendered, payload);
237
+ const output = displayPath(settings, settings.paths.output);
238
+ info(`Deploy complete: ${String(artifacts.length)} artifacts in ${output}`);
239
+ };
240
+
241
+ export { runDeploy };
@@ -0,0 +1,18 @@
1
+ import type { DeployArch } from "../types.js";
2
+
3
+ const ARCH_TABLE: Record<string, DeployArch> = {
4
+ arm64: { deb: "arm64", rpm: "aarch64", flatpak: "aarch64", appimage: "aarch64", node: "arm64" },
5
+ x64: { deb: "amd64", rpm: "x86_64", flatpak: "x86_64", appimage: "x86_64", node: "x64" },
6
+ };
7
+
8
+ const resolveArch = (arch: string = process.arch): DeployArch => {
9
+ const resolved = ARCH_TABLE[arch];
10
+
11
+ if (resolved === undefined) {
12
+ throw new Error(`Cannot deploy for ${arch}: only ${Object.keys(ARCH_TABLE).join(" and ")} are supported`);
13
+ }
14
+
15
+ return resolved;
16
+ };
17
+
18
+ export { resolveArch };
@@ -0,0 +1,39 @@
1
+ type CategoryMapping = {
2
+ section: string;
3
+ group: string;
4
+ };
5
+
6
+ const DEFAULT_MAPPING: CategoryMapping = { section: "misc", group: "Applications/System" };
7
+
8
+ const MAPPING_BY_CATEGORY: Record<string, CategoryMapping> = {
9
+ Audio: { section: "sound", group: "Applications/Multimedia" },
10
+ AudioVideo: { section: "sound", group: "Applications/Multimedia" },
11
+ Development: { section: "devel", group: "Development/Tools" },
12
+ Education: { section: "education", group: "Applications/Education" },
13
+ Game: { section: "games", group: "Amusements/Games" },
14
+ Graphics: { section: "graphics", group: "Applications/Multimedia" },
15
+ Network: { section: "net", group: "Applications/Internet" },
16
+ Office: { section: "gnome", group: "Applications/Productivity" },
17
+ Science: { section: "science", group: "Applications/Engineering" },
18
+ Settings: { section: "gnome", group: "Applications/System" },
19
+ System: { section: "admin", group: "Applications/System" },
20
+ Utility: { section: "utils", group: "Applications/Utilities" },
21
+ Video: { section: "video", group: "Applications/Multimedia" },
22
+ };
23
+
24
+ const mappingForCategories = (categories: string[]): CategoryMapping => {
25
+ for (const category of categories) {
26
+ const mapping = MAPPING_BY_CATEGORY[category];
27
+
28
+ if (mapping !== undefined) {
29
+ return mapping;
30
+ }
31
+ }
32
+
33
+ return DEFAULT_MAPPING;
34
+ };
35
+
36
+ const sectionForCategories = (categories: string[]): string => mappingForCategories(categories).section;
37
+ const groupForCategories = (categories: string[]): string => mappingForCategories(categories).group;
38
+
39
+ export { groupForCategories, sectionForCategories };
@@ -0,0 +1,29 @@
1
+ import type { DeployConfig, DeployFileAssociation } from "../types.js";
2
+
3
+ const SCHEME_HANDLER_PREFIX = "x-scheme-handler/";
4
+
5
+ const resolveFileAssociations = (deploy: DeployConfig): DeployFileAssociation[] =>
6
+ (deploy.fileAssociations ?? []).map((entry) => ({
7
+ extension: entry.extension,
8
+ mimeType: entry.mimeType,
9
+ description: entry.description ?? null,
10
+ }));
11
+
12
+ const resolveMimeTypes = (deploy: DeployConfig): string[] => {
13
+ const fromAssociations = (deploy.fileAssociations ?? []).map((entry) => entry.mimeType);
14
+ const fromProtocols = (deploy.protocols ?? []).map((scheme) => `${SCHEME_HANDLER_PREFIX}${scheme}`);
15
+
16
+ return [...new Set([...(deploy.mimeTypes ?? []), ...fromAssociations, ...fromProtocols])];
17
+ };
18
+
19
+ const resolveExecToken = (deploy: DeployConfig): string | null => {
20
+ const mimeTypes = resolveMimeTypes(deploy);
21
+
22
+ if (mimeTypes.length === 0) {
23
+ return null;
24
+ }
25
+
26
+ return mimeTypes.some((mimeType) => mimeType.startsWith(SCHEME_HANDLER_PREFIX)) ? "%U" : "%F";
27
+ };
28
+
29
+ export { resolveExecToken, resolveFileAssociations, resolveMimeTypes };
@@ -0,0 +1,133 @@
1
+ import type { DeployConfig, DeployDeveloper } from "../types.js";
2
+ import type { PackageManifest } from "./package-manifest.js";
3
+
4
+ type IdentityRequest = {
5
+ applicationId: string;
6
+ deploy: DeployConfig;
7
+ manifest: PackageManifest;
8
+ };
9
+
10
+ const DEFAULT_METADATA_LICENSE = "CC0-1.0";
11
+ const NAME_SEPARATORS = /[_-]+/;
12
+ const NON_NAME_CHARACTERS = /[^a-z\d]+/;
13
+ const SCOPE_PREFIX = /^@[^/]+\//;
14
+ const BINARY_NAME_PATTERN = /^[a-z\d][a-z\d+.-]+$/;
15
+
16
+ const lastSegment = (applicationId: string): string => applicationId.split(".").at(-1) ?? applicationId;
17
+
18
+ const titleCase = (value: string): string =>
19
+ value
20
+ .split(NAME_SEPARATORS)
21
+ .filter((word) => word.length > 0)
22
+ .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
23
+ .join(" ");
24
+
25
+ const normalizePackageName = (value: string): string =>
26
+ value
27
+ .replace(SCOPE_PREFIX, "")
28
+ .toLowerCase()
29
+ .split(NON_NAME_CHARACTERS)
30
+ .filter((part) => part.length > 0)
31
+ .join("-");
32
+
33
+ const resolveBinaryName = ({ applicationId, deploy, manifest }: IdentityRequest): string => {
34
+ const configured = deploy.binaryName;
35
+ const derived = normalizePackageName(configured ?? manifest.name ?? lastSegment(applicationId));
36
+
37
+ if (!BINARY_NAME_PATTERN.test(derived)) {
38
+ throw new Error(
39
+ `Cannot use "${derived}" as a package name: it must match ${String(BINARY_NAME_PATTERN)}. ` +
40
+ "Set `deploy.binaryName`.",
41
+ );
42
+ }
43
+
44
+ return derived;
45
+ };
46
+
47
+ const resolveName = ({ applicationId, deploy, manifest }: IdentityRequest): string =>
48
+ deploy.name ?? titleCase(manifest.name?.replace(SCOPE_PREFIX, "") ?? lastSegment(applicationId));
49
+
50
+ const resolveSummary = ({ deploy, manifest }: IdentityRequest): string => {
51
+ const summary = deploy.summary ?? manifest.description?.split("\n", 1)[0];
52
+
53
+ if (summary === undefined) {
54
+ throw new Error(
55
+ "Cannot deploy without a summary: set `deploy.summary` in gtkx.config.ts, " +
56
+ "or `description` in package.json.",
57
+ );
58
+ }
59
+
60
+ return summary;
61
+ };
62
+
63
+ const resolveDescription = (request: IdentityRequest): string[] => {
64
+ const configured = request.deploy.description;
65
+
66
+ return configured === undefined || configured.length === 0 ? [resolveSummary(request)] : configured;
67
+ };
68
+
69
+ const resolveDeveloperId = (applicationId: string): string | null => {
70
+ const segments = applicationId.split(".");
71
+
72
+ return segments.length > 2 ? segments.slice(0, -1).join(".") : null;
73
+ };
74
+
75
+ const resolveDeveloper = ({ applicationId, deploy, manifest }: IdentityRequest): DeployDeveloper => {
76
+ const name = deploy.developer?.name ?? manifest.author.name;
77
+
78
+ if (name === null) {
79
+ throw new Error(
80
+ "Cannot deploy without a developer: set `deploy.developer.name` in gtkx.config.ts, " +
81
+ "or `author` in package.json.",
82
+ );
83
+ }
84
+
85
+ return {
86
+ id: deploy.developer?.id ?? resolveDeveloperId(applicationId),
87
+ name,
88
+ email: deploy.developer?.email ?? manifest.author.email,
89
+ };
90
+ };
91
+
92
+ const resolveLicense = ({ deploy, manifest }: IdentityRequest): string => {
93
+ const license = deploy.license ?? manifest.license;
94
+
95
+ if (license === null) {
96
+ throw new Error(
97
+ "Cannot deploy without a license: set `deploy.license` in gtkx.config.ts, or `license` in package.json.",
98
+ );
99
+ }
100
+
101
+ return license;
102
+ };
103
+
104
+ const resolveVersionString = ({ deploy, manifest }: IdentityRequest): string => {
105
+ const version = deploy.version ?? manifest.version;
106
+
107
+ if (version === null) {
108
+ throw new Error(
109
+ "Cannot deploy without a version: set `deploy.version` in gtkx.config.ts, or `version` in package.json.",
110
+ );
111
+ }
112
+
113
+ return version;
114
+ };
115
+
116
+ const resolveCopyright = (request: IdentityRequest, developer: DeployDeveloper, year: number): string =>
117
+ request.deploy.copyright ?? `Copyright © ${String(year)} ${developer.name}`;
118
+
119
+ const resolveMetadataLicense = ({ deploy }: IdentityRequest): string =>
120
+ deploy.metadataLicense ?? DEFAULT_METADATA_LICENSE;
121
+
122
+ export {
123
+ type IdentityRequest,
124
+ resolveBinaryName,
125
+ resolveCopyright,
126
+ resolveDescription,
127
+ resolveDeveloper,
128
+ resolveLicense,
129
+ resolveMetadataLicense,
130
+ resolveName,
131
+ resolveSummary,
132
+ resolveVersionString,
133
+ };
@@ -0,0 +1,189 @@
1
+ import type { Config } from "@gtkx/config";
2
+ import type {
3
+ DeployConfig,
4
+ DeployDesktopAction,
5
+ DeployDeveloper,
6
+ DeployRelease,
7
+ DeploySettings,
8
+ DeployVersions,
9
+ } from "../types.js";
10
+ import { resolveArch } from "./arch.js";
11
+ import { resolveExecToken, resolveFileAssociations, resolveMimeTypes } from "./exec.js";
12
+ import {
13
+ type IdentityRequest,
14
+ resolveBinaryName,
15
+ resolveCopyright,
16
+ resolveDescription,
17
+ resolveDeveloper,
18
+ resolveLicense,
19
+ resolveMetadataLicense,
20
+ resolveName,
21
+ resolveSummary,
22
+ resolveVersionString,
23
+ } from "./identity.js";
24
+ import { readPackageManifest } from "./package-manifest.js";
25
+ import { resolvePaths } from "./paths.js";
26
+ import { resolveScreenshots } from "./screenshots.js";
27
+ import { resolveVersions } from "./version.js";
28
+
29
+ type SettingsRequest = {
30
+ root: string;
31
+ config: Config;
32
+ outDirOverride?: string | undefined;
33
+ now?: Date | undefined;
34
+ };
35
+
36
+ type ResolvedCore = {
37
+ identity: IdentityRequest;
38
+ developer: DeployDeveloper;
39
+ versions: DeployVersions;
40
+ date: string;
41
+ };
42
+
43
+ type IdentitySlice = Pick<
44
+ DeploySettings,
45
+ | "applicationId" |
46
+ "binaryName" |
47
+ "copyright" |
48
+ "description" |
49
+ "developer" |
50
+ "genericName" |
51
+ "homepage" |
52
+ "license" |
53
+ "metadataLicense" |
54
+ "name" |
55
+ "summary"
56
+ >;
57
+
58
+ type MetadataSlice = Pick<
59
+ DeploySettings,
60
+ "branding" | "categories" | "contentRating" | "keywords" | "mimeTypes" | "releases" | "screenshots" | "urls"
61
+ >;
62
+
63
+ type DesktopSlice = Pick<
64
+ DeploySettings,
65
+ | "desktopActions" |
66
+ "desktopEntry" |
67
+ "execArgs" |
68
+ "execToken" |
69
+ "fileAssociations" |
70
+ "isDbusActivatable" |
71
+ "protocols"
72
+ >;
73
+
74
+ const ISO_DATE_LENGTH = 10;
75
+ const MILLISECONDS_PER_SECOND = 1000;
76
+
77
+ const reproducibleDate = (epoch: string | undefined): Date | null => {
78
+ if (epoch === undefined || epoch.trim().length === 0) {
79
+ return null;
80
+ }
81
+
82
+ const seconds = Number(epoch);
83
+
84
+ return Number.isFinite(seconds) ? new Date(seconds * MILLISECONDS_PER_SECOND) : null;
85
+ };
86
+
87
+ const buildDate = (now: Date): string => {
88
+ const stamp = reproducibleDate(process.env.SOURCE_DATE_EPOCH) ?? now;
89
+
90
+ return stamp.toISOString().slice(0, ISO_DATE_LENGTH);
91
+ };
92
+
93
+ const newestFirst = (a: DeployRelease, b: DeployRelease): number => Number(a.date < b.date) - Number(a.date > b.date);
94
+
95
+ const resolveReleases = (deploy: DeployConfig, version: string, date: string): DeployRelease[] =>
96
+ (deploy.releases ?? [{ version, date }])
97
+ .map((entry) => ({
98
+ version: entry.version,
99
+ date: entry.date,
100
+ type: entry.type ?? null,
101
+ urgency: entry.urgency ?? null,
102
+ notes: entry.notes ?? [],
103
+ url: entry.url ?? null,
104
+ }))
105
+ .toSorted(newestFirst);
106
+
107
+ const resolveDesktopActions = (deploy: DeployConfig): DeployDesktopAction[] =>
108
+ Object.entries(deploy.desktopActions ?? {}).map(([id, action]) => ({
109
+ id,
110
+ name: action.name,
111
+ args: action.args ?? [],
112
+ icon: action.icon ?? null,
113
+ }));
114
+
115
+ const resolveLibraries = (config: Config): string[] => (Array.isArray(config.libraries) ? config.libraries : []);
116
+
117
+ const identitySlice = ({ identity, developer, date }: ResolvedCore): IdentitySlice => ({
118
+ applicationId: identity.applicationId,
119
+ binaryName: resolveBinaryName(identity),
120
+ name: resolveName(identity),
121
+ genericName: identity.deploy.genericName ?? null,
122
+ summary: resolveSummary(identity),
123
+ description: resolveDescription(identity),
124
+ developer,
125
+ license: resolveLicense(identity),
126
+ metadataLicense: resolveMetadataLicense(identity),
127
+ copyright: resolveCopyright(identity, developer, new Date(date).getUTCFullYear()),
128
+ homepage: identity.deploy.homepage ?? identity.manifest.homepage,
129
+ });
130
+
131
+ const metadataSlice = (root: string, { identity, versions, date }: ResolvedCore): MetadataSlice => {
132
+ const deploy = identity.deploy;
133
+
134
+ return {
135
+ keywords: deploy.keywords ?? [],
136
+ categories: deploy.categories ?? [],
137
+ mimeTypes: resolveMimeTypes(deploy),
138
+ urls: deploy.urls ?? {},
139
+ screenshots: resolveScreenshots({ root, deploy }),
140
+ branding: deploy.branding ?? null,
141
+ contentRating: deploy.contentRating ?? {},
142
+ releases: resolveReleases(deploy, versions.packageVersion, date),
143
+ };
144
+ };
145
+
146
+ const desktopSlice = (deploy: DeployConfig): DesktopSlice => ({
147
+ execArgs: deploy.execArgs ?? [],
148
+ execToken: resolveExecToken(deploy),
149
+ fileAssociations: resolveFileAssociations(deploy),
150
+ protocols: deploy.protocols ?? [],
151
+ desktopActions: resolveDesktopActions(deploy),
152
+ desktopEntry: deploy.desktopEntry ?? {},
153
+ isDbusActivatable: deploy.isDbusActivatable ?? false,
154
+ });
155
+
156
+ const resolveCore = (request: SettingsRequest): ResolvedCore => {
157
+ const identity: IdentityRequest = {
158
+ applicationId: request.config.applicationId,
159
+ deploy: request.config.deploy ?? {},
160
+ manifest: readPackageManifest(request.root),
161
+ };
162
+
163
+ const versions = resolveVersions({
164
+ version: resolveVersionString(identity),
165
+ release: identity.deploy.release,
166
+ epoch: identity.deploy.epoch,
167
+ });
168
+
169
+ return { identity, developer: resolveDeveloper(identity), versions, date: buildDate(request.now ?? new Date()) };
170
+ };
171
+
172
+ const resolveDeploySettings = (request: SettingsRequest): DeploySettings => {
173
+ const core = resolveCore(request);
174
+ const deploy = core.identity.deploy;
175
+
176
+ return {
177
+ ...identitySlice(core),
178
+ ...metadataSlice(request.root, core),
179
+ ...desktopSlice(deploy),
180
+ extraFiles: deploy.extraFiles ?? {},
181
+ versions: core.versions,
182
+ arch: resolveArch(),
183
+ paths: resolvePaths({ root: request.root, deploy, outDirOverride: request.outDirOverride }),
184
+ libraries: resolveLibraries(request.config),
185
+ deploy,
186
+ };
187
+ };
188
+
189
+ export { resolveDeploySettings };