app-builder-lib 27.0.0-alpha.0 → 27.0.0-alpha.10

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/dist/Framework.d.ts +2 -0
  2. package/dist/Framework.d.ts.map +1 -1
  3. package/dist/Framework.js.map +1 -1
  4. package/dist/appInfo.d.ts +1 -1
  5. package/dist/appInfo.d.ts.map +1 -1
  6. package/dist/appInfo.js +3 -3
  7. package/dist/appInfo.js.map +1 -1
  8. package/dist/asar/asar.js +1 -1
  9. package/dist/asar/asar.js.map +1 -1
  10. package/dist/asar/asarFileChecker.d.ts +4 -2
  11. package/dist/asar/asarFileChecker.d.ts.map +1 -1
  12. package/dist/asar/asarFileChecker.js +2 -3
  13. package/dist/asar/asarFileChecker.js.map +1 -1
  14. package/dist/asar/asarUtil.js +21 -11
  15. package/dist/asar/asarUtil.js.map +1 -1
  16. package/dist/codeSign/certInfo.d.ts +14 -0
  17. package/dist/codeSign/certInfo.d.ts.map +1 -1
  18. package/dist/codeSign/certInfo.js +49 -0
  19. package/dist/codeSign/certInfo.js.map +1 -1
  20. package/dist/codeSign/mac/macCodeSign.d.ts +3 -3
  21. package/dist/codeSign/mac/macCodeSign.d.ts.map +1 -1
  22. package/dist/codeSign/mac/macCodeSign.js +50 -25
  23. package/dist/codeSign/mac/macCodeSign.js.map +1 -1
  24. package/dist/codeSign/signResult.d.ts +26 -0
  25. package/dist/codeSign/signResult.d.ts.map +1 -0
  26. package/dist/codeSign/signResult.js +12 -0
  27. package/dist/codeSign/signResult.js.map +1 -0
  28. package/dist/codeSign/win/hsmSignManager.d.ts +10 -0
  29. package/dist/codeSign/win/hsmSignManager.d.ts.map +1 -0
  30. package/dist/codeSign/win/hsmSignManager.js +50 -0
  31. package/dist/codeSign/win/hsmSignManager.js.map +1 -0
  32. package/dist/codeSign/win/pkcs11SignManager.d.ts +14 -0
  33. package/dist/codeSign/win/pkcs11SignManager.d.ts.map +1 -0
  34. package/dist/codeSign/win/pkcs11SignManager.js +82 -0
  35. package/dist/codeSign/win/pkcs11SignManager.js.map +1 -0
  36. package/dist/codeSign/win/signManager.d.ts +17 -0
  37. package/dist/codeSign/win/signManager.d.ts.map +1 -0
  38. package/dist/codeSign/win/signManager.js +19 -0
  39. package/dist/codeSign/win/signManager.js.map +1 -0
  40. package/dist/codeSign/win/signtoolBaseSignManager.d.ts +95 -0
  41. package/dist/codeSign/win/signtoolBaseSignManager.d.ts.map +1 -0
  42. package/dist/codeSign/win/signtoolBaseSignManager.js +507 -0
  43. package/dist/codeSign/win/signtoolBaseSignManager.js.map +1 -0
  44. package/dist/codeSign/win/windowsCodeSign.d.ts +2 -1
  45. package/dist/codeSign/win/windowsCodeSign.d.ts.map +1 -1
  46. package/dist/codeSign/win/windowsCodeSign.js +22 -8
  47. package/dist/codeSign/win/windowsCodeSign.js.map +1 -1
  48. package/dist/codeSign/win/windowsSignAzureManager.d.ts +11 -4
  49. package/dist/codeSign/win/windowsSignAzureManager.d.ts.map +1 -1
  50. package/dist/codeSign/win/windowsSignAzureManager.js +142 -37
  51. package/dist/codeSign/win/windowsSignAzureManager.js.map +1 -1
  52. package/dist/codeSign/win/windowsSignToolManager.d.ts +1 -58
  53. package/dist/codeSign/win/windowsSignToolManager.d.ts.map +1 -1
  54. package/dist/codeSign/win/windowsSignToolManager.js +3 -363
  55. package/dist/codeSign/win/windowsSignToolManager.js.map +1 -1
  56. package/dist/configuration.d.ts +228 -163
  57. package/dist/configuration.d.ts.map +1 -1
  58. package/dist/configuration.js +11 -1
  59. package/dist/configuration.js.map +1 -1
  60. package/dist/core.d.ts +14 -0
  61. package/dist/core.d.ts.map +1 -1
  62. package/dist/core.js +11 -0
  63. package/dist/core.js.map +1 -1
  64. package/dist/electron/ElectronFramework.d.ts +3 -3
  65. package/dist/electron/ElectronFramework.d.ts.map +1 -1
  66. package/dist/electron/ElectronFramework.js +60 -61
  67. package/dist/electron/ElectronFramework.js.map +1 -1
  68. package/dist/electron/electronArchSupport.d.ts +12 -0
  69. package/dist/electron/electronArchSupport.d.ts.map +1 -0
  70. package/dist/electron/electronArchSupport.js +58 -0
  71. package/dist/electron/electronArchSupport.js.map +1 -0
  72. package/dist/electron/electronVersion.d.ts.map +1 -1
  73. package/dist/electron/electronVersion.js +1 -11
  74. package/dist/electron/electronVersion.js.map +1 -1
  75. package/dist/electron/injectFFMPEG.js +2 -2
  76. package/dist/electron/injectFFMPEG.js.map +1 -1
  77. package/dist/electron/mac/electronMac.js +24 -35
  78. package/dist/electron/mac/electronMac.js.map +1 -1
  79. package/dist/electron/mac/electronMacUtils.d.ts +24 -0
  80. package/dist/electron/mac/electronMacUtils.d.ts.map +1 -0
  81. package/dist/electron/mac/electronMacUtils.js +42 -0
  82. package/dist/electron/mac/electronMacUtils.js.map +1 -0
  83. package/dist/electron/win/electronWin.js +2 -2
  84. package/dist/electron/win/electronWin.js.map +1 -1
  85. package/dist/fileMatcher.d.ts +42 -2
  86. package/dist/fileMatcher.d.ts.map +1 -1
  87. package/dist/fileMatcher.js +246 -18
  88. package/dist/fileMatcher.js.map +1 -1
  89. package/dist/index.d.ts +11 -5
  90. package/dist/index.d.ts.map +1 -1
  91. package/dist/index.js +17 -1
  92. package/dist/index.js.map +1 -1
  93. package/dist/indexInternal.d.ts +19 -8
  94. package/dist/indexInternal.d.ts.map +1 -1
  95. package/dist/indexInternal.js +18 -7
  96. package/dist/indexInternal.js.map +1 -1
  97. package/dist/linuxPackager.d.ts.map +1 -1
  98. package/dist/linuxPackager.js +19 -1
  99. package/dist/linuxPackager.js.map +1 -1
  100. package/dist/macPackager.d.ts +31 -14
  101. package/dist/macPackager.d.ts.map +1 -1
  102. package/dist/macPackager.js +236 -147
  103. package/dist/macPackager.js.map +1 -1
  104. package/dist/node-module-collector/index.d.ts.map +1 -1
  105. package/dist/node-module-collector/index.js +47 -16
  106. package/dist/node-module-collector/index.js.map +1 -1
  107. package/dist/node-module-collector/moduleManager.d.ts +11 -2
  108. package/dist/node-module-collector/moduleManager.d.ts.map +1 -1
  109. package/dist/node-module-collector/moduleManager.js +34 -14
  110. package/dist/node-module-collector/moduleManager.js.map +1 -1
  111. package/dist/node-module-collector/nodeModulesCollector.d.ts +47 -26
  112. package/dist/node-module-collector/nodeModulesCollector.d.ts.map +1 -1
  113. package/dist/node-module-collector/nodeModulesCollector.js +157 -142
  114. package/dist/node-module-collector/nodeModulesCollector.js.map +1 -1
  115. package/dist/node-module-collector/packageManager.js +1 -1
  116. package/dist/node-module-collector/packageManager.js.map +1 -1
  117. package/dist/node-module-collector/pnpmNodeModulesCollector.d.ts +90 -1
  118. package/dist/node-module-collector/pnpmNodeModulesCollector.d.ts.map +1 -1
  119. package/dist/node-module-collector/pnpmNodeModulesCollector.js +325 -25
  120. package/dist/node-module-collector/pnpmNodeModulesCollector.js.map +1 -1
  121. package/dist/node-module-collector/types.d.ts +4 -0
  122. package/dist/node-module-collector/types.d.ts.map +1 -1
  123. package/dist/node-module-collector/types.js.map +1 -1
  124. package/dist/options/FuseOptionsV1.d.ts +137 -0
  125. package/dist/options/FuseOptionsV1.d.ts.map +1 -0
  126. package/dist/options/FuseOptionsV1.js +2 -0
  127. package/dist/options/FuseOptionsV1.js.map +1 -0
  128. package/dist/options/MsixOptions.d.ts +126 -0
  129. package/dist/options/MsixOptions.d.ts.map +1 -0
  130. package/dist/options/MsixOptions.js +2 -0
  131. package/dist/options/MsixOptions.js.map +1 -0
  132. package/dist/options/PlatformSpecificBuildOptions.d.ts +55 -9
  133. package/dist/options/PlatformSpecificBuildOptions.d.ts.map +1 -1
  134. package/dist/options/PlatformSpecificBuildOptions.js.map +1 -1
  135. package/dist/options/SnapOptions.d.ts +23 -17
  136. package/dist/options/SnapOptions.d.ts.map +1 -1
  137. package/dist/options/SnapOptions.js.map +1 -1
  138. package/dist/options/SquirrelWindowsOptions.d.ts +0 -5
  139. package/dist/options/SquirrelWindowsOptions.d.ts.map +1 -1
  140. package/dist/options/SquirrelWindowsOptions.js.map +1 -1
  141. package/dist/options/linuxOptions.d.ts +8 -12
  142. package/dist/options/linuxOptions.d.ts.map +1 -1
  143. package/dist/options/linuxOptions.js.map +1 -1
  144. package/dist/options/macOptions.d.ts +113 -131
  145. package/dist/options/macOptions.d.ts.map +1 -1
  146. package/dist/options/macOptions.js.map +1 -1
  147. package/dist/options/pkgOptions.d.ts +1 -1
  148. package/dist/options/pkgOptions.js.map +1 -1
  149. package/dist/options/winOptions.d.ts +282 -70
  150. package/dist/options/winOptions.d.ts.map +1 -1
  151. package/dist/options/winOptions.js +12 -1
  152. package/dist/options/winOptions.js.map +1 -1
  153. package/dist/packager.d.ts +6 -1
  154. package/dist/packager.d.ts.map +1 -1
  155. package/dist/packager.js +121 -40
  156. package/dist/packager.js.map +1 -1
  157. package/dist/packagerApi.d.ts +10 -1
  158. package/dist/packagerApi.d.ts.map +1 -1
  159. package/dist/packagerApi.js.map +1 -1
  160. package/dist/platformPackager.d.ts +49 -3
  161. package/dist/platformPackager.d.ts.map +1 -1
  162. package/dist/platformPackager.js +130 -17
  163. package/dist/platformPackager.js.map +1 -1
  164. package/dist/publish/PublishManager.d.ts +36 -2
  165. package/dist/publish/PublishManager.d.ts.map +1 -1
  166. package/dist/publish/PublishManager.js +387 -23
  167. package/dist/publish/PublishManager.js.map +1 -1
  168. package/dist/publish/updateInfoBuilder.d.ts +1 -1
  169. package/dist/publish/updateInfoBuilder.d.ts.map +1 -1
  170. package/dist/publish/updateInfoBuilder.js +110 -32
  171. package/dist/publish/updateInfoBuilder.js.map +1 -1
  172. package/dist/targets/ArchiveTarget.d.ts +1 -0
  173. package/dist/targets/ArchiveTarget.d.ts.map +1 -1
  174. package/dist/targets/ArchiveTarget.js +6 -3
  175. package/dist/targets/ArchiveTarget.js.map +1 -1
  176. package/dist/targets/archive.d.ts +33 -2
  177. package/dist/targets/archive.d.ts.map +1 -1
  178. package/dist/targets/archive.js +109 -29
  179. package/dist/targets/archive.js.map +1 -1
  180. package/dist/targets/blockmap/blockmap.d.ts +43 -3
  181. package/dist/targets/blockmap/blockmap.d.ts.map +1 -1
  182. package/dist/targets/blockmap/blockmap.js +141 -15
  183. package/dist/targets/blockmap/blockmap.js.map +1 -1
  184. package/dist/targets/blockmap/verbatimRange.d.ts +44 -0
  185. package/dist/targets/blockmap/verbatimRange.d.ts.map +1 -0
  186. package/dist/targets/blockmap/verbatimRange.js +117 -0
  187. package/dist/targets/blockmap/verbatimRange.js.map +1 -0
  188. package/dist/targets/differentialUpdateInfoBuilder.d.ts +28 -2
  189. package/dist/targets/differentialUpdateInfoBuilder.d.ts.map +1 -1
  190. package/dist/targets/differentialUpdateInfoBuilder.js +75 -6
  191. package/dist/targets/differentialUpdateInfoBuilder.js.map +1 -1
  192. package/dist/targets/linux/FlatpakTarget.d.ts.map +1 -1
  193. package/dist/targets/linux/FlatpakTarget.js +13 -3
  194. package/dist/targets/linux/FlatpakTarget.js.map +1 -1
  195. package/dist/targets/linux/FpmTarget.d.ts +14 -0
  196. package/dist/targets/linux/FpmTarget.d.ts.map +1 -1
  197. package/dist/targets/linux/FpmTarget.js +86 -10
  198. package/dist/targets/linux/FpmTarget.js.map +1 -1
  199. package/dist/targets/linux/LinuxTargetHelper.d.ts +15 -0
  200. package/dist/targets/linux/LinuxTargetHelper.d.ts.map +1 -1
  201. package/dist/targets/linux/LinuxTargetHelper.js +54 -59
  202. package/dist/targets/linux/LinuxTargetHelper.js.map +1 -1
  203. package/dist/targets/linux/appimage/AppImageTarget.d.ts +2 -0
  204. package/dist/targets/linux/appimage/AppImageTarget.d.ts.map +1 -1
  205. package/dist/targets/linux/appimage/AppImageTarget.js +16 -15
  206. package/dist/targets/linux/appimage/AppImageTarget.js.map +1 -1
  207. package/dist/targets/linux/appimage/appImageUtil.d.ts +5 -1
  208. package/dist/targets/linux/appimage/appImageUtil.d.ts.map +1 -1
  209. package/dist/targets/linux/appimage/appImageUtil.js +14 -7
  210. package/dist/targets/linux/appimage/appImageUtil.js.map +1 -1
  211. package/dist/targets/linux/appimage/appLauncher.d.ts.map +1 -1
  212. package/dist/targets/linux/appimage/appLauncher.js +5 -11
  213. package/dist/targets/linux/appimage/appLauncher.js.map +1 -1
  214. package/dist/targets/linux/launcherScript.d.ts +32 -0
  215. package/dist/targets/linux/launcherScript.d.ts.map +1 -0
  216. package/dist/targets/linux/launcherScript.js +24 -0
  217. package/dist/targets/linux/launcherScript.js.map +1 -0
  218. package/dist/targets/linux/snap/SnapTarget.d.ts +1 -1
  219. package/dist/targets/linux/snap/SnapTarget.d.ts.map +1 -1
  220. package/dist/targets/linux/snap/SnapTarget.js +23 -1
  221. package/dist/targets/linux/snap/SnapTarget.js.map +1 -1
  222. package/dist/targets/linux/snap/core24.d.ts +30 -1
  223. package/dist/targets/linux/snap/core24.d.ts.map +1 -1
  224. package/dist/targets/linux/snap/core24.js +146 -70
  225. package/dist/targets/linux/snap/core24.js.map +1 -1
  226. package/dist/targets/linux/snap/coreCustom.d.ts +1 -1
  227. package/dist/targets/linux/snap/coreCustom.d.ts.map +1 -1
  228. package/dist/targets/linux/snap/coreCustom.js +2 -2
  229. package/dist/targets/linux/snap/coreCustom.js.map +1 -1
  230. package/dist/targets/linux/snap/coreLegacy.d.ts +3 -3
  231. package/dist/targets/linux/snap/coreLegacy.d.ts.map +1 -1
  232. package/dist/targets/linux/snap/coreLegacy.js +12 -12
  233. package/dist/targets/linux/snap/coreLegacy.js.map +1 -1
  234. package/dist/targets/linux/snap/snapCommand.d.ts +13 -0
  235. package/dist/targets/linux/snap/snapCommand.d.ts.map +1 -0
  236. package/dist/targets/linux/snap/snapCommand.js +21 -0
  237. package/dist/targets/linux/snap/snapCommand.js.map +1 -0
  238. package/dist/targets/linux/snap/snapcraft.d.ts +190 -0
  239. package/dist/targets/linux/snap/snapcraft.d.ts.map +1 -0
  240. package/dist/targets/linux/snap/snapcraft.js +11 -0
  241. package/dist/targets/linux/snap/snapcraft.js.map +1 -0
  242. package/dist/targets/linux/snap/snapcraftBuilder.d.ts +7 -1
  243. package/dist/targets/linux/snap/snapcraftBuilder.d.ts.map +1 -1
  244. package/dist/targets/linux/snap/snapcraftBuilder.js +57 -20
  245. package/dist/targets/linux/snap/snapcraftBuilder.js.map +1 -1
  246. package/dist/targets/mac/MacTargetHelper.d.ts +146 -14
  247. package/dist/targets/mac/MacTargetHelper.d.ts.map +1 -1
  248. package/dist/targets/mac/MacTargetHelper.js +485 -91
  249. package/dist/targets/mac/MacTargetHelper.js.map +1 -1
  250. package/dist/targets/mac/pkg.d.ts +16 -0
  251. package/dist/targets/mac/pkg.d.ts.map +1 -1
  252. package/dist/targets/mac/pkg.js +31 -5
  253. package/dist/targets/mac/pkg.js.map +1 -1
  254. package/dist/targets/targetFactory.d.ts +7 -0
  255. package/dist/targets/targetFactory.d.ts.map +1 -1
  256. package/dist/targets/targetFactory.js +28 -0
  257. package/dist/targets/targetFactory.js.map +1 -1
  258. package/dist/targets/win/AppxTarget.d.ts +1 -2
  259. package/dist/targets/win/AppxTarget.d.ts.map +1 -1
  260. package/dist/targets/win/AppxTarget.js +37 -314
  261. package/dist/targets/win/AppxTarget.js.map +1 -1
  262. package/dist/targets/win/MsiTarget.d.ts.map +1 -1
  263. package/dist/targets/win/MsiTarget.js +13 -13
  264. package/dist/targets/win/MsiTarget.js.map +1 -1
  265. package/dist/targets/win/MsixTarget.d.ts +22 -0
  266. package/dist/targets/win/MsixTarget.d.ts.map +1 -0
  267. package/dist/targets/win/MsixTarget.js +214 -0
  268. package/dist/targets/win/MsixTarget.js.map +1 -0
  269. package/dist/targets/win/nsis/Defines.d.ts +3 -0
  270. package/dist/targets/win/nsis/Defines.d.ts.map +1 -1
  271. package/dist/targets/win/nsis/Defines.js.map +1 -1
  272. package/dist/targets/win/nsis/NsisTarget.d.ts +57 -3
  273. package/dist/targets/win/nsis/NsisTarget.d.ts.map +1 -1
  274. package/dist/targets/win/nsis/NsisTarget.js +252 -113
  275. package/dist/targets/win/nsis/NsisTarget.js.map +1 -1
  276. package/dist/targets/win/nsis/WebInstallerTarget.d.ts.map +1 -1
  277. package/dist/targets/win/nsis/WebInstallerTarget.js +23 -12
  278. package/dist/targets/win/nsis/WebInstallerTarget.js.map +1 -1
  279. package/dist/targets/win/nsis/nsisOptions.d.ts +56 -48
  280. package/dist/targets/win/nsis/nsisOptions.d.ts.map +1 -1
  281. package/dist/targets/win/nsis/nsisOptions.js.map +1 -1
  282. package/dist/targets/win/nsis/nsisScriptGenerator.d.ts.map +1 -1
  283. package/dist/targets/win/nsis/nsisScriptGenerator.js +4 -3
  284. package/dist/targets/win/nsis/nsisScriptGenerator.js.map +1 -1
  285. package/dist/targets/win/nsis/nsisUtil.d.ts +17 -2
  286. package/dist/targets/win/nsis/nsisUtil.d.ts.map +1 -1
  287. package/dist/targets/win/nsis/nsisUtil.js +143 -41
  288. package/dist/targets/win/nsis/nsisUtil.js.map +1 -1
  289. package/dist/targets/win/nsis/progId.d.ts +21 -0
  290. package/dist/targets/win/nsis/progId.d.ts.map +1 -0
  291. package/dist/targets/win/nsis/progId.js +60 -0
  292. package/dist/targets/win/nsis/progId.js.map +1 -0
  293. package/dist/targets/win/winAppUtil.d.ts +115 -0
  294. package/dist/targets/win/winAppUtil.d.ts.map +1 -0
  295. package/dist/targets/win/winAppUtil.js +407 -0
  296. package/dist/targets/win/winAppUtil.js.map +1 -0
  297. package/dist/toolsets/7zip.d.ts +32 -0
  298. package/dist/toolsets/7zip.d.ts.map +1 -1
  299. package/dist/toolsets/7zip.js +39 -11
  300. package/dist/toolsets/7zip.js.map +1 -1
  301. package/dist/toolsets/appimage.d.ts +3 -3
  302. package/dist/toolsets/appimage.d.ts.map +1 -1
  303. package/dist/toolsets/appimage.js +9 -6
  304. package/dist/toolsets/appimage.js.map +1 -1
  305. package/dist/toolsets/custom.d.ts +2 -3
  306. package/dist/toolsets/custom.d.ts.map +1 -1
  307. package/dist/toolsets/custom.js +67 -149
  308. package/dist/toolsets/custom.js.map +1 -1
  309. package/dist/toolsets/fpm.d.ts.map +1 -1
  310. package/dist/toolsets/fpm.js +11 -5
  311. package/dist/toolsets/fpm.js.map +1 -1
  312. package/dist/toolsets/icons.d.ts.map +1 -1
  313. package/dist/toolsets/icons.js +17 -3
  314. package/dist/toolsets/icons.js.map +1 -1
  315. package/dist/toolsets/linuxToolsMac.d.ts.map +1 -1
  316. package/dist/toolsets/linuxToolsMac.js +17 -4
  317. package/dist/toolsets/linuxToolsMac.js.map +1 -1
  318. package/dist/toolsets/nsis.d.ts +5 -0
  319. package/dist/toolsets/nsis.d.ts.map +1 -1
  320. package/dist/toolsets/nsis.js +20 -4
  321. package/dist/toolsets/nsis.js.map +1 -1
  322. package/dist/toolsets/version.d.ts +12 -0
  323. package/dist/toolsets/version.d.ts.map +1 -0
  324. package/dist/toolsets/version.js +13 -0
  325. package/dist/toolsets/version.js.map +1 -0
  326. package/dist/toolsets/winCodeSign.d.ts +56 -3
  327. package/dist/toolsets/winCodeSign.d.ts.map +1 -1
  328. package/dist/toolsets/winCodeSign.js +125 -42
  329. package/dist/toolsets/winCodeSign.js.map +1 -1
  330. package/dist/toolsets/wine.d.ts +2 -1
  331. package/dist/toolsets/wine.d.ts.map +1 -1
  332. package/dist/toolsets/wine.js +31 -15
  333. package/dist/toolsets/wine.js.map +1 -1
  334. package/dist/util/NodeModuleCopyHelper.js +14 -6
  335. package/dist/util/NodeModuleCopyHelper.js.map +1 -1
  336. package/dist/util/appFileCopier.d.ts +52 -0
  337. package/dist/util/appFileCopier.d.ts.map +1 -1
  338. package/dist/util/appFileCopier.js +221 -21
  339. package/dist/util/appFileCopier.js.map +1 -1
  340. package/dist/util/archCompatibility.d.ts +42 -0
  341. package/dist/util/archCompatibility.d.ts.map +1 -0
  342. package/dist/util/archCompatibility.js +202 -0
  343. package/dist/util/archCompatibility.js.map +1 -0
  344. package/dist/util/checksum.d.ts +36 -0
  345. package/dist/util/checksum.d.ts.map +1 -0
  346. package/dist/util/checksum.js +48 -0
  347. package/dist/util/checksum.js.map +1 -0
  348. package/dist/util/config/config.d.ts +1 -0
  349. package/dist/util/config/config.d.ts.map +1 -1
  350. package/dist/util/config/config.js +8 -1
  351. package/dist/util/config/config.js.map +1 -1
  352. package/dist/util/config/legacyConfigGuard.d.ts +7 -0
  353. package/dist/util/config/legacyConfigGuard.d.ts.map +1 -0
  354. package/dist/util/config/legacyConfigGuard.js +187 -0
  355. package/dist/util/config/legacyConfigGuard.js.map +1 -0
  356. package/dist/util/config/legacyOptions.d.ts +75 -0
  357. package/dist/util/config/legacyOptions.d.ts.map +1 -0
  358. package/dist/util/config/legacyOptions.js +399 -0
  359. package/dist/util/config/legacyOptions.js.map +1 -0
  360. package/dist/util/config/load.d.ts +2 -2
  361. package/dist/util/config/load.d.ts.map +1 -1
  362. package/dist/util/config/load.js +3 -12
  363. package/dist/util/config/load.js.map +1 -1
  364. package/dist/util/config/schemaValidator.d.ts.map +1 -1
  365. package/dist/util/config/schemaValidator.js +26 -3
  366. package/dist/util/config/schemaValidator.js.map +1 -1
  367. package/dist/util/electronGet.d.ts +30 -32
  368. package/dist/util/electronGet.d.ts.map +1 -1
  369. package/dist/util/electronGet.js +359 -129
  370. package/dist/util/electronGet.js.map +1 -1
  371. package/dist/util/flags.d.ts +5 -5
  372. package/dist/util/flags.d.ts.map +1 -1
  373. package/dist/util/flags.js +124 -16
  374. package/dist/util/flags.js.map +1 -1
  375. package/dist/util/hash.d.ts +1 -1
  376. package/dist/util/hash.d.ts.map +1 -1
  377. package/dist/util/hash.js +1 -15
  378. package/dist/util/hash.js.map +1 -1
  379. package/dist/util/installOrRebuild.d.ts +44 -0
  380. package/dist/util/installOrRebuild.d.ts.map +1 -0
  381. package/dist/util/installOrRebuild.js +276 -0
  382. package/dist/util/installOrRebuild.js.map +1 -0
  383. package/dist/util/langs.d.ts.map +1 -1
  384. package/dist/util/langs.js +1 -0
  385. package/dist/util/langs.js.map +1 -1
  386. package/dist/util/license.d.ts.map +1 -1
  387. package/dist/util/license.js +4 -1
  388. package/dist/util/license.js.map +1 -1
  389. package/dist/util/mac/macosIconComposer.d.ts +2 -1
  390. package/dist/util/mac/macosIconComposer.d.ts.map +1 -1
  391. package/dist/util/mac/macosIconComposer.js +41 -59
  392. package/dist/util/mac/macosIconComposer.js.map +1 -1
  393. package/dist/util/mac/macosVersion.d.ts +0 -1
  394. package/dist/util/mac/macosVersion.d.ts.map +1 -1
  395. package/dist/util/mac/macosVersion.js +0 -3
  396. package/dist/util/mac/macosVersion.js.map +1 -1
  397. package/dist/util/mac/plist.d.ts +1 -1
  398. package/dist/util/mac/plist.d.ts.map +1 -1
  399. package/dist/util/mac/plist.js +6 -1
  400. package/dist/util/mac/plist.js.map +1 -1
  401. package/dist/util/nativeBinaryVerifier.d.ts +40 -0
  402. package/dist/util/nativeBinaryVerifier.d.ts.map +1 -0
  403. package/dist/util/nativeBinaryVerifier.js +381 -0
  404. package/dist/util/nativeBinaryVerifier.js.map +1 -0
  405. package/dist/util/packageMetadata.js +57 -31
  406. package/dist/util/packageMetadata.js.map +1 -1
  407. package/dist/util/repositoryInfo.js +6 -3
  408. package/dist/util/repositoryInfo.js.map +1 -1
  409. package/dist/util/resolve.js +1 -1
  410. package/dist/util/resolve.js.map +1 -1
  411. package/dist/util/streamSpawnToFile.d.ts +47 -0
  412. package/dist/util/streamSpawnToFile.d.ts.map +1 -0
  413. package/dist/util/streamSpawnToFile.js +110 -0
  414. package/dist/util/streamSpawnToFile.js.map +1 -0
  415. package/dist/util/toolsetLock.d.ts +2 -0
  416. package/dist/util/toolsetLock.d.ts.map +1 -1
  417. package/dist/util/toolsetLock.js +31 -5
  418. package/dist/util/toolsetLock.js.map +1 -1
  419. package/dist/version.d.ts +1 -1
  420. package/dist/version.d.ts.map +1 -1
  421. package/dist/version.js +1 -1
  422. package/dist/version.js.map +1 -1
  423. package/dist/vm/ParallelsVm.d.ts.map +1 -1
  424. package/dist/vm/ParallelsVm.js +29 -3
  425. package/dist/vm/ParallelsVm.js.map +1 -1
  426. package/dist/vm/vm.d.ts +2 -0
  427. package/dist/vm/vm.d.ts.map +1 -1
  428. package/dist/vm/vm.js +29 -6
  429. package/dist/vm/vm.js.map +1 -1
  430. package/dist/winPackager.d.ts +6 -5
  431. package/dist/winPackager.d.ts.map +1 -1
  432. package/dist/winPackager.js +45 -39
  433. package/dist/winPackager.js.map +1 -1
  434. package/package.json +19 -18
  435. package/scheme.json +1731 -961
  436. package/templates/appx/appxmanifest.xml +2 -3
  437. package/templates/entitlements.mac.adhoc.plist +15 -0
  438. package/templates/entitlements.mac.plist +9 -6
  439. package/templates/msix/appxmanifest.xml +45 -0
  440. package/templates/nsis/assistedMessages.yml +17 -0
  441. package/templates/nsis/common.nsh +2 -2
  442. package/templates/nsis/include/allowOnlyOneInstallerInstance.nsh +96 -13
  443. package/templates/nsis/include/extractAppPackage.nsh +5 -2
  444. package/templates/nsis/include/installUtil.nsh +2 -2
  445. package/templates/nsis/include/installer.nsh +88 -50
  446. package/templates/nsis/include/webPackage.nsh +52 -27
  447. package/templates/nsis/installSection.nsh +29 -0
  448. package/templates/nsis/installer.nsi +1 -1
  449. package/templates/nsis/messages.yml +5 -0
  450. package/templates/nsis/multiUserUi.nsh +1 -1
  451. package/dist/codeSign/signManager.d.ts +0 -14
  452. package/dist/codeSign/signManager.d.ts.map +0 -1
  453. package/dist/codeSign/signManager.js +0 -2
  454. package/dist/codeSign/signManager.js.map +0 -1
  455. package/dist/util/yarn.d.ts +0 -23
  456. package/dist/util/yarn.d.ts.map +0 -1
  457. package/dist/util/yarn.js +0 -153
  458. package/dist/util/yarn.js.map +0 -1
package/scheme.json CHANGED
@@ -16,6 +16,9 @@
16
16
  {
17
17
  "$ref": "#/definitions/SpacesOptions"
18
18
  },
19
+ {
20
+ "$ref": "#/definitions/R2Options"
21
+ },
19
22
  {
20
23
  "$ref": "#/definitions/GenericServerOptions"
21
24
  },
@@ -136,6 +139,9 @@
136
139
  {
137
140
  "$ref": "#/definitions/SpacesOptions"
138
141
  },
142
+ {
143
+ "$ref": "#/definitions/R2Options"
144
+ },
139
145
  {
140
146
  "$ref": "#/definitions/GenericServerOptions"
141
147
  },
@@ -301,6 +307,9 @@
301
307
  {
302
308
  "$ref": "#/definitions/SpacesOptions"
303
309
  },
310
+ {
311
+ "$ref": "#/definitions/R2Options"
312
+ },
304
313
  {
305
314
  "$ref": "#/definitions/GenericServerOptions"
306
315
  },
@@ -451,7 +460,7 @@
451
460
  },
