app-builder-lib 27.0.0-alpha.13 → 27.0.0-alpha.14

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 (65) hide show
  1. package/dist/configuration.d.ts +47 -1
  2. package/dist/configuration.d.ts.map +1 -1
  3. package/dist/configuration.js.map +1 -1
  4. package/dist/options/PlatformSpecificBuildOptions.d.ts +4 -1
  5. package/dist/options/PlatformSpecificBuildOptions.d.ts.map +1 -1
  6. package/dist/options/PlatformSpecificBuildOptions.js.map +1 -1
  7. package/dist/packager.d.ts +6 -0
  8. package/dist/packager.d.ts.map +1 -1
  9. package/dist/packager.js +14 -3
  10. package/dist/packager.js.map +1 -1
  11. package/dist/publish/updateInfoBuilder.d.ts.map +1 -1
  12. package/dist/publish/updateInfoBuilder.js +7 -5
  13. package/dist/publish/updateInfoBuilder.js.map +1 -1
  14. package/dist/targets/blockmap/blockmap.d.ts +30 -0
  15. package/dist/targets/blockmap/blockmap.d.ts.map +1 -1
  16. package/dist/targets/blockmap/blockmap.js +99 -31
  17. package/dist/targets/blockmap/blockmap.js.map +1 -1
  18. package/dist/targets/blockmap/blockmapV3.d.ts +36 -0
  19. package/dist/targets/blockmap/blockmapV3.d.ts.map +1 -0
  20. package/dist/targets/blockmap/blockmapV3.js +41 -0
  21. package/dist/targets/blockmap/blockmapV3.js.map +1 -0
  22. package/dist/targets/blockmap/verbatimRange.d.ts +6 -0
  23. package/dist/targets/blockmap/verbatimRange.d.ts.map +1 -1
  24. package/dist/targets/blockmap/verbatimRange.js +11 -0
  25. package/dist/targets/blockmap/verbatimRange.js.map +1 -1
  26. package/dist/targets/differentialUpdateInfoBuilder.d.ts +92 -4
  27. package/dist/targets/differentialUpdateInfoBuilder.d.ts.map +1 -1
  28. package/dist/targets/differentialUpdateInfoBuilder.js +266 -10
  29. package/dist/targets/differentialUpdateInfoBuilder.js.map +1 -1
  30. package/dist/targets/linux/FpmTarget.d.ts.map +1 -1
  31. package/dist/targets/linux/FpmTarget.js +15 -1
  32. package/dist/targets/linux/FpmTarget.js.map +1 -1
  33. package/dist/targets/targetFactory.d.ts +1 -1
  34. package/dist/targets/targetFactory.d.ts.map +1 -1
  35. package/dist/targets/targetFactory.js +22 -0
  36. package/dist/targets/targetFactory.js.map +1 -1
  37. package/dist/targets/win/MsiTarget.d.ts +7 -0
  38. package/dist/targets/win/MsiTarget.d.ts.map +1 -1
  39. package/dist/targets/win/MsiTarget.js +140 -21
  40. package/dist/targets/win/MsiTarget.js.map +1 -1
  41. package/dist/targets/win/nsis/NsisTarget.d.ts.map +1 -1
  42. package/dist/targets/win/nsis/NsisTarget.js +14 -6
  43. package/dist/targets/win/nsis/NsisTarget.js.map +1 -1
  44. package/dist/toolsets/appimage.d.ts +3 -0
  45. package/dist/toolsets/appimage.d.ts.map +1 -1
  46. package/dist/toolsets/appimage.js +4 -1
  47. package/dist/toolsets/appimage.js.map +1 -1
  48. package/dist/toolsets/wix.d.ts +44 -0
  49. package/dist/toolsets/wix.d.ts.map +1 -0
  50. package/dist/toolsets/wix.js +91 -0
  51. package/dist/toolsets/wix.js.map +1 -0
  52. package/dist/util/electronUpdaterCompatibility.d.ts +43 -0
  53. package/dist/util/electronUpdaterCompatibility.d.ts.map +1 -0
  54. package/dist/util/electronUpdaterCompatibility.js +53 -0
  55. package/dist/util/electronUpdaterCompatibility.js.map +1 -0
  56. package/dist/util/packageMetadata.js +115 -51
  57. package/dist/util/packageMetadata.js.map +1 -1
  58. package/dist/version.d.ts +1 -1
  59. package/dist/version.js +1 -1
  60. package/dist/version.js.map +1 -1
  61. package/package.json +8 -8
  62. package/scheme.json +45 -6
  63. package/templates/msi/template.xml +5 -5
  64. package/templates/msiWrapped/template.xml +1 -1
  65. package/templates/nsis/assistedInstaller.nsh +32 -1