452
461
  "BitbucketOptions": {
453
462
  "additionalProperties": false,
454
- "description": "Bitbucket options.\nhttps://bitbucket.org/\nDefine `BITBUCKET_TOKEN` environment variable.\n\nFor converting an app password to a usable token, you can utilize this\n```typescript\nconvertAppPassword(owner: string, appPassword: string) {\nconst base64encodedData = Buffer.from(`${owner}:${appPassword.trim()}`).toString(\"base64\")\nreturn `Basic ${base64encodedData}`\n}\n```",
463
+ "description": "Bitbucket options.\nhttps://bitbucket.org/\nDefine `BITBUCKET_TOKEN` environment variable.\n\nBitbucket Cloud is [retiring app passwords](https://www.atlassian.com/blog/bitbucket/bitbucket-cloud-transitions-to-api-tokens) in favor of API tokens and access tokens. Authentication is selected by whether a `username` is provided:\n- With `username` — the token is sent via HTTP Basic auth. Use a Bitbucket username + [app password](https://bitbucket.org/account/settings/app-passwords), or an Atlassian account email + [API token](https://support.atlassian.com/bitbucket-cloud/docs/using-api-tokens/).\n- Without `username` — the token is sent as a repository/project/workspace [access token](https://support.atlassian.com/bitbucket-cloud/docs/using-access-tokens/) via Bearer auth.\n\nFor the auto-updater on a private repository, pass the matching header to `autoUpdater.addAuthHeader(...)`:\n```typescript\n// access token (no username)\nautoUpdater.addAuthHeader(`Bearer ${token}`)\n// app password or API token (with username)\nautoUpdater.addAuthHeader(`Basic ${Buffer.from(`${username}:${token}`).toString(\"base64\")}`)\n```",
455
464
  "properties": {
456
465
  "channel": {
457
466
  "default": "latest",
@@ -472,7 +481,7 @@
472
481
  },
473
482
  "publishAutoUpdate": {
474
483
  "default": true,
475
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
484
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
476
485
  "type": "boolean"
477
486
  },
478
487
  "publisherName": {
@@ -505,12 +514,29 @@
505
514
  ]
506
515
  },
507
516
  "token": {
508
- "description": "The [app password](https://bitbucket.org/account/settings/app-passwords) to support auto-update from private bitbucket repositories.",
517
+ "description": "The token to support auto-update from private bitbucket repositories. Depending on `username`, this is a Bitbucket [app password](https://bitbucket.org/account/settings/app-passwords), an Atlassian [API token](https://support.atlassian.com/bitbucket-cloud/docs/using-api-tokens/), or a repository/project/workspace [access token](https://support.atlassian.com/bitbucket-cloud/docs/using-access-tokens/).",
509
518
  "type": [
510
519
  "null",
511
520
  "string"
512
521
  ]
513
522
  },
523
+ "updateManifestPublicKey": {
524
+ "anyOf": [
525
+ {
526
+ "items": {
527
+ "type": "string"
528
+ },
529
+ "type": "array"
530
+ },
531
+ {
532
+ "type": [
533
+ "null",
534
+ "string"
535
+ ]
536
+ }
537
+ ],
538
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
539
+ },
514
540
  "updaterCacheDirName": {
515
541
  "type": [
516
542
  "null",
@@ -518,7 +544,7 @@
518
544
  ]
519
545
  },
520
546
  "username": {
521
- "description": "The user name to support auto-update from private bitbucket repositories.",
547
+ "description": "The user name to support auto-update from private bitbucket repositories. Provide a Bitbucket username (for an app password) or an Atlassian account email (for an API token) to authenticate with HTTP Basic auth. Leave unset to send `token` as a Bearer access token.",
522
548
  "type": [
523
549
  "null",
524
550
  "string"
@@ -547,66 +573,6 @@
547
573
  ],
548
574
  "type": "object"
549
575
  },
550
- "CustomNsisBinary": {
551
- "additionalProperties": false,
552
- "properties": {
553
- "checksum": {
554
- "default": "VKMiizYdmNdJOWpRGz4trl4lD++BvYP2irAXpMilheUP0pc93iKlWAoP843Vlraj8YG19CVn0j+dCo/hURz9+Q==",
555
- "type": [
556
- "null",
557
- "string"
558
- ]
559
- },
560
- "debugLogging": {
561
- "description": "Whether or not to enable NSIS logging for debugging.\nNote: Requires a debug-enabled NSIS build.\nelectron-builder's included `makensis` does not natively support debug-enabled NSIS installers currently, you must supply your own via `customNsisBinary?: CustomNsisBinary`\nIn your custom nsis scripts, you can leverage this functionality via `LogSet` and `LogText`",
562
- "type": [
563
- "null",
564
- "boolean"
565
- ]
566
- },
567
- "url": {
568
- "default": "https://github.com/electron-userland/electron-builder-binaries/releases/download/nsis-3.0.4.1/nsis-3.0.4.1.7z",
569
- "type": [
570
- "null",
571
- "string"
572
- ]
573
- },
574
- "version": {
575
- "default": "3.0.4.1",
576
- "type": [
577
- "null",
578
- "string"
579
- ]
580
- }
581
- },
582
- "required": [
583
- "url"
584
- ],
585
- "type": "object"
586
- },
587
- "CustomNsisResources": {
588
- "additionalProperties": false,
589
- "properties": {
590
- "checksum": {
591
- "default": "Dqd6g+2buwwvoG1Vyf6BHR1b+25QMmPcwZx40atOT57gH27rkjOei1L0JTldxZu4NFoEmW4kJgZ3DlSWVON3+Q==",
592
- "type": "string"
593
- },
594
- "url": {
595
- "default": "https://github.com/electron-userland/electron-builder-binaries/releases/download/nsis-resources-3.4.1/nsis-resources-3.4.1.7z",
596
- "type": "string"
597
- },
598
- "version": {
599
- "default": "3.4.1",
600
- "type": "string"
601
- }
602
- },
603
- "required": [
604
- "checksum",
605
- "url",
606
- "version"
607
- ],
608
- "type": "object"
609
- },
610
576
  "CustomPublishOptions": {
611
577
  "additionalProperties": {},
612
578
  "properties": {
@@ -617,7 +583,7 @@
617
583
  },
618
584
  "publishAutoUpdate": {
619
585
  "default": true,
620
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
586
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
621
587
  "type": "boolean"
622
588
  },
623
589
  "publisherName": {
@@ -645,6 +611,23 @@
645
611
  "number"
646
612
  ]
647
613
  },
614
+ "updateManifestPublicKey": {
615
+ "anyOf": [
616
+ {
617
+ "items": {
618
+ "type": "string"
619
+ },
620
+ "type": "array"
621
+ },
622
+ {
623
+ "type": [
624
+ "null",
625
+ "string"
626
+ ]
627
+ }
628
+ ],
629
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
630
+ },
648
631
  "updateProvider": {
649
632
  "description": "The Provider to provide UpdateInfo regarding available updates. Required\nto use custom providers with electron-updater.",
650
633
  "typeof": "function"
@@ -740,7 +723,7 @@
740
723
  "libuuid1",
741
724
  "libsecret-1-0"
742
725
  ],
743
- "description": "Package dependencies.\nIf need to support Debian, `libappindicator1` should be removed, it is [deprecated in Debian](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=895037).\nIf need to support KDE, `gconf2` and `gconf-service` should be removed as it's no longer used [by GNOME](https://packages.debian.org/bullseye/gconf2)."
726
+ "description": "Package dependencies.\nIf need to support Debian, `libappindicator1` should be removed, it is [deprecated in Debian](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=895037).\nIf need to support KDE, `gconf2` and `gconf-service` should be removed as it's no longer used [by GNOME](https://packages.debian.org/bullseye/gconf2).\n\nUse the `\"default\"` keyword to extend the default list instead of replacing it:\n`[\"default\", \"my-extra-lib\"]` appends `my-extra-lib` to the defaults. The resulting list is deduplicated."
744
727
  },
745
728
  "description": {
746
729
  "description": "As [description](https://www.electron.build/configuration#description) from application package.json, but allows you to specify different for Linux.",
@@ -846,6 +829,9 @@
846
829
  {
847
830
  "$ref": "#/definitions/SpacesOptions"
848
831
  },
832
+ {
833
+ "$ref": "#/definitions/R2Options"
834
+ },
849
835
  {
850
836
  "$ref": "#/definitions/GenericServerOptions"
851
837
  },
@@ -923,7 +909,8 @@
923
909
  "enum": [
924
910
  "dir",
925
911
  "file",
926
- "link"
912
+ "link",
913
+ "position"
927
914
  ],
928
915
  "type": "string"
929
916
  },
@@ -994,19 +981,20 @@
994
981
  "type": "null"
995
982
  }
996
983
  ],
997
- "default": "HFS+",
998
- "description": "The filesystem for the DMG volume (e.g. `\"APFS\"` or `\"HFS+\"`)\nThis will be changed to APFS in the next major release, so it is recommended to set it explicitly to HFS+ if you want to keep using HFS+ (e.g. for better compatibility with older macOS versions)."
984
+ "default": "APFS",
985
+ "description": "The filesystem for the DMG volume (e.g. `\"APFS\"` or `\"HFS+\"`)\nAs of v27 this defaults to APFS. Set it explicitly to `\"HFS+\"` if you need compatibility with older macOS versions (pre-10.13 High Sierra cannot mount APFS volumes)."
999
986
  },
1000
987
  "format": {
1001
988
  "default": "UDZO",
1002
- "description": "The disk image format. `ULFO` (lzfse-compressed image (OS X 10.11+ only)).",
989
+ "description": "The disk image format. `ULFO` (lzfse-compressed image (OS X 10.11+ only)). `ULMO` (lzma-compressed image (macOS 10.15+ only)).",
1003
990
  "enum": [
1004
991
  "UDBZ",
1005
992
  "UDCO",
1006
993
  "UDRO",
1007
994
  "UDRW",
1008
995
  "UDZO",
1009
- "ULFO"
996
+ "ULFO",
997
+ "ULMO"
1010
998
  ],
1011
999
  "type": "string"
1012
1000
  },
@@ -1066,6 +1054,9 @@
1066
1054
  {
1067
1055
  "$ref": "#/definitions/SpacesOptions"
1068
1056
  },
1057
+ {
1058
+ "$ref": "#/definitions/R2Options"
1059
+ },
1069
1060
  {
1070
1061
  "$ref": "#/definitions/GenericServerOptions"
1071
1062
  },
@@ -1168,98 +1159,185 @@
1168
1159
  },
1169
1160
  "type": "object"
1170
1161
  },
1171
- "ElectronDownloadOptions": {
1162
+ "ElectronGetOptions": {
1172
1163
  "additionalProperties": false,
1173
1164
  "properties": {
1174
- "arch": {
1175
- "type": "string"
1165
+ "checksums": {
1166
+ "$ref": "#/definitions/Record<string,string>",
1167
+ "description": "Provides checksums for the artifact as strings.\nCan be used if you already know the checksums of the Electron artifact\nyou are downloading and want to skip the checksum file download\nwithout skipping the checksum validation.\n\nThis should be an object whose keys are the file names of the artifacts and\nthe values are their respective SHA256 checksums."
1168
+ },
1169
+ "mirrorOptions": {
1170
+ "type": "object",
1171
+ "additionalProperties": false,
1172
+ "description": "Mirror options passed directly to @electron/get. Omits customDir, customFilename, and customVersion which are controlled by electron-builder.",
1173
+ "properties": {
1174
+ "mirror": {
1175
+ "type": "string",
1176
+ "description": "The base mirror URL for downloading Electron artifacts."
1177
+ },
1178
+ "nightlyMirror": {
1179
+ "type": "string",
1180
+ "description": "The mirror URL to use for nightly Electron builds."
1181
+ },
1182
+ "resolveAssetURL": {
1183
+ "type": "string",
1184
+ "description": "A custom function (serialised) to resolve the full asset URL."
1185
+ }
1186
+ }
1187
+ },
1188
+ "unsafelyDisableChecksums": {
1189
+ "description": "When set to `true`, disables checking that the artifact download completed successfully\nwith the correct payload.",
1190
+ "type": "boolean"
1191
+ }
1192
+ },
1193
+ "type": "object"
1194
+ },
1195
+ "ElectronSignOptions": {
1196
+ "additionalProperties": false,
1197
+ "description": "Signing options passed to `@electron/osx-sign`. Electron-builder owns the fields it must control\nitself — `app`, `keychain`, `platform`, `version`, and `optionsForFile` — and forwards everything else.\n\nAdditionally exposes a small set of per-file convenience fields that electron-builder maps\ninternally through `optionsForFile`.",
1198
+ "properties": {
1199
+ "additionalArguments": {
1200
+ "anyOf": [
1201
+ {
1202
+ "items": {
1203
+ "type": "string"
1204
+ },
1205
+ "type": "array"
1206
+ },
1207
+ {
1208
+ "type": "null"
1209
+ }
1210
+ ],
1211
+ "description": "Extra arguments passed to each `codesign` invocation."
1212
+ },
1213
+ "batchCodesignCalls": {
1214
+ "description": "Combine all files with identical CLI arguments in a single `codesign` call instead of running\n`codesign` once for each of those files. This minimizes the number of child processes that need\nto be spawned and reduces the time it takes to sign all files.",
1215
+ "type": "boolean"
1176
1216
  },
1177
- "cache": {
1178
- "description": "The [cache location](https://github.com/electron-userland/electron-download#cache-location).",
1217
+ "binaries": {
1218
+ "description": "Array of paths to additional binaries that will be signed along with built-ins of Electron.",
1219
+ "items": {
1220
+ "type": "string"
1221
+ },
1222
+ "type": "array"
1223
+ },
1224
+ "entitlements": {
1225
+ "description": "Path to the main app entitlements file. Resolved relative to the build resources directory, then the project directory.\nFalls back to `build/entitlements.mac.plist` (or `build/entitlements.mas.plist` for MAS targets) if it exists.\nOtherwise `mac` builds use the bundled default, which grants only `com.apple.security.cs.allow-jit`\n(ad-hoc builds use a bundled ad-hoc template that also disables library validation), and MAS builds use\n`@electron/osx-sign`'s built-in sandboxed `default.mas.plist`.",
1179
1226
  "type": [
1180
1227
  "null",
1181
1228
  "string"
1182
1229
  ]
1183
1230
  },
1184
- "customDir": {
1231
+ "entitlementsInherit": {
1232
+ "description": "Path to child entitlements inherited by embedded frameworks and bundles. Resolved relative to the build resources directory, then the project directory.\nFalls back to `build/entitlements.mac.inherit.plist` (or `build/entitlements.mas.inherit.plist` for MAS targets) if it exists.\nOtherwise nested binaries receive `@electron/osx-sign`'s per-file defaults (renderer/GPU helpers: `allow-jit`;\nplugin helper: Chromium's looser set; everything else: `default.darwin.plist`); ad-hoc `mac` builds use the\nbundled ad-hoc template instead.",
1185
1233
  "type": [
1186
1234
  "null",
1187
1235
  "string"
1188
1236
  ]
1189
1237
  },
1190
- "customFilename": {
1238
+ "entitlementsLoginHelper": {
1239
+ "description": "Path to entitlements for the Login Helper.\nRequired when using App Sandbox, because the Login Helper cannot inherit entitlements.\nDefaults to the value of `entitlements`.",
1191
1240
  "type": [
1192
1241
  "null",
1193
1242
  "string"
1194
1243
  ]
1195
1244
  },
1196
- "isVerifyChecksum": {
1245
+ "hardenedRuntime": {
1246
+ "description": "Whether to enable [Hardened Runtime](https://developer.apple.com/documentation/security/hardened_runtime).\n\nHardened Runtime is a prerequisite for notarization (mandatory on macOS 10.15+).\nDefaults to `true` for `darwin` builds and `false` for MAS builds (`mas` and `mas-dev`).",
1197
1247
  "type": "boolean"
1198
1248
  },
1199
- "mirror": {
1200
- "description": "The mirror.",
1249
+ "identity": {
1250
+ "description": "The signing identity (certificate name or SHA-1 hash). Applies to both app signing and DMG signing.\nPrefer the environment variables `CSC_LINK` / `CSC_NAME` over hardcoding this value.\n\n- **Not set** (default): electron-builder searches the keychain for a valid certificate.\n- **`null`**: skip signing entirely.\n- **`\"-\"`**: ad-hoc signing (requires disabling library validation — see `hardenedRuntime`).",
1201
1251
  "type": [
1202
1252
  "null",
1203
1253
  "string"
1204
1254
  ]
1205
1255
  },
1206
- "platform": {
1207
- "enum": [
1208
- "darwin",
1209
- "linux",
1210
- "mas",
1211
- "win32"
1256
+ "identityValidation": {
1257
+ "description": "Flag to enable/disable validation for the signing identity.\nIf enabled, the {@link SignOptions.identityidentity} provided\nwill be validated in the {@link BaseSignOptions.keychainkeychain} specified.",
1258
+ "type": "boolean"
1259
+ },
1260
+ "ignore": {
1261
+ "anyOf": [
1262
+ {
1263
+ "items": {
1264
+ "type": "string"
1265
+ },
1266
+ "type": "array"
1267
+ },
1268
+ {
1269
+ "typeof": "function"
1270
+ },
1271
+ {
1272
+ "type": "string"
1273
+ }
1212
1274
  ],
1213
- "type": "string"
1275
+ "description": "Defines files that will be skipped during the code signing process.\nThis property accepts a regex, function or an array of regexes and functions.\nElements of other types are treated as `RegExp`.\n\nFile paths matching a regex or returning a `true` value from a function will be ignored."
1214
1276
  },
1215
- "strictSSL": {
1277
+ "preAutoEntitlements": {
1278
+ "description": "Flag to enable/disable entitlements automation tasks necessary for code signing most Electron apps.\n* Adds [`com.apple.security.application-groups`](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_application-groups) to the entitlements file\n* Fills in the `ElectronTeamID` property in `Info.plist` with the provisioning profile's Team Identifier or by parsing the identity name.",
1216
1279
  "type": "boolean"
1217
1280
  },
1218
- "version": {
1281
+ "preEmbedProvisioningProfile": {
1282
+ "description": "Flag to enable/disable the embedding of a provisioning profile into the app's `Contents` folder.\nWill use the profile from {@link OnlySignOptions.provisioningProfile} if provided. Otherwise, it\nsearches for a `.provisionprofile` file in the current working directory.",
1283
+ "type": "boolean"
1284
+ },
1285
+ "provisioningProfile": {
1286
+ "description": "Path to a provisioning profile, which can be used to grant restricted entitlements to your app.\n\nSee [Apple Documentation](https://developer.apple.com/documentation/technotes/tn3125-inside-code-signing-provisioning-profiles) for more details.",
1219
1287
  "type": "string"
1220
1288
  },
1221
- "checksums": {
1222
- "type": "object",
1223
- "additionalProperties": {
1224
- "type": "string"
1225
- }
1289
+ "requirements": {
1290
+ "description": "Path to a [requirements file](https://developer.apple.com/library/mac/documentation/Security/Conceptual/CodeSigningGuide/RequirementLang/RequirementLang.html).\nNot applicable for MAS.",
1291
+ "type": [
1292
+ "null",
1293
+ "string"
1294
+ ]
1295
+ },
1296
+ "strictVerify": {
1297
+ "description": "Flag to enable/disable the `--strict` flag when verifying the signed application bundle.\nAlso supports string values to specify which strict restrictions to use, see codesign man page for supported values.",
1298
+ "type": [
1299
+ "string",
1300
+ "boolean"
1301
+ ]
1302
+ },
1303
+ "timestamp": {
1304
+ "description": "URL of the timestamp authority server. Passed per-file to `codesign --timestamp=<url>`.",
1305
+ "type": [
1306
+ "null",
1307
+ "string"
1308
+ ]
1309
+ },
1310
+ "type": {
1311
+ "description": "The type of certificate to use when signing: `development` or `distribution`.\n\nDefaults to a value derived from the build flavor: `mas-dev` → `development`, otherwise `distribution`.\nSet it explicitly to override — e.g. `development` on a darwin build signs with a `Mac Developer` or\n`Apple Development` certificate instead of `Developer ID Application` and embeds a matching\ndevelopment provisioning profile.\n\nDevelopment-signed apps are blocked by Gatekeeper on other machines; users must use the\nright-click → Open workaround documented at https://support.apple.com/en-us/guide/mac-help/mh40616/mac.\nSuch builds are not suitable for production distribution and cannot be notarized.",
1312
+ "enum": [
1313
+ "development",
1314
+ "distribution"
1315
+ ],
1316
+ "type": "string"
1226
1317
  }
1227
1318
  },
1228
1319
  "type": "object"
1229
1320
  },
1230
- "ElectronGetOptions": {
1321
+ "ElectronUniversalOptions": {
1231
1322
  "additionalProperties": false,
1323
+ "description": "Options forwarded to `@electron/universal`'s `makeUniversalApp`.\nElectron-builder fills in the app paths and `force`; everything else is configurable here\nand auto-tracks upstream additions to `MakeUniversalOpts`.",
1232
1324
  "properties": {
1233
- "checksums": {
1234
- "$ref": "#/definitions/Record<string,string>",
1235
- "description": "Provides checksums for the artifact as strings.\nCan be used if you already know the checksums of the Electron artifact\nyou are downloading and want to skip the checksum file download\nwithout skipping the checksum validation.\n\nThis should be an object whose keys are the file names of the artifacts and\nthe values are their respective SHA256 checksums."
1325
+ "infoPlistsToIgnore": {
1326
+ "description": "A {@link https://github.com/isaacs/minimatch?tab=readme-ov-file#features minimatch} pattern of `Info.plist`\npaths that should not receive an injected `ElectronAsarIntegrity` value.\n\nUse this if your application contains another bundle that's already signed.",
1327
+ "type": "string"
1236
1328
  },
1237
- "force": {
1238
- "description": "Whether to download an artifact regardless of whether it's in the cache directory.",
1329
+ "mergeASARs": {
1330
+ "default": true,
1331
+ "description": "Whether to merge x64 and arm64 ASARs into one.",
1239
1332
  "type": "boolean"
1240
1333
  },
1241
- "unsafelyDisableChecksums": {
1242
- "description": "When set to `true`, disables checking that the artifact download completed successfully\nwith the correct payload.",
1243
- "type": "boolean"
1334
+ "singleArchFiles": {
1335
+ "description": "If {@link MakeUniversalOpts.mergeASARs} is enabled, this property provides a\n{@link https://github.com/isaacs/minimatch?tab=readme-ov-file#features minimatch}\npattern of paths that are allowed to be present in one of the ASAR files, but not in the other.",
1336
+ "type": "string"
1244
1337
  },
1245
- "mirrorOptions": {
1246
- "type": "object",
1247
- "additionalProperties": false,
1248
- "description": "Mirror options passed directly to @electron/get. Omits customDir, customFilename, and customVersion which are controlled by electron-builder.",
1249
- "properties": {
1250
- "mirror": {
1251
- "type": "string",
1252
- "description": "The base mirror URL for downloading Electron artifacts."
1253
- },
1254
- "nightlyMirror": {
1255
- "type": "string",
1256
- "description": "The mirror URL to use for nightly Electron builds."
1257
- },
1258
- "resolveAssetURL": {
1259
- "type": "string",
1260
- "description": "A custom function (serialised) to resolve the full asset URL."
1261
- }
1262
- }
1338
+ "x64ArchFiles": {
1339
+ "description": "A {@link https://github.com/isaacs/minimatch?tab=readme-ov-file#features minimatch}\npattern of binaries that are expected to be the same x64 binary in both\n\nUse this if your application contains binaries that have already been merged into a universal file\nusing the `lipo` tool.",
1340
+ "type": "string"
1263
1341
  }
1264
1342
  },
1265
1343
  "type": "object"
@@ -1483,6 +1561,9 @@
1483
1561
  {
1484
1562
  "$ref": "#/definitions/SpacesOptions"
1485
1563
  },
1564
+ {
1565
+ "$ref": "#/definitions/R2Options"
1566
+ },
1486
1567
  {
1487
1568
  "$ref": "#/definitions/GenericServerOptions"
1488
1569
  },
@@ -1564,7 +1645,7 @@
1564
1645
  "type": "boolean"
1565
1646
  },
1566
1647
  "enableEmbeddedAsarIntegrityValidation": {
1567
- "description": "Enables ASAR integrity validation — Electron verifies the embedded SHA-256 hash of\n`app.asar` before loading it.\n\nPlatform support:\n- macOS: Electron ≥ 16.0.0\n- Windows: Electron ≥ 30.0.0\n\nFor this fuse to be meaningful, `asar.disableIntegrity` must **not** be\n`true` (otherwise the hash is not embedded).\n\nSee the [ASAR Integrity guide](https://www.electronjs.org/docs/latest/tutorial/asar-integrity).",
1648
+ "description": "Enables ASAR integrity validation — Electron verifies the embedded SHA-256 hash of\n`app.asar` before loading it.\n\nPlatform support:\n- macOS: Electron ≥ 16.0.0\n- Windows: Electron ≥ 30.0.0\n\nFor this fuse to be meaningful, `asar.disableIntegrity` must **not** be\n`true` (otherwise the hash is not embedded).",
1568
1649
  "type": "boolean"
1569
1650
  },
1570
1651
  "enableNodeCliInspectArguments": {
@@ -1588,12 +1669,16 @@
1588
1669
  "type": "boolean"
1589
1670
  },
1590
1671
  "resetAdHocDarwinSignature": {
1591
- "description": "Re-applies the ad-hoc codesignature on macOS after fuses are flipped.\n\nelectron-builder already re-signs the app after flipping fuses, so this flag is\ngenerally not needed and exists only as a compatibility shim for edge cases.\n\nSee [`@electron/fuses` — Apple Silicon](https://github.com/electron/fuses?tab=readme-ov-file#apple-silicon).",
1672
+ "description": "Re-applies the ad-hoc codesignature on macOS after fuses are flipped.\n\nelectron-builder already re-signs the app after flipping fuses, so this flag is\ngenerally not needed and exists only as a compatibility shim for edge cases.",
1592
1673
  "type": "boolean"
1593
1674
  },
1594
1675
  "runAsNode": {
1595
1676
  "description": "Controls whether the `ELECTRON_RUN_AS_NODE` environment variable is respected.\n\nWhen `true` (the Electron default), setting `ELECTRON_RUN_AS_NODE=1` in the environment\nmakes Electron behave like a plain Node.js process, bypassing the app entirely. Disable\nthis fuse in production apps to prevent that escape path.\n\n**Note:** Disabling this fuse also breaks `process.fork()` in the main process because\nit relies on `ELECTRON_RUN_AS_NODE` internally. Use\n[Utility Processes](https://www.electronjs.org/docs/latest/api/utility-process) as a\nreplacement.",
1596
1677
  "type": "boolean"
1678
+ },
1679
+ "wasmTrapHandlers": {
1680
+ "description": "Enables V8 signal-based trap handlers for out-of-bounds WebAssembly memory accesses.\n\nWhen enabled, Electron uses OS signals (e.g. `SIGSEGV` on Linux/macOS) to catch Wasm\nOOB accesses at the hardware level rather than inserting explicit bounds checks in JIT'd\ncode. This improves Wasm performance and is enabled by default in Electron.\n\nDisable only if the host environment restricts signal handlers (e.g. certain sandboxing\nconfigurations) and you observe crashes in Wasm-heavy workloads.",
1681
+ "type": "boolean"
1597
1682
  }
1598
1683
  },
1599
1684
  "type": "object"
@@ -1617,7 +1702,7 @@
1617
1702
  },
1618
1703
  "publishAutoUpdate": {
1619
1704
  "default": true,
1620
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
1705
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
1621
1706
  "type": "boolean"
1622
1707
  },
1623
1708
  "publisherName": {
@@ -1645,6 +1730,23 @@
1645
1730
  "number"
1646
1731
  ]
1647
1732
  },
1733
+ "updateManifestPublicKey": {
1734
+ "anyOf": [
1735
+ {
1736
+ "items": {
1737
+ "type": "string"
1738
+ },
1739
+ "type": "array"
1740
+ },
1741
+ {
1742
+ "type": [
1743
+ "null",
1744
+ "string"
1745
+ ]
1746
+ }
1747
+ ],
1748
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
1749
+ },
1648
1750
  "updaterCacheDirName": {
1649
1751
  "type": [
1650
1752
  "null",
@@ -1694,7 +1796,7 @@
1694
1796
  ]
1695
1797
  },
1696
1798
  "private": {
1697
- "description": "Whether to use private github auto-update provider if `GH_TOKEN` environment variable is defined. See [Private GitHub Update Repo](https://www.electron.build/auto-update#private-github-update-repo).",
1799
+ "description": "Whether to use private github auto-update provider if `GH_TOKEN` environment variable is defined. See [Private GitHub Update Repo](https://www.electron.build/docs/features/auto-update#private-github-update-repo).",
1698
1800
  "type": [
1699
1801
  "null",
1700
1802
  "boolean"
@@ -1723,7 +1825,7 @@
1723
1825
  },
1724
1826
  "publishAutoUpdate": {
1725
1827
  "default": true,
1726
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
1828
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
1727
1829
  "type": "boolean"
1728
1830
  },
1729
1831
  "publisherName": {
@@ -1781,20 +1883,37 @@
1781
1883
  ]
1782
1884
  },
1783
1885
  "token": {
1784
- "description": "The access token to support auto-update from private github repositories. Never specify it in the configuration files. Only for [setFeedURL](https://www.electron.build/auto-update#appupdatersetfeedurloptions).",
1886
+ "description": "The access token to support auto-update from private github repositories. Never specify it in the configuration files. Only for [setFeedURL](https://www.electron.build/docs/features/auto-update#custom-options-instantiating-updater-directly).",
1785
1887
  "type": [
1786
1888
  "null",
1787
1889
  "string"
1788
1890
  ]
1789
1891
  },
1790
- "updaterCacheDirName": {
1791
- "type": [
1792
- "null",
1793
- "string"
1794
- ]
1795
- }
1796
- },
1797
- "required": [
1892
+ "updateManifestPublicKey": {
1893
+ "anyOf": [
1894
+ {
1895
+ "items": {
1896
+ "type": "string"
1897
+ },
1898
+ "type": "array"
1899
+ },
1900
+ {
1901
+ "type": [
1902
+ "null",
1903
+ "string"
1904
+ ]
1905
+ }
1906
+ ],
1907
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
1908
+ },
1909
+ "updaterCacheDirName": {
1910
+ "type": [
1911
+ "null",
1912
+ "string"
1913
+ ]
1914
+ }
1915
+ },
1916
+ "required": [
1798
1917
  "provider"
1799
1918
  ],
1800
1919
  "type": "object"
@@ -1834,7 +1953,7 @@
1834
1953
  },
1835
1954
  "publishAutoUpdate": {
1836
1955
  "default": true,
1837
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
1956
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
1838
1957
  "type": "boolean"
1839
1958
  },
1840
1959
  "publisherName": {
@@ -1869,6 +1988,23 @@
1869
1988
  "string"
1870
1989
  ]
1871
1990
  },
1991
+ "updateManifestPublicKey": {
1992
+ "anyOf": [
1993
+ {
1994
+ "items": {
1995
+ "type": "string"
1996
+ },
1997
+ "type": "array"
1998
+ },
1999
+ {
2000
+ "type": [
2001
+ "null",
2002
+ "string"
2003
+ ]
2004
+ }
2005
+ ],
2006
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
2007
+ },
1872
2008
  "updaterCacheDirName": {
1873
2009
  "type": [
1874
2010
  "null",
@@ -1952,7 +2088,7 @@
1952
2088
  },
1953
2089
  "publishAutoUpdate": {
1954
2090
  "default": true,
1955
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
2091
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
1956
2092
  "type": "boolean"
1957
2093
  },
1958
2094
  "publisherName": {
@@ -1980,6 +2116,23 @@
1980
2116
  "number"
1981
2117
  ]
1982
2118
  },
2119
+ "updateManifestPublicKey": {
2120
+ "anyOf": [
2121
+ {
2122
+ "items": {
2123
+ "type": "string"
2124
+ },
2125
+ "type": "array"
2126
+ },
2127
+ {
2128
+ "type": [
2129
+ "null",
2130
+ "string"
2131
+ ]
2132
+ }
2133
+ ],
2134
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
2135
+ },
1983
2136
  "updaterCacheDirName": {
1984
2137
  "type": [
1985
2138
  "null",
@@ -2018,11 +2171,10 @@
2018
2171
  "$ref": "#/definitions/AsarOptions"
2019
2172
  },
2020
2173
  {
2021
- "const": false,
2022
- "type": "boolean"
2023
- },
2024
- {
2025
- "type": "null"
2174
+ "type": [
2175
+ "null",
2176
+ "boolean"
2177
+ ]
2026
2178
  }
2027
2179
  ],
2028
2180
  "default": true,
@@ -2091,14 +2243,6 @@
2091
2243
  "description": "Whether to infer update channel from application version pre-release components. e.g. if version `0.12.1-alpha.1`, channel will be set to `alpha`. Otherwise to `latest`.\nThis does *not* apply to github publishing, which will [never auto-detect the update channel](https://github.com/electron-userland/electron-builder/issues/8589).",
2092
2244
  "type": "boolean"
2093
2245
  },
2094
- "disableDefaultIgnoredFiles": {
2095
- "default": false,
2096
- "description": "Whether to exclude all default ignored files(https://www.electron.build/contents#files) and options. Defaults to `false`.",
2097
- "type": [
2098
- "null",
2099
- "boolean"
2100
- ]
2101
- },
2102
2246
  "electronLanguages": {
2103
2247
  "anyOf": [
2104
2248
  {
@@ -2114,7 +2258,7 @@
2114
2258
  "description": "The electron locales to keep. By default, all Electron locales used as-is."
2115
2259
  },
2116
2260
  "electronUpdaterCompatibility": {
2117
- "description": "The [electron-updater compatibility](https://www.electron.build/auto-update#compatibility) semver range.",
2261
+ "description": "The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range.",
2118
2262
  "type": [
2119
2263
  "null",
2120
2264
  "string"
@@ -2234,7 +2378,7 @@
2234
2378
  ]
2235
2379
  }
2236
2380
  ],
2237
- "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
2381
+ "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,slnx,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
2238
2382
  },
2239
2383
  "forceCodeSigning": {
2240
2384
  "default": false,
@@ -2305,6 +2449,9 @@
2305
2449
  {
2306
2450
  "$ref": "#/definitions/SpacesOptions"
2307
2451
  },
2452
+ {
2453
+ "$ref": "#/definitions/R2Options"
2454
+ },
2308
2455
  {
2309
2456
  "$ref": "#/definitions/GenericServerOptions"
2310
2457
  },
@@ -2339,11 +2486,6 @@
2339
2486
  "$ref": "#/definitions/ReleaseInfo",
2340
2487
  "description": "The release info. Intended for command line usage:\n\n```\n-c.releaseInfo.releaseNotes=\"new features\"\n```"
2341
2488
  },
2342
- "syncDesktopName": {
2343
- "default": false,
2344
- "description": "When `true`, the installed `.desktop` filename is derived from `desktopName` in `package.json`\n(minus the `.desktop` suffix) so that it matches `StartupWMClass` and Electron's `app_id`.\nFalls back to `executableName` when `desktopName` is absent.",
2345
- "type": "boolean"
2346
- },
2347
2489
  "synopsis": {
2348
2490
  "description": "The [short description](https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Description).",
2349
2491
  "type": [
@@ -2377,7 +2519,21 @@
2377
2519
  }
2378
2520
  ],
2379
2521
  "default": "AppImage",
2380
- "description": "Target package type: list of `AppImage`, `flatpak`, `snap`, `deb`, `rpm`, `freebsd`, `pacman`, `p5p`, `apk`, `7z`, `zip`, `tar.xz`, `tar.lz`, `tar.gz`, `tar.bz2`, `dir`.\n\nelectron-builder [docker image](https://www.electron.build/multi-platform-build#docker) can be used to build Linux targets on any platform.\n\nPlease [do not put an AppImage into another archive](https://github.com/probonopd/AppImageKit/wiki/Creating-AppImages#common-mistake) like a .zip or .tar.gz."
2522
+ "description": "Target package type: list of `AppImage`, `flatpak`, `snap`, `deb`, `rpm`, `freebsd`, `pacman`, `p5p`, `apk`, `7z`, `zip`, `tar.xz`, `tar.lz`, `tar.gz`, `tar.bz2`, `dir`.\n\nelectron-builder [docker image](https://www.electron.build/docs/features/multi-platform-build#docker) can be used to build Linux targets on any platform.\n\nPlease [do not put an AppImage into another archive](https://github.com/probonopd/AppImageKit/wiki/Creating-AppImages#common-mistake) like a .zip or .tar.gz."
2523
+ },
2524
+ "updateManifest": {
2525
+ "anyOf": [
2526
+ {
2527
+ "$ref": "#/definitions/UpdateManifestSigningOptions"
2528
+ },
2529
+ {
2530
+ "const": false
2531
+ },
2532
+ {
2533
+ "type": "null"
2534
+ }
2535
+ ],
2536
+ "description": "Ed25519 signing of the auto-update manifest (`latest*.yml`). Each manifest is signed and its public key is\nembedded into `app-update.yml`, so electron-updater verifies the signature before downloading an update.\n\n**Signing is required.** Publishing a build that emits auto-update metadata fails unless a signing key\nresolves. Generate one once with `electron-builder create-update-key`, then supply it via\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` / `ELECTRON_BUILDER_UPDATE_SIGN_KEY_FILE` (preferred in CI) or via\n`signingKey` / `signingKeyFile` below. Leaving this option unset — or `null` — keeps signing required and\nresolves the key from the environment; `null` is not an opt-out.\n\nSet to `false`, the only opt-out, to ship **unsigned** manifests. Every build that produces a manifest then\nlogs a warning. `false` also short-circuits the environment variables, so a leftover\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` in CI cannot re-enable signing by accident.\n\nThe requirement is only enforced when a publish policy is in effect (`--publish`); a build without one\nwarns instead, so local builds and pipelines that sign the manifest in a later step of their own are\nunaffected. It is also waived when every publish provider has `publishAutoUpdate: false`, since no manifest is\nemitted then, and for a build whose targets write no update info (e.g. only snap, flatpak, MSI/MSIX, portable,\nmas/pkg or plain archives). A publishing build checks for the key at build start, before anything is packed\nor uploaded.\n\nSee [Signed Update Manifests](https://www.electron.build/features/signed-update-manifests)."
2381
2537
  },
2382
2538
  "vendor": {
2383
2539
  "description": "The vendor. Defaults to [author](https://www.electron.build/configuration#author).",
@@ -2489,7 +2645,7 @@
2489
2645
  "type": "null"
2490
2646
  }
2491
2647
  ],
2492
- "description": "Package dependencies.\n`rpm` defaults to `[\"gtk3\", \"libnotify\", \"nss\", \"libXScrnSaver\", \"(libXtst or libXtst6)\", \"xdg-utils\", \"at-spi2-core\", \"(libuuid or libuuid1)\"]`\n`pacman` defaults to `[\"c-ares\", \"ffmpeg\", \"gtk3\", \"http-parser\", \"libevent\", \"libvpx\", \"libxslt\", \"libxss\", \"minizip\", \"nss\", \"re2\", \"snappy\", \"libnotify\", \"libappindicator-gtk3\"]`"
2648
+ "description": "Package dependencies.\n`rpm` defaults to `[\"gtk3\", \"libnotify\", \"nss\", \"libXScrnSaver\", \"(libXtst or libXtst6)\", \"xdg-utils\", \"at-spi2-core\", \"(libuuid or libuuid1)\"]`\n`pacman` defaults to `[\"c-ares\", \"ffmpeg\", \"gtk3\", \"libevent\", \"libvpx\", \"libxslt\", \"libxss\", \"minizip\", \"nss\", \"re2\", \"snappy\", \"libnotify\", \"libappindicator-gtk3\"]`\n\nUse the `\"default\"` keyword to extend the target's default list instead of replacing it:\n`[\"default\", \"my-extra-lib\"]` appends `my-extra-lib` to the defaults. The resulting list is deduplicated."
2493
2649
  },
2494
2650
  "description": {
2495
2651
  "description": "As [description](https://www.electron.build/configuration#description) from application package.json, but allows you to specify different for Linux.",
@@ -2588,6 +2744,9 @@
2588
2744
  {
2589
2745
  "$ref": "#/definitions/SpacesOptions"
2590
2746
  },
2747
+ {
2748
+ "$ref": "#/definitions/R2Options"
2749
+ },
2591
2750
  {
2592
2751
  "$ref": "#/definitions/GenericServerOptions"
2593
2752
  },
@@ -2636,20 +2795,6 @@
2636
2795
  "MacConfiguration": {
2637
2796
  "additionalProperties": false,
2638
2797
  "properties": {
2639
- "additionalArguments": {
2640
- "anyOf": [
2641
- {
2642
- "items": {
2643
- "type": "string"
2644
- },
2645
- "type": "array"
2646
- },
2647
- {
2648
- "type": "null"
2649
- }
2650
- ],
2651
- "description": "Array of strings specifying additional arguments to pass to the `codesign` command used to sign a specific file.\n\nSome subresources that you may include in your Electron app may need to be signed with --deep, this is not typically safe to apply to the entire Electron app and therefore should be applied to just your file.\nUsage Example: `['--deep']`"
2652
- },
2653
2798
  "appId": {
2654
2799
  "default": "com.electron.${name}",
2655
2800
  "description": "The application id. Used as [CFBundleIdentifier](https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-102070) for MacOS and as\n[Application User Model ID](https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx) for Windows (NSIS target only, Squirrel.Windows not supported). It is strongly recommended that an explicit ID is set.",
@@ -2671,30 +2816,15 @@
2671
2816
  "$ref": "#/definitions/AsarOptions"
2672
2817
  },
2673
2818
  {
2674
- "const": false,
2675
- "type": "boolean"
2676
- },
2677
- {
2678
- "type": "null"
2819
+ "type": [
2820
+ "null",
2821
+ "boolean"
2822
+ ]
2679
2823
  }
2680
2824
  ],
2681
2825
  "default": true,
2682
2826
  "description": "Whether to package the application's source code into an archive, using [Electron's archive format](http://electron.atom.io/docs/tutorial/application-packaging/).\n\nNode modules that must be unpacked will be detected automatically. Use {@link AsarOptions.unpack} to specify additional files to unpack."
2683
2827
  },
2684
- "binaries": {
2685
- "anyOf": [
2686
- {
2687
- "items": {
2688
- "type": "string"
2689
- },
2690
- "type": "array"
2691
- },
2692
- {
2693
- "type": "null"
2694
- }
2695
- ],
2696
- "description": "Paths of any extra binaries that need to be signed."
2697
- },
2698
2828
  "bundleShortVersion": {
2699
2829
  "description": "The `CFBundleShortVersionString`. Do not use it unless you need to.",
2700
2830
  "type": [
@@ -2771,14 +2901,6 @@
2771
2901
  "description": "Whether to infer update channel from application version pre-release components. e.g. if version `0.12.1-alpha.1`, channel will be set to `alpha`. Otherwise to `latest`.\nThis does *not* apply to github publishing, which will [never auto-detect the update channel](https://github.com/electron-userland/electron-builder/issues/8589).",
2772
2902
  "type": "boolean"
2773
2903
  },
2774
- "disableDefaultIgnoredFiles": {
2775
- "default": false,
2776
- "description": "Whether to exclude all default ignored files(https://www.electron.build/contents#files) and options. Defaults to `false`.",
2777
- "type": [
2778
- "null",
2779
- "boolean"
2780
- ]
2781
- },
2782
2904
  "electronLanguages": {
2783
2905
  "anyOf": [
2784
2906
  {
@@ -2794,28 +2916,7 @@
2794
2916
  "description": "The electron locales to keep. By default, all Electron locales used as-is."
2795
2917
  },
2796
2918
  "electronUpdaterCompatibility": {
2797
- "description": "The [electron-updater compatibility](https://www.electron.build/auto-update#compatibility) semver range.",
2798
- "type": [
2799
- "null",
2800
- "string"
2801
- ]
2802
- },
2803
- "entitlements": {
2804
- "description": "The path to entitlements file for signing the app. `build/entitlements.mac.plist` will be used if exists (it is a recommended way to set).\nMAS entitlements is specified in the [mas](https://www.electron.build/mas).\nSee [this folder in osx-sign's repository](https://github.com/electron/osx-sign/tree/main/entitlements) for examples.\nBe aware that your app may crash if the right entitlements are not set like `com.apple.security.cs.allow-jit` for example on arm64 builds with Electron 20+.\nSee [Signing and Notarizing macOS Builds from the Electron documentation](https://www.electronjs.org/docs/latest/tutorial/code-signing#signing--notarizing-macos-builds) for more information.",
2805
- "type": [
2806
- "null",
2807
- "string"
2808
- ]
2809
- },
2810
- "entitlementsInherit": {
2811
- "description": "The path to child entitlements which inherit the security settings for signing frameworks and bundles of a distribution. `build/entitlements.mac.inherit.plist` will be used if exists (it is a recommended way to set).\nSee [this folder in osx-sign's repository](https://github.com/electron/osx-sign/tree/main/entitlements) for examples.\n\nThis option only applies when signing with `entitlements` provided.",
2812
- "type": [
2813
- "null",
2814
- "string"
2815
- ]
2816
- },
2817
- "entitlementsLoginHelper": {
2818
- "description": "Path to login helper entitlement file.\nWhen using App Sandbox, the the `com.apple.security.inherit` key that is normally in the inherited entitlements cannot be inherited since the login helper is a standalone executable.\nDefaults to the value provided for `entitlements`. This option only applies when signing with `entitlements` provided.",
2919
+ "description": "The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range.",
2819
2920
  "type": [
2820
2921
  "null",
2821
2922
  "string"
@@ -2941,28 +3042,18 @@
2941
3042
  ]
2942
3043
  }
2943
3044
  ],
2944
- "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
3045
+ "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,slnx,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
2945
3046
  },
2946
3047
  "forceCodeSigning": {
2947
3048
  "default": false,
2948
3049
  "description": "Whether to fail if app will be not code signed.",
2949
3050
  "type": "boolean"
2950
3051
  },
2951
- "gatekeeperAssess": {
2952
- "default": false,
2953
- "description": "Whether to let `@electron/osx-sign` validate the signing or not.",
2954
- "type": "boolean"
2955
- },
2956
3052
  "generateUpdatesFilesForAllChannels": {
2957
3053
  "default": false,
2958
3054
  "description": "Please see [Building and Releasing using Channels](https://github.com/electron-userland/electron-builder/issues/1182#issuecomment-324947139).",
2959
3055
  "type": "boolean"
2960
3056
  },
2961
- "hardenedRuntime": {
2962
- "default": true,
2963
- "description": "Whether your app has to be signed with hardened runtime.\n\nWhen using ad-hoc signing (`identity: \"-\"`), hardened runtime enforces library validation which\nwill reject pre-signed Electron frameworks that carry a different Team ID. To resolve this either\nset `hardenedRuntime: false` or add the\n[`com.apple.security.cs.disable-library-validation`](https://developer.apple.com/documentation/BundleResources/Entitlements/com.apple.security.cs.disable-library-validation)\nentitlement to your entitlements file.",
2964
- "type": "boolean"
2965
- },
2966
3057
  "helperBundleId": {
2967
3058
  "default": "${appBundleIdentifier}.helper",
2968
3059
  "description": "The bundle identifier to use in the application helper's plist.",
@@ -3019,18 +3110,6 @@
3019
3110
  "string"
3020
3111
  ]
3021
3112
  },
3022
- "identity": {
3023
- "description": "The signing identity (certificate name) to use when signing. Consider using environment variables [CSC_LINK or CSC_NAME](https://www.electron.build/code-signing) instead of specifying this option.\nMAS installer identity is specified in the [mas](https://www.electron.build/mas).\n\n- **Not set** (default): electron-builder searches the keychain for a valid signing certificate. If none is found, signing is skipped for all architectures — there is no automatic ad-hoc fallback.\n- **`null`**: skip signing entirely.\n- **`\"-\"`**: opt in to ad-hoc signing explicitly. Note that `hardenedRuntime: true` (the default) combined with ad-hoc signing requires\n the [`com.apple.security.cs.disable-library-validation`](https://developer.apple.com/documentation/BundleResources/Entitlements/com.apple.security.cs.disable-library-validation)\n entitlement to prevent app launch failures; otherwise set `hardenedRuntime: false`.",
3024
- "type": [
3025
- "null",
3026
- "string"
3027
- ]
3028
- },
3029
- "mergeASARs": {
3030
- "default": true,
3031
- "description": "Whether to merge ASAR files for different architectures or not.\n\nThis option has no effect unless building for \"universal\" arch.",
3032
- "type": "boolean"
3033
- },
3034
3113
  "minimumSystemVersion": {
3035
3114
  "description": "The minimum version of macOS required for the app to run. Corresponds to `LSMinimumSystemVersion`.",
3036
3115
  "type": [
@@ -3042,11 +3121,6 @@
3042
3121
  "description": "Whether to disable electron-builder's [@electron/notarize](https://github.com/electron/notarize) integration.\n\nNote: In order to activate the notarization step You MUST specify one of the following via environment variables:\n\n1. `APPLE_API_KEY`, `APPLE_API_KEY_ID` and `APPLE_API_ISSUER`.\n2. `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`, and `APPLE_TEAM_ID`\n3. `APPLE_KEYCHAIN` and `APPLE_KEYCHAIN_PROFILE`\n\nFor security reasons it is recommended to use the first option (see https://github.com/electron-userland/electron-builder/issues/7859)",
3043
3122
  "type": "boolean"
3044
3123
  },
3045
- "preAutoEntitlements": {
3046
- "default": true,
3047
- "description": "Whether to enable entitlements automation from `@electron/osx-sign`.",
3048
- "type": "boolean"
3049
- },
3050
3124
  "protocols": {
3051
3125
  "anyOf": [
3052
3126
  {
@@ -3061,13 +3135,6 @@
3061
3135
  ],
3062
3136
  "description": "The URL protocol schemes."
3063
3137
  },
3064
- "provisioningProfile": {
3065
- "description": "The path to the provisioning profile to use when signing, absolute or relative to the app root.",
3066
- "type": [
3067
- "null",
3068
- "string"
3069
- ]
3070
- },
3071
3138
  "publish": {
3072
3139
  "anyOf": [
3073
3140
  {
@@ -3082,6 +3149,9 @@
3082
3149
  {
3083
3150
  "$ref": "#/definitions/SpacesOptions"
3084
3151
  },
3152
+ {
3153
+ "$ref": "#/definitions/R2Options"
3154
+ },
3085
3155
  {
3086
3156
  "$ref": "#/definitions/GenericServerOptions"
3087
3157
  },
@@ -3116,34 +3186,13 @@
3116
3186
  "$ref": "#/definitions/ReleaseInfo",
3117
3187
  "description": "The release info. Intended for command line usage:\n\n```\n-c.releaseInfo.releaseNotes=\"new features\"\n```"
3118
3188
  },
3119
- "requirements": {
3120
- "description": "Path of [requirements file](https://developer.apple.com/library/mac/documentation/Security/Conceptual/CodeSigningGuide/RequirementLang/RequirementLang.html) used in signing. Not applicable for MAS.",
3121
- "type": [
3122
- "null",
3123
- "string"
3124
- ]
3125
- },
3126
3189
  "sign": {
3127
3190
  "anyOf": [
3128
3191
  {
3129
- "typeof": "function"
3192
+ "$ref": "#/definitions/ElectronSignOptions"
3130
3193
  },
3131
3194
  {
3132
- "type": [
3133
- "null",
3134
- "string"
3135
- ]
3136
- }
3137
- ],
3138
- "description": "The custom function (or path to file or module id) to sign an app bundle."
3139
- },
3140
- "signIgnore": {
3141
- "anyOf": [
3142
- {
3143
- "items": {
3144
- "type": "string"
3145
- },
3146
- "type": "array"
3195
+ "typeof": "function"
3147
3196
  },
3148
3197
  {
3149
3198
  "type": [
@@ -3152,19 +3201,7 @@
3152
3201
  ]
3153
3202
  }
3154
3203
  ],
3155
- "description": "Regex or an array of regex's that signal skipping signing a file."
3156
- },
3157
- "singleArchFiles": {
3158
- "description": "Minimatch pattern of paths that are allowed to be present in one of the\nASAR files, but not in the other.\n\nThis option has no effect unless building for \"universal\" arch and applies\nonly if `mergeASARs` is `true`.",
3159
- "type": [
3160
- "null",
3161
- "string"
3162
- ]
3163
- },
3164
- "strictVerify": {
3165
- "default": true,
3166
- "description": "Whether to let `@electron/osx-sign` verify the contents or not.",
3167
- "type": "boolean"
3204
+ "description": "Codesigning configuration. The signing certificate is selected via `sign.identity` (or the\n`CSC_LINK` / `CSC_NAME` environment variables).\n\n- **Not set** (default): electron-builder auto-discovers a valid certificate in the keychain. If none is found, signing is skipped.\n- **`null`**: skip signing entirely.\n- **`string`**: path or module ID of a file that exports a {@link CustomMacSign} function.\n- **{@link CustomMacSign}**: inline custom signing function (JS/TS config only).\n- **{@link ElectronSignOptions}**: options forwarded directly to `@electron/osx-sign`."
3168
3205
  },
3169
3206
  "target": {
3170
3207
  "anyOf": [
@@ -3222,56 +3259,37 @@
3222
3259
  "default": "default (dmg and zip for Squirrel.Mac)",
3223
3260
  "description": "The target package type: list of `default`, `dmg`, `mas`, `mas-dev`, `pkg`, `7z`, `zip`, `tar.xz`, `tar.lz`, `tar.gz`, `tar.bz2`, `dir`.\nNote: Squirrel.Mac auto update mechanism requires both `dmg` and `zip` to be enabled, even when only `dmg` is used. Disabling `zip` will break auto update in `dmg` packages."
3224
3261
  },
3225
- "timestamp": {
3226
- "description": "Specify the URL of the timestamp authority server",
3227
- "type": [
3228
- "null",
3229
- "string"
3230
- ]
3231
- },
3232
- "type": {
3262
+ "universal": {
3233
3263
  "anyOf": [
3234
3264
  {
3235
- "enum": [
3236
- "development",
3237
- "distribution"
3238
- ],
3239
- "type": "string"
3265
+ "$ref": "#/definitions/ElectronUniversalOptions"
3240
3266
  },
3241
3267
  {
3242
3268
  "type": "null"
3243
3269
  }
3244
3270
  ],
3245
- "default": "distribution",
3246
- "description": "Whether to sign app for development or for distribution."
3271
+ "description": "Options forwarded to `@electron/universal` when building a universal (multi-arch) app.\nHas no effect unless the target arch is `universal`."
3247
3272
  },
3248
- "x64ArchFiles": {
3249
- "description": "Minimatch pattern of paths that are allowed to be x64 binaries in both\nASAR files\n\nThis option has no effect unless building for \"universal\" arch and applies\nonly if `mergeASARs` is `true`.",
3250
- "type": [
3251
- "null",
3252
- "string"
3253
- ]
3254
- }
3255
- },
3256
- "type": "object"
3257
- },
3258
- "MasConfiguration": {
3259
- "additionalProperties": false,
3260
- "properties": {
3261
- "additionalArguments": {
3273
+ "updateManifest": {
3262
3274
  "anyOf": [
3263
3275
  {
3264
- "items": {
3265
- "type": "string"
3266
- },
3267
- "type": "array"
3276
+ "$ref": "#/definitions/UpdateManifestSigningOptions"
3277
+ },
3278
+ {
3279
+ "const": false
3268
3280
  },
3269
3281
  {
3270
3282
  "type": "null"
3271
3283
  }
3272
3284
  ],
3273
- "description": "Array of strings specifying additional arguments to pass to the `codesign` command used to sign a specific file.\n\nSome subresources that you may include in your Electron app may need to be signed with --deep, this is not typically safe to apply to the entire Electron app and therefore should be applied to just your file.\nUsage Example: `['--deep']`"
3274
- },
3285
+ "description": "Ed25519 signing of the auto-update manifest (`latest*.yml`). Each manifest is signed and its public key is\nembedded into `app-update.yml`, so electron-updater verifies the signature before downloading an update.\n\n**Signing is required.** Publishing a build that emits auto-update metadata fails unless a signing key\nresolves. Generate one once with `electron-builder create-update-key`, then supply it via\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` / `ELECTRON_BUILDER_UPDATE_SIGN_KEY_FILE` (preferred in CI) or via\n`signingKey` / `signingKeyFile` below. Leaving this option unset — or `null` — keeps signing required and\nresolves the key from the environment; `null` is not an opt-out.\n\nSet to `false`, the only opt-out, to ship **unsigned** manifests. Every build that produces a manifest then\nlogs a warning. `false` also short-circuits the environment variables, so a leftover\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` in CI cannot re-enable signing by accident.\n\nThe requirement is only enforced when a publish policy is in effect (`--publish`); a build without one\nwarns instead, so local builds and pipelines that sign the manifest in a later step of their own are\nunaffected. It is also waived when every publish provider has `publishAutoUpdate: false`, since no manifest is\nemitted then, and for a build whose targets write no update info (e.g. only snap, flatpak, MSI/MSIX, portable,\nmas/pkg or plain archives). A publishing build checks for the key at build start, before anything is packed\nor uploaded.\n\nSee [Signed Update Manifests](https://www.electron.build/features/signed-update-manifests)."
3286
+ }
3287
+ },
3288
+ "type": "object"
3289
+ },
3290
+ "MasConfiguration": {
3291
+ "additionalProperties": false,
3292
+ "properties": {
3275
3293
  "appId": {
3276
3294
  "default": "com.electron.${name}",
3277
3295
  "description": "The application id. Used as [CFBundleIdentifier](https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-102070) for MacOS and as\n[Application User Model ID](https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx) for Windows (NSIS target only, Squirrel.Windows not supported). It is strongly recommended that an explicit ID is set.",
@@ -3293,30 +3311,15 @@
3293
3311
  "$ref": "#/definitions/AsarOptions"
3294
3312
  },
3295
3313
  {
3296
- "const": false,
3297
- "type": "boolean"
3298
- },
3299
- {
3300
- "type": "null"
3314
+ "type": [
3315
+ "null",
3316
+ "boolean"
3317
+ ]
3301
3318
  }
3302
3319
  ],
3303
3320
  "default": true,
3304
3321
  "description": "Whether to package the application's source code into an archive, using [Electron's archive format](http://electron.atom.io/docs/tutorial/application-packaging/).\n\nNode modules that must be unpacked will be detected automatically. Use {@link AsarOptions.unpack} to specify additional files to unpack."
3305
3322
  },
3306
- "binaries": {
3307
- "anyOf": [
3308
- {
3309
- "items": {
3310
- "type": "string"
3311
- },
3312
- "type": "array"
3313
- },
3314
- {
3315
- "type": "null"
3316
- }
3317
- ],
3318
- "description": "Paths of any extra binaries that need to be signed."
3319
- },
3320
3323
  "bundleShortVersion": {
3321
3324
  "description": "The `CFBundleShortVersionString`. Do not use it unless you need to.",
3322
3325
  "type": [
@@ -3393,14 +3396,6 @@
3393
3396
  "description": "Whether to infer update channel from application version pre-release components. e.g. if version `0.12.1-alpha.1`, channel will be set to `alpha`. Otherwise to `latest`.\nThis does *not* apply to github publishing, which will [never auto-detect the update channel](https://github.com/electron-userland/electron-builder/issues/8589).",
3394
3397
  "type": "boolean"
3395
3398
  },
3396
- "disableDefaultIgnoredFiles": {
3397
- "default": false,
3398
- "description": "Whether to exclude all default ignored files(https://www.electron.build/contents#files) and options. Defaults to `false`.",
3399
- "type": [
3400
- "null",
3401
- "boolean"
3402
- ]
3403
- },
3404
3399
  "electronLanguages": {
3405
3400
  "anyOf": [
3406
3401
  {
@@ -3416,28 +3411,7 @@
3416
3411
  "description": "The electron locales to keep. By default, all Electron locales used as-is."
3417
3412
  },
3418
3413
  "electronUpdaterCompatibility": {
3419
- "description": "The [electron-updater compatibility](https://www.electron.build/auto-update#compatibility) semver range.",
3420
- "type": [
3421
- "null",
3422
- "string"
3423
- ]
3424
- },
3425
- "entitlements": {
3426
- "description": "The path to entitlements file for signing the app. `build/entitlements.mas.plist` will be used if exists (it is a recommended way to set).\nSee [this folder in osx-sign's repository](https://github.com/electron/osx-sign/tree/main/entitlements) for examples.\nBe aware that your app may crash if the right entitlements are not set like `com.apple.security.cs.allow-jit` for example on arm64 builds with Electron 20+.\nSee [Signing and Notarizing macOS Builds from the Electron documentation](https://www.electronjs.org/docs/latest/tutorial/code-signing#signing--notarizing-macos-builds) for more information.",
3427
- "type": [
3428
- "null",
3429
- "string"
3430
- ]
3431
- },
3432
- "entitlementsInherit": {
3433
- "description": "The path to child entitlements which inherit the security settings for signing frameworks and bundles of a distribution. `build/entitlements.mas.inherit.plist` will be used if exists (it is a recommended way to set).\nSee [this folder in osx-sign's repository](https://github.com/electron/osx-sign/tree/main/entitlements) for examples.",
3434
- "type": [
3435
- "null",
3436
- "string"
3437
- ]
3438
- },
3439
- "entitlementsLoginHelper": {
3440
- "description": "Path to login helper entitlement file.\nWhen using App Sandbox, the the `com.apple.security.inherit` key that is normally in the inherited entitlements cannot be inherited since the login helper is a standalone executable.\nDefaults to the value provided for `entitlements`. This option only applies when signing with `entitlements` provided.",
3414
+ "description": "The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range.",
3441
3415
  "type": [
3442
3416
  "null",
3443
3417
  "string"
@@ -3563,28 +3537,18 @@
3563
3537
  ]
3564
3538
  }
3565
3539
  ],
3566
- "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
3540
+ "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,slnx,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
3567
3541
  },
3568
3542
  "forceCodeSigning": {
3569
3543
  "default": false,
3570
3544
  "description": "Whether to fail if app will be not code signed.",
3571
3545
  "type": "boolean"
3572
3546
  },
3573
- "gatekeeperAssess": {
3574
- "default": false,
3575
- "description": "Whether to let `@electron/osx-sign` validate the signing or not.",
3576
- "type": "boolean"
3577
- },
3578
3547
  "generateUpdatesFilesForAllChannels": {
3579
3548
  "default": false,
3580
3549
  "description": "Please see [Building and Releasing using Channels](https://github.com/electron-userland/electron-builder/issues/1182#issuecomment-324947139).",
3581
3550
  "type": "boolean"
3582
3551
  },
3583
- "hardenedRuntime": {
3584
- "default": true,
3585
- "description": "Whether your app has to be signed with hardened runtime.\n\nWhen using ad-hoc signing (`identity: \"-\"`), hardened runtime enforces library validation which\nwill reject pre-signed Electron frameworks that carry a different Team ID. To resolve this either\nset `hardenedRuntime: false` or add the\n[`com.apple.security.cs.disable-library-validation`](https://developer.apple.com/documentation/BundleResources/Entitlements/com.apple.security.cs.disable-library-validation)\nentitlement to your entitlements file.",
3586
- "type": "boolean"
3587
- },
3588
3552
  "helperBundleId": {
3589
3553
  "default": "${appBundleIdentifier}.helper",
3590
3554
  "description": "The bundle identifier to use in the application helper's plist.",
@@ -3641,18 +3605,6 @@
3641
3605
  "string"
3642
3606
  ]
3643
3607
  },
3644
- "identity": {
3645
- "description": "The signing identity (certificate name) to use when signing. Consider using environment variables [CSC_LINK or CSC_NAME](https://www.electron.build/code-signing) instead of specifying this option.\nMAS installer identity is specified in the [mas](https://www.electron.build/mas).\n\n- **Not set** (default): electron-builder searches the keychain for a valid signing certificate. If none is found, signing is skipped for all architectures — there is no automatic ad-hoc fallback.\n- **`null`**: skip signing entirely.\n- **`\"-\"`**: opt in to ad-hoc signing explicitly. Note that `hardenedRuntime: true` (the default) combined with ad-hoc signing requires\n the [`com.apple.security.cs.disable-library-validation`](https://developer.apple.com/documentation/BundleResources/Entitlements/com.apple.security.cs.disable-library-validation)\n entitlement to prevent app launch failures; otherwise set `hardenedRuntime: false`.",
3646
- "type": [
3647
- "null",
3648
- "string"
3649
- ]
3650
- },
3651
- "mergeASARs": {
3652
- "default": true,
3653
- "description": "Whether to merge ASAR files for different architectures or not.\n\nThis option has no effect unless building for \"universal\" arch.",
3654
- "type": "boolean"
3655
- },
3656
3608
  "minimumSystemVersion": {
3657
3609
  "description": "The minimum version of macOS required for the app to run. Corresponds to `LSMinimumSystemVersion`.",
3658
3610
  "type": [
@@ -3664,11 +3616,6 @@
3664
3616
  "description": "Whether to disable electron-builder's [@electron/notarize](https://github.com/electron/notarize) integration.\n\nNote: In order to activate the notarization step You MUST specify one of the following via environment variables:\n\n1. `APPLE_API_KEY`, `APPLE_API_KEY_ID` and `APPLE_API_ISSUER`.\n2. `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`, and `APPLE_TEAM_ID`\n3. `APPLE_KEYCHAIN` and `APPLE_KEYCHAIN_PROFILE`\n\nFor security reasons it is recommended to use the first option (see https://github.com/electron-userland/electron-builder/issues/7859)",
3665
3617
  "type": "boolean"
3666
3618
  },
3667
- "preAutoEntitlements": {
3668
- "default": true,
3669
- "description": "Whether to enable entitlements automation from `@electron/osx-sign`.",
3670
- "type": "boolean"
3671
- },
3672
3619
  "protocols": {
3673
3620
  "anyOf": [
3674
3621
  {
@@ -3683,13 +3630,6 @@
3683
3630
  ],
3684
3631
  "description": "The URL protocol schemes."
3685
3632
  },
3686
- "provisioningProfile": {
3687
- "description": "The path to the provisioning profile to use when signing, absolute or relative to the app root.",
3688
- "type": [
3689
- "null",
3690
- "string"
3691
- ]
3692
- },
3693
3633
  "publish": {
3694
3634
  "anyOf": [
3695
3635
  {
@@ -3704,6 +3644,9 @@
3704
3644
  {
3705
3645
  "$ref": "#/definitions/SpacesOptions"
3706
3646
  },
3647
+ {
3648
+ "$ref": "#/definitions/R2Options"
3649
+ },
3707
3650
  {
3708
3651
  "$ref": "#/definitions/GenericServerOptions"
3709
3652
  },
@@ -3738,34 +3681,13 @@
3738
3681
  "$ref": "#/definitions/ReleaseInfo",
3739
3682
  "description": "The release info. Intended for command line usage:\n\n```\n-c.releaseInfo.releaseNotes=\"new features\"\n```"
3740
3683
  },
3741
- "requirements": {
3742
- "description": "Path of [requirements file](https://developer.apple.com/library/mac/documentation/Security/Conceptual/CodeSigningGuide/RequirementLang/RequirementLang.html) used in signing. Not applicable for MAS.",
3743
- "type": [
3744
- "null",
3745
- "string"
3746
- ]
3747
- },
3748
3684
  "sign": {
3749
3685
  "anyOf": [
3750
3686
  {
3751
- "typeof": "function"
3687
+ "$ref": "#/definitions/ElectronSignOptions"
3752
3688
  },
3753
3689
  {
3754
- "type": [
3755
- "null",
3756
- "string"
3757
- ]
3758
- }
3759
- ],
3760
- "description": "The custom function (or path to file or module id) to sign an app bundle."
3761
- },
3762
- "signIgnore": {
3763
- "anyOf": [
3764
- {
3765
- "items": {
3766
- "type": "string"
3767
- },
3768
- "type": "array"
3690
+ "typeof": "function"
3769
3691
  },
3770
3692
  {
3771
3693
  "type": [
@@ -3774,19 +3696,7 @@
3774
3696
  ]
3775
3697
  }
3776
3698
  ],
3777
- "description": "Regex or an array of regex's that signal skipping signing a file."
3778
- },
3779
- "singleArchFiles": {
3780
- "description": "Minimatch pattern of paths that are allowed to be present in one of the\nASAR files, but not in the other.\n\nThis option has no effect unless building for \"universal\" arch and applies\nonly if `mergeASARs` is `true`.",
3781
- "type": [
3782
- "null",
3783
- "string"
3784
- ]
3785
- },
3786
- "strictVerify": {
3787
- "default": true,
3788
- "description": "Whether to let `@electron/osx-sign` verify the contents or not.",
3789
- "type": "boolean"
3699
+ "description": "Codesigning configuration. The signing certificate is selected via `sign.identity` (or the\n`CSC_LINK` / `CSC_NAME` environment variables).\n\n- **Not set** (default): electron-builder auto-discovers a valid certificate in the keychain. If none is found, signing is skipped.\n- **`null`**: skip signing entirely.\n- **`string`**: path or module ID of a file that exports a {@link CustomMacSign} function.\n- **{@link CustomMacSign}**: inline custom signing function (JS/TS config only).\n- **{@link ElectronSignOptions}**: options forwarded directly to `@electron/osx-sign`."
3790
3700
  },
3791
3701
  "target": {
3792
3702
  "anyOf": [
@@ -3844,35 +3754,30 @@
3844
3754
  "default": "default (dmg and zip for Squirrel.Mac)",
3845
3755
  "description": "The target package type: list of `default`, `dmg`, `mas`, `mas-dev`, `pkg`, `7z`, `zip`, `tar.xz`, `tar.lz`, `tar.gz`, `tar.bz2`, `dir`.\nNote: Squirrel.Mac auto update mechanism requires both `dmg` and `zip` to be enabled, even when only `dmg` is used. Disabling `zip` will break auto update in `dmg` packages."
3846
3756
  },
3847
- "timestamp": {
3848
- "description": "Specify the URL of the timestamp authority server",
3849
- "type": [
3850
- "null",
3851
- "string"
3852
- ]
3853
- },
3854
- "type": {
3757
+ "universal": {
3855
3758
  "anyOf": [
3856
3759
  {
3857
- "enum": [
3858
- "development",
3859
- "distribution"
3860
- ],
3861
- "type": "string"
3760
+ "$ref": "#/definitions/ElectronUniversalOptions"
3862
3761
  },
3863
3762
  {
3864
3763
  "type": "null"
3865
3764
  }
3866
3765
  ],
3867
- "default": "distribution",
3868
- "description": "Whether to sign app for development or for distribution."
3766
+ "description": "Options forwarded to `@electron/universal` when building a universal (multi-arch) app.\nHas no effect unless the target arch is `universal`."
3869
3767
  },
3870
- "x64ArchFiles": {
3871
- "description": "Minimatch pattern of paths that are allowed to be x64 binaries in both\nASAR files\n\nThis option has no effect unless building for \"universal\" arch and applies\nonly if `mergeASARs` is `true`.",
3872
- "type": [
3873
- "null",
3874
- "string"
3875
- ]
3768
+ "updateManifest": {
3769
+ "anyOf": [
3770
+ {
3771
+ "$ref": "#/definitions/UpdateManifestSigningOptions"
3772
+ },
3773
+ {
3774
+ "const": false
3775
+ },
3776
+ {
3777
+ "type": "null"
3778
+ }
3779
+ ],
3780
+ "description": "Ed25519 signing of the auto-update manifest (`latest*.yml`). Each manifest is signed and its public key is\nembedded into `app-update.yml`, so electron-updater verifies the signature before downloading an update.\n\n**Signing is required.** Publishing a build that emits auto-update metadata fails unless a signing key\nresolves. Generate one once with `electron-builder create-update-key`, then supply it via\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` / `ELECTRON_BUILDER_UPDATE_SIGN_KEY_FILE` (preferred in CI) or via\n`signingKey` / `signingKeyFile` below. Leaving this option unset — or `null` — keeps signing required and\nresolves the key from the environment; `null` is not an opt-out.\n\nSet to `false`, the only opt-out, to ship **unsigned** manifests. Every build that produces a manifest then\nlogs a warning. `false` also short-circuits the environment variables, so a leftover\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` in CI cannot re-enable signing by accident.\n\nThe requirement is only enforced when a publish policy is in effect (`--publish`); a build without one\nwarns instead, so local builds and pipelines that sign the manifest in a later step of their own are\nunaffected. It is also waived when every publish provider has `publishAutoUpdate: false`, since no manifest is\nemitted then, and for a build whose targets write no update info (e.g. only snap, flatpak, MSI/MSIX, portable,\nmas/pkg or plain archives). A publishing build checks for the key at build start, before anything is packed\nor uploaded.\n\nSee [Signed Update Manifests](https://www.electron.build/features/signed-update-manifests)."
3876
3781
  }
3877
3782
  },
3878
3783
  "type": "object"
@@ -3991,6 +3896,9 @@
3991
3896
  {
3992
3897
  "$ref": "#/definitions/SpacesOptions"
3993
3898
  },
3899
+ {
3900
+ "$ref": "#/definitions/R2Options"
3901
+ },
3994
3902
  {
3995
3903
  "$ref": "#/definitions/GenericServerOptions"
3996
3904
  },
@@ -4120,6 +4028,9 @@
4120
4028
  {
4121
4029
  "$ref": "#/definitions/SpacesOptions"
4122
4030
  },
4031
+ {
4032
+ "$ref": "#/definitions/R2Options"
4033
+ },
4123
4034
  {
4124
4035
  "$ref": "#/definitions/GenericServerOptions"
4125
4036
  },
@@ -4183,156 +4094,90 @@
4183
4094
  },
4184
4095
  "type": "object"
4185
4096
  },
4186
- "NativeModulesConfig": {
4187
- "additionalProperties": false,
4188
- "description": "Configuration for native Node.js module installation and rebuilding.\n\nAll options that control how electron-builder handles native modules — from forcing source\nbuilds at install time through to the `@electron/rebuild` compilation mode.",
4189
- "properties": {
4190
- "buildDependenciesFromSource": {
4191
- "default": false,
4192
- "description": "Whether to pass `--build-from-source` to the package manager when installing native\ndependencies, forcing them to compile from source rather than using pre-built binaries.\n\nUseful when pre-built binaries are not available for the target platform/arch combination,\nor when you need to ensure native modules are compiled against the exact Electron ABI.",
4193
- "type": "boolean"
4194
- },
4195
- "nodeGypRebuild": {
4196
- "default": false,
4197
- "description": "Whether to run `node-gyp rebuild` with Electron headers before packaging.\n\nThis is a low-level escape hatch for cases where the standard `@electron/rebuild` path\n(controlled by {@link npmRebuild}) is insufficient. Most projects should leave this `false`\nand rely on `@electron/rebuild` instead.\n\nWhen `true`, electron-builder runs `node-gyp rebuild` with the correct `npm_config_*`\nenvironment variables set for the target Electron version and architecture before the\nnormal rebuild step.",
4198
- "type": "boolean"
4199
- },
4200
- "npmRebuild": {
4201
- "default": true,
4202
- "description": "Whether to rebuild native Node.js modules for the target Electron version and architecture\nbefore packaging.\n\nWhen `true` (the default), electron-builder runs `@electron/rebuild` against the app's\n`node_modules` directory to ensure all native modules are compiled against the correct Electron\nABI. Set to `false` to skip this step entirely — useful when native modules are pre-built\nelsewhere in your pipeline or when the app has no native dependencies.\n\nThe compilation mode (`sequential` vs `parallel`) is controlled by {@link rebuildMode}.",
4203
- "type": "boolean"
4204
- },
4205
- "rebuildMode": {
4206
- "anyOf": [
4207
- {
4208
- "enum": [
4209
- "parallel",
4210
- "sequential"
4211
- ],
4212
- "type": "string"
4213
- },
4214
- {
4215
- "type": "null"
4216
- }
4217
- ],
4218
- "default": "sequential",
4219
- "description": "Compilation mode for `@electron/rebuild`.\n\n- `\"sequential\"` — rebuilds native modules one at a time. Safer in memory-constrained\n environments and produces cleaner log output.\n- `\"parallel\"` — rebuilds all native modules concurrently. Faster on machines with many cores\n and plentiful memory, but may exhaust resources on CI agents with limited RAM."
4220
- }
4221
- },
4222
- "type": "object"
4223
- },
4224
- "NsisOptions": {
4097
+ "MsixOptions": {
4225
4098
  "additionalProperties": false,
4226
4099
  "properties": {
4227
- "allowElevation": {
4228
- "default": true,
4229
- "description": "*assisted installer only.* Allow requesting for elevation. If false, user will have to restart installer with elevated permissions.",
4100
+ "addAutoLaunchExtension": {
4101
+ "description": "Whether to add auto launch extension. Defaults to `true` if electron-winstore-auto-launch is in the dependencies.",
4230
4102
  "type": "boolean"
4231
4103
  },
4232
- "allowToChangeInstallationDirectory": {
4233
- "default": false,
4234
- "description": "*assisted installer only.* Whether to allow user to change installation directory.",
4235
- "type": "boolean"
4104
+ "applicationId": {
4105
+ "description": "The application id. Defaults to `identityName`. This string contains alpha-numeric fields separated by periods.\nEach field must begin with an ASCII alphabetic character.",
4106
+ "type": "string"
4236
4107
  },
4237
4108
  "artifactName": {
4238
- "description": "The [artifact file name template](https://www.electron.build/docs/configuration#artifact-file-name-template). Defaults to `${productName} Setup ${version}.${ext}`.",
4109
+ "description": "The [artifact file name template](https://www.electron.build/configuration#artifact-file-name-template).",
4239
4110
  "type": [
4240
4111
  "null",
4241
4112
  "string"
4242
4113
  ]
4243
4114
  },
4244
- "buildUniversalInstaller": {
4245
- "default": true,
4246
- "description": "Disable building an universal installer of the archs specified in the target configuration\n*Not supported for nsis-web*",
4247
- "type": "boolean"
4248
- },
4249
- "createDesktopShortcut": {
4250
- "default": true,
4251
- "description": "Whether to create desktop shortcut. Set to `always` if to recreate also on reinstall (even if removed by user).",
4252
- "enum": [
4253
- "always",
4254
- false,
4255
- true
4115
+ "backgroundColor": {
4116
+ "default": "#464646",
4117
+ "description": "The background color of the app tile.",
4118
+ "type": [
4119
+ "null",
4120
+ "string"
4256
4121
  ]
4257
4122
  },
4258
- "createStartMenuShortcut": {
4259
- "default": true,
4260
- "description": "Whether to create start menu shortcut.",
4261
- "type": "boolean"
4262
- },
4263
- "customNsisBinary": {
4123
+ "capabilities": {
4264
4124
  "anyOf": [
4265
4125
  {
4266
- "$ref": "#/definitions/CustomNsisBinary"
4126
+ "items": {
4127
+ "type": "string"
4128
+ },
4129
+ "type": "array"
4267
4130
  },
4268
4131
  {
4269
4132
  "type": "null"
4270
4133
  }
4271
4134
  ],
4272
- "description": "Allows you to provide your own `makensis`, such as one with support for debug logging via LogSet and LogText. (Logging also requires option `debugLogging = true`)"
4273
- },
4274
- "customNsisResources": {
4275
- "anyOf": [
4276
- {
4277
- "$ref": "#/definitions/CustomNsisResources"
4278
- },
4279
- {
4280
- "type": "null"
4281
- }
4135
+ "default": [
4136
+ "runFullTrust"
4282
4137
  ],
4283
- "description": "Allows you to provide your own `nsis-resources`"
4284
- },
4285
- "deleteAppDataOnUninstall": {
4286
- "default": false,
4287
- "description": "*one-click installer only.* Whether to delete app data on uninstall.",
4288
- "type": "boolean"
4138
+ "description": "The list of capabilities to be added to the AppxManifest.xml.\nThe `runFullTrust` capability is obligatory for Electron apps and will be auto-added if not specified."
4289
4139
  },
4290
- "differentialPackage": {
4291
- "description": "Marks the package as built with differential download support for the update server.",
4140
+ "createMsixbundle": {
4141
+ "default": true,
4142
+ "description": "Whether to produce a .msixbundle when more than one architecture is built.",
4292
4143
  "type": "boolean"
4293
4144
  },
4294
- "displayLanguageSelector": {
4145
+ "createMsixupload": {
4295
4146
  "default": false,
4296
- "description": "Whether to display a language selection dialog. Not recommended (by default will be detected using OS language).",
4147
+ "description": "Whether to produce a .msixupload archive suitable for submission to the Microsoft Store Partner Center.",
4297
4148
  "type": "boolean"
4298
4149
  },
4299
- "guid": {
4300
- "description": "The GUID for the installer. Used to identify the application for upgrade and uninstall operations.\nIf not specified, a deterministic GUID is generated from the app ID (`appId`) — but this means\nchanging your `appId` will break silent upgrades of existing installs.",
4301
- "type": [
4302
- "null",
4303
- "string"
4304
- ]
4150
+ "customExtensionsPath": {
4151
+ "description": "Relative path to custom extensions xml to be included in the AppxManifest.xml.",
4152
+ "type": "string"
4305
4153
  },
4306
- "include": {
4307
- "description": "The path to NSIS include script to customize installer. Defaults to `build/installer.nsh`. See [Custom NSIS script](#custom-nsis-script).",
4308
- "type": [
4309
- "null",
4310
- "string"
4311
- ]
4154
+ "customManifestPath": {
4155
+ "description": "Relative path to a custom AppxManifest.xml template located in the build resources directory.\nSupports the same `${}` template macros as the default template, including the MSIX-specific\n`${packageIntegrity}` macro. Windows services are injected via the `${extensions}` macro\nalongside protocol/file-association extensions.",
4156
+ "type": "string"
4312
4157
  },
4313
- "installerHeader": {
4314
- "default": "build/installerHeader.bmp",
4315
- "description": "*assisted installer only.* `MUI_HEADERIMAGE`, relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.",
4158
+ "displayName": {
4159
+ "description": "A friendly name displayed to users. Corresponds to Properties.DisplayName. Defaults to the application product name.",
4316
4160
  "type": [
4317
4161
  "null",
4318
4162
  "string"
4319
4163
  ]
4320
4164
  },
4321
- "installerHeaderIcon": {
4322
- "description": "*one-click installer only.* The path to header icon (above the progress bar), relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.\nDefaults to `build/installerHeaderIcon.ico` or application icon.",
4323
- "type": [
4324
- "null",
4325
- "string"
4326
- ]
4165
+ "electronUpdaterAware": {
4166
+ "type": "boolean"
4327
4167
  },
4328
- "installerIcon": {
4329
- "description": "The path to installer icon, relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.\nDefaults to `build/installerIcon.ico` or application icon.",
4168
+ "enforcePackageIntegrity": {
4169
+ "default": false,
4170
+ "description": "Enforce package integrity (uap10:PackageIntegrity). Requires Windows 10 version 2004 (build 19041) or later.\nWhen enabled, Windows verifies that no files have been tampered with after the package was signed.",
4171
+ "type": "boolean"
4172
+ },
4173
+ "identityName": {
4174
+ "description": "The package identity name. Corresponds to Identity.Name. Defaults to the application name.",
4330
4175
  "type": [
4331
4176
  "null",
4332
4177
  "string"
4333
4178
  ]
4334
4179
  },
4335
- "installerLanguages": {
4180
+ "languages": {
4336
4181
  "anyOf": [
4337
4182
  {
4338
4183
  "items": {
@@ -4347,16 +4192,350 @@
4347
4192
  ]
4348
4193
  }
4349
4194
  ],
4350
- "description": "The installer languages (e.g. `en_US`, `de_DE`). Change only if you understand what do you do and for what."
4351
- },
4352
- "installerSidebar": {
4353
- "description": "*assisted installer only.* `MUI_WELCOMEFINISHPAGE_BITMAP`, relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.\nDefaults to `build/installerSidebar.bmp` or `${NSISDIR}\\\\Contrib\\\\Graphics\\\\Wizard\\\\nsis3-metro.bmp`. Image size 164 × 314 pixels.",
4354
- "type": [
4355
- "null",
4356
- "string"
4357
- ]
4195
+ "default": [
4196
+ "en-US"
4197
+ ],
4198
+ "description": "The list of supported languages listed in the Windows Store. The first entry (index 0) will be the default language."
4358
4199
  },
4359
- "language": {
4200
+ "makeappxArgs": {
4201
+ "anyOf": [
4202
+ {
4203
+ "items": {
4204
+ "type": "string"
4205
+ },
4206
+ "type": "array"
4207
+ },
4208
+ {
4209
+ "type": "null"
4210
+ }
4211
+ ]
4212
+ },
4213
+ "maxVersionTested": {
4214
+ "default": "same as minVersion",
4215
+ "description": "Set the MaxVersionTested field in the AppxManifest.xml.",
4216
+ "type": [
4217
+ "null",
4218
+ "string"
4219
+ ]
4220
+ },
4221
+ "minVersion": {
4222
+ "default": "\"10.0.17763.0\" (Windows 10 version 1809 — minimum for Store submissions)",
4223
+ "description": "Set the MinVersion field in the AppxManifest.xml.",
4224
+ "type": [
4225
+ "null",
4226
+ "string"
4227
+ ]
4228
+ },
4229
+ "publish": {
4230
+ "anyOf": [
4231
+ {
4232
+ "$ref": "#/definitions/GithubOptions"
4233
+ },
4234
+ {
4235
+ "$ref": "#/definitions/GitlabOptions"
4236
+ },
4237
+ {
4238
+ "$ref": "#/definitions/S3Options"
4239
+ },
4240
+ {
4241
+ "$ref": "#/definitions/SpacesOptions"
4242
+ },
4243
+ {
4244
+ "$ref": "#/definitions/R2Options"
4245
+ },
4246
+ {
4247
+ "$ref": "#/definitions/GenericServerOptions"
4248
+ },
4249
+ {
4250
+ "$ref": "#/definitions/CustomPublishOptions"
4251
+ },
4252
+ {
4253
+ "$ref": "#/definitions/KeygenOptions"
4254
+ },
4255
+ {
4256
+ "$ref": "#/definitions/SnapStoreOptions"
4257
+ },
4258
+ {
4259
+ "$ref": "#/definitions/BitbucketOptions"
4260
+ },
4261
+ {
4262
+ "items": {
4263
+ "$ref": "#/definitions/AllPublishOptions"
4264
+ },
4265
+ "type": "array"
4266
+ },
4267
+ {
4268
+ "type": [
4269
+ "null",
4270
+ "string"
4271
+ ]
4272
+ }
4273
+ ]
4274
+ },
4275
+ "publisher": {
4276
+ "description": "The Windows Store publisher. Not used if MSIX is built for testing.",
4277
+ "type": [
4278
+ "null",
4279
+ "string"
4280
+ ]
4281
+ },
4282
+ "publisherDisplayName": {
4283
+ "description": "A friendly name for the publisher displayed to users. Corresponds to Properties.PublisherDisplayName.\nDefaults to company name from the application metadata.",
4284
+ "type": [
4285
+ "null",
4286
+ "string"
4287
+ ]
4288
+ },
4289
+ "setBuildNumber": {
4290
+ "default": false,
4291
+ "description": "Whether to set the build number in the version field.",
4292
+ "type": "boolean"
4293
+ },
4294
+ "showNameOnTiles": {
4295
+ "default": false,
4296
+ "description": "Whether to overlay the app's name on top of tile images on the Start screen.",
4297
+ "type": "boolean"
4298
+ },
4299
+ "windowsServices": {
4300
+ "description": "Windows Services to register with the MSIX package (desktop6 namespace).\nRequires Windows 10 version 1903 or later, and the `packagedServices` (or `localSystemServices`)\nrestricted capability declared via `capabilities`.",
4301
+ "items": {
4302
+ "$ref": "#/definitions/MsixWindowsService"
4303
+ },
4304
+ "type": "array"
4305
+ }
4306
+ },
4307
+ "type": "object"
4308
+ },
4309
+ "MsixWindowsService": {
4310
+ "additionalProperties": false,
4311
+ "properties": {
4312
+ "arguments": {
4313
+ "description": "Optional command-line arguments passed to the service executable.",
4314
+ "type": "string"
4315
+ },
4316
+ "executable": {
4317
+ "description": "Relative path to the service executable within the package.\nDefaults to the main app executable.",
4318
+ "type": "string"
4319
+ },
4320
+ "name": {
4321
+ "description": "The service name used in the Windows Service Control Manager.",
4322
+ "type": "string"
4323
+ },
4324
+ "startAccount": {
4325
+ "default": "localSystem",
4326
+ "description": "The account the service runs under. Required by the desktop6 schema.",
4327
+ "enum": [
4328
+ "localService",
4329
+ "localSystem",
4330
+ "networkService"
4331
+ ],
4332
+ "type": "string"
4333
+ },
4334
+ "startupType": {
4335
+ "default": "manual",
4336
+ "description": "How Windows starts the service. Required by the desktop6 schema.",
4337
+ "enum": [
4338
+ "auto",
4339
+ "disabled",
4340
+ "manual"
4341
+ ],
4342
+ "type": "string"
4343
+ }
4344
+ },
4345
+ "required": [
4346
+ "name"
4347
+ ],
4348
+ "type": "object"
4349
+ },
4350
+ "NativeModulesConfig": {
4351
+ "additionalProperties": false,
4352
+ "description": "Configuration for native Node.js module installation and rebuilding.\n\nAll options that control how electron-builder handles native modules — from forcing source\nbuilds at install time through to the `@electron/rebuild` compilation mode.",
4353
+ "properties": {
4354
+ "buildDependenciesFromSource": {
4355
+ "default": false,
4356
+ "description": "Whether to pass `--build-from-source` to the package manager when installing native\ndependencies, forcing them to compile from source rather than using pre-built binaries.\n\nUseful when pre-built binaries are not available for the target platform/arch combination,\nor when you need to ensure native modules are compiled against the exact Electron ABI.\n\nOnly honored when the target platform matches the host platform: native modules cannot be\ncross-compiled from source for another OS, so for a cross-platform target native dependencies are\nrebuilt with prebuilt binaries for that target instead (and a warning is logged).",
4357
+ "type": "boolean"
4358
+ },
4359
+ "nodeGypRebuild": {
4360
+ "default": false,
4361
+ "description": "Whether to run `node-gyp rebuild` with Electron headers before packaging.\n\nThis is a low-level escape hatch for cases where the standard `@electron/rebuild` path\n(controlled by {@link npmRebuild}) is insufficient. Most projects should leave this `false`\nand rely on `@electron/rebuild` instead.\n\nWhen `true`, electron-builder runs `node-gyp rebuild` with the correct `npm_config_*`\nenvironment variables set for the target Electron version and architecture before the\nnormal rebuild step.",
4362
+ "type": "boolean"
4363
+ },
4364
+ "npmRebuild": {
4365
+ "default": true,
4366
+ "description": "Whether to rebuild native Node.js modules for the target Electron version and architecture\nbefore packaging.\n\nWhen `true` (the default), electron-builder runs `@electron/rebuild` against the app's\n`node_modules` directory to ensure all native modules are compiled against the correct Electron\nABI. Set to `false` to skip this step entirely — useful when native modules are pre-built\nelsewhere in your pipeline or when the app has no native dependencies.\n\nThe compilation mode (`sequential` vs `parallel`) is controlled by {@link rebuildMode}.",
4367
+ "type": "boolean"
4368
+ },
4369
+ "rebuildMode": {
4370
+ "anyOf": [
4371
+ {
4372
+ "enum": [
4373
+ "parallel",
4374
+ "sequential"
4375
+ ],
4376
+ "type": "string"
4377
+ },
4378
+ {
4379
+ "type": "null"
4380
+ }
4381
+ ],
4382
+ "default": "sequential",
4383
+ "description": "Compilation mode for `@electron/rebuild`.\n\n- `\"sequential\"` — rebuilds native modules one at a time. Safer in memory-constrained\n environments and produces cleaner log output.\n- `\"parallel\"` — rebuilds all native modules concurrently. Faster on machines with many cores\n and plentiful memory, but may exhaust resources on CI agents with limited RAM."
4384
+ },
4385
+ "verifyNativeBinaries": {
4386
+ "anyOf": [
4387
+ {
4388
+ "enum": [
4389
+ false,
4390
+ true,
4391
+ "warn"
4392
+ ]
4393
+ },
4394
+ {
4395
+ "type": "null"
4396
+ }
4397
+ ],
4398
+ "default": true,
4399
+ "description": "Whether to verify, after the app is packed, that every native binary shipped in the app was built for\nthe target platform and architecture.\n\nelectron-builder reads the header of each `.node` addon (and of other native libraries and executables\nsuch as `.so`, `.dylib`, `.dll`, `.exe`) in `app.asar`, `app.asar.unpacked` or the unpacked `app`\ndirectory, and compares its format (ELF / Mach-O / PE) and machine type against the target (for\na macOS universal build, each per-arch slice is checked before the slices are merged). This catches a\nstale or host-platform binary left in `node_modules` by a skipped or cached rebuild, which otherwise\nonly surfaces at runtime as `invalid ELF header` / `not a valid Win32 application` /\n`incompatible architecture`.\n\nFiles whose package declares another platform via `package.json` `os`/`cpu`, or whose path names\nanother platform/arch (e.g. prebuildify's `prebuilds/linux-arm64/`), are not loaded for this target\nand are ignored.\n\n- `true` (default) — a mismatched `.node` addon fails the build; other mismatched native files log a warning.\n- `\"warn\"` — log every mismatch as a warning and continue.\n- `false` — skip the check."
4400
+ }
4401
+ },
4402
+ "type": "object"
4403
+ },
4404
+ "NsisOptions": {
4405
+ "additionalProperties": false,
4406
+ "properties": {
4407
+ "allowElevation": {
4408
+ "default": true,
4409
+ "description": "*assisted installer only.* Allow requesting for elevation. If false, user will have to restart installer with elevated permissions.",
4410
+ "type": "boolean"
4411
+ },
4412
+ "allowToChangeInstallationDirectory": {
4413
+ "default": false,
4414
+ "description": "*assisted installer only.* Whether to allow user to change installation directory.",
4415
+ "type": "boolean"
4416
+ },
4417
+ "artifactName": {
4418
+ "description": "The [artifact file name template](https://www.electron.build/docs/configuration#artifact-file-name-template). Defaults to `${productName} Setup ${version}.${ext}`.",
4419
+ "type": [
4420
+ "null",
4421
+ "string"
4422
+ ]
4423
+ },
4424
+ "buildUniversalInstaller": {
4425
+ "default": true,
4426
+ "description": "Disable building an universal installer of the archs specified in the target configuration\n*Not supported for nsis-web*",
4427
+ "type": "boolean"
4428
+ },
4429
+ "createDesktopShortcut": {
4430
+ "default": true,
4431
+ "description": "Whether to create desktop shortcut. Set to `always` if to recreate also on reinstall (even if removed by user).",
4432
+ "enum": [
4433
+ "always",
4434
+ false,
4435
+ true
4436
+ ]
4437
+ },
4438
+ "createStartMenuShortcut": {
4439
+ "default": true,
4440
+ "description": "Whether to create start menu shortcut.",
4441
+ "type": "boolean"
4442
+ },
4443
+ "deleteAppDataOnUninstall": {
4444
+ "default": false,
4445
+ "description": "*one-click installer only.* Whether to delete app data on uninstall.",
4446
+ "type": "boolean"
4447
+ },
4448
+ "differentialPackage": {
4449
+ "default": true,
4450
+ "description": "Marks the package as built with differential download support for the update server, and selects how the\napp package is compressed:\n\n- `false` — no differential download support.\n- `\"store-asar\"` — differential-aware, with the app's `resources/app.asar` stored uncompressed (7-Zip\n `Copy`) inside the package. The differential updater diffs the *compressed* package with a\n content-defined blockmap, and the asar is a single compressed member — so any change to app code\n re-downloads the entire compressed asar (~100% of the member; its header rewrite alone diverges every\n block). Storing it keeps unchanged regions byte-identical between releases, making the delta\n proportional to what actually changed (measured on a ~32 MB asar: a one-line source change cost 0.2%\n instead of 100%). The stored asar's byte range is also chunked with finer content-defined blocks\n (4/8/16 KiB instead of the 8/16/32 KiB used for the rest of the installer), so a small change costs\n proportionally fewer bytes still. Trade-off: the installer and full package grow by roughly what\n compressing the asar saved. Without an `app.asar` (e.g. `asar` is disabled) there is nothing to store,\n so it behaves like `true`. Upgrading from an electron-builder without the finer chunking changes the\n block boundaries once: the first differential update from an installer built before it re-downloads\n close to the whole asar, and updates between installers built with it are proportional again.\n- anything else (`true`, `\"compressed\"`, unset) — differential-aware, whole package compressed.",
4451
+ "enum": [
4452
+ "compressed",
4453
+ false,
4454
+ "store-asar",
4455
+ true
4456
+ ]
4457
+ },
4458
+ "displayLanguageSelector": {
4459
+ "default": false,
4460
+ "description": "Whether to display a language selection dialog. Not recommended (by default will be detected using OS language).",
4461
+ "type": "boolean"
4462
+ },
4463
+ "guid": {
4464
+ "description": "The GUID for the installer. Used to identify the application for upgrade and uninstall operations.\nIf not specified, a deterministic GUID is generated from the app ID (`appId`) — but this means\nchanging your `appId` will break silent upgrades of existing installs.",
4465
+ "type": [
4466
+ "null",
4467
+ "string"
4468
+ ]
4469
+ },
4470
+ "include": {
4471
+ "anyOf": [
4472
+ {
4473
+ "items": {
4474
+ "type": "string"
4475
+ },
4476
+ "type": "array"
4477
+ },
4478
+ {
4479
+ "type": [
4480
+ "null",
4481
+ "string"
4482
+ ]
4483
+ }
4484
+ ],
4485
+ "description": "The path to NSIS include script to customize installer, or an array of such paths to include multiple scripts. Defaults to `build/installer.nsh`. See [Custom NSIS script](#custom-nsis-script).\n\nEach path is resolved relative to the [build resources directory](https://www.electron.build/docs/configuration#buildresources) first and then relative to the project directory.\nWhen an array is provided, all scripts are included in the specified order."
4486
+ },
4487
+ "installerDebugLogging": {
4488
+ "default": false,
4489
+ "description": "Whether to enable NSIS logging in the installer and uninstaller (`LogSet on`, which writes `install.log` to the installation\ndirectory). In your custom NSIS scripts, write to the log via `${LogText}`.\n\nRequires a log-enabled NSIS: `makensis` and its stubs compiled with `NSIS_CONFIG_LOG=yes`. The default `toolsets.nsis` bundle\nis not log-enabled, so supply one as a custom `toolsets.nsis` bundle; the build fails otherwise.\nReplaces the v26 `customNsisBinary.debugLogging`.",
4490
+ "type": "boolean"
4491
+ },
4492
+ "installerHeader": {
4493
+ "default": "build/installerHeader.bmp",
4494
+ "description": "*assisted installer only.* `MUI_HEADERIMAGE`, relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.",
4495
+ "type": [
4496
+ "null",
4497
+ "string"
4498
+ ]
4499
+ },
4500
+ "installerHeaderIcon": {
4501
+ "description": "*one-click installer only.* The path to header icon (above the progress bar), relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.\nDefaults to `build/installerHeaderIcon.ico` or application icon.",
4502
+ "type": [
4503
+ "null",
4504
+ "string"
4505
+ ]
4506
+ },
4507
+ "installerIcon": {
4508
+ "description": "The path to installer icon, relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.\nDefaults to `build/installerIcon.ico` or application icon.",
4509
+ "type": [
4510
+ "null",
4511
+ "string"
4512
+ ]
4513
+ },
4514
+ "installerLanguages": {
4515
+ "anyOf": [
4516
+ {
4517
+ "items": {
4518
+ "type": "string"
4519
+ },
4520
+ "type": "array"
4521
+ },
4522
+ {
4523
+ "type": [
4524
+ "null",
4525
+ "string"
4526
+ ]
4527
+ }
4528
+ ],
4529
+ "description": "The installer languages (e.g. `en_US`, `de_DE`). Change only if you understand what do you do and for what."
4530
+ },
4531
+ "installerSidebar": {
4532
+ "description": "*assisted installer only.* `MUI_WELCOMEFINISHPAGE_BITMAP`, relative to the [build resources](https://www.electron.build/docs/contents#extraresources) or to the project directory.\nDefaults to `build/installerSidebar.bmp` or `${NSISDIR}\\\\Contrib\\\\Graphics\\\\Wizard\\\\nsis3-metro.bmp`. Image size 164 × 314 pixels.",
4533
+ "type": [
4534
+ "null",
4535
+ "string"
4536
+ ]
4537
+ },
4538
+ "language": {
4360
4539
  "description": "[LCID Dec](https://msdn.microsoft.com/en-au/goglobal/bb964664.aspx), defaults to `1033`(`English - United States`).",
4361
4540
  "type": [
4362
4541
  "null",
@@ -4439,6 +4618,9 @@
4439
4618
  {
4440
4619
  "$ref": "#/definitions/SpacesOptions"
4441
4620
  },
4621
+ {
4622
+ "$ref": "#/definitions/R2Options"
4623
+ },
4442
4624
  {
4443
4625
  "$ref": "#/definitions/GenericServerOptions"
4444
4626
  },
@@ -4554,7 +4736,7 @@
4554
4736
  },
4555
4737
  "useZip": {
4556
4738
  "default": false,
4557
- "description": "Forces zip compression format instead of LZMA. Used internally for differential update packages.",
4739
+ "description": "Use zip instead of 7z (LZMA) for the embedded app package. Only applies to portable targets and to installers built with `differentialPackage: false`; ignored (with a warning) when `differentialPackage` is enabled and for `nsis-web`, which always use 7z.",
4558
4740
  "type": "boolean"
4559
4741
  },
4560
4742
  "warningsAsErrors": {
@@ -4579,8 +4761,13 @@
4579
4761
  "description": "*assisted installer only.* Whether to allow user to change installation directory.",
4580
4762
  "type": "boolean"
4581
4763
  },
4764
+ "allowUnverifiedAppPackage": {
4765
+ "default": false,
4766
+ "description": "Whether the web installer may install an app package that doesn't match any package built with it: a package passed via `--package-file`,\nor (when `appPackageUrl` is not set) the downloaded package. By default such a package aborts the installation.\n\nEnable only if you intentionally run one web installer with packages of other builds (e.g. a version-independent installer with `--package-file`).",
4767
+ "type": "boolean"
4768
+ },
4582
4769
  "appPackageUrl": {
4583
- "description": "The application package download URL. Optional — by default computed using publish configuration.\n\nURL like `https://example.com/download/latest` allows web installer to be version independent (installer will download latest application package).\nPlease note — it is [full URL](https://github.com/electron-userland/electron-builder/issues/1810#issuecomment-317650878).\n\nCustom `X-Arch` http header is set to `32` or `64`.",
4770
+ "description": "The application package download URL. Optional — by default computed using publish configuration.\n\nURL like `https://example.com/download/latest` allows web installer to be version independent (installer will download latest application package).\nPlease note — it is [full URL](https://github.com/electron-userland/electron-builder/issues/1810#issuecomment-317650878).\n\nCustom `X-Arch` http header is set to `32` or `64`.\n\nThe installer does not checksum-verify a package downloaded from an explicit `appPackageUrl`; a package downloaded from the default (publish-derived) URL is verified against the packages built with the installer.",
4584
4771
  "type": [
4585
4772
  "null",
4586
4773
  "string"
@@ -4613,36 +4800,20 @@
4613
4800
  "description": "Whether to create start menu shortcut.",
4614
4801
  "type": "boolean"
4615
4802
  },
4616
- "customNsisBinary": {
4617
- "anyOf": [
4618
- {
4619
- "$ref": "#/definitions/CustomNsisBinary"
4620
- },
4621
- {
4622
- "type": "null"
4623
- }
4624
- ],
4625
- "description": "Allows you to provide your own `makensis`, such as one with support for debug logging via LogSet and LogText. (Logging also requires option `debugLogging = true`)"
4626
- },
4627
- "customNsisResources": {
4628
- "anyOf": [
4629
- {
4630
- "$ref": "#/definitions/CustomNsisResources"
4631
- },
4632
- {
4633
- "type": "null"
4634
- }
4635
- ],
4636
- "description": "Allows you to provide your own `nsis-resources`"
4637
- },
4638
4803
  "deleteAppDataOnUninstall": {
4639
4804
  "default": false,
4640
4805
  "description": "*one-click installer only.* Whether to delete app data on uninstall.",
4641
4806
  "type": "boolean"
4642
4807
  },
4643
4808
  "differentialPackage": {
4644
- "description": "Marks the package as built with differential download support for the update server.",
4645
- "type": "boolean"
4809
+ "default": true,
4810
+ "description": "Marks the package as built with differential download support for the update server, and selects how the\napp package is compressed:\n\n- `false` — no differential download support.\n- `\"store-asar\"` — differential-aware, with the app's `resources/app.asar` stored uncompressed (7-Zip\n `Copy`) inside the package. The differential updater diffs the *compressed* package with a\n content-defined blockmap, and the asar is a single compressed member — so any change to app code\n re-downloads the entire compressed asar (~100% of the member; its header rewrite alone diverges every\n block). Storing it keeps unchanged regions byte-identical between releases, making the delta\n proportional to what actually changed (measured on a ~32 MB asar: a one-line source change cost 0.2%\n instead of 100%). The stored asar's byte range is also chunked with finer content-defined blocks\n (4/8/16 KiB instead of the 8/16/32 KiB used for the rest of the installer), so a small change costs\n proportionally fewer bytes still. Trade-off: the installer and full package grow by roughly what\n compressing the asar saved. Without an `app.asar` (e.g. `asar` is disabled) there is nothing to store,\n so it behaves like `true`. Upgrading from an electron-builder without the finer chunking changes the\n block boundaries once: the first differential update from an installer built before it re-downloads\n close to the whole asar, and updates between installers built with it are proportional again.\n- anything else (`true`, `\"compressed\"`, unset) — differential-aware, whole package compressed.",
4811
+ "enum": [
4812
+ "compressed",
4813
+ false,
4814
+ "store-asar",
4815
+ true
4816
+ ]
4646
4817
  },
4647
4818
  "displayLanguageSelector": {
4648
4819
  "default": false,
@@ -4657,11 +4828,26 @@
4657
4828
  ]
4658
4829
  },
4659
4830
  "include": {
4660
- "description": "The path to NSIS include script to customize installer. Defaults to `build/installer.nsh`. See [Custom NSIS script](#custom-nsis-script).",
4661
- "type": [
4662
- "null",
4663
- "string"
4664
- ]
4831
+ "anyOf": [
4832
+ {
4833
+ "items": {
4834
+ "type": "string"
4835
+ },
4836
+ "type": "array"
4837
+ },
4838
+ {
4839
+ "type": [
4840
+ "null",
4841
+ "string"
4842
+ ]
4843
+ }
4844
+ ],
4845
+ "description": "The path to NSIS include script to customize installer, or an array of such paths to include multiple scripts. Defaults to `build/installer.nsh`. See [Custom NSIS script](#custom-nsis-script).\n\nEach path is resolved relative to the [build resources directory](https://www.electron.build/docs/configuration#buildresources) first and then relative to the project directory.\nWhen an array is provided, all scripts are included in the specified order."
4846
+ },
4847
+ "installerDebugLogging": {
4848
+ "default": false,
4849
+ "description": "Whether to enable NSIS logging in the installer and uninstaller (`LogSet on`, which writes `install.log` to the installation\ndirectory). In your custom NSIS scripts, write to the log via `${LogText}`.\n\nRequires a log-enabled NSIS: `makensis` and its stubs compiled with `NSIS_CONFIG_LOG=yes`. The default `toolsets.nsis` bundle\nis not log-enabled, so supply one as a custom `toolsets.nsis` bundle; the build fails otherwise.\nReplaces the v26 `customNsisBinary.debugLogging`.",
4850
+ "type": "boolean"
4665
4851
  },
4666
4852
  "installerHeader": {
4667
4853
  "default": "build/installerHeader.bmp",
@@ -4792,6 +4978,9 @@
4792
4978
  {
4793
4979
  "$ref": "#/definitions/SpacesOptions"
4794
4980
  },
4981
+ {
4982
+ "$ref": "#/definitions/R2Options"
4983
+ },
4795
4984
  {
4796
4985
  "$ref": "#/definitions/GenericServerOptions"
4797
4986
  },
@@ -4907,7 +5096,7 @@
4907
5096
  },
4908
5097
  "useZip": {
4909
5098
  "default": false,
4910
- "description": "Forces zip compression format instead of LZMA. Used internally for differential update packages.",
5099
+ "description": "Use zip instead of 7z (LZMA) for the embedded app package. Only applies to portable targets and to installers built with `differentialPackage: false`; ignored (with a warning) when `differentialPackage` is enabled and for `nsis-web`, which always use 7z.",
4911
5100
  "type": "boolean"
4912
5101
  },
4913
5102
  "warningsAsErrors": {
@@ -4918,6 +5107,24 @@
4918
5107
  },
4919
5108
  "type": "object"
4920
5109
  },
5110
+ "Omit<MirrorOptions,\"customFilename\"|\"customDir\"|\"customVersion\">": {
5111
+ "additionalProperties": false,
5112
+ "properties": {
5113
+ "mirror": {
5114
+ "description": "The base URL of the mirror to download from.\ne.g https://github.com/electron/electron/releases/download",
5115
+ "type": "string"
5116
+ },
5117
+ "nightlyMirror": {
5118
+ "description": "The mirror URL for [`electron-nightly`](https://npmjs.com/package/electron-nightly),\nwhich lives in a separate npm package.",
5119
+ "type": "string"
5120
+ },
5121
+ "resolveAssetURL": {
5122
+ "description": "A function allowing customization of the url returned\nfrom getArtifactRemoteURL().",
5123
+ "typeof": "function"
5124
+ }
5125
+ },
5126
+ "type": "object"
5127
+ },
4921
5128
  "OutgoingHttpHeaders": {
4922
5129
  "additionalProperties": {
4923
5130
  "anyOf": [
@@ -5400,7 +5607,7 @@
5400
5607
  "type": "null"
5401
5608
  }
5402
5609
  ],
5403
- "description": "Package dependencies.\n`rpm` defaults to `[\"gtk3\", \"libnotify\", \"nss\", \"libXScrnSaver\", \"(libXtst or libXtst6)\", \"xdg-utils\", \"at-spi2-core\", \"(libuuid or libuuid1)\"]`\n`pacman` defaults to `[\"c-ares\", \"ffmpeg\", \"gtk3\", \"http-parser\", \"libevent\", \"libvpx\", \"libxslt\", \"libxss\", \"minizip\", \"nss\", \"re2\", \"snappy\", \"libnotify\", \"libappindicator-gtk3\"]`"
5610
+ "description": "Package dependencies.\n`rpm` defaults to `[\"gtk3\", \"libnotify\", \"nss\", \"libXScrnSaver\", \"(libXtst or libXtst6)\", \"xdg-utils\", \"at-spi2-core\", \"(libuuid or libuuid1)\"]`\n`pacman` defaults to `[\"c-ares\", \"ffmpeg\", \"gtk3\", \"libevent\", \"libvpx\", \"libxslt\", \"libxss\", \"minizip\", \"nss\", \"re2\", \"snappy\", \"libnotify\", \"libappindicator-gtk3\"]`\n\nUse the `\"default\"` keyword to extend the target's default list instead of replacing it:\n`[\"default\", \"my-extra-lib\"]` appends `my-extra-lib` to the defaults. The resulting list is deduplicated."
5404
5611
  },
5405
5612
  "description": {
5406
5613
  "description": "As [description](https://www.electron.build/configuration#description) from application package.json, but allows you to specify different for Linux.",
@@ -5499,6 +5706,9 @@
5499
5706
  {
5500
5707
  "$ref": "#/definitions/SpacesOptions"
5501
5708
  },
5709
+ {
5710
+ "$ref": "#/definitions/R2Options"
5711
+ },
5502
5712
  {
5503
5713
  "$ref": "#/definitions/GenericServerOptions"
5504
5714
  },
@@ -5664,7 +5874,7 @@
5664
5874
  ]
5665
5875
  },
5666
5876
  "identity": {
5667
- "description": "The name of certificate to use when signing. Consider using environment variables [CSC_LINK or CSC_NAME](https://www.electron.build/code-signing) instead of specifying this option.",
5877
+ "description": "The name of certificate to use when signing. Consider using environment variables [CSC_LINK or CSC_NAME](https://www.electron.build/docs/features/code-signing) instead of specifying this option.",
5668
5878
  "type": [
5669
5879
  "null",
5670
5880
  "string"
@@ -5759,6 +5969,9 @@
5759
5969
  {
5760
5970
  "$ref": "#/definitions/SpacesOptions"
5761
5971
  },
5972
+ {
5973
+ "$ref": "#/definitions/R2Options"
5974
+ },
5762
5975
  {
5763
5976
  "$ref": "#/definitions/GenericServerOptions"
5764
5977
  },
@@ -5836,34 +6049,29 @@
5836
6049
  "description": "Disable building an universal installer of the archs specified in the target configuration",
5837
6050
  "type": "boolean"
5838
6051
  },
5839
- "customNsisBinary": {
5840
- "anyOf": [
5841
- {
5842
- "$ref": "#/definitions/CustomNsisBinary"
5843
- },
5844
- {
5845
- "type": "null"
5846
- }
5847
- ],
5848
- "description": "Allows you to provide your own `makensis`, such as one with support for debug logging via LogSet and LogText. (Logging also requires option `debugLogging = true`)"
6052
+ "guid": {
6053
+ "description": "The GUID for the installer. Used to identify the application for upgrade and uninstall operations.\nIf not specified, a deterministic GUID is generated from the app ID (`appId`) — but this means\nchanging your `appId` will break silent upgrades of existing installs.",
6054
+ "type": [
6055
+ "null",
6056
+ "string"
6057
+ ]
5849
6058
  },
5850
- "customNsisResources": {
6059
+ "include": {
5851
6060
  "anyOf": [
5852
6061
  {
5853
- "$ref": "#/definitions/CustomNsisResources"
6062
+ "items": {
6063
+ "type": "string"
6064
+ },
6065
+ "type": "array"
5854
6066
  },
5855
6067
  {
5856
- "type": "null"
6068
+ "type": [
6069
+ "null",
6070
+ "string"
6071
+ ]
5857
6072
  }
5858
6073
  ],
5859
- "description": "Allows you to provide your own `nsis-resources`"
5860
- },
5861
- "guid": {
5862
- "description": "The GUID for the installer. Used to identify the application for upgrade and uninstall operations.\nIf not specified, a deterministic GUID is generated from the app ID (`appId`) — but this means\nchanging your `appId` will break silent upgrades of existing installs.",
5863
- "type": [
5864
- "null",
5865
- "string"
5866
- ]
6074
+ "description": "The path to NSIS include script to customize the portable launcher, or an array of such paths to include multiple scripts. See [Custom NSIS script](#custom-nsis-script).\n\nEach path is resolved relative to the [build resources directory](https://www.electron.build/docs/configuration#buildresources) first and then relative to the project directory.\nWhen an array is provided, all scripts are included in the specified order.\n\nUnlike the installer targets, the portable target does **not** fall back to `build/installer.nsh` — a custom script is only included when this option is explicitly set."
5867
6075
  },
5868
6076
  "publish": {
5869
6077
  "anyOf": [
@@ -5879,6 +6087,9 @@
5879
6087
  {
5880
6088
  "$ref": "#/definitions/SpacesOptions"
5881
6089
  },
6090
+ {
6091
+ "$ref": "#/definitions/R2Options"
6092
+ },
5882
6093
  {
5883
6094
  "$ref": "#/definitions/GenericServerOptions"
5884
6095
  },
@@ -5896,7 +6107,183 @@
5896
6107
  },
5897
6108
  {
5898
6109
  "items": {
5899
- "$ref": "#/definitions/AllPublishOptions"
6110
+ "$ref": "#/definitions/AllPublishOptions"
6111
+ },
6112
+ "type": "array"
6113
+ },
6114
+ {
6115
+ "type": [
6116
+ "null",
6117
+ "string"
6118
+ ]
6119
+ }
6120
+ ]
6121
+ },
6122
+ "requestExecutionLevel": {
6123
+ "default": "user",
6124
+ "description": "The [requested execution level](http://nsis.sourceforge.net/Reference/RequestExecutionLevel) for Windows.",
6125
+ "enum": [
6126
+ "admin",
6127
+ "highest",
6128
+ "user"
6129
+ ],
6130
+ "type": "string"
6131
+ },
6132
+ "splashImage": {
6133
+ "description": "The image to show while the portable executable is extracting. This image must be a bitmap (`.bmp`) image.",
6134
+ "type": [
6135
+ "null",
6136
+ "string"
6137
+ ]
6138
+ },
6139
+ "unicode": {
6140
+ "default": true,
6141
+ "description": "Whether to create [Unicode installer](http://nsis.sourceforge.net/Docs/Chapter1.html#intro-unicode).",
6142
+ "type": "boolean"
6143
+ },
6144
+ "unpackDirName": {
6145
+ "description": "The unpack directory for the portable app resources.\n\nIf set to a string, it will be the name in [TEMP](https://www.askvg.com/where-does-windows-store-temporary-files-and-how-to-change-temp-folder-location/) directory\nIf set explicitly to `false`, it will use the Windows temp directory ($PLUGINSDIR) that is unique to each launch of the portable application.\n\nDefaults to [uuid](https://github.com/segmentio/ksuid) of build (changed on each build of portable executable).",
6146
+ "type": [
6147
+ "string",
6148
+ "boolean"
6149
+ ]
6150
+ },
6151
+ "useZip": {
6152
+ "default": false,
6153
+ "description": "Use zip instead of 7z (LZMA) for the embedded app package. Only applies to portable targets and to installers built with `differentialPackage: false`; ignored (with a warning) when `differentialPackage` is enabled and for `nsis-web`, which always use 7z.",
6154
+ "type": "boolean"
6155
+ },
6156
+ "warningsAsErrors": {
6157
+ "default": true,
6158
+ "description": "If `warningsAsErrors` is `true` (default): NSIS will treat warnings as errors. If `warningsAsErrors` is `false`: NSIS will allow warnings.",
6159
+ "type": "boolean"
6160
+ }
6161
+ },
6162
+ "type": "object"
6163
+ },
6164
+ "Protocol": {
6165
+ "additionalProperties": false,
6166
+ "description": "URL Protocol Schemes. Protocols to associate the app with. macOS only.\n\nPlease note — on macOS [you need to register an `open-url` event handler](http://electron.atom.io/docs/api/app/#event-open-url-macos).",
6167
+ "properties": {
6168
+ "name": {
6169
+ "description": "The name. e.g. `IRC server URL`.",
6170
+ "type": "string"
6171
+ },
6172
+ "role": {
6173
+ "default": "Editor",
6174
+ "description": "*macOS-only* The app’s role with respect to the type.",
6175
+ "enum": [
6176
+ "Editor",
6177
+ "None",
6178
+ "Shell",
6179
+ "Viewer"
6180
+ ],
6181
+ "type": "string"
6182
+ },
6183
+ "schemes": {
6184
+ "description": "The schemes. e.g. `[\"irc\", \"ircs\"]`.",
6185
+ "items": {
6186
+ "type": "string"
6187
+ },
6188
+ "type": "array"
6189
+ }
6190
+ },
6191
+ "required": [
6192
+ "name",
6193
+ "schemes"
6194
+ ],
6195
+ "type": "object"
6196
+ },
6197
+ "R2Options": {
6198
+ "additionalProperties": false,
6199
+ "description": "[Cloudflare R2](https://developers.cloudflare.com/r2/) options.\nCredentials are required; define `CF_R2_ACCESS_KEY_ID` and `CF_R2_SECRET_ACCESS_KEY` environment variables\nwith an R2 API token (see https://developers.cloudflare.com/r2/api/s3/tokens/).\n\n**Public access for auto-updates:** R2 buckets are private by default. The S3-compatible API endpoint\nalways requires authentication, so `electron-updater` cannot download updates directly from it.\nYou must either enable a custom domain or an r2.dev subdomain for the bucket in the Cloudflare\ndashboard (see https://developers.cloudflare.com/r2/buckets/public-buckets/) and then set\n`publicUrl` to that base URL so the updater knows where to fetch update metadata and binaries.\n\n**ACLs:** R2 does not support S3 ACLs. The `acl` option from `BaseS3Options` is intentionally\nexcluded here. Configure public bucket access in the Cloudflare dashboard instead.\n\nExample configuration:\n\n```json\n{\n\"build\": {\n \"publish\": {\n \"provider\": \"r2\",\n \"bucket\": \"my-releases\",\n \"accountId\": \"abcdef1234567890abcdef1234567890\",\n \"publicUrl\": \"https://pub-abcdef1234567890abcdef1234567890.r2.dev\"\n }\n}\n}\n```",
6200
+ "properties": {
6201
+ "accountId": {
6202
+ "description": "Your Cloudflare account ID (32-character hex string). Found on the R2 overview page\nin the Cloudflare dashboard. Used to construct the S3-compatible upload endpoint:\n`https://<accountId>.r2.cloudflarestorage.com`",
6203
+ "type": "string"
6204
+ },
6205
+ "bucket": {
6206
+ "description": "The R2 bucket name.",
6207
+ "type": "string"
6208
+ },
6209
+ "channel": {
6210
+ "default": "latest",
6211
+ "description": "The update channel.",
6212
+ "type": [
6213
+ "null",
6214
+ "string"
6215
+ ]
6216
+ },
6217
+ "jurisdiction": {
6218
+ "anyOf": [
6219
+ {
6220
+ "enum": [
6221
+ "eu",
6222
+ "fedramp"
6223
+ ],
6224
+ "type": "string"
6225
+ },
6226
+ {
6227
+ "type": "null"
6228
+ }
6229
+ ],
6230
+ "description": "The jurisdiction of the R2 bucket, if the bucket was created with a jurisdictional\nrestriction. Buckets created in a jurisdiction live on a separate endpoint —\n`https://<accountId>.<jurisdiction>.r2.cloudflarestorage.com` — so this must match\nthe jurisdiction the bucket was created with. Omit for regular buckets.\n\nSee https://developers.cloudflare.com/r2/reference/data-location/#jurisdictional-restrictions"
6231
+ },
6232
+ "path": {
6233
+ "default": "/",
6234
+ "description": "The directory path.",
6235
+ "type": [
6236
+ "null",
6237
+ "string"
6238
+ ]
6239
+ },
6240
+ "provider": {
6241
+ "const": "r2",
6242
+ "description": "The provider. Must be `r2`.",
6243
+ "type": "string"
6244
+ },
6245
+ "publicUrl": {
6246
+ "description": "The public base URL from which `electron-updater` will download update metadata and\nbinaries. This must be the URL of your bucket's **custom domain** or **r2.dev subdomain**\n(e.g. `https://pub-xxx.r2.dev` or `https://cdn.example.com`).\n\nRequired when `publishAutoUpdate` is not `false`. The R2 S3 API endpoint requires\nauthentication and cannot serve unauthenticated download requests.\n\nSee https://developers.cloudflare.com/r2/buckets/public-buckets/",
6247
+ "type": [
6248
+ "null",
6249
+ "string"
6250
+ ]
6251
+ },
6252
+ "publishAutoUpdate": {
6253
+ "default": true,
6254
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
6255
+ "type": "boolean"
6256
+ },
6257
+ "publisherName": {
6258
+ "anyOf": [
6259
+ {
6260
+ "items": {
6261
+ "type": "string"
6262
+ },
6263
+ "type": "array"
6264
+ },
6265
+ {
6266
+ "type": "null"
6267
+ }
6268
+ ]
6269
+ },
6270
+ "requestHeaders": {
6271
+ "$ref": "#/definitions/OutgoingHttpHeaders",
6272
+ "description": "Any custom request headers"
6273
+ },
6274
+ "timeout": {
6275
+ "default": 120000,
6276
+ "description": "Request timeout in milliseconds. (Default is 2 minutes; O is ignored)",
6277
+ "type": [
6278
+ "null",
6279
+ "number"
6280
+ ]
6281
+ },
6282
+ "updateManifestPublicKey": {
6283
+ "anyOf": [
6284
+ {
6285
+ "items": {
6286
+ "type": "string"
5900
6287
  },
5901
6288
  "type": "array"
5902
6289
  },
@@ -5906,80 +6293,20 @@
5906
6293
  "string"
5907
6294
  ]
5908
6295
  }
5909
- ]
5910
- },
5911
- "requestExecutionLevel": {
5912
- "default": "user",
5913
- "description": "The [requested execution level](http://nsis.sourceforge.net/Reference/RequestExecutionLevel) for Windows.",
5914
- "enum": [
5915
- "admin",
5916
- "highest",
5917
- "user"
5918
6296
  ],
5919
- "type": "string"
6297
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
5920
6298
  },
5921
- "splashImage": {
5922
- "description": "The image to show while the portable executable is extracting. This image must be a bitmap (`.bmp`) image.",
6299
+ "updaterCacheDirName": {
5923
6300
  "type": [
5924
6301
  "null",
5925
6302
  "string"
5926
6303
  ]
5927
- },
5928
- "unicode": {
5929
- "default": true,
5930
- "description": "Whether to create [Unicode installer](http://nsis.sourceforge.net/Docs/Chapter1.html#intro-unicode).",
5931
- "type": "boolean"
5932
- },
5933
- "unpackDirName": {
5934
- "description": "The unpack directory for the portable app resources.\n\nIf set to a string, it will be the name in [TEMP](https://www.askvg.com/where-does-windows-store-temporary-files-and-how-to-change-temp-folder-location/) directory\nIf set explicitly to `false`, it will use the Windows temp directory ($PLUGINSDIR) that is unique to each launch of the portable application.\n\nDefaults to [uuid](https://github.com/segmentio/ksuid) of build (changed on each build of portable executable).",
5935
- "type": [
5936
- "string",
5937
- "boolean"
5938
- ]
5939
- },
5940
- "useZip": {
5941
- "default": false,
5942
- "description": "Forces zip compression format instead of LZMA. Used internally for differential update packages.",
5943
- "type": "boolean"
5944
- },
5945
- "warningsAsErrors": {
5946
- "default": true,
5947
- "description": "If `warningsAsErrors` is `true` (default): NSIS will treat warnings as errors. If `warningsAsErrors` is `false`: NSIS will allow warnings.",
5948
- "type": "boolean"
5949
- }
5950
- },
5951
- "type": "object"
5952
- },
5953
- "Protocol": {
5954
- "additionalProperties": false,
5955
- "description": "URL Protocol Schemes. Protocols to associate the app with. macOS only.\n\nPlease note — on macOS [you need to register an `open-url` event handler](http://electron.atom.io/docs/api/app/#event-open-url-macos).",
5956
- "properties": {
5957
- "name": {
5958
- "description": "The name. e.g. `IRC server URL`.",
5959
- "type": "string"
5960
- },
5961
- "role": {
5962
- "default": "Editor",
5963
- "description": "*macOS-only* The app’s role with respect to the type.",
5964
- "enum": [
5965
- "Editor",
5966
- "None",
5967
- "Shell",
5968
- "Viewer"
5969
- ],
5970
- "type": "string"
5971
- },
5972
- "schemes": {
5973
- "description": "The schemes. e.g. `[\"irc\", \"ircs\"]`.",
5974
- "items": {
5975
- "type": "string"
5976
- },
5977
- "type": "array"
5978
6304
  }
5979
6305
  },
5980
6306
  "required": [
5981
- "name",
5982
- "schemes"
6307
+ "accountId",
6308
+ "bucket",
6309
+ "provider"
5983
6310
  ],
5984
6311
  "type": "object"
5985
6312
  },
@@ -6075,15 +6402,25 @@
6075
6402
  },
6076
6403
  "RemoteBuildOptions": {
6077
6404
  "additionalProperties": false,
6078
- "description": "Configuration for a remote snap build on [Launchpad](https://launchpad.net/).\nRemote builds run on Canonical's infrastructure without requiring native hardware or nested virtualisation.\n\nEach electron-builder build invocation targets exactly one architecture — to build for multiple\narchitectures, configure the top-level `arch` option (e.g. `arch: [\"x64\", \"arm64\"]`); each arch\nspawns a separate `snapcraft remote-build` job on Launchpad.\n\nAuthentication is resolved in this order:\n1. `cscLink` config field — base64-encoded credentials or a file path\n2. `SNAP_CSC_LINK` environment variable — same format as `cscLink`\n (CI-recommended; follows the same pattern as `WIN_CSC_LINK` for Windows code signing)\n3. `SNAPCRAFT_STORE_CREDENTIALS` environment variable (read directly by snapcraft)\n4. An active interactive `snapcraft login` session\n\n**CI setup** (set once as a CI secret):\n```sh\nexport SNAP_CSC_LINK=$(snapcraft export-login - | base64 -w0)\n```\nThe resolved credentials are injected only into the spawned `snapcraft` subprocess\nenvironment and never exposed through `process.env`.",
6405
+ "description": "Configuration for a remote snap build on [Launchpad](https://launchpad.net/).\nRemote builds run on Canonical's infrastructure without requiring native hardware or nested virtualisation.\n\nA single remote build can target one or more architectures. Set `buildFor` to a string for one\narch, or to an array (e.g. `[\"amd64\", \"arm64\"]`) to build several architectures in a single\n`snapcraft remote-build` job on Launchpad that emits a separate snap artifact per arch.\nAlternatively, the top-level `arch` option (e.g. `arch: [\"x64\", \"arm64\"]`) spawns a separate\nremote-build job per architecture — do not combine that with a `buildFor` array (mutually exclusive).\n\nAuthentication is resolved in this order:\n1. `cscLink` config field — base64-encoded credentials or a file path\n2. `SNAP_CSC_LINK` environment variable — same format as `cscLink`\n (CI-recommended; follows the same pattern as `WIN_CSC_LINK` for Windows code signing)\n3. `SNAPCRAFT_STORE_CREDENTIALS` environment variable (read directly by snapcraft)\n4. An active interactive `snapcraft login` session\n\n**CI setup** (set once as a CI secret):\n```sh\nexport SNAP_CSC_LINK=$(snapcraft export-login - | base64 -w0)\n```\nThe resolved credentials are injected only into the spawned `snapcraft` subprocess\nenvironment and never exposed through `process.env`.",
6079
6406
  "properties": {
6080
6407
  "acceptPublicUpload": {
6081
6408
  "description": "Suppress the Launchpad public-upload consent prompt by automatically accepting it.\nYour source code will be uploaded to a **public** Launchpad repository.\nSet to `true` in CI once you understand the implications.",
6082
6409
  "type": "boolean"
6083
6410
  },
6084
6411
  "buildFor": {
6085
- "description": "Target architecture for the remote build. Accepts a single snapcraft arch string\n(e.g. `\"amd64\"`, `\"arm64\"`, `\"armhf\"`).\n\nTo build for multiple architectures, configure electron-builder's top-level `arch` option\n(e.g. `arch: [\"x64\", \"arm64\"]`) — each arch spawns a separate remote-build job on Launchpad,\nkeeping the one-build-per-artifact contract intact.",
6086
- "type": "string"
6412
+ "anyOf": [
6413
+ {
6414
+ "items": {
6415
+ "type": "string"
6416
+ },
6417
+ "type": "array"
6418
+ },
6419
+ {
6420
+ "type": "string"
6421
+ }
6422
+ ],
6423
+ "description": "Target architecture (or architectures) for the remote build.\n\n- **Single string** (e.g. `\"amd64\"`): one Launchpad job, one output snap.\n- **Array** (e.g. `[\"amd64\", \"arm64\"]`): one Launchpad job that builds all listed\n architectures and downloads each resulting snap. All produced snaps are emitted as\n separate build artifacts.\n\nUsing an array here is mutually exclusive with setting `arch: [\"x64\", \"arm64\"]` at the\nelectron-builder top level — the top-level `arch` option spawns a separate remote-build\njob per architecture, which would duplicate work."
6087
6424
  },
6088
6425
  "enabled": {
6089
6426
  "description": "Whether to enable remote build on Launchpad. Must be set explicitly to `true` to opt in.",
@@ -6187,7 +6524,7 @@
6187
6524
  "type": "null"
6188
6525
  }
6189
6526
  ],
6190
- "description": "Package dependencies.\n`rpm` defaults to `[\"gtk3\", \"libnotify\", \"nss\", \"libXScrnSaver\", \"(libXtst or libXtst6)\", \"xdg-utils\", \"at-spi2-core\", \"(libuuid or libuuid1)\"]`\n`pacman` defaults to `[\"c-ares\", \"ffmpeg\", \"gtk3\", \"http-parser\", \"libevent\", \"libvpx\", \"libxslt\", \"libxss\", \"minizip\", \"nss\", \"re2\", \"snappy\", \"libnotify\", \"libappindicator-gtk3\"]`"
6527
+ "description": "Package dependencies.\n`rpm` defaults to `[\"gtk3\", \"libnotify\", \"nss\", \"libXScrnSaver\", \"(libXtst or libXtst6)\", \"xdg-utils\", \"at-spi2-core\", \"(libuuid or libuuid1)\"]`\n`pacman` defaults to `[\"c-ares\", \"ffmpeg\", \"gtk3\", \"libevent\", \"libvpx\", \"libxslt\", \"libxss\", \"minizip\", \"nss\", \"re2\", \"snappy\", \"libnotify\", \"libappindicator-gtk3\"]`\n\nUse the `\"default\"` keyword to extend the target's default list instead of replacing it:\n`[\"default\", \"my-extra-lib\"]` appends `my-extra-lib` to the defaults. The resulting list is deduplicated."
6191
6528
  },
6192
6529
  "description": {
6193
6530
  "description": "As [description](https://www.electron.build/configuration#description) from application package.json, but allows you to specify different for Linux.",
@@ -6286,6 +6623,9 @@
6286
6623
  {
6287
6624
  "$ref": "#/definitions/SpacesOptions"
6288
6625
  },
6626
+ {
6627
+ "$ref": "#/definitions/R2Options"
6628
+ },
6289
6629
  {
6290
6630
  "$ref": "#/definitions/GenericServerOptions"
6291
6631
  },
@@ -6408,7 +6748,7 @@
6408
6748
  },
6409
6749
  "publishAutoUpdate": {
6410
6750
  "default": true,
6411
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
6751
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
6412
6752
  "type": "boolean"
6413
6753
  },
6414
6754
  "publisherName": {
@@ -6460,6 +6800,23 @@
6460
6800
  "number"
6461
6801
  ]
6462
6802
  },
6803
+ "updateManifestPublicKey": {
6804
+ "anyOf": [
6805
+ {
6806
+ "items": {
6807
+ "type": "string"
6808
+ },
6809
+ "type": "array"
6810
+ },
6811
+ {
6812
+ "type": [
6813
+ "null",
6814
+ "string"
6815
+ ]
6816
+ }
6817
+ ],
6818
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
6819
+ },
6463
6820
  "updaterCacheDirName": {
6464
6821
  "type": [
6465
6822
  "null",
@@ -6489,7 +6846,7 @@
6489
6846
  },
6490
6847
  "SnapOptions24": {
6491
6848
  "additionalProperties": false,
6492
- "description": "**[Beta]** Options for building a core24 snap. This interface does not extend the legacy\n`SnapBaseOptions` — it uses the snapcraft CLI directly.\n\nFields inherited from {@link CommonLinuxOptions} (`description`, `category`, `mimeTypes`,\n`executableArgs`, `desktop`, `synopsis`) are automatically populated from the root `linux.*`\nconfiguration. You do not need to duplicate them here; values set directly on this interface\ntake precedence over the cascaded `linux.*` values.",
6849
+ "description": "Options for building a core24 snap. This interface does not extend the legacy\n`SnapBaseOptions` — it uses the snapcraft CLI directly.\n\nFields inherited from {@link CommonLinuxOptions} (`description`, `category`, `mimeTypes`,\n`executableArgs`, `desktop`, `synopsis`) are automatically populated from the root `linux.*`\nconfiguration. You do not need to duplicate them here; values set directly on this interface\ntake precedence over the cascaded `linux.*` values.",
6493
6850
  "properties": {
6494
6851
  "after": {
6495
6852
  "anyOf": [
@@ -6755,6 +7112,9 @@
6755
7112
  {
6756
7113
  "$ref": "#/definitions/SpacesOptions"
6757
7114
  },
7115
+ {
7116
+ "$ref": "#/definitions/R2Options"
7117
+ },
6758
7118
  {
6759
7119
  "$ref": "#/definitions/GenericServerOptions"
6760
7120
  },
@@ -6793,7 +7153,7 @@
6793
7153
  "type": "null"
6794
7154
  }
6795
7155
  ],
6796
- "description": "Configuration for a remote build on [Launchpad](https://launchpad.net/).\nEnables cross-architecture builds in CI without native hardware or nested virtualisation.\nEach build invocation targets one arch; use `arch: [\"x64\", \"arm64\"]` to build for multiple."
7156
+ "description": "Configuration for a remote build on [Launchpad](https://launchpad.net/).\nEnables cross-architecture builds in CI without native hardware or nested virtualisation.\nSet `remoteBuild.buildFor: [\"amd64\", \"arm64\"]` to build several architectures in one Launchpad\njob, or the top-level `arch: [\"x64\", \"arm64\"]` option to spawn a separate job per architecture\n(the two are mutually exclusive)."
6797
7157
  },
6798
7158
  "slots": {
6799
7159
  "anyOf": [
@@ -7151,6 +7511,9 @@
7151
7511
  {
7152
7512
  "$ref": "#/definitions/SpacesOptions"
7153
7513
  },
7514
+ {
7515
+ "$ref": "#/definitions/R2Options"
7516
+ },
7154
7517
  {
7155
7518
  "$ref": "#/definitions/GenericServerOptions"
7156
7519
  },
@@ -7277,7 +7640,7 @@
7277
7640
  },
7278
7641
  "publishAutoUpdate": {
7279
7642
  "default": true,
7280
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
7643
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
7281
7644
  "type": "boolean"
7282
7645
  },
7283
7646
  "publisherName": {
@@ -7309,6 +7672,23 @@
7309
7672
  "number"
7310
7673
  ]
7311
7674
  },
7675
+ "updateManifestPublicKey": {
7676
+ "anyOf": [
7677
+ {
7678
+ "items": {
7679
+ "type": "string"
7680
+ },
7681
+ "type": "array"
7682
+ },
7683
+ {
7684
+ "type": [
7685
+ "null",
7686
+ "string"
7687
+ ]
7688
+ }
7689
+ ],
7690
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
7691
+ },
7312
7692
  "updaterCacheDirName": {
7313
7693
  "type": [
7314
7694
  "null",
@@ -7385,7 +7765,7 @@
7385
7765
  "type": "null"
7386
7766
  }
7387
7767
  ],
7388
- "description": "**[Beta]** Options for building a core24 snap. Uses the snapcraft CLI directly.\nInherits desktop-entry fields from `CommonLinuxOptions` and publish config from `TargetSpecificOptions`."
7768
+ "description": "Options for building a core24 snap. Uses the snapcraft CLI directly.\nInherits desktop-entry fields from `CommonLinuxOptions` and publish config from `TargetSpecificOptions`."
7389
7769
  },
7390
7770
  "cscLink": {
7391
7771
  "description": "Snapcraft Store credentials — base64-encoded credentials string or file path.\nAccepts the same formats as `WIN_CSC_LINK` / `CSC_LINK`: base64 data,\nabsolute/relative/`~/` file paths, and `file://` URIs.\nRelative paths are resolved against the build resources directory.\n\nInjected as `SNAPCRAFT_STORE_CREDENTIALS` into every snapcraft subprocess\n(core18/core20/core22/core24 builds and `snapcraft upload`).\nNot applied for `base: \"custom\"` — inject credentials manually via environment variables.\n\nThe `SNAP_CSC_LINK` environment variable is the CI-friendly alternative.\nGenerate with: `snapcraft export-login - | base64 -w0`",
@@ -7400,7 +7780,7 @@
7400
7780
  "type": "null"
7401
7781
  }
7402
7782
  ],
7403
- "description": "**[Beta]** Pass-through custom snap configuration. electron-builder will read the\nsnapcraft.yaml at `yamlPath` and use it verbatim — no plugs, extensions,\norganize mappings, or desktop files are injected."
7783
+ "description": "Pass-through custom snap configuration. electron-builder will read the\nsnapcraft.yaml at `yamlPath` and use it verbatim — no plugs, extensions,\norganize mappings, or desktop files are injected."
7404
7784
  },
7405
7785
  "publish": {
7406
7786
  "anyOf": [
@@ -7416,6 +7796,9 @@
7416
7796
  {
7417
7797
  "$ref": "#/definitions/SpacesOptions"
7418
7798
  },
7799
+ {
7800
+ "$ref": "#/definitions/R2Options"
7801
+ },
7419
7802
  {
7420
7803
  "$ref": "#/definitions/GenericServerOptions"
7421
7804
  },
@@ -7751,7 +8134,7 @@
7751
8134
  },
7752
8135
  "publishAutoUpdate": {
7753
8136
  "default": true,
7754
- "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
8137
+ "description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.\nA provider with `false` never becomes the feed embedded in `app-update.yml` while a later provider receives the metadata:\nthe first provider that does is embedded instead.",
7755
8138
  "type": "boolean"
7756
8139
  },
7757
8140
  "publisherName": {
@@ -7783,6 +8166,23 @@
7783
8166
  "number"
7784
8167
  ]
7785
8168
  },
8169
+ "updateManifestPublicKey": {
8170
+ "anyOf": [
8171
+ {
8172
+ "items": {
8173
+ "type": "string"
8174
+ },
8175
+ "type": "array"
8176
+ },
8177
+ {
8178
+ "type": [
8179
+ "null",
8180
+ "string"
8181
+ ]
8182
+ }
8183
+ ],
8184
+ "description": "Ed25519 public key(s) (PEM or base64 SPKI) used by electron-updater to verify the signed update\nmanifest before downloading — the install's trust list. A manifest is accepted when any listed key\nvalidates one of its signatures. Embedded into `app-update.yml` at build time when update manifest\nsigning is enabled: a single string for one key, an array for several. Managed by electron-builder —\npopulated from `updateManifest.publicKey` or derived from the configured signing key(s); setting it\nmanually in the `publish` configuration is rejected as a configuration error."
8185
+ },
7786
8186
  "updaterCacheDirName": {
7787
8187
  "type": [
7788
8188
  "null",
@@ -7807,10 +8207,6 @@
7807
8207
  "string"
7808
8208
  ]
7809
8209
  },
7810
- "customSquirrelVendorDir": {
7811
- "description": "The custom squirrel vendor dir. If not specified will use the Squirrel.Windows that is shipped with electron-installer(https://github.com/electron/windows-installer/tree/main/vendor).\nAfter https://github.com/electron-userland/electron-builder-binaries/pull/56 merged, will add `electron-builder-binaries` to get the latest version of squirrel.",
7812
- "type": "string"
7813
- },
7814
8210
  "iconUrl": {
7815
8211
  "description": "A URL to an ICO file to use as the application icon (displayed in Control Panel > Programs and Features). Defaults to the Electron icon.\n\nPlease note — [local icon file url is not accepted](https://github.com/atom/grunt-electron-installer/issues/73), must be https/http.\n\nIf you don't plan to build windows installer, you can omit it.\nIf your project repository is public on GitHub, it will be `https://github.com/${u}/${p}/blob/master/build/icon.ico?raw=true` by default.",
7816
8212
  "type": [
@@ -7847,6 +8243,9 @@
7847
8243
  {
7848
8244
  "$ref": "#/definitions/SpacesOptions"
7849
8245
  },
8246
+ {
8247
+ "$ref": "#/definitions/R2Options"
8248
+ },
7850
8249
  {
7851
8250
  "$ref": "#/definitions/GenericServerOptions"
7852
8251
  },
@@ -7934,7 +8333,7 @@
7934
8333
  },
7935
8334
  "ToolsetConfig": {
7936
8335
  "additionalProperties": false,
7937
- "description": "Version pins and custom bundle overrides for the binary toolsets that electron-builder\ndownloads and caches locally.\n\nEach toolset is a versioned archive hosted at\n[electron-userland/electron-builder-binaries](https://github.com/electron-userland/electron-builder-binaries/releases).\nOmitting a property (or setting it to `null`) selects the modern default for that toolset.\nSetting a property to `\"0.0.0\"` forces the legacy bundle — useful only for diagnosing\nregressions introduced by newer toolset bundles.\n\nTo supply your own bundle, set the property to a {@link ToolsetCustom} object with a `url`\n(https:// or file://) and a `checksum` for verification. The bundle must mirror the expected\ndirectory layout of the corresponding built-in bundle; see the build scripts at\nhttps://github.com/electron-userland/electron-builder-binaries/tree/master/packages.",
8336
+ "description": "Version pins and custom bundle overrides for the binary toolsets that electron-builder downloads and caches locally.\n\nEach toolset is a versioned archive hosted at [electron-userland/electron-builder-binaries](https://github.com/electron-userland/electron-builder-binaries/releases).\nOmitting a property (or setting it to `latest`) selects the modern default for that toolset.\n\nTo supply your own bundle, set the property to a {@link ToolsetCustom} object with a `url` (https:// or file://) and a `checksum` for verification. The bundle must mirror the expected directory layout of the corresponding built-in bundle; see the build scripts at\nhttps://github.com/electron-userland/electron-builder-binaries/tree/master/packages.",
7938
8337
  "properties": {
7939
8338
  "appimage": {
7940
8339
  "anyOf": [
@@ -7944,17 +8343,15 @@
7944
8343
  {
7945
8344
  "enum": [
7946
8345
  "0.0.0",
7947
- "1.0.2",
7948
- "1.0.3"
8346
+ "1.0.3",
8347
+ "1.1.0",
8348
+ "latest"
7949
8349
  ],
7950
8350
  "type": "string"
7951
- },
7952
- {
7953
- "type": "null"
7954
8351
  }
7955
8352
  ],
7956
- "default": "1.0.3",
7957
- "description": "Version of the AppImage toolset bundle used for building `.AppImage` files.\n\nThe bundle ships:\n- **`mksquashfs`** — creates the SquashFS filesystem embedded in the AppImage.\n- **`desktop-file-validate`** — validates the generated `.desktop` entry.\n- **AppImage runtime** — the self-executing stub that mounts the SquashFS at launch.\n\nAvailable versions:\n| Version | Runtime date | Notes |\n|---------|-------------|-------|\n| `\"0.0.0\"` | Legacy | FUSE2-based AppImage runtime (pre-v27 default) |\n| `\"1.0.2\"` | 20251108 | Static-runtime (FUSE3-compatible) |\n| `\"1.0.3\"` | 20251108 | Static-runtime (FUSE3-compatible); recommended (default) |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/releases?q=appimage"
8353
+ "default": "latest",
8354
+ "description": "Version of the AppImage toolset bundle used for building `.AppImage` files.\n\nThe bundle ships:\n- **`mksquashfs`** — creates the SquashFS filesystem embedded in the AppImage.\n- **`desktop-file-validate`** — validates the generated `.desktop` entry.\n- **AppImage runtime** — the self-executing stub that mounts the SquashFS at launch.\n\nAvailable versions:\n| Version | Runtime date | Notes |\n|---------|-------------|-------|\n| `\"0.0.0\"` | Legacy | FUSE2-based AppImage runtime (pre-v27) |\n| `\"1.0.3\"` | 20251108 | Introduces static AppImage runtime |\n| `\"1.1.0\"` | 20251108 | Adds `unsquashfs` support |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/appimage/CHANGELOG.md"
7958
8355
  },
7959
8356
  "fpm": {
7960
8357
  "anyOf": [
@@ -7962,15 +8359,15 @@
7962
8359
  "$ref": "#/definitions/ToolsetCustom"
7963
8360
  },
7964
8361
  {
7965
- "const": "2.2.1",
8362
+ "enum": [
8363
+ "2.2.1",
8364
+ "latest"
8365
+ ],
7966
8366
  "type": "string"
7967
- },
7968
- {
7969
- "type": "null"
7970
8367
  }
7971
8368
  ],
7972
- "default": "2.2.1",
7973
- "description": "Version of the FPM bundle used to build Linux packages (`.deb`, `.rpm`, `.pacman`, etc.)\non macOS and Linux hosts.\n\nAvailable versions:\n| Version | FPM version | Notes |\n|---------|------------|-------|\n| `\"2.2.1\"` | 1.17.0 (Ruby 3.4.3) | Current default |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/releases?q=fpm"
8369
+ "default": "latest",
8370
+ "description": "Version of the FPM bundle used to build Linux packages (`.deb`, `.rpm`, `.pacman`, etc.)\non macOS and Linux hosts.\n\nAvailable versions:\n| Version | FPM version | Notes |\n|---------|------------|-------|\n| `\"2.2.1\"` | 1.17.0 (Ruby 3.4.3) | Current default |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/fpm/CHANGELOG.md"
7974
8371
  },
7975
8372
  "icons": {
7976
8373
  "anyOf": [
@@ -7978,15 +8375,15 @@
7978
8375
  "$ref": "#/definitions/ToolsetCustom"
7979
8376
  },
7980
8377
  {
7981
- "const": "1.1.0",
8378
+ "enum": [
8379
+ "1.2.3",
8380
+ "latest"
8381
+ ],
7982
8382
  "type": "string"
7983
- },
7984
- {
7985
- "type": "null"
7986
8383
  }
7987
8384
  ],
7988
- "default": "1.1.0",
7989
- "description": "Version of the icons-conversion bundle used to convert source images to `.icns`, `.ico`,\nand PNG icon sets.\n\nSet to a {@link ToolsetCustom} object to supply your own icons bundle directory.\n\nAvailable versions:\n| Version | Notes |\n|---------|-------|\n| `\"1.1.0\"` | Current default |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/releases?q=icons"
8385
+ "default": "latest",
8386
+ "description": "Version of the icons-conversion bundle used to convert source images to `.icns`, `.ico`,\nand PNG icon sets.\n\nSet to a {@link ToolsetCustom} object to supply your own icons bundle directory.\n\nAvailable versions:\n| Version | Notes |\n|---------|-------|\n| `\"1.2.3\"` | Writes 16px/32px ICNS entries as `ic04`/`ic05` ARGB (fixes corrupt small icons in Finder) |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/icons/CHANGELOG.md"
7990
8387
  },
7991
8388
  "linuxToolsMac": {
7992
8389
  "anyOf": [
@@ -7994,15 +8391,16 @@
7994
8391
  "$ref": "#/definitions/ToolsetCustom"
7995
8392
  },
7996
8393
  {
7997
- "const": "1.0.0",
8394
+ "enum": [
8395
+ "1.0.0",
8396
+ "1.0.1",
8397
+ "latest"
8398
+ ],
7998
8399
  "type": "string"
7999
- },
8000
- {
8001
- "type": "null"
8002
8400
  }
8003
8401
  ],
8004
- "default": "1.0.0",
8005
- "description": "Version of the Linux-tools-mac bundle used to produce `.tar.lz` archives and build\nLinux targets on macOS hosts.\n\nThe bundle ships macOS-native builds of `ar`, `lzip`, and `gtar` (GNU tar).\n\nAvailable versions:\n| Version | Notes |\n|---------|-------|\n| `\"1.0.0\"` | Current default |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/releases?q=linux-tools-mac"
8402
+ "default": "latest",
8403
+ "description": "Version of the Linux-tools-mac bundle used to produce `.tar.lz` archives and build\nLinux targets on macOS hosts.\n\nThe bundle ships macOS-native builds of `ar`, `lzip`, and `gtar` (GNU tar).\n\nAvailable versions:\n| Version | Notes |\n|---------|-------|\n| `\"1.0.0\"` | gnu-tar, lzip, makedepend, glib, libgsf, libtool, pcre, gettext, binutils |\n| `\"1.0.1\"` | Same tools rebuilt on macOS 15 runners — binaries run on macOS 15+ (1.0.0 required macOS 26) |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/linux-tools-mac/CHANGELOG.md"
8006
8404
  },
8007
8405
  "nsis": {
8008
8406
  "anyOf": [
@@ -8012,16 +8410,14 @@
8012
8410
  {
8013
8411
  "enum": [
8014
8412
  "0.0.0",
8015
- "1.2.1"
8413
+ "1.2.1",
8414
+ "latest"
8016
8415
  ],
8017
8416
  "type": "string"
8018
- },
8019
- {
8020
- "type": "null"
8021
8417
  }
8022
8418
  ],
8023
- "default": "1.2.1",
8024
- "description": "Version of the NSIS toolset bundle used to compile Windows installers.\n\nThe bundle ships:\n- **`makensis`** — the NSIS compiler invoked to build `.nsi` scripts into `.exe` installers.\n- **NSIS plugins** — the plugin DLLs (`NsisMultiUser`, `UAC`, `StdUtils`, etc.) referenced by\n electron-builder's default installer scripts.\n- **`elevate.exe`** — UAC elevation helper included in NSIS installers.\n\nAvailable versions:\n| Version | `makensis` version | Notes |\n|---------|------------------|-------|\n| `\"0.0.0\"` | 3.0.4.1 | Legacy split bundle — `nsis` + `nsis-resources` archives (pre-v27 default) |\n| `\"1.2.1\"` | 3.12 | Unified bundle — single archive, entrypoint scripts auto-set `NSISDIR` (default) |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/releases?q=nsis"
8419
+ "default": "latest",
8420
+ "description": "Version of the NSIS toolset bundle used to compile Windows installers.\n\nThe bundle ships:\n- **`makensis`** — the NSIS compiler invoked to build `.nsi` scripts into `.exe` installers.\n- **NSIS plugins** — the plugin DLLs (`NsisMultiUser`, `UAC`, `StdUtils`, etc.) referenced by\n electron-builder's default installer scripts.\n- **`elevate.exe`** — UAC elevation helper included in NSIS installers.\n\nAvailable versions:\n| Version | `makensis` version | Notes |\n|---------|------------------|-------|\n| `\"0.0.0\"` | 3.0.4.1 | Legacy split bundle — `nsis` + `nsis-resources` archives (pre-v27) |\n| `\"1.2.1\"` | 3.12 | Unified bundle — single archive, entrypoint scripts auto-set `NSISDIR` |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/nsis/CHANGELOG.md\n\nA custom bundle (a {@link ToolsetCustom} object) must follow the layout at\nhttps://www.electron.build/docs/toolsets#custom-nsis-bundle-layout"
8025
8421
  },
8026
8422
  "sevenZip": {
8027
8423
  "anyOf": [
@@ -8029,15 +8425,32 @@
8029
8425
  "$ref": "#/definitions/ToolsetCustom"
8030
8426
  },
8031
8427
  {
8032
- "const": "1.0.0",
8428
+ "enum": [
8429
+ "1.0.0",
8430
+ "1.0.1",
8431
+ "latest"
8432
+ ],
8033
8433
  "type": "string"
8434
+ }
8435
+ ],
8436
+ "default": "latest",
8437
+ "description": "Version of the 7-Zip binary bundle used internally to extract `.7z` and `.tar.xz` archives.\n\nSet to a {@link ToolsetCustom} object to supply your own 7za binary.\nThe `url` must point to a directory (or a `.tar.gz`/`.zip` archive of one) that contains\n`bin/7za` (macOS/Linux) or `bin/7za.exe` (Windows).\n\n**Bootstrap constraint:** the custom bundle itself must be a `.tar.gz` or `.zip` archive\n(or a bare `file://` directory). `.7z` and `.tar.xz` archives cannot be used here because\nextracting them requires 7za — a circular dependency.\n\nAvailable versions:\n| Version | Notes |\n|---------|-------|\n| `\"1.0.0\"` | Shipped the 32-bit `7za.exe` for every Windows arch (1.75 GiB memory cap, no LZMA2 multithreading on x64/arm64) |\n| `\"1.0.1\"` | Correct per-arch Windows binaries (x64, ia32, arm64) |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/7zip/CHANGELOG.md"
8438
+ },
8439
+ "squirrel": {
8440
+ "anyOf": [
8441
+ {
8442
+ "$ref": "#/definitions/ToolsetCustom"
8034
8443
  },
8035
8444
  {
8036
- "type": "null"
8445
+ "enum": [
8446
+ "1.1.1",
8447
+ "latest"
8448
+ ],
8449
+ "type": "string"
8037
8450
  }
8038
8451
  ],
8039
- "default": "1.0.0",
8040
- "description": "Version of the 7-Zip binary bundle used internally to extract `.7z` and `.tar.xz` archives.\n\nSet to a {@link ToolsetCustom} object to supply your own 7za binary.\nThe `url` must point to a directory (or a `.tar.gz`/`.zip` archive of one) that contains\n`bin/7za` (macOS/Linux) or `bin/7za.exe` (Windows).\n\n**Bootstrap constraint:** the custom bundle itself must be a `.tar.gz` or `.zip` archive\n(or a bare `file://` directory). `.7z` and `.tar.xz` archives cannot be used here because\nextracting them requires 7za — a circular dependency."
8452
+ "default": "latest",
8453
+ "description": "Version of the `squirrel.windows` bundle used to build Squirrel.Windows installers.\n\nThe bundle ships the Squirrel vendor toolset under `electron-winstaller/vendor/`:\n- **`Squirrel.exe`** / **`Squirrel-Mono.exe`** — releasify the app into `Setup.exe` (and an optional MSI).\n- **`SyncReleases.exe`** — downloads prior releases to produce delta packages.\n- **`nuget.exe`**, **`7z`** — pack the app into a `.nupkg` and compress release assets.\n\n`rcedit.exe` is provisioned from the {@link winCodeSign} toolset at runtime (on every platform;\nunder Wine on non-Windows hosts). Building an MSI additionally uses the shared WiX toolset.\n\nAvailable versions:\n| Version | Notes |\n|---------|-------|\n| `\"1.1.1\"` | Squirrel.Windows 2.0.1 (patched) with a standalone, checksum-verified `nuget.exe` 6.14.0 |\n\nSet to a {@link ToolsetCustom} object to supply your own bundle — it must contain the\n`electron-winstaller/vendor/` subtree. Only used when building the `squirrelWindows` target.\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/squirrel.windows/CHANGELOG.md"
8041
8454
  },
8042
8455
  "winCodeSign": {
8043
8456
  "anyOf": [
@@ -8048,95 +8461,160 @@
8048
8461
  "enum": [
8049
8462
  "0.0.0",
8050
8463
  "1.0.0",
8051
- "1.1.0"
8464
+ "1.1.0",
8465
+ "1.1.1",
8466
+ "1.2.1",
8467
+ "1.3.0",
8468
+ "latest"
8469
+ ],
8470
+ "type": "string"
8471
+ }
8472
+ ],
8473
+ "default": "latest",
8474
+ "description": "Version of the `win-codesign` bundle used for Windows code signing and resource editing.\n\nThe bundle ships:\n- **`signtool.exe`** (Windows) / **`osslsigncode`** (macOS & Linux) — used to sign `.exe`,\n `.dll`, and `.msix` artifacts.\n- **`rcedit`** — embeds version metadata and icons into `.exe` files (legacy usage, migrated to npm `resedit` package).\n- **Windows Kits** — used by AppX/MSIX packaging (`makeappx`, `signtool`).\n\nAvailable versions:\n| Version | Notes |\n|---------|-------|\n| `\"0.0.0\"` | Legacy bundle — `winCodeSign-2.6.0` (pre-v27) |\n| `\"1.0.0\"` | Windows Kits 10.0.26100.0, `osslsigncode` v2.9 |\n| `\"1.1.1\"` | Updates `osslsigncode` to v2.11 |\n| `\"1.2.1\"` | Adds native `osslsigncode` arm64 |\n| `\"1.3.0\"` | Includes support for Azure Trusted Signing `signtool` via dlib and .NET 8 runtime |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/win-codesign/CHANGELOG.md"
8475
+ },
8476
+ "wine": {
8477
+ "anyOf": [
8478
+ {
8479
+ "$ref": "#/definitions/ToolsetCustom"
8480
+ },
8481
+ {
8482
+ "enum": [
8483
+ "0.0.0",
8484
+ "1.0.1",
8485
+ "latest",
8486
+ "system"
8052
8487
  ],
8053
8488
  "type": "string"
8489
+ }
8490
+ ],
8491
+ "default": "latest",
8492
+ "description": "Version of the Wine bundle used to run Windows tools (NSIS, rcedit, signtool) on\nnon-Windows hosts (macOS and Linux).\n\nWine is only required when building Windows targets on a non-Windows machine. On Windows,\nthis setting has no effect.\n\nAvailable versions:\n| Version | Wine version | Platform support | Notes |\n|---------|-------------|-----------------|-------|\n| `\"0.0.0\"` | 4.0.1 | macOS | Legacy portable bundle (pre-v27) |\n| `\"1.0.1\"` | 11.0 | macOS | Supports arm64 macOS via Rosetta |\n| `\"system\"` | host install | macOS, Linux | Uses the `wine` binary on `PATH` instead of a bundle |\n\n`\"system\"` is the replacement for the `USE_SYSTEM_WINE` environment variable removed in v27, and\nis what `\"latest\"` (the default) currently resolves to on every platform: the published `\"1.0.1\"`\nbundles ship no PE builtins, so a host Wine installation is required to build Windows targets on\nmacOS or Linux.\n\nTo use a custom Wine binary, use a `ToolsetCustom` object.\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/wine/CHANGELOG.md"
8493
+ }
8494
+ },
8495
+ "type": "object"
8496
+ },
8497
+ "ToolsetCustom": {
8498
+ "additionalProperties": false,
8499
+ "description": "A custom toolset bundle supplied by the user in place of a built-in versioned bundle.\n\nThe bundle must mirror the expected directory layout of the corresponding built-in bundle.\nSee the build scripts at\nhttps://github.com/electron-userland/electron-builder-binaries/tree/master/packages.\n\nFile formats supported for `url` archives: `.zip`, `.7z`, `.tar.gz`, `.tar.xz`.\n\n`checksum` is the SHA-256 of the archive as 64 hex characters or its SHA-512 as 88 base64 characters (the format v26\nused for all toolset checksums), the same for every toolset. See https://www.electron.build/docs/toolsets#custom-toolset-checksum",
8500
+ "properties": {
8501
+ "checksum": {
8502
+ "description": "Checksum of the bundle archive, in one of two formats:\n- the SHA-256 as 64 hex characters (uppercase is lowercased), e.g. `shasum -a 256 <archive>` (macOS / Linux),\n `(Get-FileHash -Algorithm SHA256 <archive>).Hash` (PowerShell) or `certutil -hashfile <archive> SHA256`;\n- the SHA-512 as 88 base64 characters, the format v26 used for all toolset checksums, e.g.\n `openssl dgst -sha512 -binary <archive> | openssl base64 -A`.\n\nPrefixed forms such as `sha256:…` or `sha512-…`, and a hex-encoded SHA-512, are rejected before anything is downloaded.\nA downloaded archive is verified before it is cached or extracted, and a local `file://` archive before it is extracted.\n\nRequired for remote (`https://`) URLs and local archive files (`file://`).\nNot needed for bare directory paths — the directory is used as-is with no caching and no verification.",
8503
+ "type": "string"
8504
+ },
8505
+ "url": {
8506
+ "description": "The `https://` URL or `file://` path to load the custom toolset bundle from.\n\n- `https://` — downloaded and cached locally; the archive is extracted before use.\n- `file:///absolute/path` — used directly; relative paths must be within the project resources dir.\n\nArchives (`.zip`, `.7z`, `.tar.gz`, `.tar.xz`) are extracted automatically.\nA bare directory path (no archive) is used as-is.",
8507
+ "type": "string"
8508
+ },
8509
+ "version": {
8510
+ "description": "Optional version label used in the local cache directory name.\nFalls back to the first 8 hex characters of the `checksum` digest when omitted.",
8511
+ "type": "string"
8512
+ }
8513
+ },
8514
+ "required": [
8515
+ "url"
8516
+ ],
8517
+ "type": "object"
8518
+ },
8519
+ "UpdateManifestSigningOptions": {
8520
+ "additionalProperties": false,
8521
+ "properties": {
8522
+ "publicKey": {
8523
+ "anyOf": [
8524
+ {
8525
+ "items": {
8526
+ "type": "string"
8527
+ },
8528
+ "type": "array"
8529
+ },
8530
+ {
8531
+ "type": [
8532
+ "null",
8533
+ "string"
8534
+ ]
8535
+ }
8536
+ ],
8537
+ "description": "The Ed25519 public key(s) (PEM or base64 SPKI) embedded into `app-update.yml` as the updater's trust list.\nThe updater accepts a manifest when any listed key validates one of its signatures. Optional — when\nomitted the public key of every configured signing key is derived and embedded. Set it explicitly to trust\nadditional keys ahead of a rotation (for example `[current, next]`).\n\nA `publicKey` on its own does not satisfy the signing requirement — electron-builder still has no key to\nsign with. An external signer (HSM/KMS) that signs `latest*.yml` in a later step therefore either builds\nwithout a publish policy, where the requirement only warns and the unsigned manifest is written locally, or\nkeeps publishing with `publishAutoUpdate: false` on every publish provider - electron-builder then uploads the\nartifacts and embeds this key, but writes no `latest*.yml`, so the external step has to produce it too."
8538
+ },
8539
+ "signingKey": {
8540
+ "anyOf": [
8541
+ {
8542
+ "items": {
8543
+ "type": "string"
8544
+ },
8545
+ "type": "array"
8054
8546
  },
8055
8547
  {
8056
- "type": "null"
8548
+ "type": [
8549
+ "null",
8550
+ "string"
8551
+ ]
8057
8552
  }
8058
8553
  ],
8059
- "default": "1.1.0",
8060
- "description": "Version of the `win-codesign` bundle used for Windows code signing and resource editing.\n\nThe bundle ships:\n- **`signtool.exe`** (Windows) / **`osslsigncode`** (macOS & Linux) — used to sign `.exe`,\n `.dll`, and `.msix` artifacts.\n- **`rcedit`** — used to embed version metadata and icons into `.exe` files.\n- **Windows Kits** (`10.0.26100.0`) — used by AppX/MSIX packaging (`makeappx`, `signtool`).\n\nAvailable versions:\n| Version | Contents |\n|---------|----------|\n| `\"0.0.0\"` | Legacy bundle — `winCodeSign-2.6.0` (pre-v27 default) |\n| `\"1.0.0\"` | Modern bundle — Windows Kits 10.0.26100.0, `win-codesign` v1.0.0 |\n| `\"1.1.0\"` | Modern bundle — Windows Kits 10.0.26100.0, `win-codesign` v1.1.0 (default) |\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/releases?q=win-codesign"
8554
+ "description": "Ed25519 private key(s) in PEM (PKCS#8) format used to sign the update manifest. A single PEM string may\ncontain several concatenated keys, or pass an array with one key each; the manifest is signed by every key\n(dual-signing for [key rotation](https://www.electron.build/features/key-rotation)) and the first key also\nfills the legacy single `signature` field.\nSecret — prefer the `ELECTRON_BUILDER_UPDATE_SIGN_KEY` environment variable in CI over committing this to config."
8061
8555
  },
8062
- "wine": {
8556
+ "signingKeyFile": {
8063
8557
  "anyOf": [
8064
8558
  {
8065
- "$ref": "#/definitions/ToolsetCustom"
8066
- },
8067
- {
8068
- "const": "0.0.0",
8069
- "type": "string"
8559
+ "items": {
8560
+ "type": "string"
8561
+ },
8562
+ "type": "array"
8070
8563
  },
8071
8564
  {
8072
- "type": "null"
8565
+ "type": [
8566
+ "null",
8567
+ "string"
8568
+ ]
8073
8569
  }
8074
8570
  ],
8075
- "default": "0.0.0",
8076
- "description": "Version of the Wine bundle used to run Windows tools (NSIS, rcedit, signtool) on\nnon-Windows hosts (macOS and Linux).\n\nWine is only required when building Windows targets on a non-Windows machine. On Windows,\nthis setting has no effect.\n\nAvailable versions:\n| Version | Wine version | Platform support | Notes |\n|---------|-------------|-----------------|-------|\n| `\"0.0.0\"` | 4.0.1 | macOS only | Legacy portable bundle (pre-v27 default) |\n\nOn Linux, the system `wine` binary is used instead of a bundled one.\nSet `USE_SYSTEM_WINE=true` to force system Wine regardless of this setting.\n\nReleases: https://github.com/electron-userland/electron-builder-binaries/releases?q=wine"
8571
+ "description": "Path(s) to file(s) containing the Ed25519 private key (PEM, PKCS#8). Alternative to `signingKey`.\nAn array signs with every listed key, in order. Relative paths are resolved against the project directory."
8077
8572
  }
8078
8573
  },
8079
8574
  "type": "object"
8080
8575
  },
8081
- "ToolsetCustom": {
8576
+ "WindowsAzureSigningConfig": {
8082
8577
  "additionalProperties": false,
8083
- "description": "A custom toolset bundle supplied by the user in place of a built-in versioned bundle.\n\nThe bundle must mirror the expected directory layout of the corresponding built-in bundle.\nSee the build scripts at\nhttps://github.com/electron-userland/electron-builder-binaries/tree/master/packages.\n\nFile formats supported for `url` archives: `.zip`, `.7z`, `.tar.gz`, `.tar.xz`.",
8578
+ "description": "The `signtool /dlib` Azure Trusted Signing integration was introduced in `toolsets.winCodeSign: 1.3.0`.\nThe legacy PowerShell integration is deprecated, but leverages the same underlying Azure APIs, so both interfaces share the same config shape.",
8084
8579
  "properties": {
8085
- "checksum": {
8086
- "description": "SHA checksum of the custom toolset bundle for verification.\nRequired for remote (`https://`) URLs and local archive files (`file://`).\nNot needed for bare directory paths — the directory is used as-is with no caching.",
8087
- "type": "string"
8088
- },
8089
- "url": {
8090
- "description": "The `https://` URL or `file://` path to load the custom toolset bundle from.\n\n- `https://` — downloaded and cached locally; the archive is extracted before use.\n- `file:///absolute/path` — used directly; relative paths must be within the project resources dir.\n\nArchives (`.zip`, `.7z`, `.tar.gz`, `.tar.xz`) are extracted automatically.\nA bare directory path (no archive) is used as-is.",
8091
- "type": "string"
8580
+ "additionalMetadata": {
8581
+ "$ref": "#/definitions/Record<string,string>",
8582
+ "description": "Additional fields to include verbatim in the `metadata.json` file passed to\n`Azure.CodeSigning.Dlib.dll` via `signtool /dmdf`. Use this for DLib-specific options\nnot covered by the typed fields above (e.g. `ExcludeCredentials`, `CorrelationId`)."
8092
8583
  },
8093
- "version": {
8094
- "description": "Optional version label used in the local cache directory name.\nFalls back to the first 8 characters of `checksum` when omitted.",
8095
- "type": "string"
8096
- }
8097
- },
8098
- "required": [
8099
- "url"
8100
- ],
8101
- "type": "object"
8102
- },
8103
- "WindowsAzureSigningConfiguration": {
8104
- "additionalProperties": {
8105
- "type": [
8106
- "null",
8107
- "string"
8108
- ]
8109
- },
8110
- "properties": {
8111
8584
  "certificateProfileName": {
8112
- "description": "The Certificate Profile name. Translates to field: CertificateProfileName",
8585
+ "description": "The name of the Trusted Signing Certificate Profile to sign with, as created in your Azure\nCode Signing Account. Maps to the DLib metadata field `CertificateProfileName`.",
8113
8586
  "type": "string"
8114
8587
  },
8115
8588
  "codeSigningAccountName": {
8116
- "description": "The Code Signing Signing Account name. Translates to field: CodeSigningAccountName",
8589
+ "description": "The name of the Azure Trusted Signing (Code Signing) Account that owns the certificate profile.\nMaps to the DLib metadata field `CodeSigningAccountName`.",
8117
8590
  "type": "string"
8118
8591
  },
8119
8592
  "endpoint": {
8120
- "description": "The Trusted Signing Account endpoint. The URI value must have a URI that aligns to the\nregion your Trusted Signing Account and Certificate Profile you are specifying were created\nin during the setup of these resources.\n\nTranslates to field: Endpoint\n\nRequires one of environment variable configurations for authenticating to Microsoft Entra ID per [Microsoft's documentation](https://learn.microsoft.com/en-us/dotnet/api/azure.identity.environmentcredential?view=azure-dotnet#definition)",
8593
+ "description": "The Trusted Signing Account endpoint. The URI value must align to the region your Trusted\nSigning Account and Certificate Profile were created in.\n\nRequires Azure Entra ID environment variables per\n[Microsoft's documentation](https://learn.microsoft.com/en-us/dotnet/api/azure.identity.environmentcredential?view=azure-dotnet#definition).",
8121
8594
  "type": "string"
8122
8595
  },
8123
8596
  "fileDigest": {
8124
8597
  "default": "SHA256",
8125
- "description": "The File Digest for signing each file. Translates to field: FileDigest",
8598
+ "description": "The digest algorithm used to hash the files being signed. Maps to the DLib metadata field\n`FileDigest`.",
8126
8599
  "type": "string"
8127
8600
  },
8128
8601
  "publisherName": {
8129
- "description": "[The publisher name](https://github.com/electron-userland/electron-builder/issues/1187#issuecomment-278972073), exactly as in your code signed certificate. Several names can be provided.",
8602
+ "description": "The publisher name to associate with the signature, exactly as it appears in the certificate\nissued by your Trusted Signing certificate profile. Required. Used for\n[update verification](#verifyUpdateCodeSignature) (embedded in `app-update.yml` and checked by\nelectron-updater) and must match the certificate subject.",
8130
8603
  "type": "string"
8131
8604
  },
8132
8605
  "timestampDigest": {
8133
8606
  "default": "SHA256",
8134
- "description": "The Timestamp Digest. Translates to field: TimestampDigest",
8607
+ "description": "The timestamp digest algorithm. Translates to field: TimestampDigest.",
8135
8608
  "type": "string"
8136
8609
  },
8137
8610
  "timestampRfc3161": {
8138
8611
  "default": "http://timestamp.acs.microsoft.com",
8139
- "description": "The Timestamp rfc3161 server. Translates to field: TimestampRfc3161",
8612
+ "description": "The RFC3161 timestamp server. Translates to field: TimestampRfc3161.",
8613
+ "type": "string"
8614
+ },
8615
+ "type": {
8616
+ "const": "azure",
8617
+ "description": "Discriminator selecting Azure Trusted Signing (cloud signing — no local certificate).",
8140
8618
  "type": "string"
8141
8619
  }
8142
8620
  },
@@ -8144,7 +8622,8 @@
8144
8622
  "certificateProfileName",
8145
8623
  "codeSigningAccountName",
8146
8624
  "endpoint",
8147
- "publisherName"
8625
+ "publisherName",
8626
+ "type"
8148
8627
  ],
8149
8628
  "type": "object"
8150
8629
  },
@@ -8172,27 +8651,15 @@
8172
8651
  "$ref": "#/definitions/AsarOptions"
8173
8652
  },
8174
8653
  {
8175
- "const": false,
8176
- "type": "boolean"
8177
- },
8178
- {
8179
- "type": "null"
8654
+ "type": [
8655
+ "null",
8656
+ "boolean"
8657
+ ]
8180
8658
  }
8181
8659
  ],
8182
8660
  "default": true,
8183
8661
  "description": "Whether to package the application's source code into an archive, using [Electron's archive format](http://electron.atom.io/docs/tutorial/application-packaging/).\n\nNode modules that must be unpacked will be detected automatically. Use {@link AsarOptions.unpack} to specify additional files to unpack."
8184
8662
  },
8185
- "azureSignOptions": {
8186
- "anyOf": [
8187
- {
8188
- "$ref": "#/definitions/WindowsAzureSigningConfiguration"
8189
- },
8190
- {
8191
- "type": "null"
8192
- }
8193
- ],
8194
- "description": "Options for usage of Azure Trusted Signing service\nCannot be used in conjunction with `signtoolOptions`, signing will default to Azure Trusted Signing"
8195
- },
8196
8663
  "compression": {
8197
8664
  "anyOf": [
8198
8665
  {
@@ -8231,14 +8698,6 @@
8231
8698
  "description": "Whether to infer update channel from application version pre-release components. e.g. if version `0.12.1-alpha.1`, channel will be set to `alpha`. Otherwise to `latest`.\nThis does *not* apply to github publishing, which will [never auto-detect the update channel](https://github.com/electron-userland/electron-builder/issues/8589).",
8232
8699
  "type": "boolean"
8233
8700
  },
8234
- "disableDefaultIgnoredFiles": {
8235
- "default": false,
8236
- "description": "Whether to exclude all default ignored files(https://www.electron.build/contents#files) and options. Defaults to `false`.",
8237
- "type": [
8238
- "null",
8239
- "boolean"
8240
- ]
8241
- },
8242
8701
  "electronLanguages": {
8243
8702
  "anyOf": [
8244
8703
  {
@@ -8254,7 +8713,7 @@
8254
8713
  "description": "The electron locales to keep. By default, all Electron locales used as-is."
8255
8714
  },
8256
8715
  "electronUpdaterCompatibility": {
8257
- "description": "The [electron-updater compatibility](https://www.electron.build/auto-update#compatibility) semver range.",
8716
+ "description": "The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range.",
8258
8717
  "type": [
8259
8718
  "null",
8260
8719
  "string"
@@ -8360,7 +8819,7 @@
8360
8819
  ]
8361
8820
  }
8362
8821
  ],
8363
- "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
8822
+ "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,slnx,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
8364
8823
  },
8365
8824
  "forceCodeSigning": {
8366
8825
  "default": false,
@@ -8389,52 +8848,243 @@
8389
8848
  },
8390
8849
  "protocols": {
8391
8850
  "anyOf": [
8392
- {
8393
- "$ref": "#/definitions/Protocol"
8394
- },
8851
+ {
8852
+ "$ref": "#/definitions/Protocol"
8853
+ },
8854
+ {
8855
+ "items": {
8856
+ "$ref": "#/definitions/Protocol"
8857
+ },
8858
+ "type": "array"
8859
+ }
8860
+ ],
8861
+ "description": "The URL protocol schemes."
8862
+ },
8863
+ "publish": {
8864
+ "anyOf": [
8865
+ {
8866
+ "$ref": "#/definitions/GithubOptions"
8867
+ },
8868
+ {
8869
+ "$ref": "#/definitions/GitlabOptions"
8870
+ },
8871
+ {
8872
+ "$ref": "#/definitions/S3Options"
8873
+ },
8874
+ {
8875
+ "$ref": "#/definitions/SpacesOptions"
8876
+ },
8877
+ {
8878
+ "$ref": "#/definitions/R2Options"
8879
+ },
8880
+ {
8881
+ "$ref": "#/definitions/GenericServerOptions"
8882
+ },
8883
+ {
8884
+ "$ref": "#/definitions/CustomPublishOptions"
8885
+ },
8886
+ {
8887
+ "$ref": "#/definitions/KeygenOptions"
8888
+ },
8889
+ {
8890
+ "$ref": "#/definitions/SnapStoreOptions"
8891
+ },
8892
+ {
8893
+ "$ref": "#/definitions/BitbucketOptions"
8894
+ },
8895
+ {
8896
+ "items": {
8897
+ "$ref": "#/definitions/AllPublishOptions"
8898
+ },
8899
+ "type": "array"
8900
+ },
8901
+ {
8902
+ "type": [
8903
+ "null",
8904
+ "string"
8905
+ ]
8906
+ }
8907
+ ],
8908
+ "description": "Publisher configuration. See [Auto Update](https://www.electron.build/publish) for more information."
8909
+ },
8910
+ "releaseInfo": {
8911
+ "$ref": "#/definitions/ReleaseInfo",
8912
+ "description": "The release info. Intended for command line usage:\n\n```\n-c.releaseInfo.releaseNotes=\"new features\"\n```"
8913
+ },
8914
+ "requestedExecutionLevel": {
8915
+ "anyOf": [
8916
+ {
8917
+ "enum": [
8918
+ "asInvoker",
8919
+ "highestAvailable",
8920
+ "requireAdministrator"
8921
+ ],
8922
+ "type": "string"
8923
+ },
8924
+ {
8925
+ "type": "null"
8926
+ }
8927
+ ],
8928
+ "default": "asInvoker",
8929
+ "description": "The [security level](https://msdn.microsoft.com/en-us/library/6ad1fshk.aspx#Anchor_9) at which the application requests to be executed.\nCannot be specified per target, allowed only in the `win`."
8930
+ },
8931
+ "sign": {
8932
+ "anyOf": [
8933
+ {
8934
+ "$ref": "#/definitions/WindowsSigntoolSigningConfig"
8935
+ },
8936
+ {
8937
+ "$ref": "#/definitions/WindowsHsmSigningConfig"
8938
+ },
8939
+ {
8940
+ "$ref": "#/definitions/WindowsPkcs11SigningConfig"
8941
+ },
8942
+ {
8943
+ "$ref": "#/definitions/WindowsAzureSigningConfig"
8944
+ },
8945
+ {
8946
+ "const": false,
8947
+ "type": "boolean"
8948
+ },
8949
+ {
8950
+ "type": "null"
8951
+ }
8952
+ ],
8953
+ "description": "Code signing configuration. Code signing stamps every installer and executable\nelectron-builder produces with an Authenticode signature, so that Windows (SmartScreen / UAC)\nand your auto-updater can verify the publisher and that the files were not tampered with.\n\nHow this option behaves:\n- Leave **unset** to sign using credentials discovered from the environment — primarily a\n certificate supplied via `WIN_CSC_LINK` (or `CSC_LINK`) with its password in\n `WIN_CSC_KEY_PASSWORD` (or `CSC_KEY_PASSWORD`). `WIN_CSC_LINK` accepts a file path, an\n `https://` URL, or a base64-encoded certificate. This is the recommended setup for CI.\n- Set to `false` or `null` to **disable** code signing entirely (executable resources such as\n the icon and metadata are still edited).\n- Set to an **object** to configure signing explicitly. The **required** `type` field selects the\n signing backend (`signtool`, `hsm`, `pkcs11`, or `azure`) and dispatches to a dedicated sign\n manager; provide exactly one of the modes below. When `win.sign` is left unset, the `signtool`\n backend is used with env-discovered credentials. Each output artifact is signed individually,\n and by default executables are dual-signed (see `signingHashAlgorithms`).\n\n- `{ type: \"signtool\", ... }` — Sign with a local certificate file (.pfx/.p12) or a\n certificate from the Windows certificate store. Uses Microsoft `signtool.exe` on Windows and\n `osslsigncode` on macOS/Linux.\n- `{ type: \"hsm\", ... }` — Sign using a Hardware Security Module (HSM) or FIPS-compliant\n hardware token via signtool's `/csp` (cryptographic service provider) and `/kc` (key\n container) flags. Requires a modern `winCodeSign` toolset (the default — only the legacy\n `\"0.0.0\"` pin is unsupported). Windows-only.\n- `{ type: \"pkcs11\", ... }` — Sign using a PKCS#11 hardware token via osslsigncode.\n Available on macOS and Linux CI without a Windows VM.\n- `{ type: \"azure\", ... }` — Sign via Azure Trusted Signing (cloud service). Requires\n Azure Entra ID environment variables for authentication.\n\nSee [Code Signing](https://www.electron.build/docs/features/code-signing)."
8954
+ },
8955
+ "signExts": {
8956
+ "anyOf": [
8957
+ {
8958
+ "items": {
8959
+ "type": "string"
8960
+ },
8961
+ "type": "array"
8962
+ },
8963
+ {
8964
+ "type": "null"
8965
+ }
8966
+ ],
8967
+ "default": null,
8968
+ "description": "Additional file name suffixes to code sign, beyond the default. By default electron-builder\nonly signs `.exe` files; list extra suffixes here to also sign e.g. `.dll`, `.node`, or\nspecific file names. Advanced option — most apps do not need it.\n\nEach entry is matched with `String.endsWith`, so both bare extensions (`\".dll\"`) and full file\nnames (`\"mybinary.dll\"`) work. Prefix a pattern with `!` to *exclude* a suffix that would\notherwise be signed. Positive patterns are evaluated first, then negative ones. For example,\n`[\"somefilename\", \".dll\", \"!.appx\"]` signs `.dll` files (and anything ending in `somefilename`)\nbut never signs `.appx` files."
8969
+ },
8970
+ "target": {
8971
+ "anyOf": [
8972
+ {
8973
+ "$ref": "#/definitions/TargetConfiguration"
8974
+ },
8975
+ {
8976
+ "items": {
8977
+ "anyOf": [
8978
+ {
8979
+ "$ref": "#/definitions/TargetConfiguration"
8980
+ },
8981
+ {
8982
+ "type": "string"
8983
+ }
8984
+ ]
8985
+ },
8986
+ "type": "array"
8987
+ },
8988
+ {
8989
+ "type": [
8990
+ "null",
8991
+ "string"
8992
+ ]
8993
+ }
8994
+ ],
8995
+ "default": "nsis",
8996
+ "description": "The target package type: list of `nsis`, `nsis-web` (Web installer), `portable` ([portable app](https://www.electron.build/nsis#portable) without installation), `appx`, `msix`, `msi`, `msi-wrapped`, `squirrel`, `7z`, `zip`, `tar.xz`, `tar.lz`, `tar.gz`, `tar.bz2`, `dir`.\nAppX and MSIX packages can be built on Windows 10 or Windows Server 2012 R2 (version 6.3+) or later, and on macOS via Parallels Desktop.\n\nTo use Squirrel.Windows please install `electron-builder-squirrel-windows` dependency."
8997
+ },
8998
+ "updateManifest": {
8999
+ "anyOf": [
9000
+ {
9001
+ "$ref": "#/definitions/UpdateManifestSigningOptions"
9002
+ },
9003
+ {
9004
+ "const": false
9005
+ },
9006
+ {
9007
+ "type": "null"
9008
+ }
9009
+ ],
9010
+ "description": "Ed25519 signing of the auto-update manifest (`latest*.yml`). Each manifest is signed and its public key is\nembedded into `app-update.yml`, so electron-updater verifies the signature before downloading an update.\n\n**Signing is required.** Publishing a build that emits auto-update metadata fails unless a signing key\nresolves. Generate one once with `electron-builder create-update-key`, then supply it via\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` / `ELECTRON_BUILDER_UPDATE_SIGN_KEY_FILE` (preferred in CI) or via\n`signingKey` / `signingKeyFile` below. Leaving this option unset — or `null` — keeps signing required and\nresolves the key from the environment; `null` is not an opt-out.\n\nSet to `false`, the only opt-out, to ship **unsigned** manifests. Every build that produces a manifest then\nlogs a warning. `false` also short-circuits the environment variables, so a leftover\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` in CI cannot re-enable signing by accident.\n\nThe requirement is only enforced when a publish policy is in effect (`--publish`); a build without one\nwarns instead, so local builds and pipelines that sign the manifest in a later step of their own are\nunaffected. It is also waived when every publish provider has `publishAutoUpdate: false`, since no manifest is\nemitted then, and for a build whose targets write no update info (e.g. only snap, flatpak, MSI/MSIX, portable,\nmas/pkg or plain archives). A publishing build checks for the key at build start, before anything is packed\nor uploaded.\n\nSee [Signed Update Manifests](https://www.electron.build/features/signed-update-manifests)."
9011
+ },
9012
+ "verifyUpdateCodeSignature": {
9013
+ "default": true,
9014
+ "description": "Whether the NSIS auto-updater should verify the Authenticode signature of a downloaded update\nbefore installing it. This is a **runtime** check performed by your app via electron-updater,\nnot a build-time check.\n\nWhen enabled (the default), the resolved [publisher name](#publisherName) is embedded into\n`app-update.yml` at build time. At update time electron-updater inspects the certificate that\nsigned the downloaded installer and compares its subject (Distinguished Name / Common Name)\nagainst that publisher name, refusing to install on a mismatch. This prevents a tampered or\nmaliciously substituted update from being installed.\n\nSet to `false` to skip verification — in which case the publisher name is **not** embedded.\nDisable this only if your updates are not Authenticode-signed.",
9015
+ "type": "boolean"
9016
+ }
9017
+ },
9018
+ "type": "object"
9019
+ },
9020
+ "WindowsHsmSigningConfig": {
9021
+ "additionalProperties": false,
9022
+ "properties": {
9023
+ "additionalCertificateFile": {
9024
+ "description": "Path to an additional certificate file (typically an intermediate / cross-signing CA\ncertificate) whose contents are added to the signature block via signtool's `/ac` flag. Use\nthis when the signing certificate's full chain is not already present on target machines and\nyou want it embedded in the signature so the chain can be validated.",
9025
+ "type": [
9026
+ "null",
9027
+ "string"
9028
+ ]
9029
+ },
9030
+ "certificateFile": {
9031
+ "description": "Path to the certificate file containing the public certificate chain (.crt / .cer / .pfx).\nThe private key is NOT read from this file — it is provided by the HSM via `cryptoServiceProvider`.",
9032
+ "type": [
9033
+ "null",
9034
+ "string"
9035
+ ]
9036
+ },
9037
+ "certificateSha1": {
9038
+ "description": "Alternative to `certificateFile`: locate the public certificate in the Windows certificate\nstore by its SHA-1 thumbprint. The private key still comes from the HSM via\n`cryptoServiceProvider` / `keyContainer`; this only identifies which public certificate to sign\nwith.",
9039
+ "type": [
9040
+ "null",
9041
+ "string"
9042
+ ]
9043
+ },
9044
+ "certificateSubjectName": {
9045
+ "description": "Alternative to `certificateFile`: locate the public certificate in the Windows certificate\nstore by (a substring of) its subject name. The private key still comes from the HSM via\n`cryptoServiceProvider` / `keyContainer`; this only identifies which public certificate to sign\nwith.",
9046
+ "type": [
9047
+ "null",
9048
+ "string"
9049
+ ]
9050
+ },
9051
+ "cryptoServiceProvider": {
9052
+ "description": "The name of the cryptographic service provider (CSP) that holds the private key.\nMaps to signtool's `/csp` flag. Examples:\n- Google Cloud KMS: `\"Google Cloud KMS Provider\"`\n- Smart card / FIPS token: `\"Microsoft Base Smart Card Crypto Provider\"`\n\nRequires a modern `winCodeSign` toolset (the default; only the legacy `\"0.0.0\"` pin is\nunsupported). Windows-only — use `type: \"pkcs11\"` on macOS/Linux.",
9053
+ "type": "string"
9054
+ },
9055
+ "keyContainer": {
9056
+ "description": "The key container name within the CSP. Maps to signtool's `/kc` flag.\n\nExample for Google Cloud KMS:\n`\"projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME/cryptoKeyVersions/1\"`",
9057
+ "type": "string"
9058
+ },
9059
+ "publisherName": {
9060
+ "anyOf": [
8395
9061
  {
8396
9062
  "items": {
8397
- "$ref": "#/definitions/Protocol"
9063
+ "type": "string"
8398
9064
  },
8399
9065
  "type": "array"
9066
+ },
9067
+ {
9068
+ "type": [
9069
+ "null",
9070
+ "string"
9071
+ ]
8400
9072
  }
8401
9073
  ],
8402
- "description": "The URL protocol schemes."
9074
+ "description": "The publisher name(s) to associate with the signature, written exactly as the subject appears\nin your code signing certificate. May be a single string or an array — an array is useful when\nrotating certificates, so updates signed by either the old or the new certificate still verify.\n\nThis value is not a `signtool` argument; it is consumed in two places:\n- **Update verification** — when [verifyUpdateCodeSignature](#verifyUpdateCodeSignature) is\n enabled, it is written into `app-update.yml` and electron-updater checks it against the\n certificate that signed each downloaded update.\n- **AppX / MSIX identity** — the package `Publisher` attribute must equal the certificate\n subject, so electron-builder derives it from this value (or the certificate) to keep them\n in sync; a mismatch makes packaging fail with `ERROR_BAD_FORMAT`.\n\nDefaults to the Common Name (CN) extracted from your code signing certificate. **Required**\n(while `verifyUpdateCodeSignature` is enabled and `app-update.yml` is written) with a custom\n[sign](#sign) hook, even if a certificate is configured, and for a certificate without a CN —\notherwise the build fails. Set to `null` to opt out."
8403
9075
  },
8404
- "publish": {
9076
+ "rfc3161TimeStampServer": {
9077
+ "default": "http://timestamp.digicert.com",
9078
+ "description": "The URL of the [RFC 3161](https://www.ietf.org/rfc/rfc3161.txt) timestamp server, used for\nSHA-256 and nested/appended signatures (signtool's `/tr` flag). Timestamping records *when*\nthe file was signed so the signature stays valid after the signing certificate expires.\nIgnored when the build runs with `ELECTRON_BUILDER_OFFLINE=true`.",
9079
+ "type": [
9080
+ "null",
9081
+ "string"
9082
+ ]
9083
+ },
9084
+ "sign": {
8405
9085
  "anyOf": [
8406
9086
  {
8407
- "$ref": "#/definitions/GithubOptions"
8408
- },
8409
- {
8410
- "$ref": "#/definitions/GitlabOptions"
8411
- },
8412
- {
8413
- "$ref": "#/definitions/S3Options"
8414
- },
8415
- {
8416
- "$ref": "#/definitions/SpacesOptions"
8417
- },
8418
- {
8419
- "$ref": "#/definitions/GenericServerOptions"
8420
- },
8421
- {
8422
- "$ref": "#/definitions/CustomPublishOptions"
8423
- },
8424
- {
8425
- "$ref": "#/definitions/KeygenOptions"
8426
- },
8427
- {
8428
- "$ref": "#/definitions/SnapStoreOptions"
8429
- },
8430
- {
8431
- "$ref": "#/definitions/BitbucketOptions"
8432
- },
8433
- {
8434
- "items": {
8435
- "$ref": "#/definitions/AllPublishOptions"
8436
- },
8437
- "type": "array"
9087
+ "typeof": "function"
8438
9088
  },
8439
9089
  {
8440
9090
  "type": [
@@ -8443,40 +9093,75 @@
8443
9093
  ]
8444
9094
  }
8445
9095
  ],
8446
- "description": "Publisher configuration. See [Auto Update](https://www.electron.build/publish) for more information."
8447
- },
8448
- "releaseInfo": {
8449
- "$ref": "#/definitions/ReleaseInfo",
8450
- "description": "The release info. Intended for command line usage:\n\n```\n-c.releaseInfo.releaseNotes=\"new features\"\n```"
9096
+ "description": "A custom signing hook that **replaces** electron-builder's built-in `signtool` /\n`osslsigncode` invocation. Provide a function, or the path / module id of a file that exports\na `sign` function (resolved relative to the project, then as a module).\n\nThe hook is invoked once per signing pass (i.e. once per entry in\n[signingHashAlgorithms](#signingHashAlgorithms)) and receives a configuration object describing\nthe file to sign (`path`), the resolved certificate info (`cscInfo`), the current `hash`, and\nwhether this pass is a nested signature (`isNest`), plus a `computeSignToolArgs(isWin)` helper\nthat returns the default arguments electron-builder would otherwise have used. Use this to\nintegrate an external or cloud signing service. See\n[Code Signing](https://www.electron.build/docs/features/code-signing).\n\nelectron-builder cannot tell which certificate the hook signs with, so also set\n[publisherName](#publisherName) to that certificate's subject: it is never derived from a\ncertificate for a hook (not even one in the config), and without it a build that writes\n`app-update.yml` fails."
8451
9097
  },
8452
- "requestedExecutionLevel": {
9098
+ "signingHashAlgorithms": {
8453
9099
  "anyOf": [
8454
9100
  {
8455
- "enum": [
8456
- "asInvoker",
8457
- "highestAvailable",
8458
- "requireAdministrator"
8459
- ],
8460
- "type": "string"
9101
+ "items": {
9102
+ "enum": [
9103
+ "sha1",
9104
+ "sha256"
9105
+ ],
9106
+ "type": "string"
9107
+ },
9108
+ "type": "array"
8461
9109
  },
8462
9110
  {
8463
9111
  "type": "null"
8464
9112
  }
8465
9113
  ],
8466
- "default": "asInvoker",
8467
- "description": "The [security level](https://msdn.microsoft.com/en-us/library/6ad1fshk.aspx#Anchor_9) at which the application requests to be executed.\nCannot be specified per target, allowed only in the `win`."
9114
+ "default": "['sha1', 'sha256']",
9115
+ "description": "The digest (hash) algorithms to sign with, applied via signtool's `/fd` flag (or\nosslsigncode's `-h`). One signing pass runs per entry, in order; listing more than one\n**dual-signs** the file, with each additional signature appended as a nested signature\n(signtool `/as`). Signing with both `sha1` and `sha256` lets a single binary validate on\nlegacy (pre-SHA-2) Windows as well as modern Windows.\n\nSome targets override this: `.msi` cannot be dual-signed (a single hash is used) and AppX/MSIX\nis always `sha256` only."
8468
9116
  },
8469
- "signAndEditExecutable": {
8470
- "default": true,
8471
- "description": "Whether to sign and add metadata to executable via [`resedit`](https://www.npmjs.com/package/resedit).\nMetadata includes information about the app name/description/version, publisher, copyright, etc.\nThis property also is responsible for adding the app icon and setting execution level.\nSet to `false` only if you need to fully disable resedit-based resource editing.\nTo skip only code signing while keeping resource editing, use `signExecutable: false` instead.",
8472
- "type": "boolean"
9117
+ "timeStampServer": {
9118
+ "default": "http://timestamp.digicert.com",
9119
+ "description": "The URL of the legacy Authenticode timestamp server, used for SHA-1 signatures (signtool's\n`/t` flag). This is also the timestamp server used by `osslsigncode` (`-t`) when signing on\nmacOS/Linux. See [rfc3161TimeStampServer](#rfc3161TimeStampServer) for SHA-256 / nested\nsignatures. Ignored when the build runs with `ELECTRON_BUILDER_OFFLINE=true`.",
9120
+ "type": [
9121
+ "null",
9122
+ "string"
9123
+ ]
8473
9124
  },
8474
- "signExecutable": {
8475
- "default": true,
8476
- "description": "Whether to sign Windows executables and any additional files matched by `signExts`.\nSet to `false` to skip Windows code signing while still editing executable resources\n(icon, metadata, etc. via [`resedit`](https://www.npmjs.com/package/resedit)).\nThis option is not limited to the main executable edit/sign flow and can also affect\nsigning of Windows installers or other artifacts that use the standard signing path.",
8477
- "type": "boolean"
9125
+ "type": {
9126
+ "const": "hsm",
9127
+ "description": "Discriminator selecting HSM / hardware-token signing via signtool's `/csp` and `/kc` flags.",
9128
+ "type": "string"
9129
+ }
9130
+ },
9131
+ "required": [
9132
+ "cryptoServiceProvider",
9133
+ "keyContainer",
9134
+ "type"
9135
+ ],
9136
+ "type": "object"
9137
+ },
9138
+ "WindowsPkcs11SigningConfig": {
9139
+ "additionalProperties": false,
9140
+ "description": "Sign with a PKCS#11 hardware token (smart card, USB HSM, cloud KMS exposed via a PKCS#11\nprovider) using `osslsigncode`. Unlike `hsm`, this mode does **not** require Windows or a\nWindows VM, so it can sign Windows binaries directly from macOS/Linux CI. The token PIN is read\nfrom the `WIN_CSC_KEY_PASSWORD` (or `CSC_KEY_PASSWORD`) environment variable.",
9141
+ "properties": {
9142
+ "additionalCertificateFile": {
9143
+ "description": "Path to an additional certificate file (typically an intermediate / cross-signing CA\ncertificate) whose contents are added to the signature block via signtool's `/ac` flag. Use\nthis when the signing certificate's full chain is not already present on target machines and\nyou want it embedded in the signature so the chain can be validated.",
9144
+ "type": [
9145
+ "null",
9146
+ "string"
9147
+ ]
8478
9148
  },
8479
- "signExts": {
9149
+ "certificateFile": {
9150
+ "description": "Optional path to a certificate chain file to accompany the PKCS#11 key.\nIf omitted the certificate embedded in the token is used.",
9151
+ "type": [
9152
+ "null",
9153
+ "string"
9154
+ ]
9155
+ },
9156
+ "pkcs11KeyUri": {
9157
+ "description": "RFC 7512 PKCS#11 URI identifying the private key within the module.\nMaps to osslsigncode's `-key` parameter.\n\nExample: `\"pkcs11:token=MyToken;object=MyKey;type=private\"`\n\nMust be paired with `pkcs11Module`.",
9158
+ "type": "string"
9159
+ },
9160
+ "pkcs11Module": {
9161
+ "description": "Path to the PKCS#11 shared library (`.so` on Linux, `.dylib` on macOS).\nThe library must be installed separately — electron-builder does not bundle it.\n\nExample: `\"/usr/lib/x86_64-linux-gnu/opensc-pkcs11.so\"`\n\nMust be paired with `pkcs11KeyUri`.",
9162
+ "type": "string"
9163
+ },
9164
+ "publisherName": {
8480
9165
  "anyOf": [
8481
9166
  {
8482
9167
  "items": {
@@ -8485,92 +9170,110 @@
8485
9170
  "type": "array"
8486
9171
  },
8487
9172
  {
8488
- "type": "null"
9173
+ "type": [
9174
+ "null",
9175
+ "string"
9176
+ ]
8489
9177
  }
8490
9178
  ],
8491
- "default": null,
8492
- "description": "Explicit file name/extensions (`str.endsWith`) to also sign. Advanced option.\nSupports negative patterns, e.g. example that excludes `.appx` files: `[\"somefilename\", \".dll\", \"!.appx\"]`."
9179
+ "description": "The publisher name(s) to associate with the signature, written exactly as the subject appears\nin your code signing certificate. May be a single string or an array — an array is useful when\nrotating certificates, so updates signed by either the old or the new certificate still verify.\n\nThis value is not a `signtool` argument; it is consumed in two places:\n- **Update verification** — when [verifyUpdateCodeSignature](#verifyUpdateCodeSignature) is\n enabled, it is written into `app-update.yml` and electron-updater checks it against the\n certificate that signed each downloaded update.\n- **AppX / MSIX identity** — the package `Publisher` attribute must equal the certificate\n subject, so electron-builder derives it from this value (or the certificate) to keep them\n in sync; a mismatch makes packaging fail with `ERROR_BAD_FORMAT`.\n\nDefaults to the Common Name (CN) extracted from your code signing certificate. **Required**\n(while `verifyUpdateCodeSignature` is enabled and `app-update.yml` is written) with a custom\n[sign](#sign) hook, even if a certificate is configured, and for a certificate without a CN —\notherwise the build fails. Set to `null` to opt out."
8493
9180
  },
8494
- "signtoolOptions": {
9181
+ "rfc3161TimeStampServer": {
9182
+ "default": "http://timestamp.digicert.com",
9183
+ "description": "The URL of the [RFC 3161](https://www.ietf.org/rfc/rfc3161.txt) timestamp server, used for\nSHA-256 and nested/appended signatures (signtool's `/tr` flag). Timestamping records *when*\nthe file was signed so the signature stays valid after the signing certificate expires.\nIgnored when the build runs with `ELECTRON_BUILDER_OFFLINE=true`.",
9184
+ "type": [
9185
+ "null",
9186
+ "string"
9187
+ ]
9188
+ },
9189
+ "sign": {
8495
9190
  "anyOf": [
8496
9191
  {
8497
- "$ref": "#/definitions/WindowsSigntoolConfiguration"
9192
+ "typeof": "function"
8498
9193
  },
8499
9194
  {
8500
- "type": "null"
9195
+ "type": [
9196
+ "null",
9197
+ "string"
9198
+ ]
8501
9199
  }
8502
9200
  ],
8503
- "description": "Options for usage with signtool.exe\nCannot be used in conjunction with `azureSignOptions`, signing will default to Azure Trusted Signing"
9201
+ "description": "A custom signing hook that **replaces** electron-builder's built-in `signtool` /\n`osslsigncode` invocation. Provide a function, or the path / module id of a file that exports\na `sign` function (resolved relative to the project, then as a module).\n\nThe hook is invoked once per signing pass (i.e. once per entry in\n[signingHashAlgorithms](#signingHashAlgorithms)) and receives a configuration object describing\nthe file to sign (`path`), the resolved certificate info (`cscInfo`), the current `hash`, and\nwhether this pass is a nested signature (`isNest`), plus a `computeSignToolArgs(isWin)` helper\nthat returns the default arguments electron-builder would otherwise have used. Use this to\nintegrate an external or cloud signing service. See\n[Code Signing](https://www.electron.build/docs/features/code-signing).\n\nelectron-builder cannot tell which certificate the hook signs with, so also set\n[publisherName](#publisherName) to that certificate's subject: it is never derived from a\ncertificate for a hook (not even one in the config), and without it a build that writes\n`app-update.yml` fails."
8504
9202
  },
8505
- "target": {
9203
+ "signingHashAlgorithms": {
8506
9204
  "anyOf": [
8507
- {
8508
- "$ref": "#/definitions/TargetConfiguration"
8509
- },
8510
9205
  {
8511
9206
  "items": {
8512
- "anyOf": [
8513
- {
8514
- "$ref": "#/definitions/TargetConfiguration"
8515
- },
8516
- {
8517
- "type": "string"
8518
- }
8519
- ]
9207
+ "enum": [
9208
+ "sha1",
9209
+ "sha256"
9210
+ ],
9211
+ "type": "string"
8520
9212
  },
8521
9213
  "type": "array"
8522
9214
  },
8523
9215
  {
8524
- "type": [
8525
- "null",
8526
- "string"
8527
- ]
9216
+ "type": "null"
8528
9217
  }
8529
9218
  ],
8530
- "default": "nsis",
8531
- "description": "The target package type: list of `nsis`, `nsis-web` (Web installer), `portable` ([portable]https://www.electron.build/nsis#portable) app without installation), `appx`, `msi`, `msi-wrapped`, `squirrel`, `7z`, `zip`, `tar.xz`, `tar.lz`, `tar.gz`, `tar.bz2`, `dir`.\nAppX package can be built only on Windows 10.\n\nTo use Squirrel.Windows please install `electron-builder-squirrel-windows` dependency."
9219
+ "default": "['sha1', 'sha256']",
9220
+ "description": "The digest (hash) algorithms to sign with, applied via signtool's `/fd` flag (or\nosslsigncode's `-h`). One signing pass runs per entry, in order; listing more than one\n**dual-signs** the file, with each additional signature appended as a nested signature\n(signtool `/as`). Signing with both `sha1` and `sha256` lets a single binary validate on\nlegacy (pre-SHA-2) Windows as well as modern Windows.\n\nSome targets override this: `.msi` cannot be dual-signed (a single hash is used) and AppX/MSIX\nis always `sha256` only."
8532
9221
  },
8533
- "verifyUpdateCodeSignature": {
8534
- "default": true,
8535
- "description": "Whether to verify the signature of an available update before installation.\nThe [publisher name](#publisherName) will be used for the signature verification.",
8536
- "type": "boolean"
9222
+ "timeStampServer": {
9223
+ "default": "http://timestamp.digicert.com",
9224
+ "description": "The URL of the legacy Authenticode timestamp server, used for SHA-1 signatures (signtool's\n`/t` flag). This is also the timestamp server used by `osslsigncode` (`-t`) when signing on\nmacOS/Linux. See [rfc3161TimeStampServer](#rfc3161TimeStampServer) for SHA-256 / nested\nsignatures. Ignored when the build runs with `ELECTRON_BUILDER_OFFLINE=true`.",
9225
+ "type": [
9226
+ "null",
9227
+ "string"
9228
+ ]
9229
+ },
9230
+ "type": {
9231
+ "const": "pkcs11",
9232
+ "description": "Discriminator selecting cross-platform PKCS#11 token signing via `osslsigncode`.",
9233
+ "type": "string"
8537
9234
  }
8538
9235
  },
9236
+ "required": [
9237
+ "pkcs11KeyUri",
9238
+ "pkcs11Module",
9239
+ "type"
9240
+ ],
8539
9241
  "type": "object"
8540
9242
  },
8541
- "WindowsSigntoolConfiguration": {
9243
+ "WindowsSigntoolSigningConfig": {
8542
9244
  "additionalProperties": false,
9245
+ "description": "Sign with a certificate file (`.pfx` / `.p12`) or with a certificate from the Windows\ncertificate store, using Microsoft `signtool.exe` on Windows and `osslsigncode` on macOS/Linux.\nThis is the default mode when `win.sign` is unset. Supply the certificate one of four ways:\na file via `certificateFile` (or the `WIN_CSC_LINK` env var), or a store lookup via\n`certificateSubjectName` or `certificateSha1`.",
8543
9246
  "properties": {
8544
9247
  "additionalCertificateFile": {
8545
- "description": "The path to an additional certificate file you want to add to the signature block.",
9248
+ "description": "Path to an additional certificate file (typically an intermediate / cross-signing CA\ncertificate) whose contents are added to the signature block via signtool's `/ac` flag. Use\nthis when the signing certificate's full chain is not already present on target machines and\nyou want it embedded in the signature so the chain can be validated.",
8546
9249
  "type": [
8547
9250
  "null",
8548
9251
  "string"
8549
9252
  ]
8550
9253
  },
8551
9254
  "certificateFile": {
8552
- "description": "The path to the *.pfx certificate you want to sign with. Please use it only if you cannot use env variable `CSC_LINK` (`WIN_CSC_LINK`) for some reason.\nPlease see [Code Signing](https://www.electron.build/code-signing).",
9255
+ "description": "Path to the PKCS#12 certificate file (`.pfx` or `.p12`) holding both the signing certificate\nand its private key. Passed to signtool via `/f` (or osslsigncode via `-pkcs12`).\n\nPrefer supplying this out-of-band via the `WIN_CSC_LINK` (or `CSC_LINK`) environment variable\ninstead of hardcoding a path — that variable also accepts an `https://` URL or a base64-encoded\ncertificate, which is safer and more convenient on CI. See\n[Code Signing](https://www.electron.build/docs/features/code-signing).",
8553
9256
  "type": [
8554
9257
  "null",
8555
9258
  "string"
8556
9259
  ]
8557
9260
  },
8558
9261
  "certificatePassword": {
8559
- "description": "The password to the certificate provided in `certificateFile`. Please use it only if you cannot use env variable `CSC_KEY_PASSWORD` (`WIN_CSC_KEY_PASSWORD`) for some reason.\nPlease see [Code Signing](https://www.electron.build/code-signing).",
9262
+ "description": "The password protecting the private key in `certificateFile`. Passed to signtool via `/p`\n(or osslsigncode via `-pass`).\n\nPrefer the `WIN_CSC_KEY_PASSWORD` (or `CSC_KEY_PASSWORD`) environment variable so the secret\nnever lands in your build configuration.",
8560
9263
  "type": [
8561
9264
  "null",
8562
9265
  "string"
8563
9266
  ]
8564
9267
  },
8565
9268
  "certificateSha1": {
8566
- "description": "The SHA1 hash of the signing certificate. The SHA1 hash is commonly specified when multiple certificates satisfy the criteria specified by the remaining switches. Works only on Windows (or on macOS if [Parallels Desktop](https://www.parallels.com/products/desktop/) Windows 10 virtual machines exits).",
9269
+ "description": "Select the signing certificate from the Windows certificate store by its SHA-1 thumbprint,\ninstead of pointing at a `.pfx` file. electron-builder looks the certificate up in the store\nand signs with `/sha1 <thumbprint> /s <store>`. Like\n[certificateSubjectName](#certificateSubjectName), this suits EV certificates backed by a\nhardware token; if both are set, both must resolve to the same certificate.\n\nWorks only on Windows (or macOS with Parallels Desktop, via the bundled Windows VM).",
8567
9270
  "type": [
8568
9271
  "null",
8569
9272
  "string"
8570
9273
  ]
8571
9274
  },
8572
9275
  "certificateSubjectName": {
8573
- "description": "The name of the subject of the signing certificate, which is often labeled with the field name `issued to`. Required only for EV Code Signing and works only on Windows (or on macOS if [Parallels Desktop](https://www.parallels.com/products/desktop/) Windows 10 virtual machines exits).",
9276
+ "description": "Select the signing certificate from the Windows certificate store by (a substring of) its\nsubject name, instead of pointing at a `.pfx` file. electron-builder enumerates the installed\ncode-signing certificates, picks the match, and signs by its thumbprint\n(`/sha1 <thumbprint> /s <store>`). **Required for EV (Extended Validation) certificates**,\nwhose private keys live on a hardware token and cannot be exported to a file.\n\nWorks only on Windows (or macOS with Parallels Desktop, via the bundled Windows VM).",
8574
9277
  "type": [
8575
9278
  "null",
8576
9279
  "string"
@@ -8591,11 +9294,11 @@
8591
9294
  ]
8592
9295
  }
8593
9296
  ],
8594
- "description": "[The publisher name](https://github.com/electron-userland/electron-builder/issues/1187#issuecomment-278972073), exactly as in your code signed certificate. Several names can be provided.\nDefaults to common name from your code signing certificate."
9297
+ "description": "The publisher name(s) to associate with the signature, written exactly as the subject appears\nin your code signing certificate. May be a single string or an array — an array is useful when\nrotating certificates, so updates signed by either the old or the new certificate still verify.\n\nThis value is not a `signtool` argument; it is consumed in two places:\n- **Update verification** — when [verifyUpdateCodeSignature](#verifyUpdateCodeSignature) is\n enabled, it is written into `app-update.yml` and electron-updater checks it against the\n certificate that signed each downloaded update.\n- **AppX / MSIX identity** — the package `Publisher` attribute must equal the certificate\n subject, so electron-builder derives it from this value (or the certificate) to keep them\n in sync; a mismatch makes packaging fail with `ERROR_BAD_FORMAT`.\n\nDefaults to the Common Name (CN) extracted from your code signing certificate. **Required**\n(while `verifyUpdateCodeSignature` is enabled and `app-update.yml` is written) with a custom\n[sign](#sign) hook, even if a certificate is configured, and for a certificate without a CN —\notherwise the build fails. Set to `null` to opt out."
8595
9298
  },
8596
9299
  "rfc3161TimeStampServer": {
8597
9300
  "default": "http://timestamp.digicert.com",
8598
- "description": "The URL of the RFC 3161 time stamp server.",
9301
+ "description": "The URL of the [RFC 3161](https://www.ietf.org/rfc/rfc3161.txt) timestamp server, used for\nSHA-256 and nested/appended signatures (signtool's `/tr` flag). Timestamping records *when*\nthe file was signed so the signature stays valid after the signing certificate expires.\nIgnored when the build runs with `ELECTRON_BUILDER_OFFLINE=true`.",
8599
9302
  "type": [
8600
9303
  "null",
8601
9304
  "string"
@@ -8613,7 +9316,7 @@
8613
9316
  ]
8614
9317
  }
8615
9318
  ],
8616
- "description": "The custom function (or path to file or module id) to sign Windows executables"
9319
+ "description": "A custom signing hook that **replaces** electron-builder's built-in `signtool` /\n`osslsigncode` invocation. Provide a function, or the path / module id of a file that exports\na `sign` function (resolved relative to the project, then as a module).\n\nThe hook is invoked once per signing pass (i.e. once per entry in\n[signingHashAlgorithms](#signingHashAlgorithms)) and receives a configuration object describing\nthe file to sign (`path`), the resolved certificate info (`cscInfo`), the current `hash`, and\nwhether this pass is a nested signature (`isNest`), plus a `computeSignToolArgs(isWin)` helper\nthat returns the default arguments electron-builder would otherwise have used. Use this to\nintegrate an external or cloud signing service. See\n[Code Signing](https://www.electron.build/docs/features/code-signing).\n\nelectron-builder cannot tell which certificate the hook signs with, so also set\n[publisherName](#publisherName) to that certificate's subject: it is never derived from a\ncertificate for a hook (not even one in the config), and without it a build that writes\n`app-update.yml` fails."
8617
9320
  },
8618
9321
  "signingHashAlgorithms": {
8619
9322
  "anyOf": [
@@ -8632,17 +9335,25 @@
8632
9335
  }
8633
9336
  ],
8634
9337
  "default": "['sha1', 'sha256']",
8635
- "description": "Array of signing algorithms used. For AppX `sha256` is always used."
9338
+ "description": "The digest (hash) algorithms to sign with, applied via signtool's `/fd` flag (or\nosslsigncode's `-h`). One signing pass runs per entry, in order; listing more than one\n**dual-signs** the file, with each additional signature appended as a nested signature\n(signtool `/as`). Signing with both `sha1` and `sha256` lets a single binary validate on\nlegacy (pre-SHA-2) Windows as well as modern Windows.\n\nSome targets override this: `.msi` cannot be dual-signed (a single hash is used) and AppX/MSIX\nis always `sha256` only."
8636
9339
  },
8637
9340
  "timeStampServer": {
8638
9341
  "default": "http://timestamp.digicert.com",
8639
- "description": "The URL of the time stamp server.",
9342
+ "description": "The URL of the legacy Authenticode timestamp server, used for SHA-1 signatures (signtool's\n`/t` flag). This is also the timestamp server used by `osslsigncode` (`-t`) when signing on\nmacOS/Linux. See [rfc3161TimeStampServer](#rfc3161TimeStampServer) for SHA-256 / nested\nsignatures. Ignored when the build runs with `ELECTRON_BUILDER_OFFLINE=true`.",
8640
9343
  "type": [
8641
9344
  "null",
8642
9345
  "string"
8643
9346
  ]
9347
+ },
9348
+ "type": {
9349
+ "const": "signtool",
9350
+ "description": "Discriminator selecting the default file/store signing mode.",
9351
+ "type": "string"
8644
9352
  }
8645
9353
  },
9354
+ "required": [
9355
+ "type"
9356
+ ],
8646
9357
  "type": "object"
8647
9358
  }
8648
9359
  },
@@ -8704,6 +9415,24 @@
8704
9415
  ],
8705
9416
  "description": "Called after code signing but **before** the signed app is packed into the final\ndistributable format (e.g. before `dmg` is created from the signed `.app`).\n\nUse this hook to perform post-sign validation or to add signed resources that are not part of\nthe main app bundle.\n\nReceives an {@link AfterPackContext}."
8706
9417
  },
9418
+ "allowMissingDependencies": {
9419
+ "anyOf": [
9420
+ {
9421
+ "items": {
9422
+ "type": "string"
9423
+ },
9424
+ "type": "array"
9425
+ },
9426
+ {
9427
+ "type": [
9428
+ "null",
9429
+ "boolean"
9430
+ ]
9431
+ }
9432
+ ],
9433
+ "default": false,
9434
+ "description": "Whether production dependencies that cannot be resolved during node-module collection are\nallowed — i.e. whether the build should continue with a warning instead of failing.\n\nDuring collection every production dependency must resolve to an installed package on disk. A\ndependency that does not resolve (`cannot find path for dependency` / `dependency not found on\ndisk`) is not bundled, which typically breaks the packaged app at runtime with\n`MODULE_NOT_FOUND`.\n\n- `false` or `null` (default): the build fails after dependency collection completes,\n reporting the **complete** list of missing production dependencies at once.\n- `string[]`: the listed dependency names are allowed to be missing; any other missing\n production dependency still fails the build. Entries match the package name of the reported\n `name@version` entry (e.g. `some-native-module`, `@scope/pkg`), or an exact `name@version`\n string to allow only that resolved version to be missing.\n- `true`: missing production dependencies are only logged as warnings (the electron-builder\n ≤ 26 behavior).\n\nMissing *optional* dependencies (declared in `optionalDependencies`, e.g. `fsevents` on\nLinux/Windows, or platform-specific packages) are always allowed and never fail the build.\n\nIndependent of {@link ignoredProductionDependencies}, which controls which dependencies are\nexcluded from the copied `node_modules`; this option only controls validation of the\ncollection result."
9435
+ },
8707
9436
  "apk": {
8708
9437
  "anyOf": [
8709
9438
  {
@@ -8800,11 +9529,10 @@
8800
9529
  "$ref": "#/definitions/AsarOptions"
8801
9530
  },
8802
9531
  {
8803
- "const": false,
8804
- "type": "boolean"
8805
- },
8806
- {
8807
- "type": "null"
9532
+ "type": [
9533
+ "null",
9534
+ "boolean"
9535
+ ]
8808
9536
  }
8809
9537
  ],
8810
9538
  "default": true,
@@ -8931,14 +9659,6 @@
8931
9659
  ],
8932
9660
  "description": "Overrides for input/output directory paths used during the build."
8933
9661
  },
8934
- "disableDefaultIgnoredFiles": {
8935
- "default": false,
8936
- "description": "Whether to exclude all default ignored files(https://www.electron.build/contents#files) and options. Defaults to `false`.",
8937
- "type": [
8938
- "null",
8939
- "boolean"
8940
- ]
8941
- },
8942
9662
  "dmg": {
8943
9663
  "anyOf": [
8944
9664
  {
@@ -8970,32 +9690,29 @@
8970
9690
  ]
8971
9691
  }
8972
9692
  ],
8973
- "description": "Override the source of the Electron distribution to stage.\n\nShould return the path to either:\n- A **directory** containing a pre-built, unpacked Electron app (e.g. `~/electron/out/R`).\n- A **directory** containing Electron zip archives following the naming convention\n `electron-v${version}-${platformName}-${arch}.zip`.\n\nWhen not set, electron-builder downloads the official Electron release from GitHub (or the\nmirror configured via `electronDownload`).\n\nReceives a {@link PrepareApplicationStageDirectoryOptions}."
9693
+ "description": "Override the source of the Electron distribution to stage.\n\nShould return the path to either:\n- A **directory** containing a pre-built, unpacked Electron app (e.g. `~/electron/out/R`).\n- A **directory** containing Electron zip archives following the naming convention\n `electron-v${version}-${platformName}-${arch}.zip`.\n\nWhen not set, electron-builder downloads the official Electron release from GitHub (or the\nmirror configured via `electronGet`).\n\nReceives a {@link PrepareApplicationStageDirectoryOptions}."
8974
9694
  },
8975
- "electronDownload": {
9695
+ "electronFuses": {
8976
9696
  "anyOf": [
8977
9697
  {
8978
- "$ref": "#/definitions/ElectronDownloadOptions"
8979
- },
8980
- {
8981
- "$ref": "#/definitions/ElectronGetOptions"
9698
+ "$ref": "#/definitions/FuseOptionsV1"
8982
9699
  },
8983
9700
  {
8984
9701
  "type": "null"
8985
9702
  }
8986
9703
  ],
8987
- "description": "Options forwarded to [`@electron/get`](https://github.com/electron/get) when downloading the\nElectron distribution to package.\n\nAlso accepts the legacy `electron-download` shape for backward compatibility."
9704
+ "description": "Options forwarded to [`@electron/fuses`](https://github.com/electron/fuses) to flip Electron\nfeature flags in the binary.\n\nFuses are compile-time-like flags baked into the Electron binary that cannot be changed at\nruntime. Flipping them is the approved mechanism for hardening Electron apps (e.g., disabling\n`ELECTRON_RUN_AS_NODE`, enabling ASAR integrity, etc.).\n\nelectron-builder flips fuses after packaging but before signing so that the final signature\ncovers the modified binary."
8988
9705
  },
8989
- "electronFuses": {
9706
+ "electronGet": {
8990
9707
  "anyOf": [
8991
9708
  {
8992
- "$ref": "#/definitions/FuseOptionsV1"
9709
+ "$ref": "#/definitions/ElectronGetOptions"
8993
9710
  },
8994
9711
  {
8995
9712
  "type": "null"
8996
9713
  }
8997
9714
  ],
8998
- "description": "Options forwarded to [`@electron/fuses`](https://github.com/electron/fuses) to flip Electron\nfeature flags in the binary.\n\nFuses are compile-time-like flags baked into the Electron binary that cannot be changed at\nruntime. Flipping them is the approved mechanism for hardening Electron apps (e.g., disabling\n`ELECTRON_RUN_AS_NODE`, enabling ASAR integrity, etc.).\n\nelectron-builder flips fuses after packaging but before signing so that the final signature\ncovers the modified binary."
9715
+ "description": "Options forwarded to [`@electron/get`](https://github.com/electron/get) when downloading the\nElectron distribution to package.\n\n`checksums` (a map of artifact file name → SHA-256 hex) makes checksum validation fully offline —\nwithout it, `@electron/get` fetches `SHASUMS256.txt` from the network on every build, even when the\nartifact itself is already cached. When `checksums` is not configured, electron-builder automatically\npicks up a locally seeded `SHASUMS256.txt-<version>` (or `SHASUMS256.txt`) file at the root of the\nElectron cache directory. See the\n[air-gapped / offline builds guide](https://www.electron.build/tutorials/offline-air-gapped-builds)."
8999
9716
  },
9000
9717
  "electronLanguages": {
9001
9718
  "anyOf": [
@@ -9012,7 +9729,7 @@
9012
9729
  "description": "The electron locales to keep. By default, all Electron locales used as-is."
9013
9730
  },
9014
9731
  "electronUpdaterCompatibility": {
9015
- "description": "The [electron-updater compatibility](https://www.electron.build/auto-update#compatibility) semver range.",
9732
+ "description": "The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range.",
9016
9733
  "type": [
9017
9734
  "null",
9018
9735
  "string"
@@ -9145,7 +9862,7 @@
9145
9862
  ]
9146
9863
  }
9147
9864
  ],
9148
- "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
9865
+ "description": "A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](https://www.electron.build/configuration#directories), which specifies which files to include when copying files to create the package.\n\nDefaults to:\n```json\n[\n\"**\\/*\",\n\"!**\\/node_modules/*\\/{CHANGELOG.md,README.md,README,readme.md,readme}\",\n\"!**\\/node_modules/*\\/{test,__tests__,tests,powered-test,example,examples}\",\n\"!**\\/node_modules/*.d.ts\",\n\"!**\\/node_modules/.bin\",\n\"!**\\/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,slnx,xproj}\",\n\"!.editorconfig\",\n\"!**\\/._*\",\n\"!**\\/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}\",\n\"!**\\/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}\",\n\"!**\\/{appveyor.yml,.travis.yml,circle.yml}\",\n\"!**\\/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}\"\n]\n```\n\nDevelopment dependencies are never copied in any case. You don't need to ignore it explicitly. Hidden files are not ignored by default, but all files that should be ignored, are ignored by default.\n\nDefault pattern \\`**\\/*\\` **is not added to your custom** if some of your patterns is not ignore (i.e. not starts with `!`). `package.json` and \\`**\\/node_modules/**\\/*` (only production dependencies will be copied) is added to your custom in any case. All default ignores are added in any case — you don't need to repeat it if you configure own patterns.\n\nMay be specified in the platform options (e.g. in the [mac](https://www.electron.build/mac)).\n\nYou may also specify custom source and destination directories by using `FileSet` objects instead of simple glob patterns.\n\n```json\n[\n{\n\"from\": \"path/to/source\",\n\"to\": \"path/to/destination\",\n\"filter\": [\"**\\/*\", \"!foo/*.js\"]\n}\n]\n```\n\nYou can use [file macros](https://www.electron.build/file-patterns#file-macros) in the `from` and `to` fields as well. `from` and `to` can be files and you can use this to [rename](https://github.com/electron-userland/electron-builder/issues/1119) a file while packaging."
9149
9866
  },
9150
9867
  "flatpak": {
9151
9868
  "anyOf": [
@@ -9185,6 +9902,24 @@
9185
9902
  "string"
9186
9903
  ]
9187
9904
  },
9905
+ "ignoredProductionDependencies": {
9906
+ "anyOf": [
9907
+ {
9908
+ "items": {
9909
+ "type": "string"
9910
+ },
9911
+ "type": "array"
9912
+ },
9913
+ {
9914
+ "type": "null"
9915
+ }
9916
+ ],
9917
+ "default": [
9918
+ "electron",
9919
+ "electron-builder"
9920
+ ],
9921
+ "description": "Names of production dependencies that are excluded from the copied `node_modules`, even if they\nare declared in the `dependencies` section of `package.json`.\n\nelectron-builder copies the resolved production dependency tree into the app. Some packages —\nnotably `electron` — are already provided another way (the Electron runtime is embedded\nseparately), so copying them would just duplicate what is already there. Such packages are\nexcluded from the copy rather than rejected: they remain valid production dependencies for\ntooling purposes (e.g. SBOM, license, and vulnerability tracking) without being shipped twice.\n\nOnly dependencies **declared by the app itself** are eligible: a listed name and the transitive\ndependencies required *only* by it are dropped, while anything also required by another (kept)\nproduction dependency stays bundled. A matching name that appears solely as a transitive\ndependency of a kept package is never excluded. Note that a kept package which `require()`s an\nexcluded name at runtime *without declaring it* (relying on hoisting) will fail with\n`MODULE_NOT_FOUND` — declare such a dependency properly or remove the name from this list.\n\nMatching is by the dependency name as declared in `package.json`: an npm alias\n(`\"custom-electron\": \"npm:electron@^30.0.0\"`) is matched by its alias key (`custom-electron`),\nnever by the underlying package name.\n\nOverriding this option **replaces** the default list, so include `electron` and `electron-builder`\nunless you intend to ship them. The most common reason to override is to *add* a dependency that a\nbundler (Vite, webpack, esbuild, …) already inlines into your app code: keep it in `dependencies`\nso SBOM/license tooling still sees it, and list it here so a duplicate copy is not packaged — e.g.\n`[\"electron\", \"electron-builder\", \"react\", \"react-dom\"]`. Removing a default name keeps that\npackage in the copied `node_modules`. Setting the option to `null` (or omitting it) applies the\ndefault list; to disable exclusion entirely, set it to an empty array `[]`. Each excluded package\nis logged once during packaging."
9922
+ },
9188
9923
  "includePdb": {
9189
9924
  "default": false,
9190
9925
  "description": "Whether to include `.pdb` (Program Database) symbol files in the output.\n\nPDB files enable Windows crash-dump analysis but significantly increase artifact size. Enable\nfor internal builds where you want symbol information; disable for public distribution.",
@@ -9270,6 +10005,17 @@
9270
10005
  ],
9271
10006
  "description": "MSI-wrapped NSIS installer options.\n\nWraps the standard NSIS installer inside an MSI package so that it can be deployed via\nGroup Policy or other MSI-only channels while preserving the NSIS installer UX."
9272
10007
  },
10008
+ "msix": {
10009
+ "anyOf": [
10010
+ {
10011
+ "$ref": "#/definitions/MsixOptions"
10012
+ },
10013
+ {
10014
+ "type": "null"
10015
+ }
10016
+ ],
10017
+ "description": "MSIX package options. MSIX is the modern successor to AppX with additional deployment features."
10018
+ },
9273
10019
  "nativeModules": {
9274
10020
  "anyOf": [
9275
10021
  {
@@ -9413,6 +10159,9 @@
9413
10159
  {
9414
10160
  "$ref": "#/definitions/SpacesOptions"
9415
10161
  },
10162
+ {
10163
+ "$ref": "#/definitions/R2Options"
10164
+ },
9416
10165
  {
9417
10166
  "$ref": "#/definitions/GenericServerOptions"
9418
10167
  },
@@ -9526,7 +10275,21 @@
9526
10275
  "type": "null"
9527
10276
  }
9528
10277
  ],
9529
- "description": "Pinned versions of the binary toolsets electron-builder downloads and uses internally.\n\nEach property selects a specific release of the corresponding tool bundle. Set a property to\n`\"0.0.0\"` to force the legacy bundle (pre-v27 behaviour). Leave a property unset (or set to\n`null`) to use the modern default for that toolset."
10278
+ "description": "Pinned versions of the binary toolsets electron-builder downloads and uses internally.\n\nEach property selects a specific release of the corresponding tool bundle. Set a property to\n`\"0.0.0\"` to force the legacy bundle (pre-v27 behaviour). Leave a property unset (or set it to\n`\"latest\"`) to use the modern default (newest bundle) for that toolset.\n\nNote: Toolset versioning can drop intermediate releases (such as if a problem is discovered in a bundle). If you need to pin to a specific release, check the release notes for the toolset to ensure the version you specify is valid."
10279
+ },
10280
+ "updateManifest": {
10281
+ "anyOf": [
10282
+ {
10283
+ "$ref": "#/definitions/UpdateManifestSigningOptions"
10284
+ },
10285
+ {
10286
+ "const": false
10287
+ },
10288
+ {
10289
+ "type": "null"
10290
+ }
10291
+ ],
10292
+ "description": "Ed25519 signing of the auto-update manifest (`latest*.yml`). Each manifest is signed and its public key is\nembedded into `app-update.yml`, so electron-updater verifies the signature before downloading an update.\n\n**Signing is required.** Publishing a build that emits auto-update metadata fails unless a signing key\nresolves. Generate one once with `electron-builder create-update-key`, then supply it via\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` / `ELECTRON_BUILDER_UPDATE_SIGN_KEY_FILE` (preferred in CI) or via\n`signingKey` / `signingKeyFile` below. Leaving this option unset — or `null` — keeps signing required and\nresolves the key from the environment; `null` is not an opt-out.\n\nSet to `false`, the only opt-out, to ship **unsigned** manifests. Every build that produces a manifest then\nlogs a warning. `false` also short-circuits the environment variables, so a leftover\n`ELECTRON_BUILDER_UPDATE_SIGN_KEY` in CI cannot re-enable signing by accident.\n\nThe requirement is only enforced when a publish policy is in effect (`--publish`); a build without one\nwarns instead, so local builds and pipelines that sign the manifest in a later step of their own are\nunaffected. It is also waived when every publish provider has `publishAutoUpdate: false`, since no manifest is\nemitted then, and for a build whose targets write no update info (e.g. only snap, flatpak, MSI/MSIX, portable,\nmas/pkg or plain archives). A publishing build checks for the key at build start, before anything is packed\nor uploaded.\n\nSee [Signed Update Manifests](https://www.electron.build/features/signed-update-manifests)."
9530
10293
  },
9531
10294
  "win": {
9532
10295
  "anyOf": [
@@ -9539,6 +10302,13 @@
9539
10302
  ],
9540
10303
  "description": "Windows-specific build options (signing, NSIS, icon, file associations, etc.)."
9541
10304
  },
10305
+ "writeEffectiveConfig": {
10306
+ "description": "Whether to write `builder-effective-config.yaml` (the resolved configuration, including the detected\n`electronVersion`) to the output directory.\n\nDefaults to writing it only for local interactive builds: not on CI and not when stdout is piped.\nSet `true` to always write it, e.g. to read the resolved configuration in a CI step, or `false` to never write it.",
10307
+ "type": [
10308
+ "null",
10309
+ "boolean"
10310
+ ]
10311
+ },
9542
10312
  "$schema": {
9543
10313
  "description": "JSON Schema for this document.",
9544
10314
  "type": [