@@ -94,6 +94,28 @@ export interface CommonConfiguration {
94
94
  * @see {@link ToolsetConfig}
95
95
  */
96
96
  readonly toolsets?: ToolsetConfig | null;
97
+ /**
98
+ * Format of the `<artifact>.blockmap` file published next to installers and update archives, which electron-updater reads for
99
+ * differential downloads. The map is read by the updater already installed in your users' apps, so the format follows
100
+ * `electronUpdaterCompatibility` (default `">=7"`):
101
+ *
102
+ * - unset: `"v3"` when `electronUpdaterCompatibility` includes only electron-updater 7 and later, else `"v2"`, with a build
103
+ * warning.
104
+ * - `"v3"`: a binary block map that electron-updater fetches in parts with HTTP `Range` requests (only the parts that changed
105
+ * since the installed version), with finer blocks for stored members such as an uncompressed `app.asar`. Needs electron-updater
106
+ * 7 or later: with an `electronUpdaterCompatibility` that includes earlier versions, the build fails.
107
+ * - `"v2"`: the gzipped JSON block map every electron-updater version reads, downloaded in full on every update; the package and
108
+ * block map are the same as electron-builder 26 wrote.
109
+ * - `"latest"`: the newest format the `electronUpdaterCompatibility` range supports (currently the same as unset). A future
110
+ * format then costs one full download per user, as below.
111
+ *
112
+ * Apps whose electron-updater cannot read a release's format, or whose cached map is in another format, download that update
113
+ * in full once; the next one is differential again, or with an artifact name without `${version}` the one after it.
114
+ *
115
+ * Block maps embedded in an artifact (AppImage, the NSIS web installer's app package) are always `"v2"`.
116
+ * See [the v27 notes](https://www.electron.build/docs/migration/v27-build-changes#block-map-format-follows-electronupdatercompatibility).
117
+ */
118
+ readonly blockmap?: "v2" | "v3" | "latest" | null;
97
119
  /**
98
120
  * macOS-specific build options (signing, entitlements, notarization, target categories, etc.).
99
121
  * @see {@link MacConfiguration}
@@ -677,6 +699,7 @@ export interface ToolsetConfig {
677
699
  * | `"0.0.0"` | Legacy | FUSE2-based AppImage runtime (pre-v27) |
678
700
  * | `"1.0.3"` | 20251108 | Introduces static AppImage runtime |
679
701
  * | `"1.1.0"` | 20251108 | Adds `unsquashfs` support |
702
+ * | `"1.2.0"` | 20251108 | squashfs-tools 4.7.5 with a statically linked zstd 1.5.7, so Linux and macOS hosts produce identical images |
680
703
  *
681
704
  * An explicit version pin always selects exactly that release.
682
705
  *
@@ -684,7 +707,7 @@ export interface ToolsetConfig {
684
707
  *
685
708
  * @default "latest"
686
709
  */
687
- readonly appimage?: "0.0.0" | "1.0.3" | "1.1.0" | ToolsetCustom | "latest";
710
+ readonly appimage?: "0.0.0" | "1.0.3" | "1.1.0" | "1.2.0" | ToolsetCustom | "latest";
688
711
  /**
689
712
  * Version of the NSIS toolset bundle used to compile Windows installers.
690
713
  *
@@ -708,6 +731,29 @@ export interface ToolsetConfig {
708
731
  * @default "latest"
709
732
  */
710
733
  readonly nsis?: "0.0.0" | "1.2.1" | ToolsetCustom | "latest";
734
+ /**
735
+ * Version of the WiX Toolset bundle used to build `msi` and `msiWrapped` installers.
736
+ *
737
+ * The bundle ships **`candle.exe`** and **`light.exe`** (compile and link the generated `.wxs` project) and the WiX
738
+ * extensions (`WixUIExtension` for assisted installers). On macOS and Linux they run under Wine with wine-mono.
739
+ *
740
+ * Available versions:
741
+ * | Version | WiX version | Notes |
742
+ * |---------|-------------|-------|
743
+ * | `"0.0.0"` | 4.0.0.5512 (preview) | Legacy bundle (pre-v27). An `arm64` app is packaged in an `x64` MSI, because this toolset has no `arm64` |
744
+ * | `"2.0.0"` | 3.14.1 | Builds a native `arm64` MSI for `arm64` |
745
+ *
746
+ * The `.wxs` project uses the WiX 3 schema with `"2.0.0"`: an `msiProjectCreated` hook that inserts elements of a WiX 4
747
+ * extension namespace must use the WiX 3 one (for example `http://schemas.microsoft.com/wix/UtilExtension`), or pin `"0.0.0"`.
748
+ *
749
+ * A custom bundle (a {@link ToolsetCustom} object) must have the WiX v3 layout: `candle.exe`, `light.exe` and the
750
+ * extensions at its root.
751
+ *
752
+ * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/wix/CHANGELOG.md
753
+ *
754
+ * @default "latest"
755
+ */
756
+ readonly wix?: "0.0.0" | "2.0.0" | ToolsetCustom | "latest";
711
757
  /**
712
758
  * Version of the Wine bundle used to run Windows tools (NSIS, rcedit, signtool) on
713
759
  * non-Windows hosts (macOS and Linux).
@@ -1 +1 @@
1
- {"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAA0B,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAA","sourcesContent":["import { Arch } from \"builder-util\"\nimport { BeforeBuildContext, Target } from \"./core.js\"\nimport { ElectronBrandingOptions } from \"./electron/ElectronFramework.js\"\nimport { PrepareApplicationStageDirectoryOptions } from \"./Framework.js\"\nimport { AppXOptions } from \"./options/AppXOptions.js\"\nimport { AppImageOptions, DebOptions, FlatpakOptions, LinuxConfiguration, LinuxTargetSpecificOptions, PacmanOptions, RpmOptions } from \"./options/linuxOptions.js\"\nimport { DmgOptions, MacConfiguration, MasConfiguration } from \"./options/macOptions.js\"\nimport { MsiOptions } from \"./options/MsiOptions.js\"\nimport { MsiWrappedOptions } from \"./options/MsiWrappedOptions.js\"\nimport { MsixOptions } from \"./options/MsixOptions.js\"\nimport { PkgOptions } from \"./options/pkgOptions.js\"\nimport { PlatformSpecificBuildOptions } from \"./options/PlatformSpecificBuildOptions.js\"\nimport { SnapcraftOptions } from \"./options/SnapOptions.js\"\nimport { SquirrelWindowsOptions } from \"./options/SquirrelWindowsOptions.js\"\nimport { WindowsConfiguration } from \"./options/winOptions.js\"\nimport { BuildResult } from \"./packager.js\"\nimport { ArtifactBuildStarted, ArtifactCreated } from \"./packagerApi.js\"\nimport { PlatformPackager } from \"./platformPackager.js\"\nimport { NsisOptions, NsisWebOptions, PortableOptions } from \"./targets/win/nsis/nsisOptions.js\"\nimport { ElectronGetOptions } from \"./util/electronGet.js\"\nimport type { ExecutablesConfig } from \"builder-util\"\n// the types of toolsets.executables live with its resolver, in builder-util\nexport type { ExecutableLocation, ExecutableName, ExecutablesConfig } from \"builder-util\"\nimport { FuseOptionsV1 } from \"./options/FuseOptionsV1.js\"\n\n/**\n * Production dependencies that are excluded from the copied `node_modules` by default. These are\n * still legitimate production dependencies (for SBOM, license, and vulnerability tracking), but\n * electron-builder already provides them another way — notably the Electron runtime, which is\n * embedded separately — so copying them into the app would just duplicate what is already there.\n * Users can override the set via {@link CommonConfiguration.ignoredProductionDependencies}.\n *\n * Declared next to the option so the code constant, the jsdoc `@default`, and the generated\n * `scheme.json` stay in one place; a test asserts the generated schema matches this constant.\n */\nexport const DEFAULT_IGNORED_PRODUCTION_DEPENDENCIES: ReadonlyArray<string> = [\"electron\", \"electron-builder\"]\n\n// duplicate appId here because it is important\n/**\n * Configuration options shared across all platforms.\n *\n * These properties apply regardless of the target platform and control general build behaviour such\n * as the application identity, output paths, native dependency rebuilding, toolset versions, and\n * platform-specific target sub-configurations.\n */\nexport interface CommonConfiguration {\n /**\n * The application identifier.\n *\n * Used as [`CFBundleIdentifier`](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleidentifier)\n * on macOS and as the\n * [Application User Model ID](https://learn.microsoft.com/en-us/windows/win32/shell/appids)\n * on Windows (NSIS target only; Squirrel.Windows does not support custom Application User Model IDs).\n *\n * It is strongly recommended to set an explicit, reverse-DNS-style identifier (e.g. `\"com.example.myapp\"`)\n * rather than relying on the generated default.\n *\n * @default com.electron.${name}\n */\n readonly appId?: string | null\n\n /**\n * The human-readable product name displayed in installers, the macOS dock, and the Windows\n * Apps & Features list.\n *\n * Unlike the `name` field in `package.json`, this value may contain spaces and other characters\n * that are not allowed in npm package names.\n *\n * Resolution order:\n * 1. `productName` inside the `build` configuration block.\n * 2. `productName` at the top level of `package.json`.\n * 3. `name` at the top level of `package.json`.\n */\n readonly productName?: string | null\n\n /**\n * The copyright string embedded in the built artifacts.\n *\n * Appears in the Windows `LegalCopyright` version-info field and the macOS `NSHumanReadableCopyright`\n * Info.plist key.\n *\n * @default Copyright © ${year} ${author}\n */\n readonly copyright?: string | null\n\n /**\n * Overrides for input/output directory paths used during the build.\n *\n * @see {@link MetadataDirectories}\n */\n readonly directories?: MetadataDirectories | null\n\n /**\n * Pinned versions of the binary toolsets electron-builder downloads and uses internally.\n *\n * Each 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 *\n * Note: 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.\n *\n * @see {@link ToolsetConfig}\n */\n readonly toolsets?: ToolsetConfig | null\n\n /**\n * macOS-specific build options (signing, entitlements, notarization, target categories, etc.).\n * @see {@link MacConfiguration}\n */\n readonly mac?: MacConfiguration | null\n /**\n * macOS App Store (MAS) submission options.\n * @see {@link MasConfiguration}\n */\n readonly mas?: MasConfiguration | null\n /**\n * macOS App Store development-signing options (`mas-dev` target).\n * Used for local testing of MAS builds without submitting to the store.\n * @see {@link MasConfiguration}\n */\n readonly masDev?: MasConfiguration | null\n /**\n * macOS DMG disk image options (background image, window position, icon layout, licence, etc.).\n * @see {@link DmgOptions}\n */\n readonly dmg?: DmgOptions | null\n /**\n * macOS PKG flat-package installer options.\n * @see {@link PkgOptions}\n */\n readonly pkg?: PkgOptions | null\n\n /**\n * Windows-specific build options (signing, NSIS, icon, file associations, etc.).\n * @see {@link WindowsConfiguration}\n */\n readonly win?: WindowsConfiguration | null\n /**\n * NSIS one-click installer options.\n *\n * NSIS (Nullsoft Scriptable Install System) is the default Windows installer format produced by\n * electron-builder. It generates a lightweight, self-extracting `.exe` installer.\n *\n * @see {@link NsisOptions}\n */\n readonly nsis?: NsisOptions | null\n /**\n * NSIS web installer options.\n *\n * Like the standard NSIS installer but the app payload is downloaded from a remote URL at install\n * time rather than bundled into the `.exe`. Useful for very large apps or staged rollouts.\n *\n * @see {@link NsisWebOptions}\n */\n readonly nsisWeb?: NsisWebOptions | null\n /**\n * Portable executable options.\n *\n * Produces a single `.exe` that requires no installation — it extracts and runs directly.\n *\n * @see {@link PortableOptions}\n */\n readonly portable?: PortableOptions | null\n /**\n * Windows Store (MSIX/AppX) package options.\n *\n * Produces a `.appx` or `.msix` package suitable for distribution through the Microsoft Store or\n * side-loading.\n *\n * @see {@link AppXOptions}\n */\n readonly appx?: AppXOptions | null\n /** MSIX package options. MSIX is the modern successor to AppX with additional deployment features. */\n readonly msix?: MsixOptions | null\n /**\n * WiX-based MSI installer options.\n *\n * Produces a traditional `.msi` package built with the WiX Toolset. Best for enterprise\n * deployments that require MSI-based installation policies.\n *\n * @see {@link MsiOptions}\n */\n readonly msi?: MsiOptions | null\n /**\n * MSI-wrapped NSIS installer options.\n *\n * Wraps the standard NSIS installer inside an MSI package so that it can be deployed via\n * Group Policy or other MSI-only channels while preserving the NSIS installer UX.\n *\n * @see {@link MsiWrappedOptions}\n */\n readonly msiWrapped?: MsiWrappedOptions | null\n /**\n * Squirrel.Windows auto-update installer options.\n *\n * Requires the `electron-builder-squirrel-windows` optional dependency.\n *\n * @see {@link SquirrelWindowsOptions}\n */\n readonly squirrelWindows?: SquirrelWindowsOptions | null\n /**\n * General Linux build options shared across all Linux targets (icon, category, desktop entry,\n * executable name, etc.). Target-specific compression and packaging options live in the\n * per-format interfaces (`DebOptions`, `RpmOptions`, `PacmanOptions`, etc.).\n *\n * @see {@link LinuxConfiguration}\n */\n readonly linux?: LinuxConfiguration | null\n /**\n * Debian package options.\n *\n * Targets Debian, Ubuntu, and Debian-based distributions. Produces a `.deb` archive\n * installable via `dpkg -i` or `apt install ./package.deb`.\n *\n * @see {@link DebOptions}\n */\n readonly deb?: DebOptions | null\n /**\n * Snapcraft configuration.\n *\n * Selects the snapcraft base and provides per-core options:\n * - `base: \"core18\" | \"core20\" | \"core22\"` — legacy bases; still functional but not recommended\n * for new apps.\n * - `base: \"core24\"` — modern base with the GNOME extension (recommended, requires Electron 25+).\n * - `base: \"custom\"` — pass an existing `snapcraft.yaml` through unchanged; no plugs, extensions,\n * or desktop files are injected.\n *\n * @example\n * ```json\n * { \"snapcraft\": { \"base\": \"core24\", \"core24\": { \"useLXD\": true } } }\n * ```\n *\n * @see {@link SnapcraftOptions}\n */\n readonly snapcraft?: SnapcraftOptions | null\n /**\n * AppImage options.\n *\n * AppImage is a portable application format that bundles the app and its runtime dependencies\n * into a single self-contained executable that runs on most Linux distributions without\n * installation. The produced `.AppImage` file is executable after `chmod +x`.\n *\n * @see {@link AppImageOptions}\n */\n readonly appImage?: AppImageOptions | null\n /**\n * Flatpak options.\n *\n * Flatpak is a sandboxed application distribution format for Linux distributed via\n * [Flathub](https://flathub.org/) or self-hosted OSTree repositories.\n *\n * @see {@link FlatpakOptions}\n */\n readonly flatpak?: FlatpakOptions | null\n /**\n * Pacman package options.\n *\n * Targets Arch Linux and Arch-based distributions (Manjaro, EndeavourOS, etc.).\n * Produces a `.pacman` archive installable via `pacman -U ./package.pacman`.\n *\n * @see {@link PacmanOptions}\n */\n readonly pacman?: PacmanOptions | null\n /**\n * RPM package options.\n *\n * Targets Fedora, Red Hat Enterprise Linux, SUSE, and RPM-based distributions.\n * Produces a `.rpm` archive installable via `rpm -i` or `dnf install ./package.rpm`.\n *\n * @see {@link RpmOptions}\n */\n readonly rpm?: RpmOptions | null\n /**\n * FreeBSD `pkg` package options.\n *\n * Produces a `.pkg` archive for the FreeBSD package manager.\n */\n readonly freebsd?: LinuxTargetSpecificOptions | null\n /**\n * Solaris IPS package options.\n *\n * Produces a `.p5p` archive for the Solaris Image Packaging System (`pkg`).\n */\n readonly p5p?: LinuxTargetSpecificOptions | null\n /**\n * Alpine Linux APK package options.\n *\n * Produces an `.apk` archive installable via `apk add --allow-untrusted ./package.apk`.\n */\n readonly apk?: LinuxTargetSpecificOptions | null\n\n /**\n * Additional command-line arguments appended to the package manager's `install` command when\n * electron-builder installs app dependencies (i.e., when `node_modules` is missing and a fresh\n * install is required).\n *\n * These arguments are appended **only** during the install phase, not during the rebuild phase.\n * To influence `@electron/rebuild` directly, see {@link NativeModulesConfig.rebuildMode}.\n *\n * @example\n * ```json\n * { \"npmArgs\": [\"--prefer-offline\", \"--ignore-scripts\"] }\n * ```\n */\n readonly npmArgs?: Array<string> | string | null\n\n /**\n * Names of production dependencies that are excluded from the copied `node_modules`, even if they\n * are declared in the `dependencies` section of `package.json`.\n *\n * electron-builder copies the resolved production dependency tree into the app. Some packages —\n * notably `electron` — are already provided another way (the Electron runtime is embedded\n * separately), so copying them would just duplicate what is already there. Such packages are\n * excluded from the copy rather than rejected: they remain valid production dependencies for\n * tooling purposes (e.g. SBOM, license, and vulnerability tracking) without being shipped twice.\n *\n * Only dependencies **declared by the app itself** are eligible: a listed name and the transitive\n * dependencies required *only* by it are dropped, while anything also required by another (kept)\n * production dependency stays bundled. A matching name that appears solely as a transitive\n * dependency of a kept package is never excluded. Note that a kept package which `require()`s an\n * excluded 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 *\n * Matching 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`),\n * never by the underlying package name.\n *\n * Overriding this option **replaces** the default list, so include `electron` and `electron-builder`\n * unless you intend to ship them. The most common reason to override is to *add* a dependency that a\n * bundler (Vite, webpack, esbuild, …) already inlines into your app code: keep it in `dependencies`\n * so 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\n * package in the copied `node_modules`. Setting the option to `null` (or omitting it) applies the\n * default list; to disable exclusion entirely, set it to an empty array `[]`. Each excluded package\n * is logged once during packaging.\n *\n * @default [\"electron\", \"electron-builder\"]\n */\n readonly ignoredProductionDependencies?: Array<string> | null\n\n /**\n * Whether production dependencies that cannot be resolved during node-module collection are\n * allowed — i.e. whether the build should continue with a warning instead of failing.\n *\n * During collection every production dependency must resolve to an installed package on disk. A\n * dependency that does not resolve (`cannot find path for dependency` / `dependency not found on\n * disk`) 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 *\n * Missing *optional* dependencies (declared in `optionalDependencies`, e.g. `fsevents` on\n * Linux/Windows, or platform-specific packages) are always allowed and never fail the build.\n *\n * Independent of {@link ignoredProductionDependencies}, which controls which dependencies are\n * excluded from the copied `node_modules`; this option only controls validation of the\n * collection result.\n *\n * @default false\n */\n readonly allowMissingDependencies?: boolean | Array<string> | null\n\n /**\n * Configuration for native Node.js module installation and rebuilding.\n *\n * Groups all options that control how electron-builder handles native modules — from forcing\n * source builds during install through to the `@electron/rebuild` compilation mode.\n *\n * @see {@link NativeModulesConfig}\n */\n readonly nativeModules?: NativeModulesConfig | null\n\n /**\n * The build number.\n *\n * Maps to the `--iteration` flag for FPM-based Linux targets and is appended to the version\n * string in `CFBundleVersion` (macOS) and `FileVersion` (Windows) when {@link buildVersion} is\n * not set explicitly.\n *\n * If not set, falls back to the first defined environment variable among:\n * `BUILD_NUMBER`, `TRAVIS_BUILD_NUMBER`, `APPVEYOR_BUILD_NUMBER`, `CIRCLE_BUILD_NUM`,\n * `BUILD_BUILDNUMBER`, `CI_PIPELINE_IID`.\n */\n readonly buildNumber?: string | null\n\n /**\n * The full build version string.\n *\n * Maps to `CFBundleVersion` on macOS and the `FileVersion` metadata field on Windows.\n * Defaults to the `version` field from `package.json`.\n *\n * If `buildVersion` is not set but {@link buildNumber} is defined (or resolved from an\n * environment variable), the effective build version becomes `${version}.${buildNumber}`.\n */\n readonly buildVersion?: string | null\n\n /**\n * Whether to download the FFmpeg library variant from Electron's release assets and replace the\n * default (proprietary codec) FFmpeg library before signing.\n *\n * The alternate FFmpeg is compiled without proprietary codec support (H.264, AAC, etc.) and is\n * required for distributing on certain platforms (e.g., Linux distributions that prohibit\n * proprietary codecs). Enabling this swaps the bundled `ffmpeg` dynamic library before the app\n * is signed.\n */\n readonly downloadAlternateFFmpeg?: boolean\n\n /**\n * Additional properties to deep-merge into the app's `package.json` at build time.\n *\n * Useful for injecting build-time metadata (e.g., a git commit hash or CI build URL) that\n * should be readable at runtime via `require('./package.json')` or `import.meta.url`.\n *\n * @example\n * ```json\n * { \"extraMetadata\": { \"commitHash\": \"abc1234\", \"buildDate\": \"2025-01-01\" } }\n * ```\n */\n readonly extraMetadata?: any\n\n /**\n * Whether to throw an error and abort the build if the app could not be code-signed, notarized, or have its\n * auto-update manifests signed - and to verify the signatures the build produces.\n *\n * Set to `true` in release pipelines to catch missing or misconfigured signing credentials\n * before producing unsigned artifacts. When `false` (the default), missing signing credentials\n * produce a warning and the build continues unsigned.\n *\n * With `true`:\n * - macOS: the app must be signed, which needs a macOS host, also in pull-request builds (set `CSC_FOR_PULL_REQUEST=true` to sign\n * them, or pass `-c.forceCodeSigning=false` there), and notarized: notarization credentials must be set when the build starts.\n * The output of a custom `mac.sign` signer is checked with `codesign --verify --deep --strict`, the stapled ticket with\n * `stapler validate`, a signed pkg with `pkgutil --check-signature`, and a DMG with `dmg.sign: true` must be signed.\n * - Windows: every signed file is read back and must carry a valid Authenticode signature.\n * - Every platform (the only effect on Linux): auto-update manifests must be signed, also by a build that does not publish.\n * - A prepackaged app, which electron-builder does not sign, must already be signed (and, on macOS, notarized).\n *\n * Explicit opt-outs are honored with a warning: `mac.notarize: false`, `updateManifest: false`, `win.signExts` exclusions and a\n * custom `nsis.script` (whose uninstaller electron-builder does not sign). `win.sign: false` and `mac.sign: null` contradict it\n * and fail the build. `electron-builder verify` checks the build output afterwards.\n *\n * @default false\n */\n readonly forceCodeSigning?: boolean\n\n /**\n * Whether to remove the `scripts` field from bundled `package.json` files.\n *\n * Lifecycle scripts (`preinstall`, `postinstall`, etc.) have no meaning inside a packaged\n * Electron app and can trigger unintended behaviour if any tooling inspects the bundled\n * `package.json`. Removing them reduces artifact size and prevents accidental execution.\n *\n * @default true\n */\n readonly removePackageScripts?: boolean\n\n /**\n * Whether to remove the `keywords` field from bundled `package.json` files.\n *\n * The `keywords` array is only meaningful for package registry discoverability and has no\n * runtime value inside a packaged Electron app. Removing it marginally reduces artifact size.\n *\n * @default true\n */\n readonly removePackageKeywords?: boolean\n\n /**\n * Options forwarded to [`@electron/fuses`](https://github.com/electron/fuses) to flip Electron\n * feature flags in the binary.\n *\n * Fuses are compile-time-like flags baked into the Electron binary that cannot be changed at\n * runtime. Flipping them is the approved mechanism for hardening Electron apps (e.g., disabling\n * `ELECTRON_RUN_AS_NODE`, enabling ASAR integrity, etc.).\n *\n * electron-builder flips fuses after packaging but before signing so that the final signature\n * covers the modified binary.\n *\n * @see {@link FuseOptionsV1}\n */\n readonly electronFuses?: FuseOptionsV1 | null\n\n /**\n * Configuration for experimental concurrent (multi-platform / multi-arch) builds.\n *\n * When `jobs > 1`, electron-builder runs up to `jobs` platform builds in parallel. This is an\n * experimental feature — use with caution and verify that your hook functions and build resources\n * are safe to execute concurrently.\n *\n * @see {@link Concurrency}\n */\n readonly concurrency?: Concurrency | null\n}\n\n/**\n * The root build configuration object passed to electron-builder.\n *\n * Extends {@link CommonConfiguration} with top-level Electron-specific options, configuration\n * inheritance/presets, and all per-platform build hooks.\n */\nexport interface Configuration extends CommonConfiguration, PlatformSpecificBuildOptions, Hooks {\n /**\n * Options forwarded to [`@electron/get`](https://github.com/electron/get) when downloading the\n * Electron distribution to package.\n *\n * `checksums` (a map of artifact file name → SHA-256 hex) makes checksum validation fully offline —\n * without it, `@electron/get` fetches `SHASUMS256.txt` from the network on every build, even when the\n * artifact itself is already cached. When `checksums` is not configured, electron-builder automatically\n * picks up a locally seeded `SHASUMS256.txt-<version>` (or `SHASUMS256.txt`) file at the root of the\n * Electron cache directory. See the\n * [air-gapped / offline builds guide](https://www.electron.build/tutorials/offline-air-gapped-builds).\n */\n readonly electronGet?: ElectronGetOptions | null\n\n /**\n * Electron branding overrides.\n *\n * Required only when packaging a custom Electron fork that ships a modified `BRANDING.json`\n * (e.g., a fork that renames the `Electron Helper` process or the `Electron Framework`).\n * Standard Electron builds do not need this.\n */\n readonly electronBranding?: ElectronBrandingOptions\n\n /**\n * The Electron version to package against.\n *\n * Defaults to the version of the `electron` (or `electron-prebuilt`) dependency declared in\n * `package.json`. Set this explicitly only when the installed Electron version is not the one\n * you want to package against (e.g., in monorepos where the Electron dependency lives in a\n * different workspace).\n */\n electronVersion?: string | null\n\n /**\n * Whether to write `builder-effective-config.yaml` (the resolved configuration, including the detected\n * `electronVersion`) to the output directory.\n *\n * Defaults to writing it only for local interactive builds: not on CI and not when stdout is piped.\n * Set `true` to always write it, e.g. to read the resolved configuration in a CI step, or `false` to never write it.\n */\n readonly writeEffectiveConfig?: boolean | null\n\n /**\n * One or more configuration presets or file paths to merge into this configuration.\n *\n * Accepts a string or array of strings, each of which is either:\n * - A built-in preset name (`\"react-cra\"` is the only currently supported value).\n * - A path to a JS/JSON config file relative to the project directory.\n *\n * Configs are merged left-to-right using a deep-assign strategy that properly combines `files`\n * glob patterns rather than replacing them.\n *\n * The `react-cra` preset is applied automatically when `react-scripts` is found in\n * `dependencies`. Set `extends: null` to opt out of automatic preset detection.\n */\n extends?: Array<string> | string | null\n}\n\n/**\n * Configuration for native Node.js module installation and rebuilding.\n *\n * All options that control how electron-builder handles native modules — from forcing source\n * builds at install time through to the `@electron/rebuild` compilation mode.\n */\nexport interface NativeModulesConfig {\n /**\n * Whether to pass `--build-from-source` to the package manager when installing native\n * dependencies, forcing them to compile from source rather than using pre-built binaries.\n *\n * Useful when pre-built binaries are not available for the target platform/arch combination,\n * or when you need to ensure native modules are compiled against the exact Electron ABI.\n *\n * Only honored when the target platform matches the host platform: native modules cannot be\n * cross-compiled from source for another OS, so for a cross-platform target native dependencies are\n * rebuilt with prebuilt binaries for that target instead (and a warning is logged).\n *\n * @default false\n */\n buildDependenciesFromSource?: boolean\n\n /**\n * Whether to run `node-gyp rebuild` with Electron headers before packaging.\n *\n * This 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`\n * and rely on `@electron/rebuild` instead.\n *\n * When `true`, electron-builder runs `node-gyp rebuild` with the correct `npm_config_*`\n * environment variables set for the target Electron version and architecture before the\n * normal rebuild step.\n *\n * @default false\n */\n readonly nodeGypRebuild?: boolean\n\n /**\n * Whether to rebuild native Node.js modules for the target Electron version and architecture\n * before packaging.\n *\n * When `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\n * ABI. Set to `false` to skip this step entirely — useful when native modules are pre-built\n * elsewhere in your pipeline or when the app has no native dependencies.\n *\n * The compilation mode (`sequential` vs `parallel`) is controlled by {@link rebuildMode}.\n *\n * @default true\n */\n readonly npmRebuild?: boolean\n\n /**\n * 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.\n *\n * @default \"sequential\"\n */\n readonly rebuildMode?: \"sequential\" | \"parallel\" | null\n\n /**\n * Whether to verify, after the app is packed, that every native binary shipped in the app was built for\n * the target platform and architecture.\n *\n * electron-builder reads the header of each `.node` addon (and of other native libraries and executables\n * such as `.so`, `.dylib`, `.dll`, `.exe`) in `app.asar`, `app.asar.unpacked` or the unpacked `app`\n * directory, and compares its format (ELF / Mach-O / PE) and machine type against the target (for\n * a macOS universal build, each per-arch slice is checked before the slices are merged). This catches a\n * stale or host-platform binary left in `node_modules` by a skipped or cached rebuild, which otherwise\n * only surfaces at runtime as `invalid ELF header` / `not a valid Win32 application` /\n * `incompatible architecture`.\n *\n * Files whose package declares another platform via `package.json` `os`/`cpu`, or whose path names\n * another platform/arch (e.g. prebuildify's `prebuilds/linux-arm64/`), are not loaded for this target\n * and 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.\n *\n * @default true\n */\n readonly verifyNativeBinaries?: boolean | \"warn\" | null\n}\n\nexport type Hook<T, V> = (contextOrPath: T) => Promise<V> | V\n\nexport interface PackContext {\n readonly outDir: string\n readonly appOutDir: string\n readonly packager: PlatformPackager<any>\n readonly electronPlatformName: string\n readonly arch: Arch\n readonly targets: Array<Target>\n}\nexport type AfterPackContext = PackContext\nexport type BeforePackContext = PackContext\nexport type AfterExtractContext = PackContext\n\n/**\n * Version pins and custom bundle overrides for the binary toolsets that electron-builder downloads and caches locally.\n *\n * Each toolset is a versioned archive hosted at [electron-userland/electron-builder-binaries](https://github.com/electron-userland/electron-builder-binaries/releases).\n * Omitting a property (or setting it to `latest`) selects the modern default for that toolset.\n *\n * To 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\n * https://github.com/electron-userland/electron-builder-binaries/tree/master/packages.\n */\nexport interface ToolsetConfig {\n /**\n * Version of the `win-codesign` bundle used for Windows code signing and resource editing.\n *\n * The 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 *\n * Available 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 * | `\"1.3.1\"` | macOS `osslsigncode` bundles its own OpenSSL (no Homebrew `openssl@3` needed) and libp11's PKCS#11 provider |\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/win-codesign/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly winCodeSign?: \"0.0.0\" | \"1.0.0\" | \"1.1.0\" | \"1.1.1\" | \"1.2.1\" | \"1.3.0\" | \"1.3.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the AppImage toolset bundle used for building `.AppImage` files.\n *\n * The bundle ships:\n * - **`mksquashfs`** — creates the SquashFS filesystem embedded in the AppImage. It also packs legacy-base (core18/core20/core22) snaps built from the snap template app.\n * - **`desktop-file-validate`** — validates the generated `.desktop` entry.\n * - **AppImage runtime** — the self-executing stub that mounts the SquashFS at launch.\n *\n * Available 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 *\n * An explicit version pin always selects exactly that release.\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/appimage/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly appimage?: \"0.0.0\" | \"1.0.3\" | \"1.1.0\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the NSIS toolset bundle used to compile Windows installers.\n *\n * The 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 *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/nsis/CHANGELOG.md\n *\n * A custom bundle (a {@link ToolsetCustom} object) must follow the layout at\n * https://www.electron.build/docs/toolsets#custom-nsis-bundle-layout\n *\n * @default \"latest\"\n */\n readonly nsis?: \"0.0.0\" | \"1.2.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the Wine bundle used to run Windows tools (NSIS, rcedit, signtool) on\n * non-Windows hosts (macOS and Linux).\n *\n * Wine is only required when building Windows targets on a non-Windows machine. On Windows,\n * this setting has no effect.\n *\n * Available 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 host Wine at a fixed install location instead of a bundle |\n *\n * `\"system\"` is the replacement for the `USE_SYSTEM_WINE` environment variable removed in v27, and\n * is what `\"latest\"` (the default) currently resolves to on every platform: the published `\"1.0.1\"`\n * bundles ship no PE builtins, so a host Wine installation is required to build Windows targets on\n * macOS or Linux.\n *\n * The host Wine (`\"system\"`) is started by absolute path, never looked up on `PATH`: it is the `wine` entry of\n * {@link executables}, which lists its default install locations and is where a Wine installed elsewhere is set.\n * Setting both a bundle that would be used (a `ToolsetCustom` object, or a version on macOS; on Linux a version selects no\n * bundle) and `executables.wine` is a configuration error.\n *\n * To use a custom Wine bundle, use a `ToolsetCustom` object.\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/wine/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly wine?: \"0.0.0\" | \"1.0.1\" | \"system\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the FPM bundle used to build Linux packages (`.deb`, `.rpm`, `.pacman`, etc.)\n * on macOS and Linux hosts.\n *\n * Available versions:\n * | Version | FPM version | Notes |\n * |---------|------------|-------|\n * | `\"2.2.1\"` | 1.17.0 (Ruby 3.4.3) | Current default |\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/fpm/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly fpm?: \"2.2.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the Linux-tools-mac bundle used to produce `.tar.lz` archives and build\n * Linux targets on macOS hosts.\n *\n * The bundle ships macOS-native builds of `ar`, `lzip`, and `gtar` (GNU tar).\n *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/linux-tools-mac/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly linuxToolsMac?: \"1.0.0\" | \"1.0.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the 7-Zip binary bundle used internally to extract `.7z` and `.tar.xz` archives.\n *\n * Set to a {@link ToolsetCustom} object to supply your own 7za binary.\n * The `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\n * extracting them requires 7za — a circular dependency.\n *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/7zip/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly sevenZip?: \"1.0.0\" | \"1.0.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the icons-conversion bundle used to convert source images to `.icns`, `.ico`,\n * and PNG icon sets.\n *\n * Set to a {@link ToolsetCustom} object to supply your own icons bundle directory.\n *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/icons/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly icons?: \"1.2.3\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the `squirrel.windows` bundle used to build Squirrel.Windows installers.\n *\n * The 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;\n * under Wine on non-Windows hosts). Building an MSI additionally uses the shared WiX toolset.\n *\n * Available 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 *\n * Set 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/squirrel.windows/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly squirrel?: \"1.1.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Where the host programs that electron-builder starts are installed on the build machine, by program name.\n *\n * electron-builder starts these programs only from an absolute path, never by looking up a name on `PATH`. For each one it\n * uses the first location that is an executable file: from this entry when it is set, otherwise from a built-in list of\n * default install locations for the host operating system (see https://www.electron.build/docs/toolsets#executables).\n * An entry replaces the default list for that program; it is not merged with it.\n *\n * @example\n * ```json\n * {\n * \"toolsets\": {\n * \"executables\": {\n * \"mono\": \"file:///opt/homebrew/bin/mono\",\n * \"pwsh\": [\"file:///usr/local/microsoft/powershell/7/pwsh\", \"file:///opt/microsoft/powershell/7/pwsh\"],\n * \"powershell\": \"file:///C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe\"\n * }\n * }\n * }\n * ```\n */\n readonly executables?: ExecutablesConfig | null\n}\n\n/**\n * A custom toolset bundle supplied by the user in place of a built-in versioned bundle.\n *\n * The bundle must mirror the expected directory layout of the corresponding built-in bundle.\n * See the build scripts at\n * https://github.com/electron-userland/electron-builder-binaries/tree/master/packages.\n *\n * File 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\n * used for all toolset checksums), the same for every toolset. See https://www.electron.build/docs/toolsets#custom-toolset-checksum\n *\n * @example\n * ```json\n * {\n * \"toolsets\": {\n * \"nsis\": {\n * \"url\": \"file:///path/to/my-nsis-bundle.tar.gz\",\n * \"checksum\": \"56997fdefe25e7928a1a68b4583d08b240b66cf660234053b20131a74cc082f4\",\n * \"version\": \"my-custom-1.0\"\n * }\n * }\n * }\n * ```\n */\nexport interface ToolsetCustom {\n /**\n * 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 *\n * Archives (`.zip`, `.7z`, `.tar.gz`, `.tar.xz`) are extracted automatically.\n * A bare directory path (no archive) is used as-is.\n */\n readonly url: string\n\n /**\n * 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 *\n * Prefixed forms such as `sha256:…` or `sha512-…`, and a hex-encoded SHA-512, are rejected before anything is downloaded.\n * A downloaded archive is verified before it is cached or extracted, and a local `file://` archive before it is extracted.\n *\n * Required for remote (`https://`) URLs and local archive files (`file://`).\n * Not needed for bare directory paths — the directory is used as-is with no caching and no verification.\n * @see https://www.electron.build/docs/toolsets#custom-toolset-checksum\n */\n readonly checksum?: string\n\n /**\n * Optional version label used in the local cache directory name.\n * Falls back to the first 8 hex characters of the `checksum` digest when omitted.\n */\n readonly version?: string\n}\n\n/**\n * Lifecycle hooks that run at specific points during the electron-builder pipeline.\n *\n * Each hook can be specified as:\n * - An **inline function** (JavaScript/TypeScript config files only):\n * ```js\n * // electron-builder.config.js\n * module.exports = { beforePack: async (context) => { /* ... *\\/ } }\n * ```\n * - A **path** to a CommonJS/ESM module (relative to the project directory) that exports the\n * hook as its **default export**:\n * ```json\n * { \"build\": { \"beforePack\": \"./scripts/myHook.js\" } }\n * ```\n * ```js\n * // scripts/myHook.js\n * export default async function (context) { /* ... *\\/ }\n * ```\n */\nexport interface Hooks {\n /**\n * Called immediately before electron-builder begins packing the app for each platform/arch\n * combination.\n *\n * Use this hook to perform last-minute modifications to source files or build resources before\n * they are read by the packager.\n *\n * Receives a {@link BeforePackContext}.\n */\n readonly beforePack?: Hook<BeforePackContext, void> | string | null\n\n /**\n * Called after the prebuilt Electron binary has been extracted to the staging directory but\n * before the app files have been copied into it.\n *\n * Use this hook to patch or augment the Electron binary itself (e.g. rename helper processes,\n * inject native libraries) before the app payload is laid down on top.\n *\n * Receives an {@link AfterExtractContext}.\n */\n readonly afterExtract?: Hook<AfterExtractContext, void> | string | null\n\n /**\n * Called after the app files have been copied into the staging directory (and ASAR created if\n * applicable) but **before** signing and before the output archive/installer is built.\n *\n * Use this hook to post-process the staged app bundle (e.g. strip debug symbols, inject\n * platform-specific resources).\n *\n * Receives an {@link AfterPackContext}.\n */\n readonly afterPack?: Hook<AfterPackContext, void> | string | null\n\n /**\n * Called after code signing but **before** the signed app is packed into the final\n * distributable format (e.g. before `dmg` is created from the signed `.app`).\n *\n * Use this hook to perform post-sign validation or to add signed resources that are not part of\n * the main app bundle.\n *\n * Receives an {@link AfterPackContext}.\n */\n readonly afterSign?: Hook<AfterPackContext, void> | string | null\n\n /**\n * Called when an individual artifact build starts (e.g. just before a `.dmg` or `.exe` is\n * written to disk).\n *\n * Receives an {@link ArtifactBuildStarted}.\n */\n readonly artifactBuildStarted?: Hook<ArtifactBuildStarted, void> | string | null\n\n /**\n * Called when an individual artifact has been successfully built and written to disk.\n *\n * Use this hook to collect artifact paths, upload to custom destinations, or trigger\n * post-processing steps.\n *\n * Receives an {@link ArtifactCreated}.\n */\n readonly artifactBuildCompleted?: Hook<ArtifactCreated, void> | string | null\n\n /**\n * Called after **all** artifacts across all platforms/architectures have been built.\n *\n * May return an array of additional file paths that should be treated as publish targets\n * (i.e. uploaded to the configured publisher).\n *\n * Receives a {@link BuildResult}.\n *\n * @example\n * ```js\n * export default async function afterAllArtifactBuild(result) {\n * return [\"/path/to/extra-file.txt\"]\n * }\n * ```\n */\n readonly afterAllArtifactBuild?: Hook<BuildResult, Array<string>> | string | null\n\n /**\n * Called after the WiX MSI project XML has been written to a temporary directory but before\n * `candle.exe` / `light.exe` compile it into a `.msi` package.\n *\n * The hook receives the path to the project directory as a string. Use it to patch the generated\n * `.wxs` files for customizations not exposed through electron-builder's options.\n */\n readonly msiProjectCreated?: Hook<string, void> | string | null\n\n /**\n * Called after the AppX/MSIX manifest XML has been written to the staging directory but before\n * `makeappx` packages it.\n *\n * The hook receives the path to the manifest file as a string. Use it to inject custom manifest\n * extensions (capabilities, protocol handlers, etc.) not exposed through {@link AppXOptions}.\n */\n readonly appxManifestCreated?: Hook<string, void> | string | null\n\n /**\n * Called after the `distribution.xml` of a macOS `pkg` installer has been written (synthesized by\n * `productbuild --synthesize`, then customized from {@link PkgOptions}) but before `productbuild` builds the\n * installer from it.\n *\n * The hook receives the path to the distribution file as a string. Edit it in place or overwrite it to\n * customize the installer beyond {@link PkgOptions} (for example, its `<title>`).\n */\n readonly pkgDistributionCreated?: Hook<string, void> | string | null\n\n /**\n * Called for every file inside each `node_modules` package directory as electron-builder\n * decides whether to include it in the packaged app.\n *\n * Return `true` to force-include the file regardless of the default exclusion rules.\n * Return `false` or `undefined` to let electron-builder apply its normal filtering logic.\n *\n * Receives the absolute path of the file as a string.\n */\n readonly onNodeModuleFile?: Hook<string, void | boolean> | string | null\n\n /**\n * Called before dependencies are installed or native modules are rebuilt.\n *\n * Return `false` (or a `Promise` that resolves to `false`) to skip the install/rebuild step\n * entirely — useful when you manage `node_modules` externally (e.g. in a CI pipeline that\n * restores them from cache). When not set, electron-builder proceeds with the normal\n * install/rebuild flow.\n *\n * If this hook is provided and `node_modules` is missing, electron-builder will not perform\n * the production-dependencies check.\n *\n * Receives a {@link BeforeBuildContext}.\n */\n readonly beforeBuild?: Hook<BeforeBuildContext, boolean | void> | string | null\n\n /**\n * Override the source of the Electron distribution to stage.\n *\n * Should 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 *\n * When not set, electron-builder downloads the official Electron release from GitHub (or the\n * mirror configured via `electronGet`).\n *\n * Receives a {@link PrepareApplicationStageDirectoryOptions}.\n */\n readonly electronDist?: Hook<PrepareApplicationStageDirectoryOptions, string> | string | null\n}\n\n/**\n * Overrides for the input and output directories used during the build.\n */\nexport interface MetadataDirectories {\n /**\n * The directory that contains static build resources (icons, background images, license files,\n * custom NSIS scripts, etc.) that electron-builder reads during packaging.\n *\n * **Build resources are not copied into the packaged app.** If you need runtime access to a\n * file (e.g. a tray icon), include it explicitly via the `fileOptions.files` option:\n * ```json\n * { \"fileOptions\": { \"files\": [\"**\\/*\", \"build/icon.*\"] } }\n * ```\n *\n * @default \"build\"\n */\n readonly buildResources?: string | null\n\n /**\n * The directory where electron-builder writes its output (installers, zip archives, etc.).\n *\n * [File macros](https://www.electron.build/file-patterns#file-macros) are supported, e.g.\n * `\"dist/${os}-${arch}\"` to separate outputs by platform and architecture.\n *\n * @default \"dist\"\n */\n readonly output?: string | null\n\n /**\n * The directory that contains the application's `package.json` and source code.\n *\n * Defaults to `app`, then `www`, then the project root. Set this when your packagable app\n * lives in a subdirectory (common in monorepos or when using a separate frontend build step).\n */\n readonly app?: string | null\n}\n\n/**\n * Configuration for experimental concurrent builds.\n */\nexport interface Concurrency {\n /**\n * Maximum number of platform/architecture builds to run in parallel.\n *\n * Set to `1` to disable concurrency (sequential builds, the safe default). Higher values\n * reduce wall-clock time on multi-platform builds at the cost of increased memory and CPU\n * usage. Ensure that your {@link Hooks} and build resources are safe to execute concurrently\n * before raising this limit.\n *\n * @default 1\n */\n jobs: number\n}\n"]}
1
+ {"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAA0B,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAA","sourcesContent":["import { Arch } from \"builder-util\"\nimport { BeforeBuildContext, Target } from \"./core.js\"\nimport { ElectronBrandingOptions } from \"./electron/ElectronFramework.js\"\nimport { PrepareApplicationStageDirectoryOptions } from \"./Framework.js\"\nimport { AppXOptions } from \"./options/AppXOptions.js\"\nimport { AppImageOptions, DebOptions, FlatpakOptions, LinuxConfiguration, LinuxTargetSpecificOptions, PacmanOptions, RpmOptions } from \"./options/linuxOptions.js\"\nimport { DmgOptions, MacConfiguration, MasConfiguration } from \"./options/macOptions.js\"\nimport { MsiOptions } from \"./options/MsiOptions.js\"\nimport { MsiWrappedOptions } from \"./options/MsiWrappedOptions.js\"\nimport { MsixOptions } from \"./options/MsixOptions.js\"\nimport { PkgOptions } from \"./options/pkgOptions.js\"\nimport { PlatformSpecificBuildOptions } from \"./options/PlatformSpecificBuildOptions.js\"\nimport { SnapcraftOptions } from \"./options/SnapOptions.js\"\nimport { SquirrelWindowsOptions } from \"./options/SquirrelWindowsOptions.js\"\nimport { WindowsConfiguration } from \"./options/winOptions.js\"\nimport { BuildResult } from \"./packager.js\"\nimport { ArtifactBuildStarted, ArtifactCreated } from \"./packagerApi.js\"\nimport { PlatformPackager } from \"./platformPackager.js\"\nimport { NsisOptions, NsisWebOptions, PortableOptions } from \"./targets/win/nsis/nsisOptions.js\"\nimport { ElectronGetOptions } from \"./util/electronGet.js\"\nimport type { ExecutablesConfig } from \"builder-util\"\n// the types of toolsets.executables live with its resolver, in builder-util\nexport type { ExecutableLocation, ExecutableName, ExecutablesConfig } from \"builder-util\"\nimport { FuseOptionsV1 } from \"./options/FuseOptionsV1.js\"\n\n/**\n * Production dependencies that are excluded from the copied `node_modules` by default. These are\n * still legitimate production dependencies (for SBOM, license, and vulnerability tracking), but\n * electron-builder already provides them another way — notably the Electron runtime, which is\n * embedded separately — so copying them into the app would just duplicate what is already there.\n * Users can override the set via {@link CommonConfiguration.ignoredProductionDependencies}.\n *\n * Declared next to the option so the code constant, the jsdoc `@default`, and the generated\n * `scheme.json` stay in one place; a test asserts the generated schema matches this constant.\n */\nexport const DEFAULT_IGNORED_PRODUCTION_DEPENDENCIES: ReadonlyArray<string> = [\"electron\", \"electron-builder\"]\n\n// duplicate appId here because it is important\n/**\n * Configuration options shared across all platforms.\n *\n * These properties apply regardless of the target platform and control general build behaviour such\n * as the application identity, output paths, native dependency rebuilding, toolset versions, and\n * platform-specific target sub-configurations.\n */\nexport interface CommonConfiguration {\n /**\n * The application identifier.\n *\n * Used as [`CFBundleIdentifier`](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleidentifier)\n * on macOS and as the\n * [Application User Model ID](https://learn.microsoft.com/en-us/windows/win32/shell/appids)\n * on Windows (NSIS target only; Squirrel.Windows does not support custom Application User Model IDs).\n *\n * It is strongly recommended to set an explicit, reverse-DNS-style identifier (e.g. `\"com.example.myapp\"`)\n * rather than relying on the generated default.\n *\n * @default com.electron.${name}\n */\n readonly appId?: string | null\n\n /**\n * The human-readable product name displayed in installers, the macOS dock, and the Windows\n * Apps & Features list.\n *\n * Unlike the `name` field in `package.json`, this value may contain spaces and other characters\n * that are not allowed in npm package names.\n *\n * Resolution order:\n * 1. `productName` inside the `build` configuration block.\n * 2. `productName` at the top level of `package.json`.\n * 3. `name` at the top level of `package.json`.\n */\n readonly productName?: string | null\n\n /**\n * The copyright string embedded in the built artifacts.\n *\n * Appears in the Windows `LegalCopyright` version-info field and the macOS `NSHumanReadableCopyright`\n * Info.plist key.\n *\n * @default Copyright © ${year} ${author}\n */\n readonly copyright?: string | null\n\n /**\n * Overrides for input/output directory paths used during the build.\n *\n * @see {@link MetadataDirectories}\n */\n readonly directories?: MetadataDirectories | null\n\n /**\n * Pinned versions of the binary toolsets electron-builder downloads and uses internally.\n *\n * Each 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 *\n * Note: 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.\n *\n * @see {@link ToolsetConfig}\n */\n readonly toolsets?: ToolsetConfig | null\n\n /**\n * Format of the `<artifact>.blockmap` file published next to installers and update archives, which electron-updater reads for\n * differential downloads. The map is read by the updater already installed in your users' apps, so the format follows\n * `electronUpdaterCompatibility` (default `\">=7\"`):\n *\n * - unset: `\"v3\"` when `electronUpdaterCompatibility` includes only electron-updater 7 and later, else `\"v2\"`, with a build\n * warning.\n * - `\"v3\"`: a binary block map that electron-updater fetches in parts with HTTP `Range` requests (only the parts that changed\n * since the installed version), with finer blocks for stored members such as an uncompressed `app.asar`. Needs electron-updater\n * 7 or later: with an `electronUpdaterCompatibility` that includes earlier versions, the build fails.\n * - `\"v2\"`: the gzipped JSON block map every electron-updater version reads, downloaded in full on every update; the package and\n * block map are the same as electron-builder 26 wrote.\n * - `\"latest\"`: the newest format the `electronUpdaterCompatibility` range supports (currently the same as unset). A future\n * format then costs one full download per user, as below.\n *\n * Apps whose electron-updater cannot read a release's format, or whose cached map is in another format, download that update\n * in full once; the next one is differential again, or with an artifact name without `${version}` the one after it.\n *\n * Block maps embedded in an artifact (AppImage, the NSIS web installer's app package) are always `\"v2\"`.\n * See [the v27 notes](https://www.electron.build/docs/migration/v27-build-changes#block-map-format-follows-electronupdatercompatibility).\n */\n readonly blockmap?: \"v2\" | \"v3\" | \"latest\" | null\n\n /**\n * macOS-specific build options (signing, entitlements, notarization, target categories, etc.).\n * @see {@link MacConfiguration}\n */\n readonly mac?: MacConfiguration | null\n /**\n * macOS App Store (MAS) submission options.\n * @see {@link MasConfiguration}\n */\n readonly mas?: MasConfiguration | null\n /**\n * macOS App Store development-signing options (`mas-dev` target).\n * Used for local testing of MAS builds without submitting to the store.\n * @see {@link MasConfiguration}\n */\n readonly masDev?: MasConfiguration | null\n /**\n * macOS DMG disk image options (background image, window position, icon layout, licence, etc.).\n * @see {@link DmgOptions}\n */\n readonly dmg?: DmgOptions | null\n /**\n * macOS PKG flat-package installer options.\n * @see {@link PkgOptions}\n */\n readonly pkg?: PkgOptions | null\n\n /**\n * Windows-specific build options (signing, NSIS, icon, file associations, etc.).\n * @see {@link WindowsConfiguration}\n */\n readonly win?: WindowsConfiguration | null\n /**\n * NSIS one-click installer options.\n *\n * NSIS (Nullsoft Scriptable Install System) is the default Windows installer format produced by\n * electron-builder. It generates a lightweight, self-extracting `.exe` installer.\n *\n * @see {@link NsisOptions}\n */\n readonly nsis?: NsisOptions | null\n /**\n * NSIS web installer options.\n *\n * Like the standard NSIS installer but the app payload is downloaded from a remote URL at install\n * time rather than bundled into the `.exe`. Useful for very large apps or staged rollouts.\n *\n * @see {@link NsisWebOptions}\n */\n readonly nsisWeb?: NsisWebOptions | null\n /**\n * Portable executable options.\n *\n * Produces a single `.exe` that requires no installation — it extracts and runs directly.\n *\n * @see {@link PortableOptions}\n */\n readonly portable?: PortableOptions | null\n /**\n * Windows Store (MSIX/AppX) package options.\n *\n * Produces a `.appx` or `.msix` package suitable for distribution through the Microsoft Store or\n * side-loading.\n *\n * @see {@link AppXOptions}\n */\n readonly appx?: AppXOptions | null\n /** MSIX package options. MSIX is the modern successor to AppX with additional deployment features. */\n readonly msix?: MsixOptions | null\n /**\n * WiX-based MSI installer options.\n *\n * Produces a traditional `.msi` package built with the WiX Toolset. Best for enterprise\n * deployments that require MSI-based installation policies.\n *\n * @see {@link MsiOptions}\n */\n readonly msi?: MsiOptions | null\n /**\n * MSI-wrapped NSIS installer options.\n *\n * Wraps the standard NSIS installer inside an MSI package so that it can be deployed via\n * Group Policy or other MSI-only channels while preserving the NSIS installer UX.\n *\n * @see {@link MsiWrappedOptions}\n */\n readonly msiWrapped?: MsiWrappedOptions | null\n /**\n * Squirrel.Windows auto-update installer options.\n *\n * Requires the `electron-builder-squirrel-windows` optional dependency.\n *\n * @see {@link SquirrelWindowsOptions}\n */\n readonly squirrelWindows?: SquirrelWindowsOptions | null\n /**\n * General Linux build options shared across all Linux targets (icon, category, desktop entry,\n * executable name, etc.). Target-specific compression and packaging options live in the\n * per-format interfaces (`DebOptions`, `RpmOptions`, `PacmanOptions`, etc.).\n *\n * @see {@link LinuxConfiguration}\n */\n readonly linux?: LinuxConfiguration | null\n /**\n * Debian package options.\n *\n * Targets Debian, Ubuntu, and Debian-based distributions. Produces a `.deb` archive\n * installable via `dpkg -i` or `apt install ./package.deb`.\n *\n * @see {@link DebOptions}\n */\n readonly deb?: DebOptions | null\n /**\n * Snapcraft configuration.\n *\n * Selects the snapcraft base and provides per-core options:\n * - `base: \"core18\" | \"core20\" | \"core22\"` — legacy bases; still functional but not recommended\n * for new apps.\n * - `base: \"core24\"` — modern base with the GNOME extension (recommended, requires Electron 25+).\n * - `base: \"custom\"` — pass an existing `snapcraft.yaml` through unchanged; no plugs, extensions,\n * or desktop files are injected.\n *\n * @example\n * ```json\n * { \"snapcraft\": { \"base\": \"core24\", \"core24\": { \"useLXD\": true } } }\n * ```\n *\n * @see {@link SnapcraftOptions}\n */\n readonly snapcraft?: SnapcraftOptions | null\n /**\n * AppImage options.\n *\n * AppImage is a portable application format that bundles the app and its runtime dependencies\n * into a single self-contained executable that runs on most Linux distributions without\n * installation. The produced `.AppImage` file is executable after `chmod +x`.\n *\n * @see {@link AppImageOptions}\n */\n readonly appImage?: AppImageOptions | null\n /**\n * Flatpak options.\n *\n * Flatpak is a sandboxed application distribution format for Linux distributed via\n * [Flathub](https://flathub.org/) or self-hosted OSTree repositories.\n *\n * @see {@link FlatpakOptions}\n */\n readonly flatpak?: FlatpakOptions | null\n /**\n * Pacman package options.\n *\n * Targets Arch Linux and Arch-based distributions (Manjaro, EndeavourOS, etc.).\n * Produces a `.pacman` archive installable via `pacman -U ./package.pacman`.\n *\n * @see {@link PacmanOptions}\n */\n readonly pacman?: PacmanOptions | null\n /**\n * RPM package options.\n *\n * Targets Fedora, Red Hat Enterprise Linux, SUSE, and RPM-based distributions.\n * Produces a `.rpm` archive installable via `rpm -i` or `dnf install ./package.rpm`.\n *\n * @see {@link RpmOptions}\n */\n readonly rpm?: RpmOptions | null\n /**\n * FreeBSD `pkg` package options.\n *\n * Produces a `.pkg` archive for the FreeBSD package manager.\n */\n readonly freebsd?: LinuxTargetSpecificOptions | null\n /**\n * Solaris IPS package options.\n *\n * Produces a `.p5p` archive for the Solaris Image Packaging System (`pkg`).\n */\n readonly p5p?: LinuxTargetSpecificOptions | null\n /**\n * Alpine Linux APK package options.\n *\n * Produces an `.apk` archive installable via `apk add --allow-untrusted ./package.apk`.\n */\n readonly apk?: LinuxTargetSpecificOptions | null\n\n /**\n * Additional command-line arguments appended to the package manager's `install` command when\n * electron-builder installs app dependencies (i.e., when `node_modules` is missing and a fresh\n * install is required).\n *\n * These arguments are appended **only** during the install phase, not during the rebuild phase.\n * To influence `@electron/rebuild` directly, see {@link NativeModulesConfig.rebuildMode}.\n *\n * @example\n * ```json\n * { \"npmArgs\": [\"--prefer-offline\", \"--ignore-scripts\"] }\n * ```\n */\n readonly npmArgs?: Array<string> | string | null\n\n /**\n * Names of production dependencies that are excluded from the copied `node_modules`, even if they\n * are declared in the `dependencies` section of `package.json`.\n *\n * electron-builder copies the resolved production dependency tree into the app. Some packages —\n * notably `electron` — are already provided another way (the Electron runtime is embedded\n * separately), so copying them would just duplicate what is already there. Such packages are\n * excluded from the copy rather than rejected: they remain valid production dependencies for\n * tooling purposes (e.g. SBOM, license, and vulnerability tracking) without being shipped twice.\n *\n * Only dependencies **declared by the app itself** are eligible: a listed name and the transitive\n * dependencies required *only* by it are dropped, while anything also required by another (kept)\n * production dependency stays bundled. A matching name that appears solely as a transitive\n * dependency of a kept package is never excluded. Note that a kept package which `require()`s an\n * excluded 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 *\n * Matching 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`),\n * never by the underlying package name.\n *\n * Overriding this option **replaces** the default list, so include `electron` and `electron-builder`\n * unless you intend to ship them. The most common reason to override is to *add* a dependency that a\n * bundler (Vite, webpack, esbuild, …) already inlines into your app code: keep it in `dependencies`\n * so 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\n * package in the copied `node_modules`. Setting the option to `null` (or omitting it) applies the\n * default list; to disable exclusion entirely, set it to an empty array `[]`. Each excluded package\n * is logged once during packaging.\n *\n * @default [\"electron\", \"electron-builder\"]\n */\n readonly ignoredProductionDependencies?: Array<string> | null\n\n /**\n * Whether production dependencies that cannot be resolved during node-module collection are\n * allowed — i.e. whether the build should continue with a warning instead of failing.\n *\n * During collection every production dependency must resolve to an installed package on disk. A\n * dependency that does not resolve (`cannot find path for dependency` / `dependency not found on\n * disk`) 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 *\n * Missing *optional* dependencies (declared in `optionalDependencies`, e.g. `fsevents` on\n * Linux/Windows, or platform-specific packages) are always allowed and never fail the build.\n *\n * Independent of {@link ignoredProductionDependencies}, which controls which dependencies are\n * excluded from the copied `node_modules`; this option only controls validation of the\n * collection result.\n *\n * @default false\n */\n readonly allowMissingDependencies?: boolean | Array<string> | null\n\n /**\n * Configuration for native Node.js module installation and rebuilding.\n *\n * Groups all options that control how electron-builder handles native modules — from forcing\n * source builds during install through to the `@electron/rebuild` compilation mode.\n *\n * @see {@link NativeModulesConfig}\n */\n readonly nativeModules?: NativeModulesConfig | null\n\n /**\n * The build number.\n *\n * Maps to the `--iteration` flag for FPM-based Linux targets and is appended to the version\n * string in `CFBundleVersion` (macOS) and `FileVersion` (Windows) when {@link buildVersion} is\n * not set explicitly.\n *\n * If not set, falls back to the first defined environment variable among:\n * `BUILD_NUMBER`, `TRAVIS_BUILD_NUMBER`, `APPVEYOR_BUILD_NUMBER`, `CIRCLE_BUILD_NUM`,\n * `BUILD_BUILDNUMBER`, `CI_PIPELINE_IID`.\n */\n readonly buildNumber?: string | null\n\n /**\n * The full build version string.\n *\n * Maps to `CFBundleVersion` on macOS and the `FileVersion` metadata field on Windows.\n * Defaults to the `version` field from `package.json`.\n *\n * If `buildVersion` is not set but {@link buildNumber} is defined (or resolved from an\n * environment variable), the effective build version becomes `${version}.${buildNumber}`.\n */\n readonly buildVersion?: string | null\n\n /**\n * Whether to download the FFmpeg library variant from Electron's release assets and replace the\n * default (proprietary codec) FFmpeg library before signing.\n *\n * The alternate FFmpeg is compiled without proprietary codec support (H.264, AAC, etc.) and is\n * required for distributing on certain platforms (e.g., Linux distributions that prohibit\n * proprietary codecs). Enabling this swaps the bundled `ffmpeg` dynamic library before the app\n * is signed.\n */\n readonly downloadAlternateFFmpeg?: boolean\n\n /**\n * Additional properties to deep-merge into the app's `package.json` at build time.\n *\n * Useful for injecting build-time metadata (e.g., a git commit hash or CI build URL) that\n * should be readable at runtime via `require('./package.json')` or `import.meta.url`.\n *\n * @example\n * ```json\n * { \"extraMetadata\": { \"commitHash\": \"abc1234\", \"buildDate\": \"2025-01-01\" } }\n * ```\n */\n readonly extraMetadata?: any\n\n /**\n * Whether to throw an error and abort the build if the app could not be code-signed, notarized, or have its\n * auto-update manifests signed - and to verify the signatures the build produces.\n *\n * Set to `true` in release pipelines to catch missing or misconfigured signing credentials\n * before producing unsigned artifacts. When `false` (the default), missing signing credentials\n * produce a warning and the build continues unsigned.\n *\n * With `true`:\n * - macOS: the app must be signed, which needs a macOS host, also in pull-request builds (set `CSC_FOR_PULL_REQUEST=true` to sign\n * them, or pass `-c.forceCodeSigning=false` there), and notarized: notarization credentials must be set when the build starts.\n * The output of a custom `mac.sign` signer is checked with `codesign --verify --deep --strict`, the stapled ticket with\n * `stapler validate`, a signed pkg with `pkgutil --check-signature`, and a DMG with `dmg.sign: true` must be signed.\n * - Windows: every signed file is read back and must carry a valid Authenticode signature.\n * - Every platform (the only effect on Linux): auto-update manifests must be signed, also by a build that does not publish.\n * - A prepackaged app, which electron-builder does not sign, must already be signed (and, on macOS, notarized).\n *\n * Explicit opt-outs are honored with a warning: `mac.notarize: false`, `updateManifest: false`, `win.signExts` exclusions and a\n * custom `nsis.script` (whose uninstaller electron-builder does not sign). `win.sign: false` and `mac.sign: null` contradict it\n * and fail the build. `electron-builder verify` checks the build output afterwards.\n *\n * @default false\n */\n readonly forceCodeSigning?: boolean\n\n /**\n * Whether to remove the `scripts` field from bundled `package.json` files.\n *\n * Lifecycle scripts (`preinstall`, `postinstall`, etc.) have no meaning inside a packaged\n * Electron app and can trigger unintended behaviour if any tooling inspects the bundled\n * `package.json`. Removing them reduces artifact size and prevents accidental execution.\n *\n * @default true\n */\n readonly removePackageScripts?: boolean\n\n /**\n * Whether to remove the `keywords` field from bundled `package.json` files.\n *\n * The `keywords` array is only meaningful for package registry discoverability and has no\n * runtime value inside a packaged Electron app. Removing it marginally reduces artifact size.\n *\n * @default true\n */\n readonly removePackageKeywords?: boolean\n\n /**\n * Options forwarded to [`@electron/fuses`](https://github.com/electron/fuses) to flip Electron\n * feature flags in the binary.\n *\n * Fuses are compile-time-like flags baked into the Electron binary that cannot be changed at\n * runtime. Flipping them is the approved mechanism for hardening Electron apps (e.g., disabling\n * `ELECTRON_RUN_AS_NODE`, enabling ASAR integrity, etc.).\n *\n * electron-builder flips fuses after packaging but before signing so that the final signature\n * covers the modified binary.\n *\n * @see {@link FuseOptionsV1}\n */\n readonly electronFuses?: FuseOptionsV1 | null\n\n /**\n * Configuration for experimental concurrent (multi-platform / multi-arch) builds.\n *\n * When `jobs > 1`, electron-builder runs up to `jobs` platform builds in parallel. This is an\n * experimental feature — use with caution and verify that your hook functions and build resources\n * are safe to execute concurrently.\n *\n * @see {@link Concurrency}\n */\n readonly concurrency?: Concurrency | null\n}\n\n/**\n * The root build configuration object passed to electron-builder.\n *\n * Extends {@link CommonConfiguration} with top-level Electron-specific options, configuration\n * inheritance/presets, and all per-platform build hooks.\n */\nexport interface Configuration extends CommonConfiguration, PlatformSpecificBuildOptions, Hooks {\n /**\n * Options forwarded to [`@electron/get`](https://github.com/electron/get) when downloading the\n * Electron distribution to package.\n *\n * `checksums` (a map of artifact file name → SHA-256 hex) makes checksum validation fully offline —\n * without it, `@electron/get` fetches `SHASUMS256.txt` from the network on every build, even when the\n * artifact itself is already cached. When `checksums` is not configured, electron-builder automatically\n * picks up a locally seeded `SHASUMS256.txt-<version>` (or `SHASUMS256.txt`) file at the root of the\n * Electron cache directory. See the\n * [air-gapped / offline builds guide](https://www.electron.build/tutorials/offline-air-gapped-builds).\n */\n readonly electronGet?: ElectronGetOptions | null\n\n /**\n * Electron branding overrides.\n *\n * Required only when packaging a custom Electron fork that ships a modified `BRANDING.json`\n * (e.g., a fork that renames the `Electron Helper` process or the `Electron Framework`).\n * Standard Electron builds do not need this.\n */\n readonly electronBranding?: ElectronBrandingOptions\n\n /**\n * The Electron version to package against.\n *\n * Defaults to the version of the `electron` (or `electron-prebuilt`) dependency declared in\n * `package.json`. Set this explicitly only when the installed Electron version is not the one\n * you want to package against (e.g., in monorepos where the Electron dependency lives in a\n * different workspace).\n */\n electronVersion?: string | null\n\n /**\n * Whether to write `builder-effective-config.yaml` (the resolved configuration, including the detected\n * `electronVersion`) to the output directory.\n *\n * Defaults to writing it only for local interactive builds: not on CI and not when stdout is piped.\n * Set `true` to always write it, e.g. to read the resolved configuration in a CI step, or `false` to never write it.\n */\n readonly writeEffectiveConfig?: boolean | null\n\n /**\n * One or more configuration presets or file paths to merge into this configuration.\n *\n * Accepts a string or array of strings, each of which is either:\n * - A built-in preset name (`\"react-cra\"` is the only currently supported value).\n * - A path to a JS/JSON config file relative to the project directory.\n *\n * Configs are merged left-to-right using a deep-assign strategy that properly combines `files`\n * glob patterns rather than replacing them.\n *\n * The `react-cra` preset is applied automatically when `react-scripts` is found in\n * `dependencies`. Set `extends: null` to opt out of automatic preset detection.\n */\n extends?: Array<string> | string | null\n}\n\n/**\n * Configuration for native Node.js module installation and rebuilding.\n *\n * All options that control how electron-builder handles native modules — from forcing source\n * builds at install time through to the `@electron/rebuild` compilation mode.\n */\nexport interface NativeModulesConfig {\n /**\n * Whether to pass `--build-from-source` to the package manager when installing native\n * dependencies, forcing them to compile from source rather than using pre-built binaries.\n *\n * Useful when pre-built binaries are not available for the target platform/arch combination,\n * or when you need to ensure native modules are compiled against the exact Electron ABI.\n *\n * Only honored when the target platform matches the host platform: native modules cannot be\n * cross-compiled from source for another OS, so for a cross-platform target native dependencies are\n * rebuilt with prebuilt binaries for that target instead (and a warning is logged).\n *\n * @default false\n */\n buildDependenciesFromSource?: boolean\n\n /**\n * Whether to run `node-gyp rebuild` with Electron headers before packaging.\n *\n * This 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`\n * and rely on `@electron/rebuild` instead.\n *\n * When `true`, electron-builder runs `node-gyp rebuild` with the correct `npm_config_*`\n * environment variables set for the target Electron version and architecture before the\n * normal rebuild step.\n *\n * @default false\n */\n readonly nodeGypRebuild?: boolean\n\n /**\n * Whether to rebuild native Node.js modules for the target Electron version and architecture\n * before packaging.\n *\n * When `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\n * ABI. Set to `false` to skip this step entirely — useful when native modules are pre-built\n * elsewhere in your pipeline or when the app has no native dependencies.\n *\n * The compilation mode (`sequential` vs `parallel`) is controlled by {@link rebuildMode}.\n *\n * @default true\n */\n readonly npmRebuild?: boolean\n\n /**\n * 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.\n *\n * @default \"sequential\"\n */\n readonly rebuildMode?: \"sequential\" | \"parallel\" | null\n\n /**\n * Whether to verify, after the app is packed, that every native binary shipped in the app was built for\n * the target platform and architecture.\n *\n * electron-builder reads the header of each `.node` addon (and of other native libraries and executables\n * such as `.so`, `.dylib`, `.dll`, `.exe`) in `app.asar`, `app.asar.unpacked` or the unpacked `app`\n * directory, and compares its format (ELF / Mach-O / PE) and machine type against the target (for\n * a macOS universal build, each per-arch slice is checked before the slices are merged). This catches a\n * stale or host-platform binary left in `node_modules` by a skipped or cached rebuild, which otherwise\n * only surfaces at runtime as `invalid ELF header` / `not a valid Win32 application` /\n * `incompatible architecture`.\n *\n * Files whose package declares another platform via `package.json` `os`/`cpu`, or whose path names\n * another platform/arch (e.g. prebuildify's `prebuilds/linux-arm64/`), are not loaded for this target\n * and 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.\n *\n * @default true\n */\n readonly verifyNativeBinaries?: boolean | \"warn\" | null\n}\n\nexport type Hook<T, V> = (contextOrPath: T) => Promise<V> | V\n\nexport interface PackContext {\n readonly outDir: string\n readonly appOutDir: string\n readonly packager: PlatformPackager<any>\n readonly electronPlatformName: string\n readonly arch: Arch\n readonly targets: Array<Target>\n}\nexport type AfterPackContext = PackContext\nexport type BeforePackContext = PackContext\nexport type AfterExtractContext = PackContext\n\n/**\n * Version pins and custom bundle overrides for the binary toolsets that electron-builder downloads and caches locally.\n *\n * Each toolset is a versioned archive hosted at [electron-userland/electron-builder-binaries](https://github.com/electron-userland/electron-builder-binaries/releases).\n * Omitting a property (or setting it to `latest`) selects the modern default for that toolset.\n *\n * To 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\n * https://github.com/electron-userland/electron-builder-binaries/tree/master/packages.\n */\nexport interface ToolsetConfig {\n /**\n * Version of the `win-codesign` bundle used for Windows code signing and resource editing.\n *\n * The 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 *\n * Available 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 * | `\"1.3.1\"` | macOS `osslsigncode` bundles its own OpenSSL (no Homebrew `openssl@3` needed) and libp11's PKCS#11 provider |\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/win-codesign/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly winCodeSign?: \"0.0.0\" | \"1.0.0\" | \"1.1.0\" | \"1.1.1\" | \"1.2.1\" | \"1.3.0\" | \"1.3.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the AppImage toolset bundle used for building `.AppImage` files.\n *\n * The bundle ships:\n * - **`mksquashfs`** — creates the SquashFS filesystem embedded in the AppImage. It also packs legacy-base (core18/core20/core22) snaps built from the snap template app.\n * - **`desktop-file-validate`** — validates the generated `.desktop` entry.\n * - **AppImage runtime** — the self-executing stub that mounts the SquashFS at launch.\n *\n * Available 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 * | `\"1.2.0\"` | 20251108 | squashfs-tools 4.7.5 with a statically linked zstd 1.5.7, so Linux and macOS hosts produce identical images |\n *\n * An explicit version pin always selects exactly that release.\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/appimage/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly appimage?: \"0.0.0\" | \"1.0.3\" | \"1.1.0\" | \"1.2.0\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the NSIS toolset bundle used to compile Windows installers.\n *\n * The 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 *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/nsis/CHANGELOG.md\n *\n * A custom bundle (a {@link ToolsetCustom} object) must follow the layout at\n * https://www.electron.build/docs/toolsets#custom-nsis-bundle-layout\n *\n * @default \"latest\"\n */\n readonly nsis?: \"0.0.0\" | \"1.2.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the WiX Toolset bundle used to build `msi` and `msiWrapped` installers.\n *\n * The bundle ships **`candle.exe`** and **`light.exe`** (compile and link the generated `.wxs` project) and the WiX\n * extensions (`WixUIExtension` for assisted installers). On macOS and Linux they run under Wine with wine-mono.\n *\n * Available versions:\n * | Version | WiX version | Notes |\n * |---------|-------------|-------|\n * | `\"0.0.0\"` | 4.0.0.5512 (preview) | Legacy bundle (pre-v27). An `arm64` app is packaged in an `x64` MSI, because this toolset has no `arm64` |\n * | `\"2.0.0\"` | 3.14.1 | Builds a native `arm64` MSI for `arm64` |\n *\n * The `.wxs` project uses the WiX 3 schema with `\"2.0.0\"`: an `msiProjectCreated` hook that inserts elements of a WiX 4\n * extension namespace must use the WiX 3 one (for example `http://schemas.microsoft.com/wix/UtilExtension`), or pin `\"0.0.0\"`.\n *\n * A custom bundle (a {@link ToolsetCustom} object) must have the WiX v3 layout: `candle.exe`, `light.exe` and the\n * extensions at its root.\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/wix/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly wix?: \"0.0.0\" | \"2.0.0\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the Wine bundle used to run Windows tools (NSIS, rcedit, signtool) on\n * non-Windows hosts (macOS and Linux).\n *\n * Wine is only required when building Windows targets on a non-Windows machine. On Windows,\n * this setting has no effect.\n *\n * Available 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 host Wine at a fixed install location instead of a bundle |\n *\n * `\"system\"` is the replacement for the `USE_SYSTEM_WINE` environment variable removed in v27, and\n * is what `\"latest\"` (the default) currently resolves to on every platform: the published `\"1.0.1\"`\n * bundles ship no PE builtins, so a host Wine installation is required to build Windows targets on\n * macOS or Linux.\n *\n * The host Wine (`\"system\"`) is started by absolute path, never looked up on `PATH`: it is the `wine` entry of\n * {@link executables}, which lists its default install locations and is where a Wine installed elsewhere is set.\n * Setting both a bundle that would be used (a `ToolsetCustom` object, or a version on macOS; on Linux a version selects no\n * bundle) and `executables.wine` is a configuration error.\n *\n * To use a custom Wine bundle, use a `ToolsetCustom` object.\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/wine/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly wine?: \"0.0.0\" | \"1.0.1\" | \"system\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the FPM bundle used to build Linux packages (`.deb`, `.rpm`, `.pacman`, etc.)\n * on macOS and Linux hosts.\n *\n * Available versions:\n * | Version | FPM version | Notes |\n * |---------|------------|-------|\n * | `\"2.2.1\"` | 1.17.0 (Ruby 3.4.3) | Current default |\n *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/fpm/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly fpm?: \"2.2.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the Linux-tools-mac bundle used to produce `.tar.lz` archives and build\n * Linux targets on macOS hosts.\n *\n * The bundle ships macOS-native builds of `ar`, `lzip`, and `gtar` (GNU tar).\n *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/linux-tools-mac/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly linuxToolsMac?: \"1.0.0\" | \"1.0.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the 7-Zip binary bundle used internally to extract `.7z` and `.tar.xz` archives.\n *\n * Set to a {@link ToolsetCustom} object to supply your own 7za binary.\n * The `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\n * extracting them requires 7za — a circular dependency.\n *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/7zip/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly sevenZip?: \"1.0.0\" | \"1.0.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the icons-conversion bundle used to convert source images to `.icns`, `.ico`,\n * and PNG icon sets.\n *\n * Set to a {@link ToolsetCustom} object to supply your own icons bundle directory.\n *\n * Available 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/icons/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly icons?: \"1.2.3\" | ToolsetCustom | \"latest\"\n\n /**\n * Version of the `squirrel.windows` bundle used to build Squirrel.Windows installers.\n *\n * The 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;\n * under Wine on non-Windows hosts). Building an MSI additionally uses the shared WiX toolset.\n *\n * Available 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 *\n * Set 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 *\n * Releases: https://github.com/electron-userland/electron-builder-binaries/blob/master/packages/squirrel.windows/CHANGELOG.md\n *\n * @default \"latest\"\n */\n readonly squirrel?: \"1.1.1\" | ToolsetCustom | \"latest\"\n\n /**\n * Where the host programs that electron-builder starts are installed on the build machine, by program name.\n *\n * electron-builder starts these programs only from an absolute path, never by looking up a name on `PATH`. For each one it\n * uses the first location that is an executable file: from this entry when it is set, otherwise from a built-in list of\n * default install locations for the host operating system (see https://www.electron.build/docs/toolsets#executables).\n * An entry replaces the default list for that program; it is not merged with it.\n *\n * @example\n * ```json\n * {\n * \"toolsets\": {\n * \"executables\": {\n * \"mono\": \"file:///opt/homebrew/bin/mono\",\n * \"pwsh\": [\"file:///usr/local/microsoft/powershell/7/pwsh\", \"file:///opt/microsoft/powershell/7/pwsh\"],\n * \"powershell\": \"file:///C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe\"\n * }\n * }\n * }\n * ```\n */\n readonly executables?: ExecutablesConfig | null\n}\n\n/**\n * A custom toolset bundle supplied by the user in place of a built-in versioned bundle.\n *\n * The bundle must mirror the expected directory layout of the corresponding built-in bundle.\n * See the build scripts at\n * https://github.com/electron-userland/electron-builder-binaries/tree/master/packages.\n *\n * File 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\n * used for all toolset checksums), the same for every toolset. See https://www.electron.build/docs/toolsets#custom-toolset-checksum\n *\n * @example\n * ```json\n * {\n * \"toolsets\": {\n * \"nsis\": {\n * \"url\": \"file:///path/to/my-nsis-bundle.tar.gz\",\n * \"checksum\": \"56997fdefe25e7928a1a68b4583d08b240b66cf660234053b20131a74cc082f4\",\n * \"version\": \"my-custom-1.0\"\n * }\n * }\n * }\n * ```\n */\nexport interface ToolsetCustom {\n /**\n * 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 *\n * Archives (`.zip`, `.7z`, `.tar.gz`, `.tar.xz`) are extracted automatically.\n * A bare directory path (no archive) is used as-is.\n */\n readonly url: string\n\n /**\n * 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 *\n * Prefixed forms such as `sha256:…` or `sha512-…`, and a hex-encoded SHA-512, are rejected before anything is downloaded.\n * A downloaded archive is verified before it is cached or extracted, and a local `file://` archive before it is extracted.\n *\n * Required for remote (`https://`) URLs and local archive files (`file://`).\n * Not needed for bare directory paths — the directory is used as-is with no caching and no verification.\n * @see https://www.electron.build/docs/toolsets#custom-toolset-checksum\n */\n readonly checksum?: string\n\n /**\n * Optional version label used in the local cache directory name.\n * Falls back to the first 8 hex characters of the `checksum` digest when omitted.\n */\n readonly version?: string\n}\n\n/**\n * Lifecycle hooks that run at specific points during the electron-builder pipeline.\n *\n * Each hook can be specified as:\n * - An **inline function** (JavaScript/TypeScript config files only):\n * ```js\n * // electron-builder.config.js\n * module.exports = { beforePack: async (context) => { /* ... *\\/ } }\n * ```\n * - A **path** to a CommonJS/ESM module (relative to the project directory) that exports the\n * hook as its **default export**:\n * ```json\n * { \"build\": { \"beforePack\": \"./scripts/myHook.js\" } }\n * ```\n * ```js\n * // scripts/myHook.js\n * export default async function (context) { /* ... *\\/ }\n * ```\n */\nexport interface Hooks {\n /**\n * Called immediately before electron-builder begins packing the app for each platform/arch\n * combination.\n *\n * Use this hook to perform last-minute modifications to source files or build resources before\n * they are read by the packager.\n *\n * Receives a {@link BeforePackContext}.\n */\n readonly beforePack?: Hook<BeforePackContext, void> | string | null\n\n /**\n * Called after the prebuilt Electron binary has been extracted to the staging directory but\n * before the app files have been copied into it.\n *\n * Use this hook to patch or augment the Electron binary itself (e.g. rename helper processes,\n * inject native libraries) before the app payload is laid down on top.\n *\n * Receives an {@link AfterExtractContext}.\n */\n readonly afterExtract?: Hook<AfterExtractContext, void> | string | null\n\n /**\n * Called after the app files have been copied into the staging directory (and ASAR created if\n * applicable) but **before** signing and before the output archive/installer is built.\n *\n * Use this hook to post-process the staged app bundle (e.g. strip debug symbols, inject\n * platform-specific resources).\n *\n * Receives an {@link AfterPackContext}.\n */\n readonly afterPack?: Hook<AfterPackContext, void> | string | null\n\n /**\n * Called after code signing but **before** the signed app is packed into the final\n * distributable format (e.g. before `dmg` is created from the signed `.app`).\n *\n * Use this hook to perform post-sign validation or to add signed resources that are not part of\n * the main app bundle.\n *\n * Receives an {@link AfterPackContext}.\n */\n readonly afterSign?: Hook<AfterPackContext, void> | string | null\n\n /**\n * Called when an individual artifact build starts (e.g. just before a `.dmg` or `.exe` is\n * written to disk).\n *\n * Receives an {@link ArtifactBuildStarted}.\n */\n readonly artifactBuildStarted?: Hook<ArtifactBuildStarted, void> | string | null\n\n /**\n * Called when an individual artifact has been successfully built and written to disk.\n *\n * Use this hook to collect artifact paths, upload to custom destinations, or trigger\n * post-processing steps.\n *\n * Receives an {@link ArtifactCreated}.\n */\n readonly artifactBuildCompleted?: Hook<ArtifactCreated, void> | string | null\n\n /**\n * Called after **all** artifacts across all platforms/architectures have been built.\n *\n * May return an array of additional file paths that should be treated as publish targets\n * (i.e. uploaded to the configured publisher).\n *\n * Receives a {@link BuildResult}.\n *\n * @example\n * ```js\n * export default async function afterAllArtifactBuild(result) {\n * return [\"/path/to/extra-file.txt\"]\n * }\n * ```\n */\n readonly afterAllArtifactBuild?: Hook<BuildResult, Array<string>> | string | null\n\n /**\n * Called after the WiX MSI project XML has been written to a temporary directory but before\n * `candle.exe` / `light.exe` compile it into a `.msi` package.\n *\n * The hook receives the path to the project directory as a string. Use it to patch the generated\n * `.wxs` files for customizations not exposed through electron-builder's options.\n */\n readonly msiProjectCreated?: Hook<string, void> | string | null\n\n /**\n * Called after the AppX/MSIX manifest XML has been written to the staging directory but before\n * `makeappx` packages it.\n *\n * The hook receives the path to the manifest file as a string. Use it to inject custom manifest\n * extensions (capabilities, protocol handlers, etc.) not exposed through {@link AppXOptions}.\n */\n readonly appxManifestCreated?: Hook<string, void> | string | null\n\n /**\n * Called after the `distribution.xml` of a macOS `pkg` installer has been written (synthesized by\n * `productbuild --synthesize`, then customized from {@link PkgOptions}) but before `productbuild` builds the\n * installer from it.\n *\n * The hook receives the path to the distribution file as a string. Edit it in place or overwrite it to\n * customize the installer beyond {@link PkgOptions} (for example, its `<title>`).\n */\n readonly pkgDistributionCreated?: Hook<string, void> | string | null\n\n /**\n * Called for every file inside each `node_modules` package directory as electron-builder\n * decides whether to include it in the packaged app.\n *\n * Return `true` to force-include the file regardless of the default exclusion rules.\n * Return `false` or `undefined` to let electron-builder apply its normal filtering logic.\n *\n * Receives the absolute path of the file as a string.\n */\n readonly onNodeModuleFile?: Hook<string, void | boolean> | string | null\n\n /**\n * Called before dependencies are installed or native modules are rebuilt.\n *\n * Return `false` (or a `Promise` that resolves to `false`) to skip the install/rebuild step\n * entirely — useful when you manage `node_modules` externally (e.g. in a CI pipeline that\n * restores them from cache). When not set, electron-builder proceeds with the normal\n * install/rebuild flow.\n *\n * If this hook is provided and `node_modules` is missing, electron-builder will not perform\n * the production-dependencies check.\n *\n * Receives a {@link BeforeBuildContext}.\n */\n readonly beforeBuild?: Hook<BeforeBuildContext, boolean | void> | string | null\n\n /**\n * Override the source of the Electron distribution to stage.\n *\n * Should 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 *\n * When not set, electron-builder downloads the official Electron release from GitHub (or the\n * mirror configured via `electronGet`).\n *\n * Receives a {@link PrepareApplicationStageDirectoryOptions}.\n */\n readonly electronDist?: Hook<PrepareApplicationStageDirectoryOptions, string> | string | null\n}\n\n/**\n * Overrides for the input and output directories used during the build.\n */\nexport interface MetadataDirectories {\n /**\n * The directory that contains static build resources (icons, background images, license files,\n * custom NSIS scripts, etc.) that electron-builder reads during packaging.\n *\n * **Build resources are not copied into the packaged app.** If you need runtime access to a\n * file (e.g. a tray icon), include it explicitly via the `fileOptions.files` option:\n * ```json\n * { \"fileOptions\": { \"files\": [\"**\\/*\", \"build/icon.*\"] } }\n * ```\n *\n * @default \"build\"\n */\n readonly buildResources?: string | null\n\n /**\n * The directory where electron-builder writes its output (installers, zip archives, etc.).\n *\n * [File macros](https://www.electron.build/file-patterns#file-macros) are supported, e.g.\n * `\"dist/${os}-${arch}\"` to separate outputs by platform and architecture.\n *\n * @default \"dist\"\n */\n readonly output?: string | null\n\n /**\n * The directory that contains the application's `package.json` and source code.\n *\n * Defaults to `app`, then `www`, then the project root. Set this when your packagable app\n * lives in a subdirectory (common in monorepos or when using a separate frontend build step).\n */\n readonly app?: string | null\n}\n\n/**\n * Configuration for experimental concurrent builds.\n */\nexport interface Concurrency {\n /**\n * Maximum number of platform/architecture builds to run in parallel.\n *\n * Set to `1` to disable concurrency (sequential builds, the safe default). Higher values\n * reduce wall-clock time on multi-platform builds at the cost of increased memory and CPU\n * usage. Ensure that your {@link Hooks} and build resources are safe to execute concurrently\n * before raising this limit.\n *\n * @default 1\n */\n jobs: number\n}\n"]}
@@ -314,7 +314,10 @@ export interface PlatformSpecificBuildOptions extends TargetSpecificOptions {
314
314
  */
315
315
  readonly forceCodeSigning?: boolean;
316
316
  /**
317
- * The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range.
317
+ * The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range: the
318
+ * electron-updater versions the installed apps ship, which have to read the update files this build writes. It selects the
319
+ * `.blockmap` format (see `blockmap`), and the build fails when the app's electron-updater does not satisfy it.
320
+ * @default >=7
318
321
  */
319
322
  readonly electronUpdaterCompatibility?: string | null;
320
323
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"PlatformSpecificBuildOptions.d.ts","sourceRoot":"","sources":["../../src/options/PlatformSpecificBuildOptions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"PlatformSpecificBuildOptions.d.ts","sourceRoot":"","sources":["../../src/options/PlatformSpecificBuildOptions.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"PlatformSpecificBuildOptions.js","sourceRoot":"","sources":["../../src/options/PlatformSpecificBuildOptions.ts"],"names":[],"mappings":"","sourcesContent":["import { CompressionLevel, Publish, TargetConfiguration, TargetSpecificOptions } from \"../core.js\"\nimport { FileAssociation } from \"./FileAssociation.js\"\n\nexport interface FileSet {\n /**\n * The source path relative to and defaults to:\n *\n * - the [app directory](https://www.electron.build/configuration#directories) for `files`,\n * - the project directory for `extraResources` and `extraFiles`.\n * If you don't use two-package.json structure and don't set custom app directory, app directory equals to project directory.\n */\n from?: string\n /**\n * The destination path relative to and defaults to:\n *\n * - the asar archive root for `files`,\n * - the app's content directory for `extraFiles`,\n * - the app's resource directory for `extraResources`.\n */\n to?: string\n /**\n * The [glob patterns](https://www.electron.build/file-patterns). Defaults to \"**\\/*\"\n */\n filter?: Array<string> | string\n}\n\nexport interface AsarOptions {\n /**\n * Whether to automatically unpack executables files.\n * @default true\n */\n smartUnpack?: boolean\n\n /**\n * Path to a file containing the order in which files should be packed into the asar archive.\n * Each line of the file is a relative path from the app directory. Files listed first are\n * packed first, which can improve app startup time by front-loading frequently accessed modules.\n * See the [asar documentation](https://github.com/electron/asar) for details.\n *\n * Lines use the same syntax `@electron/asar` accepts: the path may carry a leading `/` or a\n * `<count>:` prefix (as written by a load counter), and blank lines are ignored. There is no comment\n * syntax, and `\\` separators are accepted. Directory entries are moved to the front in their original\n * relative order (they hold no data), listed files follow in the order of the file, and every other\n * file keeps its original order after them. Lines naming a directory are ignored, and listed files\n * that are not in the archive are skipped.\n *\n * The path is resolved like other build resources: relative to the [build resources directory](#directories)\n * first, then to the project directory. A missing file fails the build. Packing files ahead of the default\n * dependencies-first layout can increase differential update download size.\n */\n ordering?: string | null\n\n /**\n * A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](#directories),\n * which specifies which files to unpack when creating the asar archive.\n */\n unpack?: Array<string> | string | null\n\n /**\n * Align the start of every packed file's content inside `app.asar` to a multiple of this many bytes\n * (zero padding between files). Off when unset or `0`.\n *\n * Meant for differential updates with `nsis.differentialPackage: \"store-asar\"`: the asar header stores\n * every file's absolute content offset, so without alignment a change that grows a file by a single byte\n * shifts the offset of every later file and most of the header has to be re-downloaded. With alignment\n * a file can grow within its slot and no other offset moves. Measured on a 32 MB asar with 3,000 files:\n * `512` cut a small length-changing edit from 414 KB to 139 KB of differential download for 2.2 % more\n * asar size. Padding does not help when a file is added or removed (a new header entry shifts all later\n * offsets) or when growth crosses the slot. File order, sizes and per-file integrity are unchanged;\n * Electron and `@electron/asar` read files by offset + size and ignore the gaps.\n *\n * Must be a positive integer; values above 64 KiB log a warning because every file is padded up to the\n * boundary. The alignment is applied when electron-builder packs `app.asar`, so it is lost when the\n * archive is rebuilt afterwards: macOS universal builds with `mac.universal.mergeASARs` (the default)\n * repack the merged asar, and `--prepackaged` skips packing entirely.\n * @default 0\n */\n contentAlignment?: number | null\n\n /**\n * Whether to skip the ASAR package integrity sanity check.\n *\n * Set to `true` only when using a custom Electron fork that implements its own encrypted or\n * non-standard ASAR integrity validation that is not compatible with electron-builder's default\n * check. Standard builds should leave this `false`.\n *\n * @default false\n */\n disableSanityCheck?: boolean\n\n /**\n * Whether to skip computing the ASAR integrity hash.\n *\n * Normally electron-builder computes and embeds a SHA-256 hash of `app.asar` so that Electron\n * can verify it at startup (when the `enableEmbeddedAsarIntegrityValidation` fuse is enabled). Set to\n * `true` only for custom Electron forks with encrypted ASAR support where the header is not\n * readable by standard tools. It also skips the macOS ASAR integrity digest (`mac.asarIntegrityDigest`).\n *\n * @default false\n */\n disableIntegrity?: boolean\n}\n\n/**\n * Which files are copied into the packaged app, which file extensions are excluded from it, and which symlinks among them may lead outside it,\n * set under `fileOptions` at the configuration root or per platform (e.g. `mac.fileOptions`). A platform's file lists are added to the root\n * ones; a platform's `excludedExts` and `allowExternalLinks` replace the root ones.\n * See [file options](https://www.electron.build/docs/migration/v27-config-changes#file-options-fileoptions).\n */\nexport interface FilesBuildOptions {\n /**\n * 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 as well (e.g. `mac.fileOptions.files`, see [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.\n */\n files?: Array<FileSet | string> | FileSet | string | null\n\n /**\n * A [glob patterns](https://www.electron.build/file-patterns) relative to the project directory, when specified, copy the file or directory with matching names directly into the app's resources directory (`Contents/Resources` for MacOS, `resources` for Linux and Windows).\n *\n * File patterns (and support for `from` and `to` fields) the same as for [files](#files).\n *\n */\n extraResources?: Array<FileSet | string> | FileSet | string | null\n\n /**\n * The same as [extraResources](#extraresources) but copy into the app's content directory (`Contents` for MacOS, root directory for Linux and Windows).\n */\n extraFiles?: Array<FileSet | string> | FileSet | string | null\n\n /**\n * File extensions (without the leading dot) excluded from the packaged app files and the copied `node_modules`.\n *\n * - `\"default\"` expands to the built-in list of excluded extensions (see the table below).\n * - Any other entry adds that extension, e.g. `\"map\"`.\n * - An entry starting with `!` removes that extension from the others listed, e.g. `[\"default\", \"!pdb\"]` to keep `.pdb` (Program Database)\n * symbol files for Windows crash-dump analysis. `.pdb` files contain symbol names and the source paths of the build machine:\n * keep them only in internal builds or builds for a symbol server, or upload them to a symbol server instead of shipping them.\n * A list of removals only, such as `[\"!pdb\"]`, is rejected because it would exclude no extension at all: write `[\"default\", \"!pdb\"]`. A `\"!ext\"` in a list that does not otherwise list that extension (e.g. `[\"map\", \"!pdb\"]`) has no effect and logs a warning.\n *\n * The built-in list (`\"default\"`):\n *\n * | Extension | Typically used for |\n * | --- | --- |\n * | `.iml` | IntelliJ IDEA / WebStorm module file |\n * | `.hprof` | Java heap dump |\n * | `.orig` | Original copy of a file, left behind by merge tools and `patch` |\n * | `.pyc` | Compiled Python bytecode |\n * | `.pyo` | Optimized compiled Python bytecode (Python 2) |\n * | `.rbc` | Compiled Ruby bytecode (Rubinius) |\n * | `.swp` | Vim swap file |\n * | `.csproj` | C# (MSBuild) project file |\n * | `.sln` | Visual Studio solution file |\n * | `.slnx` | Visual Studio XML solution file |\n * | `.suo` | Visual Studio solution user options |\n * | `.xproj` | .NET Core project file (Visual Studio 2015) |\n * | `.cc` | C++ source file, e.g. of a native module |\n * | `.d.ts` | TypeScript declaration file |\n * | `.mk` | Makefile fragment generated by node-gyp |\n * | `.a` | Static library archive from a native build |\n * | `.o` | Object file from a native build |\n * | `.obj` | Object file from an MSVC native build; also used for Wavefront 3D models, which a `files` pattern can re-include |\n * | `.forge-meta` | Metadata `@electron/rebuild` writes next to a rebuilt native module |\n * | `.pdb` | Program Database: Windows debug symbols, with symbol names and the build machine's source paths |\n *\n * The list replaces the defaults: list `\"default\"` to extend them rather than replace them. `null` (or omitting it) is `[\"default\"]`,\n * and an empty array `[]` excludes no extension.\n *\n * An invalid list (an entry that is not a file extension, `\"!default\"`, or removals only) fails the build when the configuration is validated, at the root and in every platform section, before anything is packed.\n *\n * ```json\n * { \"fileOptions\": { \"excludedExts\": [\"default\", \"!pdb\", \"map\"] } }\n * ```\n *\n * Set it under `fileOptions`, at the configuration root or per platform. Unlike the other lists, a later list replaces an earlier one rather\n * than being merged with it. For the root and for each platform section, the last layer that sets the list wins: the `extends` parents in\n * order, then the configuration file, then the programmatic or `-c` configuration. For the `mas` and `mas-dev` targets, a `mas` list then\n * replaces the `mac` one, and a `masDev` list (for `mas-dev`) replaces both. A platform's list then replaces the root one, whichever layer\n * set either. A `null` value keeps the earlier list.\n *\n * A `files` pattern that names an excluded extension includes only the app files it matches: `**\\/*.obj` every `.obj` file outside\n * `node_modules` and the build resources and output directories, `models/teapot.obj` only that file.\n *\n * A single entry may be given as a string, e.g. on the command line: `-c.fileOptions.excludedExts=default`. For several entries, repeat the flag:\n * `-c.fileOptions.excludedExts=default -c.fileOptions.excludedExts=!pdb` (in an interactive bash or zsh, write the second one as `'-c.fileOptions.excludedExts=!pdb'`, single-quoted, so that `!pdb` is not expanded).\n * @default [\"default\"]\n */\n excludedExts?: Array<string> | string | null\n\n /**\n * Whether symlinks among the packaged files may lead outside the app, the workspace and the package-manager store.\n *\n * Only the build configuration is trusted, not the files it packages: by default (`false`) electron-builder refuses\n * - a file of the app (`app.asar` or `asar: false`) that is a symlink, or is reached through one, whose real path is outside the workspace\n * root, the project and app directories and the package-manager store (`npm link`, a `file:../lib` dependency outside the repository,\n * a symlink into the home or temp directory),\n * - a copied symlink that resolves outside the app: one in `extraResources` / `extraFiles` (other than into the workspace or the store),\n * one kept by an `asar: false` copy, and any symlink leaving the app in a target that stores what symlinks point to (Windows `zip` / `7z`,\n * the NSIS app package, AppX/MSIX, Squirrel.Windows).\n *\n * Without these checks, a symlink planted in a dependency or a copied directory could package files from elsewhere on the build machine (SSH keys,\n * credentials) into the artifact, which is why this is off by default.\n *\n * - `true` allows any such symlink.\n * - A list of paths, relative to the project directory or absolute, allows a symlink only when the real path of what it points to is\n * inside the real path of one of them (e.g. `[\"../shared-lib\"]`). A listed path that does not exist fails the build.\n *\n * An allowed symlink is packaged: what it points to is copied (or stored by the archive), and a copied symlink is kept\n * as it is. A warning is logged once when this allows a symlink.\n *\n * Set it under `fileOptions`, at the configuration root or per platform; a platform's value (`false` included) replaces the root one\n * rather than being added to it:\n * ```json\n * { \"fileOptions\": { \"allowExternalLinks\": [\"../shared-lib\"] }, \"linux\": { \"fileOptions\": { \"allowExternalLinks\": true } } }\n * ```\n *\n * This does not allow writing through a symlink: a copy or a file written by electron-builder whose destination leads outside the\n * output directory through a symlink is always refused, and a symlink at such a file name is replaced, never followed.\n * See [Symbolic links](https://www.electron.build/docs/contents#symbolic-links).\n * @default false\n */\n allowExternalLinks?: boolean | Array<string> | null\n}\n\nexport interface PlatformSpecificBuildOptions extends TargetSpecificOptions {\n /**\n * Which files to copy into the packaged app (`files`, the app sources, `extraResources` and `extraFiles`), which file extensions to exclude\n * from it (`excludedExts`), and whether symlinks among them may lead outside the app and the workspace (`allowExternalLinks`).\n * Set at the configuration root, per platform (e.g. `mac.fileOptions`), or both: a platform's file lists are added to the root ones,\n * and a platform's `excludedExts` and `allowExternalLinks` replace the root ones.\n *\n * ```json\n * {\n * \"fileOptions\": {\n * \"files\": [\"dist/**\\/*\", \"package.json\"],\n * \"extraResources\": [{ \"from\": \"assets/bin\", \"to\": \"bin\" }]\n * }\n * }\n * ```\n *\n * `files`, `extraResources` and `extraFiles` set directly on the configuration or a platform section are moved here\n * when the configuration is loaded, with a warning. Run `electron-builder migrate-schema` to update the configuration.\n */\n fileOptions?: FilesBuildOptions | null\n\n /**\n * 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.\n * @default com.electron.${name}\n */\n readonly appId?: string | null\n\n /**\n * The [artifact file name template](https://www.electron.build/configuration#artifact-file-name-template). Defaults to `${productName}-${version}.${ext}` (some target can have other defaults, see corresponding options).\n */\n readonly artifactName?: string | null\n\n /**\n * The executable name. Defaults to `productName`\n * Note: Except for Linux, where this would constitute a breaking change in previous behavior and lead to both invalid executable names and Desktop files. Ref comments in: https://github.com/electron-userland/electron-builder/pull/9068\n */\n readonly executableName?: string | null\n\n /**\n * The compression level. If you want to rapidly test build, `store` can reduce build time significantly. `maximum` doesn't lead to noticeable size difference, but increase build time.\n * @default normal\n */\n readonly compression?: CompressionLevel | null\n\n /**\n * Whether to package the application's source code into an archive, using [Electron's archive format](https://www.electronjs.org/docs/latest/tutorial/asar-archives).\n *\n * Node modules that must be unpacked will be detected automatically. Use {@link AsarOptions.unpack} to specify additional files to unpack.\n * @default true\n */\n readonly asar?: AsarOptions | boolean | null\n\n /** @private */\n readonly icon?: string | null\n\n /**\n * The file associations.\n */\n readonly fileAssociations?: Array<FileAssociation> | FileAssociation\n /**\n * The URL protocol schemes.\n */\n readonly protocols?: Array<Protocol> | Protocol\n\n /**\n * The electron locales to keep. By default, all Electron locales used as-is.\n */\n readonly electronLanguages?: Array<string> | string\n\n /**\n * Overrides the root `forceCodeSigning` for this platform: whether to fail the build if the app could not be code-signed,\n * notarized, or have its auto-update manifests signed, and to verify the signatures it produces. See the root option for\n * what is enforced. Mac App Store builds cascade `mac` → `mas` (→ `masDev` for `mas-dev`), like every other option, so `mas.forceCodeSigning` / `masDev.forceCodeSigning` apply to their targets only.\n * @default false\n */\n readonly forceCodeSigning?: boolean\n\n /**\n * The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range.\n */\n readonly electronUpdaterCompatibility?: string | null\n\n /**\n * Publisher configuration. See [Auto Update](https://www.electron.build/publish) for more information.\n */\n publish?: Publish\n\n /**\n * 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`.\n * This does *not* apply to github publishing, which will [never auto-detect the update channel](https://github.com/electron-userland/electron-builder/issues/8589).\n * @default true\n */\n readonly detectUpdateChannel?: boolean\n\n /**\n * Please see [Building and Releasing using Channels](https://github.com/electron-userland/electron-builder/issues/1182#issuecomment-324947139).\n * @default false\n */\n readonly generateUpdatesFilesForAllChannels?: boolean\n\n /**\n * Ed25519 signing of the auto-update manifest (`latest*.yml`). Each manifest is signed and its public key is\n * embedded 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\n * resolves. Generate one once with `electron-builder create-update-key`, then supply it via\n * `ELECTRON_BUILDER_UPDATE_SIGN_KEY` (the PEM file, base64-encoded) / `ELECTRON_BUILDER_UPDATE_SIGN_KEY_FILE` (its path),\n * preferred in CI, or via `signingKey` / `signingKeyFile` below. Leaving this option unset — or `null` — keeps signing required and\n * resolves the key from the environment; `null` is not an opt-out.\n *\n * Set to `false`, the only opt-out, to ship **unsigned** manifests. Every build that produces a manifest then\n * logs 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 *\n * The requirement is enforced when a publish policy is in effect (`--publish`) or `forceCodeSigning` is set; any other\n * build warns instead, so local builds and pipelines that sign the manifest in a later step of their own are\n * unaffected. It is also waived when every publish provider has `publishAutoUpdate: false`, since no manifest is\n * emitted then, and for a build whose targets write no update info (e.g. only snap, flatpak, MSI/MSIX, portable,\n * mas/pkg or plain archives). A publishing (or `forceCodeSigning`) build checks for the key at build start, before\n * anything is packed or uploaded. Every signed manifest is read back and verified before it is written.\n *\n * See [Signed Update Manifests](https://www.electron.build/features/signed-update-manifests).\n */\n readonly updateManifest?: UpdateManifestSigningOptions | false | null\n\n /**\n * The release info. Intended for command line usage:\n *\n * ```\n * -c.releaseInfo.releaseNotes=\"new features\"\n * ```\n */\n readonly releaseInfo?: ReleaseInfo\n\n /**\n * The build target(s) for this platform. Can be a target name string, a {@link TargetConfiguration}\n * object, or an array of either. Available targets depend on the platform — see platform-specific\n * options (e.g. {@link MacConfiguration.target}, {@link WindowsConfiguration.target},\n * {@link LinuxConfiguration.target}).\n */\n readonly target?: Array<string | TargetConfiguration> | string | TargetConfiguration | null\n\n /** @private */\n cscLink?: string | null\n\n /** @private */\n cscKeyPassword?: string | null\n\n /**\n * The default architecture to build for when no `--arch` flag is specified.\n * Defaults to the current machine's architecture.\n */\n readonly defaultArch?: string\n}\n\nexport interface UpdateManifestSigningOptions {\n /**\n * Ed25519 private key(s) in PEM (PKCS#8) format used to sign the update manifest. A single PEM string may\n * contain 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\n * fills the legacy single `signature` field.\n * Secret — prefer the `ELECTRON_BUILDER_UPDATE_SIGN_KEY` environment variable (the PEM file, base64-encoded) in CI over committing this to config.\n */\n readonly signingKey?: string | Array<string> | null\n\n /**\n * Path(s) to file(s) containing the Ed25519 private key (PEM, PKCS#8). Alternative to `signingKey`.\n * An array signs with every listed key, in order. Relative paths are resolved against the project directory.\n */\n readonly signingKeyFile?: string | Array<string> | null\n\n /**\n * The Ed25519 public key(s) (PEM or base64 SPKI) embedded into `app-update.yml` as the updater's trust list.\n * The updater accepts a manifest when any listed key validates one of its signatures. Optional — when\n * omitted the public key of every configured signing key is derived and embedded. Set it explicitly to trust\n * additional keys ahead of a rotation (for example `[current, next]`).\n *\n * A `publicKey` on its own does not satisfy the signing requirement — electron-builder still has no key to\n * sign with. An external signer (HSM/KMS) that signs `latest*.yml` in a later step therefore either builds\n * without a publish policy and without `forceCodeSigning`, where the requirement only warns and the unsigned\n * manifest is written locally, or keeps publishing with `publishAutoUpdate: false` on every publish provider -\n * electron-builder then uploads the artifacts and embeds this key, but writes no `latest*.yml`, so the external\n * step has to produce it too.\n *\n * When set, it must contain at least one of the signing keys: a publishing (or `forceCodeSigning`) build signed only by\n * keys outside this list fails, since its installs would reject manifests signed with them. See `allowSigningKeyOutsideTrustList`.\n */\n readonly publicKey?: string | Array<string> | null\n\n /**\n * Allows a publishing build to sign its manifests only with keys that are not in `publicKey` - a deliberate\n * cutover release that is verified by installs with the old key, but hands them over to the keys listed in\n * `publicKey`. Every later release must then be signed by a listed key. Without it such a build fails; a build\n * without a publish policy or `forceCodeSigning` only warns. Has no effect when `publicKey` is not set.\n * @default false\n */\n readonly allowSigningKeyOutsideTrustList?: boolean | null\n}\n\nexport interface ReleaseInfo {\n /**\n * The release name.\n */\n releaseName?: string | null\n\n /**\n * The release notes.\n */\n releaseNotes?: string | null\n\n /**\n * The path to release notes file. Defaults to `release-notes-${platform}.md` (where `platform` it is current platform — `mac`, `linux` or `windows`) or `release-notes.md` in the [build resources](https://www.electron.build/contents#extraresources).\n */\n releaseNotesFile?: string | null\n\n /**\n * The release date.\n */\n releaseDate?: string\n\n /**\n * Vendor specific information.\n */\n vendor?: { [key: string]: any } | null\n}\n\n/**\n * URL Protocol Schemes. Protocols to associate the app with. macOS only.\n *\n * Please note — on macOS [you need to register an `open-url` event handler](http://electron.atom.io/docs/api/app/#event-open-url-macos).\n */\nexport interface Protocol {\n /**\n * The name. e.g. `IRC server URL`.\n */\n readonly name: string\n\n /**\n * The schemes. e.g. `[\"irc\", \"ircs\"]`.\n */\n readonly schemes: Array<string>\n\n /**\n * *macOS-only* The app’s role with respect to the type.\n * @default Editor\n */\n readonly role?: \"Editor\" | \"Viewer\" | \"Shell\" | \"None\"\n}\n"]}
1
+ {"version":3,"file":"PlatformSpecificBuildOptions.js","sourceRoot":"","sources":["../../src/options/PlatformSpecificBuildOptions.ts"],"names":[],"mappings":"","sourcesContent":["import { CompressionLevel, Publish, TargetConfiguration, TargetSpecificOptions } from \"../core.js\"\nimport { FileAssociation } from \"./FileAssociation.js\"\n\nexport interface FileSet {\n /**\n * The source path relative to and defaults to:\n *\n * - the [app directory](https://www.electron.build/configuration#directories) for `files`,\n * - the project directory for `extraResources` and `extraFiles`.\n * If you don't use two-package.json structure and don't set custom app directory, app directory equals to project directory.\n */\n from?: string\n /**\n * The destination path relative to and defaults to:\n *\n * - the asar archive root for `files`,\n * - the app's content directory for `extraFiles`,\n * - the app's resource directory for `extraResources`.\n */\n to?: string\n /**\n * The [glob patterns](https://www.electron.build/file-patterns). Defaults to \"**\\/*\"\n */\n filter?: Array<string> | string\n}\n\nexport interface AsarOptions {\n /**\n * Whether to automatically unpack executables files.\n * @default true\n */\n smartUnpack?: boolean\n\n /**\n * Path to a file containing the order in which files should be packed into the asar archive.\n * Each line of the file is a relative path from the app directory. Files listed first are\n * packed first, which can improve app startup time by front-loading frequently accessed modules.\n * See the [asar documentation](https://github.com/electron/asar) for details.\n *\n * Lines use the same syntax `@electron/asar` accepts: the path may carry a leading `/` or a\n * `<count>:` prefix (as written by a load counter), and blank lines are ignored. There is no comment\n * syntax, and `\\` separators are accepted. Directory entries are moved to the front in their original\n * relative order (they hold no data), listed files follow in the order of the file, and every other\n * file keeps its original order after them. Lines naming a directory are ignored, and listed files\n * that are not in the archive are skipped.\n *\n * The path is resolved like other build resources: relative to the [build resources directory](#directories)\n * first, then to the project directory. A missing file fails the build. Packing files ahead of the default\n * dependencies-first layout can increase differential update download size.\n */\n ordering?: string | null\n\n /**\n * A [glob patterns](https://www.electron.build/file-patterns) relative to the [app directory](#directories),\n * which specifies which files to unpack when creating the asar archive.\n */\n unpack?: Array<string> | string | null\n\n /**\n * Align the start of every packed file's content inside `app.asar` to a multiple of this many bytes\n * (zero padding between files). Off when unset or `0`.\n *\n * Meant for differential updates with `nsis.differentialPackage: \"store-asar\"`: the asar header stores\n * every file's absolute content offset, so without alignment a change that grows a file by a single byte\n * shifts the offset of every later file and most of the header has to be re-downloaded. With alignment\n * a file can grow within its slot and no other offset moves. Measured on a 32 MB asar with 3,000 files:\n * `512` cut a small length-changing edit from 414 KB to 139 KB of differential download for 2.2 % more\n * asar size. Padding does not help when a file is added or removed (a new header entry shifts all later\n * offsets) or when growth crosses the slot. File order, sizes and per-file integrity are unchanged;\n * Electron and `@electron/asar` read files by offset + size and ignore the gaps.\n *\n * Must be a positive integer; values above 64 KiB log a warning because every file is padded up to the\n * boundary. The alignment is applied when electron-builder packs `app.asar`, so it is lost when the\n * archive is rebuilt afterwards: macOS universal builds with `mac.universal.mergeASARs` (the default)\n * repack the merged asar, and `--prepackaged` skips packing entirely.\n * @default 0\n */\n contentAlignment?: number | null\n\n /**\n * Whether to skip the ASAR package integrity sanity check.\n *\n * Set to `true` only when using a custom Electron fork that implements its own encrypted or\n * non-standard ASAR integrity validation that is not compatible with electron-builder's default\n * check. Standard builds should leave this `false`.\n *\n * @default false\n */\n disableSanityCheck?: boolean\n\n /**\n * Whether to skip computing the ASAR integrity hash.\n *\n * Normally electron-builder computes and embeds a SHA-256 hash of `app.asar` so that Electron\n * can verify it at startup (when the `enableEmbeddedAsarIntegrityValidation` fuse is enabled). Set to\n * `true` only for custom Electron forks with encrypted ASAR support where the header is not\n * readable by standard tools. It also skips the macOS ASAR integrity digest (`mac.asarIntegrityDigest`).\n *\n * @default false\n */\n disableIntegrity?: boolean\n}\n\n/**\n * Which files are copied into the packaged app, which file extensions are excluded from it, and which symlinks among them may lead outside it,\n * set under `fileOptions` at the configuration root or per platform (e.g. `mac.fileOptions`). A platform's file lists are added to the root\n * ones; a platform's `excludedExts` and `allowExternalLinks` replace the root ones.\n * See [file options](https://www.electron.build/docs/migration/v27-config-changes#file-options-fileoptions).\n */\nexport interface FilesBuildOptions {\n /**\n * 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 as well (e.g. `mac.fileOptions.files`, see [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.\n */\n files?: Array<FileSet | string> | FileSet | string | null\n\n /**\n * A [glob patterns](https://www.electron.build/file-patterns) relative to the project directory, when specified, copy the file or directory with matching names directly into the app's resources directory (`Contents/Resources` for MacOS, `resources` for Linux and Windows).\n *\n * File patterns (and support for `from` and `to` fields) the same as for [files](#files).\n *\n */\n extraResources?: Array<FileSet | string> | FileSet | string | null\n\n /**\n * The same as [extraResources](#extraresources) but copy into the app's content directory (`Contents` for MacOS, root directory for Linux and Windows).\n */\n extraFiles?: Array<FileSet | string> | FileSet | string | null\n\n /**\n * File extensions (without the leading dot) excluded from the packaged app files and the copied `node_modules`.\n *\n * - `\"default\"` expands to the built-in list of excluded extensions (see the table below).\n * - Any other entry adds that extension, e.g. `\"map\"`.\n * - An entry starting with `!` removes that extension from the others listed, e.g. `[\"default\", \"!pdb\"]` to keep `.pdb` (Program Database)\n * symbol files for Windows crash-dump analysis. `.pdb` files contain symbol names and the source paths of the build machine:\n * keep them only in internal builds or builds for a symbol server, or upload them to a symbol server instead of shipping them.\n * A list of removals only, such as `[\"!pdb\"]`, is rejected because it would exclude no extension at all: write `[\"default\", \"!pdb\"]`. A `\"!ext\"` in a list that does not otherwise list that extension (e.g. `[\"map\", \"!pdb\"]`) has no effect and logs a warning.\n *\n * The built-in list (`\"default\"`):\n *\n * | Extension | Typically used for |\n * | --- | --- |\n * | `.iml` | IntelliJ IDEA / WebStorm module file |\n * | `.hprof` | Java heap dump |\n * | `.orig` | Original copy of a file, left behind by merge tools and `patch` |\n * | `.pyc` | Compiled Python bytecode |\n * | `.pyo` | Optimized compiled Python bytecode (Python 2) |\n * | `.rbc` | Compiled Ruby bytecode (Rubinius) |\n * | `.swp` | Vim swap file |\n * | `.csproj` | C# (MSBuild) project file |\n * | `.sln` | Visual Studio solution file |\n * | `.slnx` | Visual Studio XML solution file |\n * | `.suo` | Visual Studio solution user options |\n * | `.xproj` | .NET Core project file (Visual Studio 2015) |\n * | `.cc` | C++ source file, e.g. of a native module |\n * | `.d.ts` | TypeScript declaration file |\n * | `.mk` | Makefile fragment generated by node-gyp |\n * | `.a` | Static library archive from a native build |\n * | `.o` | Object file from a native build |\n * | `.obj` | Object file from an MSVC native build; also used for Wavefront 3D models, which a `files` pattern can re-include |\n * | `.forge-meta` | Metadata `@electron/rebuild` writes next to a rebuilt native module |\n * | `.pdb` | Program Database: Windows debug symbols, with symbol names and the build machine's source paths |\n *\n * The list replaces the defaults: list `\"default\"` to extend them rather than replace them. `null` (or omitting it) is `[\"default\"]`,\n * and an empty array `[]` excludes no extension.\n *\n * An invalid list (an entry that is not a file extension, `\"!default\"`, or removals only) fails the build when the configuration is validated, at the root and in every platform section, before anything is packed.\n *\n * ```json\n * { \"fileOptions\": { \"excludedExts\": [\"default\", \"!pdb\", \"map\"] } }\n * ```\n *\n * Set it under `fileOptions`, at the configuration root or per platform. Unlike the other lists, a later list replaces an earlier one rather\n * than being merged with it. For the root and for each platform section, the last layer that sets the list wins: the `extends` parents in\n * order, then the configuration file, then the programmatic or `-c` configuration. For the `mas` and `mas-dev` targets, a `mas` list then\n * replaces the `mac` one, and a `masDev` list (for `mas-dev`) replaces both. A platform's list then replaces the root one, whichever layer\n * set either. A `null` value keeps the earlier list.\n *\n * A `files` pattern that names an excluded extension includes only the app files it matches: `**\\/*.obj` every `.obj` file outside\n * `node_modules` and the build resources and output directories, `models/teapot.obj` only that file.\n *\n * A single entry may be given as a string, e.g. on the command line: `-c.fileOptions.excludedExts=default`. For several entries, repeat the flag:\n * `-c.fileOptions.excludedExts=default -c.fileOptions.excludedExts=!pdb` (in an interactive bash or zsh, write the second one as `'-c.fileOptions.excludedExts=!pdb'`, single-quoted, so that `!pdb` is not expanded).\n * @default [\"default\"]\n */\n excludedExts?: Array<string> | string | null\n\n /**\n * Whether symlinks among the packaged files may lead outside the app, the workspace and the package-manager store.\n *\n * Only the build configuration is trusted, not the files it packages: by default (`false`) electron-builder refuses\n * - a file of the app (`app.asar` or `asar: false`) that is a symlink, or is reached through one, whose real path is outside the workspace\n * root, the project and app directories and the package-manager store (`npm link`, a `file:../lib` dependency outside the repository,\n * a symlink into the home or temp directory),\n * - a copied symlink that resolves outside the app: one in `extraResources` / `extraFiles` (other than into the workspace or the store),\n * one kept by an `asar: false` copy, and any symlink leaving the app in a target that stores what symlinks point to (Windows `zip` / `7z`,\n * the NSIS app package, AppX/MSIX, Squirrel.Windows).\n *\n * Without these checks, a symlink planted in a dependency or a copied directory could package files from elsewhere on the build machine (SSH keys,\n * credentials) into the artifact, which is why this is off by default.\n *\n * - `true` allows any such symlink.\n * - A list of paths, relative to the project directory or absolute, allows a symlink only when the real path of what it points to is\n * inside the real path of one of them (e.g. `[\"../shared-lib\"]`). A listed path that does not exist fails the build.\n *\n * An allowed symlink is packaged: what it points to is copied (or stored by the archive), and a copied symlink is kept\n * as it is. A warning is logged once when this allows a symlink.\n *\n * Set it under `fileOptions`, at the configuration root or per platform; a platform's value (`false` included) replaces the root one\n * rather than being added to it:\n * ```json\n * { \"fileOptions\": { \"allowExternalLinks\": [\"../shared-lib\"] }, \"linux\": { \"fileOptions\": { \"allowExternalLinks\": true } } }\n * ```\n *\n * This does not allow writing through a symlink: a copy or a file written by electron-builder whose destination leads outside the\n * output directory through a symlink is always refused, and a symlink at such a file name is replaced, never followed.\n * See [Symbolic links](https://www.electron.build/docs/contents#symbolic-links).\n * @default false\n */\n allowExternalLinks?: boolean | Array<string> | null\n}\n\nexport interface PlatformSpecificBuildOptions extends TargetSpecificOptions {\n /**\n * Which files to copy into the packaged app (`files`, the app sources, `extraResources` and `extraFiles`), which file extensions to exclude\n * from it (`excludedExts`), and whether symlinks among them may lead outside the app and the workspace (`allowExternalLinks`).\n * Set at the configuration root, per platform (e.g. `mac.fileOptions`), or both: a platform's file lists are added to the root ones,\n * and a platform's `excludedExts` and `allowExternalLinks` replace the root ones.\n *\n * ```json\n * {\n * \"fileOptions\": {\n * \"files\": [\"dist/**\\/*\", \"package.json\"],\n * \"extraResources\": [{ \"from\": \"assets/bin\", \"to\": \"bin\" }]\n * }\n * }\n * ```\n *\n * `files`, `extraResources` and `extraFiles` set directly on the configuration or a platform section are moved here\n * when the configuration is loaded, with a warning. Run `electron-builder migrate-schema` to update the configuration.\n */\n fileOptions?: FilesBuildOptions | null\n\n /**\n * 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.\n * @default com.electron.${name}\n */\n readonly appId?: string | null\n\n /**\n * The [artifact file name template](https://www.electron.build/configuration#artifact-file-name-template). Defaults to `${productName}-${version}.${ext}` (some target can have other defaults, see corresponding options).\n */\n readonly artifactName?: string | null\n\n /**\n * The executable name. Defaults to `productName`\n * Note: Except for Linux, where this would constitute a breaking change in previous behavior and lead to both invalid executable names and Desktop files. Ref comments in: https://github.com/electron-userland/electron-builder/pull/9068\n */\n readonly executableName?: string | null\n\n /**\n * The compression level. If you want to rapidly test build, `store` can reduce build time significantly. `maximum` doesn't lead to noticeable size difference, but increase build time.\n * @default normal\n */\n readonly compression?: CompressionLevel | null\n\n /**\n * Whether to package the application's source code into an archive, using [Electron's archive format](https://www.electronjs.org/docs/latest/tutorial/asar-archives).\n *\n * Node modules that must be unpacked will be detected automatically. Use {@link AsarOptions.unpack} to specify additional files to unpack.\n * @default true\n */\n readonly asar?: AsarOptions | boolean | null\n\n /** @private */\n readonly icon?: string | null\n\n /**\n * The file associations.\n */\n readonly fileAssociations?: Array<FileAssociation> | FileAssociation\n /**\n * The URL protocol schemes.\n */\n readonly protocols?: Array<Protocol> | Protocol\n\n /**\n * The electron locales to keep. By default, all Electron locales used as-is.\n */\n readonly electronLanguages?: Array<string> | string\n\n /**\n * Overrides the root `forceCodeSigning` for this platform: whether to fail the build if the app could not be code-signed,\n * notarized, or have its auto-update manifests signed, and to verify the signatures it produces. See the root option for\n * what is enforced. Mac App Store builds cascade `mac` → `mas` (→ `masDev` for `mas-dev`), like every other option, so `mas.forceCodeSigning` / `masDev.forceCodeSigning` apply to their targets only.\n * @default false\n */\n readonly forceCodeSigning?: boolean\n\n /**\n * The [electron-updater compatibility](https://www.electron.build/docs/features/auto-update#compatibility) semver range: the\n * electron-updater versions the installed apps ship, which have to read the update files this build writes. It selects the\n * `.blockmap` format (see `blockmap`), and the build fails when the app's electron-updater does not satisfy it.\n * @default >=7\n */\n readonly electronUpdaterCompatibility?: string | null\n\n /**\n * Publisher configuration. See [Auto Update](https://www.electron.build/publish) for more information.\n */\n publish?: Publish\n\n /**\n * 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`.\n * This does *not* apply to github publishing, which will [never auto-detect the update channel](https://github.com/electron-userland/electron-builder/issues/8589).\n * @default true\n */\n readonly detectUpdateChannel?: boolean\n\n /**\n * Please see [Building and Releasing using Channels](https://github.com/electron-userland/electron-builder/issues/1182#issuecomment-324947139).\n * @default false\n */\n readonly generateUpdatesFilesForAllChannels?: boolean\n\n /**\n * Ed25519 signing of the auto-update manifest (`latest*.yml`). Each manifest is signed and its public key is\n * embedded 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\n * resolves. Generate one once with `electron-builder create-update-key`, then supply it via\n * `ELECTRON_BUILDER_UPDATE_SIGN_KEY` (the PEM file, base64-encoded) / `ELECTRON_BUILDER_UPDATE_SIGN_KEY_FILE` (its path),\n * preferred in CI, or via `signingKey` / `signingKeyFile` below. Leaving this option unset — or `null` — keeps signing required and\n * resolves the key from the environment; `null` is not an opt-out.\n *\n * Set to `false`, the only opt-out, to ship **unsigned** manifests. Every build that produces a manifest then\n * logs 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 *\n * The requirement is enforced when a publish policy is in effect (`--publish`) or `forceCodeSigning` is set; any other\n * build warns instead, so local builds and pipelines that sign the manifest in a later step of their own are\n * unaffected. It is also waived when every publish provider has `publishAutoUpdate: false`, since no manifest is\n * emitted then, and for a build whose targets write no update info (e.g. only snap, flatpak, MSI/MSIX, portable,\n * mas/pkg or plain archives). A publishing (or `forceCodeSigning`) build checks for the key at build start, before\n * anything is packed or uploaded. Every signed manifest is read back and verified before it is written.\n *\n * See [Signed Update Manifests](https://www.electron.build/features/signed-update-manifests).\n */\n readonly updateManifest?: UpdateManifestSigningOptions | false | null\n\n /**\n * The release info. Intended for command line usage:\n *\n * ```\n * -c.releaseInfo.releaseNotes=\"new features\"\n * ```\n */\n readonly releaseInfo?: ReleaseInfo\n\n /**\n * The build target(s) for this platform. Can be a target name string, a {@link TargetConfiguration}\n * object, or an array of either. Available targets depend on the platform — see platform-specific\n * options (e.g. {@link MacConfiguration.target}, {@link WindowsConfiguration.target},\n * {@link LinuxConfiguration.target}).\n */\n readonly target?: Array<string | TargetConfiguration> | string | TargetConfiguration | null\n\n /** @private */\n cscLink?: string | null\n\n /** @private */\n cscKeyPassword?: string | null\n\n /**\n * The default architecture to build for when no `--arch` flag is specified.\n * Defaults to the current machine's architecture.\n */\n readonly defaultArch?: string\n}\n\nexport interface UpdateManifestSigningOptions {\n /**\n * Ed25519 private key(s) in PEM (PKCS#8) format used to sign the update manifest. A single PEM string may\n * contain 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\n * fills the legacy single `signature` field.\n * Secret — prefer the `ELECTRON_BUILDER_UPDATE_SIGN_KEY` environment variable (the PEM file, base64-encoded) in CI over committing this to config.\n */\n readonly signingKey?: string | Array<string> | null\n\n /**\n * Path(s) to file(s) containing the Ed25519 private key (PEM, PKCS#8). Alternative to `signingKey`.\n * An array signs with every listed key, in order. Relative paths are resolved against the project directory.\n */\n readonly signingKeyFile?: string | Array<string> | null\n\n /**\n * The Ed25519 public key(s) (PEM or base64 SPKI) embedded into `app-update.yml` as the updater's trust list.\n * The updater accepts a manifest when any listed key validates one of its signatures. Optional — when\n * omitted the public key of every configured signing key is derived and embedded. Set it explicitly to trust\n * additional keys ahead of a rotation (for example `[current, next]`).\n *\n * A `publicKey` on its own does not satisfy the signing requirement — electron-builder still has no key to\n * sign with. An external signer (HSM/KMS) that signs `latest*.yml` in a later step therefore either builds\n * without a publish policy and without `forceCodeSigning`, where the requirement only warns and the unsigned\n * manifest is written locally, or keeps publishing with `publishAutoUpdate: false` on every publish provider -\n * electron-builder then uploads the artifacts and embeds this key, but writes no `latest*.yml`, so the external\n * step has to produce it too.\n *\n * When set, it must contain at least one of the signing keys: a publishing (or `forceCodeSigning`) build signed only by\n * keys outside this list fails, since its installs would reject manifests signed with them. See `allowSigningKeyOutsideTrustList`.\n */\n readonly publicKey?: string | Array<string> | null\n\n /**\n * Allows a publishing build to sign its manifests only with keys that are not in `publicKey` - a deliberate\n * cutover release that is verified by installs with the old key, but hands them over to the keys listed in\n * `publicKey`. Every later release must then be signed by a listed key. Without it such a build fails; a build\n * without a publish policy or `forceCodeSigning` only warns. Has no effect when `publicKey` is not set.\n * @default false\n */\n readonly allowSigningKeyOutsideTrustList?: boolean | null\n}\n\nexport interface ReleaseInfo {\n /**\n * The release name.\n */\n releaseName?: string | null\n\n /**\n * The release notes.\n */\n releaseNotes?: string | null\n\n /**\n * The path to release notes file. Defaults to `release-notes-${platform}.md` (where `platform` it is current platform — `mac`, `linux` or `windows`) or `release-notes.md` in the [build resources](https://www.electron.build/contents#extraresources).\n */\n releaseNotesFile?: string | null\n\n /**\n * The release date.\n */\n releaseDate?: string\n\n /**\n * Vendor specific information.\n */\n vendor?: { [key: string]: any } | null\n}\n\n/**\n * URL Protocol Schemes. Protocols to associate the app with. macOS only.\n *\n * Please note — on macOS [you need to register an `open-url` event handler](http://electron.atom.io/docs/api/app/#event-open-url-macos).\n */\nexport interface Protocol {\n /**\n * The name. e.g. `IRC server URL`.\n */\n readonly name: string\n\n /**\n * The schemes. e.g. `[\"irc\", \"ircs\"]`.\n */\n readonly schemes: Array<string>\n\n /**\n * *macOS-only* The app’s role with respect to the type.\n * @default Editor\n */\n readonly role?: \"Editor\" | \"Viewer\" | \"Shell\" | \"None\"\n}\n"]}
@@ -90,7 +90,13 @@ export declare class Packager {
90
90
  emitAfterPack(context: AfterPackContext): Promise<void>;
91
91
  emitAfterSign(context: AfterPackContext): Promise<void>;
92
92
  emitAfterExtract(context: AfterPackContext): Promise<void>;
93
+ /**
94
+ * Loads and validates the configuration. The app's electron-updater is checked against no platform's `electronUpdaterCompatibility`
95
+ * here: `build` checks it against the platforms it builds, while the CLI `publish` and `verify` commands write no update files.
96
+ */
93
97
  validateConfig(): Promise<void>;
98
+ /** `builtTargets`: the targets the build creates, whose update files the app's electron-updater has to read. */
99
+ private loadAndValidateConfig;
94
100
  build(repositoryInfo?: SourceRepositoryInfo): Promise<BuildResult>;
95
101
  private buildWithValidatedConfig;
96
102
  private readProjectMetadataIfTwoPackageStructureOrPrepacked;