app-builder-lib 26.9.1 → 26.11.0

package/out/configuration.d.ts

@@ -1,9 +1,9 @@
 import { Arch } from "builder-util";
 import { BeforeBuildContext, Target } from "./core";
-import { ElectronBrandingOptions, ElectronDownloadOptions } from "./electron/ElectronFramework";
+import { ElectronBrandingOptions } from "./electron/ElectronFramework";
 import { PrepareApplicationStageDirectoryOptions } from "./Framework";
 import { AppXOptions } from "./options/AppXOptions";
-import { AppImageOptions, DebOptions, FlatpakOptions, LinuxConfiguration, LinuxTargetSpecificOptions } from "./options/linuxOptions";
+import { AppImageOptions, DebOptions, FlatpakOptions, LinuxConfiguration, LinuxTargetSpecificOptions, PacmanOptions, RpmOptions } from "./options/linuxOptions";
 import { DmgOptions, MacConfiguration, MasConfiguration } from "./options/macOptions";
 import { MsiOptions } from "./options/MsiOptions";
 import { MsiWrappedOptions } from "./options/MsiWrappedOptions";
@@ -16,6 +16,7 @@ import { BuildResult } from "./packager";
 import { ArtifactBuildStarted, ArtifactCreated } from "./packagerApi";
 import { PlatformPackager } from "./platformPackager";
 import { NsisOptions, NsisWebOptions, PortableOptions } from "./targets/nsis/nsisOptions";
+import { ElectronDownloadOptions, ElectronGetOptions } from "./util/electronGet";
 /**
  * Configuration Options
  */
@@ -68,39 +69,75 @@ export interface CommonConfiguration {
      * Options related to how build Windows targets.
      */
     readonly win?: WindowsConfiguration | null;
+    /** NSIS installer options. */
     readonly nsis?: NsisOptions | null;
+    /** NSIS web installer options (downloads app package at install time). */
     readonly nsisWeb?: NsisWebOptions | null;
+    /** Portable executable options (no installation required). */
     readonly portable?: PortableOptions | null;
+    /** Windows Store (AppX) package options. */
     readonly appx?: AppXOptions | null;
-    /** @private */
+    /**
+     * MSI package options.
+     */
     readonly msi?: MsiOptions | null;
-    /** @private */
+    /**
+     * MSI-wrapped installer options.
+     */
     readonly msiWrapped?: MsiWrappedOptions | null;
+    /**
+     * Squirrel.Windows installer options. Requires the `electron-builder-squirrel-windows` dependency.
+     */
     readonly squirrelWindows?: SquirrelWindowsOptions | null;
     /**
-     * Options related to how build Linux targets.
+     * General Linux build options shared across all Linux targets (icon, category, desktop entry,
+     * executable name, etc.). Target-specific compression and packaging options live in the
+     * per-format interfaces (`DebOptions`, `RpmOptions`, `PacmanOptions`, etc.).
      */
     readonly linux?: LinuxConfiguration | null;
     /**
-     * Debian package options.
+     * Debian package options. Targets Debian, Ubuntu, and Debian-based distributions.
+     * Produces a `.deb` archive installable via `dpkg -i` or `apt install`.
      */
     readonly deb?: DebOptions | null;
     /**
-     * Snap options.
+     * Snap package options. Requires [snapcraft](https://snapcraft.io/) to be installed.
      */
     readonly snap?: SnapOptions | null;
     /**
-     * AppImage options.
+     * AppImage options. AppImage is a portable application format that bundles the app
+     * and its dependencies into a single self-contained executable that runs on most
+     * Linux distributions without installation.
      */
     readonly appImage?: AppImageOptions | null;
     /**
-     * Flatpak options.
+     * Flatpak options. Flatpak is a sandboxed application distribution format for Linux
+     * that runs in a controlled environment and is distributed via [Flathub](https://flathub.org/)
+     * or other Flatpak repositories.
      */
     readonly flatpak?: FlatpakOptions | null;
-    readonly pacman?: LinuxTargetSpecificOptions | null;
-    readonly rpm?: LinuxTargetSpecificOptions | null;
+    /**
+     * Pacman package options. Targets Arch Linux and Arch-based distributions
+     * (Manjaro, EndeavourOS, etc.). Produces a `.pacman` archive installable via `pacman -U`.
+     */
+    readonly pacman?: PacmanOptions | null;
+    /**
+     * RPM package options. Targets Fedora, Red Hat Enterprise Linux, SUSE, and related
+     * distributions. Produces a `.rpm` archive installable via `rpm` or `dnf`.
+     */
+    readonly rpm?: RpmOptions | null;
+    /**
+     * FreeBSD package options. Produces a `.pkg` archive for the FreeBSD `pkg` package manager.
+     */
     readonly freebsd?: LinuxTargetSpecificOptions | null;
+    /**
+     * Solaris IPS package options. Produces a `.p5p` archive for the Solaris Image Packaging
+     * System (`pkg`).
+     */
     readonly p5p?: LinuxTargetSpecificOptions | null;
+    /**
+     * Alpine Linux APK package options. Produces an `.apk` archive installable via `apk add`.
+     */
     readonly apk?: LinuxTargetSpecificOptions | null;
     /**
      * Whether to build the application native dependencies from source.
@@ -181,12 +218,14 @@ export interface CommonConfiguration {
 export interface Configuration extends CommonConfiguration, PlatformSpecificBuildOptions, Hooks {
     /**
      * Whether to use [electron-compile](http://github.com/electron/electron-compile) to compile app. Defaults to `true` if `electron-compile` in the dependencies. And `false` if in the `devDependencies` or doesn't specified.
+     * @deprecated `electron-compile` is no longer maintained. Compile your app with a modern bundler (webpack, vite, etc.) instead.
      */
     readonly electronCompile?: boolean;
     /**
-     * The [electron-download](https://github.com/electron-userland/electron-download#usage) options.
+     * The [electron-download](https://github.com/electron-userland/electron-download#usage) options. (legacy)
+     * Alternatively, you can use [electron/get](https://github.com/electron/get#usage) options.
      */
-    readonly electronDownload?: ElectronDownloadOptions;
+    readonly electronDownload?: ElectronDownloadOptions | ElectronGetOptions | null;
     /**
      * The branding used by Electron's distributables. This is needed if a fork has modified Electron's BRANDING.json file.
      */
@@ -206,14 +245,17 @@ export interface Configuration extends CommonConfiguration, PlatformSpecificBuil
     /**
      * *libui-based frameworks only* The version of NodeJS you are packaging for.
      * You can set it to `current` to set the Node.js version that you use to run.
+     * @deprecated libui-based frameworks (proton-native, etc.) are no longer actively maintained. This option has no effect when using Electron.
      */
     readonly nodeVersion?: string | null;
     /**
      * *libui-based frameworks only* The version of LaunchUI you are packaging for. Applicable for Windows only. Defaults to version suitable for used framework version.
+     * @deprecated libui-based frameworks (proton-native, etc.) are no longer actively maintained. This option has no effect when using Electron.
      */
     readonly launchUiVersion?: boolean | string | null;
     /**
      * The framework name. One of `electron`, `proton`, `libui`. Defaults to `electron`.
+     * @deprecated `proton` and `libui` framework support is no longer actively maintained. Use `electron` (the default).
      */
     readonly framework?: string | null;
     /**
@@ -267,79 +309,69 @@ export interface ToolsetConfig {
 }
 export interface Hooks {
     /**
-  The function (or path to file or module id) to be run before pack.
-  
-  ```typescript
-  (context: BeforePackContext): Promise<any> | any
-  ```
-  
-  !!! example "As function"
-  
-      ```js
-      beforePack: async (context) => {
-        // your code
-      }
-      ```
-  
-  Because in a configuration file you cannot use JavaScript, can be specified as a path to file or module id. Function must be exported as default export.
-  
-  ```json
-  "build": {
-    "beforePack": "./myBeforePackHook.js"
-  }
-  ```
-  
-  File `myBeforePackHook.js` in the project root directory:
-  
-  !!! example "myBeforePackHook.js"
-      ```js
-      exports.default = async function(context) {
-        // your custom code
-      }
-      ```
+     * The function (or path to file or module id) to be run before pack.
+     * Receives a {@link BeforePackContext}.
+     *
+     * Can be specified inline as a function in JavaScript configs:
+     * ```js
+     * // electron-builder.config.js
+     * module.exports = {
+     *   beforePack: async (context) => {
+     *     // your code
+     *   }
+     * }
+     * ```
+     *
+     * Or as a path to a module that exports the function as its default export:
+     * ```json
+     * { "build": { "beforePack": "./myBeforePackHook.js" } }
+     * ```
+     * ```js
+     * // myBeforePackHook.js
+     * exports.default = async function(context) {
+     *   // your custom code
+     * }
+     * ```
      */
     readonly beforePack?: Hook<BeforePackContext, void> | string | null;
     /**
-     * The function (or path to file or module id) to be [run after the prebuilt Electron binary has been extracted to the output directory](#afterextract)
-     * Same setup as {@link beforePack}
+     * The function (or path to file or module id) to be run after the prebuilt Electron binary has been extracted to the output directory.
+     * Receives an {@link AfterExtractContext}. For file/module setup, see {@link beforePack}.
      */
     readonly afterExtract?: Hook<AfterExtractContext, void> | string | null;
     /**
-     * The function (or path to file or module id) to be [run after pack](#afterpack) (but before pack into distributable format and sign).
-     * Same setup as {@link beforePack}
+     * The function (or path to file or module id) to be run after pack but before pack into distributable format and sign.
+     * Receives an {@link AfterPackContext}. For file/module setup, see {@link beforePack}.
      */
     readonly afterPack?: Hook<AfterPackContext, void> | string | null;
     /**
-     * The function (or path to file or module id) to be [run after pack and sign](#aftersign) (but before pack into distributable format).
-     * Same setup as {@link beforePack}
+     * The function (or path to file or module id) to be run after pack and sign but before pack into distributable format.
+     * Receives an {@link AfterPackContext}. For file/module setup, see {@link beforePack}.
      */
     readonly afterSign?: Hook<AfterPackContext, void> | string | null;
     /**
-     * The function (or path to file or module id) to be run on artifact build start.
-     * Same setup as {@link beforePack}
+     * The function (or path to file or module id) to be run when an individual artifact build starts.
+     * Receives an {@link ArtifactBuildStarted}. For file/module setup, see {@link beforePack}.
      */
     readonly artifactBuildStarted?: Hook<ArtifactBuildStarted, void> | string | null;
     /**
-     * The function (or path to file or module id) to be run on artifact build completed.
-     * Same setup as {@link beforePack}
+     * The function (or path to file or module id) to be run when an individual artifact build completes.
+     * Receives an {@link ArtifactCreated}. For file/module setup, see {@link beforePack}.
      */
     readonly artifactBuildCompleted?: Hook<ArtifactCreated, void> | string | null;
     /**
      * The function (or path to file or module id) to be run after all artifacts are built.
-  
-  ```typescript
-  (buildResult: BuildResult): Promise<Array<string>> | Array<string>
-  ```
-  
-  Configuration in the same way as `afterPack` (see above).
-  
-  !!! example "myAfterAllArtifactBuild.js"
-      ```js
-      exports.default = function () {
-        // you can return additional files to publish
-        return ["/path/to/additional/result/file"]
-      }
-      ```
+     * Receives a {@link BuildResult}. May return an array of additional file paths to publish.
+     *
+     * For file/module setup, see {@link beforePack}.
+     *
+     * @example
+     * ```js
+     * exports.default = function () {
+     *   // return additional files to publish
+     *   return ["/path/to/additional/result/file"]
+     * }
+     * ```
      */
     readonly afterAllArtifactBuild?: Hook<BuildResult, Array<string>> | string | null;
     /**
@@ -377,7 +409,7 @@ export interface MetadataDirectories {
      */
     readonly buildResources?: string | null;
     /**
-     * The output directory. [File macros](./file-patterns.md#file-macros) are supported.
+     * The output directory. [File macros](https://www.electron.build/file-patterns#file-macros) are supported.
      * @default dist
      */
     readonly output?: string | null;

package/out/configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"","sourcesContent":["import { Arch } from \"builder-util\"\nimport { BeforeBuildContext, Target } from \"./core\"\nimport { ElectronBrandingOptions, ElectronDownloadOptions } from \"./electron/ElectronFramework\"\nimport { PrepareApplicationStageDirectoryOptions } from \"./Framework\"\nimport { AppXOptions } from \"./options/AppXOptions\"\nimport { AppImageOptions, DebOptions, FlatpakOptions, LinuxConfiguration, LinuxTargetSpecificOptions } from \"./options/linuxOptions\"\nimport { DmgOptions, MacConfiguration, MasConfiguration } from \"./options/macOptions\"\nimport { MsiOptions } from \"./options/MsiOptions\"\nimport { MsiWrappedOptions } from \"./options/MsiWrappedOptions\"\nimport { PkgOptions } from \"./options/pkgOptions\"\nimport { PlatformSpecificBuildOptions } from \"./options/PlatformSpecificBuildOptions\"\nimport { SnapOptions } from \"./options/SnapOptions\"\nimport { SquirrelWindowsOptions } from \"./options/SquirrelWindowsOptions\"\nimport { WindowsConfiguration } from \"./options/winOptions\"\nimport { BuildResult } from \"./packager\"\nimport { ArtifactBuildStarted, ArtifactCreated } from \"./packagerApi\"\nimport { PlatformPackager } from \"./platformPackager\"\nimport { NsisOptions, NsisWebOptions, PortableOptions } from \"./targets/nsis/nsisOptions\"\n\n// duplicate appId here because it is important\n/**\n * Configuration Options\n */\nexport interface CommonConfiguration {\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   * As [name](#metadata), but allows you to specify a product name for your executable which contains spaces and other special characters not allowed in the [name property](https://docs.npmjs.com/files/package.json#name).\n   * If not specified inside of the `build` configuration, `productName` property defined at the top level of `package.json` is used. If not specified at the top level of `package.json`, [name property](https://docs.npmjs.com/files/package.json#name) is used.\n   */\n  readonly productName?: string | null\n\n  /**\n   * The human-readable copyright line for the app.\n   * @default Copyright © year ${author}\n   */\n  readonly copyright?: string | null\n\n  /**\n   * Directories for build resources\n   */\n  readonly directories?: MetadataDirectories | null\n\n  /**\n   * Configuration of toolsets utilized by electron-builder\n   */\n  readonly toolsets?: ToolsetConfig | null\n\n  /**\n   * Options related to how build macOS targets.\n   */\n  readonly mac?: MacConfiguration | null\n  /**\n   * MAS (Mac Application Store) options.\n   */\n  readonly mas?: MasConfiguration | null\n  /**\n   * MAS (Mac Application Store) development options (`mas-dev` target).\n   */\n  readonly masDev?: MasConfiguration | null\n  /**\n   * macOS DMG options.\n   */\n  readonly dmg?: DmgOptions | null\n  /**\n   * macOS PKG options.\n   */\n  readonly pkg?: PkgOptions | null\n\n  /**\n   * Options related to how build Windows targets.\n   */\n  readonly win?: WindowsConfiguration | null\n  readonly nsis?: NsisOptions | null\n  readonly nsisWeb?: NsisWebOptions | null\n  readonly portable?: PortableOptions | null\n  readonly appx?: AppXOptions | null\n  /** @private */\n  readonly msi?: MsiOptions | null\n  /** @private */\n  readonly msiWrapped?: MsiWrappedOptions | null\n  readonly squirrelWindows?: SquirrelWindowsOptions | null\n\n  /**\n   * Options related to how build Linux targets.\n   */\n  readonly linux?: LinuxConfiguration | null\n  /**\n   * Debian package options.\n   */\n  readonly deb?: DebOptions | null\n  /**\n   * Snap options.\n   */\n  readonly snap?: SnapOptions | null\n  /**\n   * AppImage options.\n   */\n  readonly appImage?: AppImageOptions | null\n  /**\n   * Flatpak options.\n   */\n  readonly flatpak?: FlatpakOptions | null\n  readonly pacman?: LinuxTargetSpecificOptions | null\n  readonly rpm?: LinuxTargetSpecificOptions | null\n  readonly freebsd?: LinuxTargetSpecificOptions | null\n  readonly p5p?: LinuxTargetSpecificOptions | null\n  readonly apk?: LinuxTargetSpecificOptions | null\n\n  /**\n   * Whether to build the application native dependencies from source.\n   * @default false\n   */\n  buildDependenciesFromSource?: boolean\n  /**\n   * Whether to execute `node-gyp rebuild` before starting to package the app.\n   *\n   * Don't [use](https://github.com/electron-userland/electron-builder/issues/683#issuecomment-241214075) [npm](http://electron.atom.io/docs/tutorial/using-native-node-modules/#using-npm) (neither `.npmrc`) for configuring electron headers. Use `electron-builder node-gyp-rebuild` instead.\n   * @default false\n   */\n  readonly nodeGypRebuild?: boolean\n  /**\n   * Additional command line arguments to use when installing app native deps.\n   */\n  readonly npmArgs?: Array<string> | string | null\n  /**\n   * Whether to [rebuild](https://docs.npmjs.com/cli/rebuild) native dependencies before starting to package the app.\n   * @default true\n   */\n  readonly npmRebuild?: boolean\n  /**\n   * Use `legacy` app-builder binary for installing native dependencies, or `@electron/rebuild` in `sequential` or `parallel` compilation modes.\n   * @default sequential\n   */\n  readonly nativeRebuilder?: \"legacy\" | \"sequential\" | \"parallel\" | null\n\n  /**\n   * The build number. Maps to the `--iteration` flag for builds using FPM on Linux.\n   * If not defined, then it will fallback to `BUILD_NUMBER` or `TRAVIS_BUILD_NUMBER` or `APPVEYOR_BUILD_NUMBER` or `CIRCLE_BUILD_NUM` or `BUILD_BUILDNUMBER` or `CI_PIPELINE_IID` env.\n   */\n  readonly buildNumber?: string | null\n\n  /**\n   * The build version. Maps to the `CFBundleVersion` on macOS, and `FileVersion` metadata property on Windows. Defaults to the `version`.\n   * If `buildVersion` is not defined and `buildNumber` (or one of the `buildNumber` envs) is defined, it will be used as a build version (`version.buildNumber`).\n   */\n  readonly buildVersion?: string | null\n\n  /**\n   * Whether to download the alternate FFmpeg library from Electron's release assets and replace the default FFmpeg library prior to signing\n   */\n  readonly downloadAlternateFFmpeg?: boolean\n\n  /**\n   * Inject properties to `package.json`.\n   */\n  readonly extraMetadata?: any\n\n  /**\n   * Whether to fail if the application is not signed (to prevent unsigned app if code signing configuration is not correct).\n   * @default false\n   */\n  readonly forceCodeSigning?: boolean\n\n  /**\n   * Whether to include PDB files.\n   * @default false\n   */\n  readonly includePdb?: boolean\n\n  /**\n   * Whether to remove `scripts` field from `package.json` files.\n   *\n   * @default true\n   */\n  readonly removePackageScripts?: boolean\n\n  /**\n   * Whether to remove `keywords` field from `package.json` files.\n   *\n   * @default true\n   */\n  readonly removePackageKeywords?: boolean\n\n  /**\n   * Options to pass to `@electron/fuses`\n   * Ref: https://github.com/electron/fuses\n   */\n  readonly electronFuses?: FuseOptionsV1 | null\n\n  /**\n   * [Experimental] Configuration for concurrent builds.\n   */\n  readonly concurrency?: Concurrency | null\n}\n\nexport interface Configuration extends CommonConfiguration, PlatformSpecificBuildOptions, Hooks {\n  /**\n   * Whether to use [electron-compile](http://github.com/electron/electron-compile) to compile app. Defaults to `true` if `electron-compile` in the dependencies. And `false` if in the `devDependencies` or doesn't specified.\n   */\n  readonly electronCompile?: boolean\n\n  /**\n   * The [electron-download](https://github.com/electron-userland/electron-download#usage) options.\n   */\n  readonly electronDownload?: ElectronDownloadOptions\n\n  /**\n   * The branding used by Electron's distributables. This is needed if a fork has modified Electron's BRANDING.json file.\n   */\n  readonly electronBranding?: ElectronBrandingOptions\n\n  /**\n   * The version of electron you are packaging for. Defaults to version of `electron`, `electron-prebuilt` or `electron-prebuilt-compile` dependency.\n   */\n  electronVersion?: string | null\n\n  /**\n   * The name of a built-in configuration preset (currently, only `react-cra` is supported) or any number of paths to config files (relative to project dir).\n   *\n   * The latter allows to mixin a config from multiple other configs, as if you `Object.assign` them, but properly combine `files` glob patterns.\n   *\n   * If `react-scripts` in the app dependencies, `react-cra` will be set automatically. Set to `null` to disable automatic detection.\n   */\n  extends?: Array<string> | string | null\n\n  /**\n   * *libui-based frameworks only* The version of NodeJS you are packaging for.\n   * You can set it to `current` to set the Node.js version that you use to run.\n   */\n  readonly nodeVersion?: string | null\n\n  /**\n   * *libui-based frameworks only* The version of LaunchUI you are packaging for. Applicable for Windows only. Defaults to version suitable for used framework version.\n   */\n  readonly launchUiVersion?: boolean | string | null\n\n  /**\n   * The framework name. One of `electron`, `proton`, `libui`. Defaults to `electron`.\n   */\n  readonly framework?: string | null\n\n  /**\n   * Whether to disable sanity check asar package (useful for custom electron forks that implement their own encrypted integrity validation)\n   * @default false\n   */\n  readonly disableSanityCheckAsar?: boolean\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 * Configuration of toolsets utilized by electron-builder\n */\nexport interface ToolsetConfig {\n  /**\n   * `win-codesign` version to use for signing Windows artifacts.\n   * Located at https://github.com/electron-userland/electron-builder-binaries/releases?q=win-codesign&expanded=true\n   *\n   * Stable:\n   * v0.0.0 (winCodeSign)\n   *\n   * Beta:\n   * Windows Kits 10.0.26100.0\n   * v1.0.0, v1.1.0\n   *\n   * @default \"0.0.0\"\n   */\n  readonly winCodeSign?: \"0.0.0\" | \"1.0.0\" | \"1.1.0\" | null\n\n  /**\n   * `appimage` bundle version to use for Appimage packaging and runtime.\n   * Located at https://github.com/electron-userland/electron-builder-binaries/releases?q=appimage&expanded=true\n   * 0.0.0 - legacy toolset (appimage)\n   *\n   * Betas:\n   * 1.0.2 - Runtime 20251108\n   * 1.0.3 - Runtime 20251108 (Resolves GH issue #9598)\n   *\n   * @default \"0.0.0\"\n   */\n  readonly appimage?: \"0.0.0\" | \"1.0.2\" | \"1.0.3\" | null\n}\n\nexport interface Hooks {\n  /**\nThe function (or path to file or module id) to be run before pack.\n\n```typescript\n(context: BeforePackContext): Promise<any> | any\n```\n\n!!! example \"As function\"\n\n    ```js\n    beforePack: async (context) => {\n      // your code\n    }\n    ```\n\nBecause in a configuration file you cannot use JavaScript, can be specified as a path to file or module id. Function must be exported as default export.\n\n```json\n\"build\": {\n  \"beforePack\": \"./myBeforePackHook.js\"\n}\n```\n\nFile `myBeforePackHook.js` in the project root directory:\n\n!!! example \"myBeforePackHook.js\"\n    ```js\n    exports.default = async function(context) {\n      // your custom code\n    }\n    ```\n   */\n  readonly beforePack?: Hook<BeforePackContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be [run after the prebuilt Electron binary has been extracted to the output directory](#afterextract)\n   * Same setup as {@link beforePack}\n   */\n  readonly afterExtract?: Hook<AfterExtractContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be [run after pack](#afterpack) (but before pack into distributable format and sign).\n   * Same setup as {@link beforePack}\n   */\n  readonly afterPack?: Hook<AfterPackContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be [run after pack and sign](#aftersign) (but before pack into distributable format).\n   * Same setup as {@link beforePack}\n   */\n  readonly afterSign?: Hook<AfterPackContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be run on artifact build start.\n   * Same setup as {@link beforePack}\n   */\n  readonly artifactBuildStarted?: Hook<ArtifactBuildStarted, void> | string | null\n  /**\n   * The function (or path to file or module id) to be run on artifact build completed.\n   * Same setup as {@link beforePack}\n   */\n  readonly artifactBuildCompleted?: Hook<ArtifactCreated, void> | string | null\n  /**\n   * The function (or path to file or module id) to be run after all artifacts are built.\n\n```typescript\n(buildResult: BuildResult): Promise<Array<string>> | Array<string>\n```\n\nConfiguration in the same way as `afterPack` (see above).\n\n!!! example \"myAfterAllArtifactBuild.js\"\n    ```js\n    exports.default = function () {\n      // you can return additional files to publish\n      return [\"/path/to/additional/result/file\"]\n    }\n    ```\n   */\n  readonly afterAllArtifactBuild?: Hook<BuildResult, Array<string>> | string | null\n  /**\n   * The function (or path to file or module id) to be run after MSI project created on disk - not packed into .msi package yet.\n   */\n  readonly msiProjectCreated?: Hook<string, void> | string | null\n  /**\n   * The function (or path to file or module id) to be run after Appx manifest created on disk - not packed into .appx package yet.\n   */\n  readonly appxManifestCreated?: Hook<string, void> | string | null\n  /**\n   * The function (or path to file or module id) to be [run on each node module](#onnodemodulefile) file. Returning `true`/`false` will determine whether to force include or to use the default copier logic\n   */\n  readonly onNodeModuleFile?: Hook<string, void | boolean> | string | null\n  /**\n   * The function (or path to file or module id) to be run before dependencies are installed or rebuilt. Works when `npmRebuild` is set to `true`. Resolving to `false` will skip dependencies install or rebuild.\n   *\n   * If provided and `node_modules` are missing, it will not invoke production dependencies check.\n   */\n  readonly beforeBuild?: Hook<BeforeBuildContext, boolean | void> | string | null\n  /**\n   * The function (or path to file or module id) to be run when staging the electron artifact environment.\n   * Returns the path to custom Electron build (e.g. `~/electron/out/R`) or folder of electron zips.\n   *\n   * Zip files must follow the pattern `electron-v${version}-${platformName}-${arch}.zip`, otherwise it will be assumed to be an unpacked Electron app directory\n   */\n  readonly electronDist?: Hook<PrepareApplicationStageDirectoryOptions, string> | string | null\n}\n\nexport interface MetadataDirectories {\n  /**\n   * The path to build resources.\n   *\n   * Please note — build resources are not packed into the app. If you need to use some files, e.g. as tray icon, please include required files explicitly: `\"files\": [\"**\\/*\", \"build/icon.*\"]`\n   * @default build\n   */\n  readonly buildResources?: string | null\n\n  /**\n   * The output directory. [File macros](./file-patterns.md#file-macros) are supported.\n   * @default dist\n   */\n  readonly output?: string | null\n\n  /**\n   * The application directory (containing the application package.json), defaults to `app`, `www` or working directory.\n   */\n  readonly app?: string | null\n}\n\n/**\n * All options come from [@electron/fuses](https://github.com/electron/fuses)\n * Ref: https://raw.githubusercontent.com/electron/electron/refs/heads/main/docs/tutorial/fuses.md\n */\nexport interface FuseOptionsV1 {\n  /**\n   *The runAsNode fuse toggles whether the `ELECTRON_RUN_AS_NODE` environment variable is respected or not.  Please note that if this fuse is disabled then `process.fork` in the main process will not function as expected as it depends on this environment variable to function. Instead, we recommend that you use [Utility Processes](https://github.com/electron/electron/blob/main/docs/api/utility-process.md), which work for many use cases where you need a standalone Node.js process (like a Sqlite server process or similar scenarios).\n   */\n  runAsNode?: boolean\n  /**\n   * The cookieEncryption fuse toggles whether the cookie store on disk is encrypted using OS level cryptography keys.  By default the sqlite database that Chromium uses to store cookies stores the values in plaintext.  If you wish to ensure your apps cookies are encrypted in the same way Chrome does then you should enable this fuse.  Please note it is a one-way transition, if you enable this fuse existing unencrypted cookies will be encrypted-on-write but if you then disable the fuse again your cookie store will effectively be corrupt and useless.  Most apps can safely enable this fuse.\n   */\n  enableCookieEncryption?: boolean\n  /**\n   * The nodeOptions fuse toggles whether the [`NODE_OPTIONS`](https://nodejs.org/api/cli.html#node_optionsoptions)  and [`NODE_EXTRA_CA_CERTS`](https://github.com/nodejs/node/blob/main/doc/api/cli.md#node_extra_ca_certsfile) environment variables are respected.  The `NODE_OPTIONS` environment variable can be used to pass all kinds of custom options to the Node.js runtime and isn't typically used by apps in production.  Most apps can safely disable this fuse.\n   */\n  enableNodeOptionsEnvironmentVariable?: boolean\n  /**\n   * The nodeCliInspect fuse toggles whether the `--inspect`, `--inspect-brk`, etc. flags are respected or not.  When disabled it also ensures that `SIGUSR1` signal does not initialize the main process inspector.  Most apps can safely disable this fuse.\n   */\n  enableNodeCliInspectArguments?: boolean\n  /**\n   * The embeddedAsarIntegrityValidation fuse toggles an experimental feature on macOS that validates the content of the `app.asar` file when it is loaded.  This feature is designed to have a minimal performance impact but may marginally slow down file reads from inside the `app.asar` archive.\n   * Currently, ASAR integrity checking is supported on:\n   *\n   *  - macOS as of electron>=16.0.0\n   *  - Windows as of electron>=30.0.0\n   *\n   * For more information on how to use asar integrity validation please read the [Asar Integrity](https://github.com/electron/electron/blob/main/docs/tutorial/asar-integrity.md) documentation.\n   */\n  enableEmbeddedAsarIntegrityValidation?: boolean\n  /**\n   * The onlyLoadAppFromAsar fuse changes the search system that Electron uses to locate your app code.  By default Electron will search in the following order `app.asar` -> `app` -> `default_app.asar`.  When this fuse is enabled the search order becomes a single entry `app.asar` thus ensuring that when combined with the `embeddedAsarIntegrityValidation` fuse it is impossible to load non-validated code.\n   */\n  onlyLoadAppFromAsar?: boolean\n  /**\n   * The loadBrowserProcessSpecificV8Snapshot fuse changes which V8 snapshot file is used for the browser process.  By default Electron's processes will all use the same V8 snapshot file.  When this fuse is enabled the browser process uses the file called `browser_v8_context_snapshot.bin` for its V8 snapshot. The other processes will use the V8 snapshot file that they normally do.\n   */\n  loadBrowserProcessSpecificV8Snapshot?: boolean\n  /**\n   * The grantFileProtocolExtraPrivileges fuse changes whether pages loaded from the `file://` protocol are given privileges beyond what they would receive in a traditional web browser.  This behavior was core to Electron apps in original versions of Electron but is no longer required as apps should be [serving local files from custom protocols](https://github.com/electron/electron/blob/main/docs/tutorial/security.md#18-avoid-usage-of-the-file-protocol-and-prefer-usage-of-custom-protocols) now instead.  If you aren't serving pages from `file://` you should disable this fuse.\n   * The extra privileges granted to the `file://` protocol by this fuse are incompletely documented below:\n   *\n   *  - `file://` protocol pages can use `fetch` to load other assets over `file://`\n   *  - `file://` protocol pages can use service workers\n   *  - `file://` protocol pages have universal access granted to child frames also running on `file://` protocols regardless of sandbox settings\n   */\n  grantFileProtocolExtraPrivileges?: boolean\n  /**\n   * Resets the app signature, specifically used for macOS.\n   * Note: This should be unneeded since electron-builder signs the app directly after flipping the fuses.\n   * Ref: https://github.com/electron/fuses?tab=readme-ov-file#apple-silicon\n   */\n  resetAdHocDarwinSignature?: boolean\n}\n\nexport interface Concurrency {\n  /**\n   * The maximum number of concurrent jobs to run.\n   * @default 1\n   */\n  jobs: number\n}\n"]}
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"","sourcesContent":["import { Arch } from \"builder-util\"\nimport { BeforeBuildContext, Target } from \"./core\"\nimport { ElectronBrandingOptions } from \"./electron/ElectronFramework\"\nimport { PrepareApplicationStageDirectoryOptions } from \"./Framework\"\nimport { AppXOptions } from \"./options/AppXOptions\"\nimport { AppImageOptions, DebOptions, FlatpakOptions, LinuxConfiguration, LinuxTargetSpecificOptions, PacmanOptions, RpmOptions } from \"./options/linuxOptions\"\nimport { DmgOptions, MacConfiguration, MasConfiguration } from \"./options/macOptions\"\nimport { MsiOptions } from \"./options/MsiOptions\"\nimport { MsiWrappedOptions } from \"./options/MsiWrappedOptions\"\nimport { PkgOptions } from \"./options/pkgOptions\"\nimport { PlatformSpecificBuildOptions } from \"./options/PlatformSpecificBuildOptions\"\nimport { SnapOptions } from \"./options/SnapOptions\"\nimport { SquirrelWindowsOptions } from \"./options/SquirrelWindowsOptions\"\nimport { WindowsConfiguration } from \"./options/winOptions\"\nimport { BuildResult } from \"./packager\"\nimport { ArtifactBuildStarted, ArtifactCreated } from \"./packagerApi\"\nimport { PlatformPackager } from \"./platformPackager\"\nimport { NsisOptions, NsisWebOptions, PortableOptions } from \"./targets/nsis/nsisOptions\"\nimport { ElectronDownloadOptions, ElectronGetOptions } from \"./util/electronGet\"\n\n// duplicate appId here because it is important\n/**\n * Configuration Options\n */\nexport interface CommonConfiguration {\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   * As [name](#metadata), but allows you to specify a product name for your executable which contains spaces and other special characters not allowed in the [name property](https://docs.npmjs.com/files/package.json#name).\n   * If not specified inside of the `build` configuration, `productName` property defined at the top level of `package.json` is used. If not specified at the top level of `package.json`, [name property](https://docs.npmjs.com/files/package.json#name) is used.\n   */\n  readonly productName?: string | null\n\n  /**\n   * The human-readable copyright line for the app.\n   * @default Copyright © year ${author}\n   */\n  readonly copyright?: string | null\n\n  /**\n   * Directories for build resources\n   */\n  readonly directories?: MetadataDirectories | null\n\n  /**\n   * Configuration of toolsets utilized by electron-builder\n   */\n  readonly toolsets?: ToolsetConfig | null\n\n  /**\n   * Options related to how build macOS targets.\n   */\n  readonly mac?: MacConfiguration | null\n  /**\n   * MAS (Mac Application Store) options.\n   */\n  readonly mas?: MasConfiguration | null\n  /**\n   * MAS (Mac Application Store) development options (`mas-dev` target).\n   */\n  readonly masDev?: MasConfiguration | null\n  /**\n   * macOS DMG options.\n   */\n  readonly dmg?: DmgOptions | null\n  /**\n   * macOS PKG options.\n   */\n  readonly pkg?: PkgOptions | null\n\n  /**\n   * Options related to how build Windows targets.\n   */\n  readonly win?: WindowsConfiguration | null\n  /** NSIS installer options. */\n  readonly nsis?: NsisOptions | null\n  /** NSIS web installer options (downloads app package at install time). */\n  readonly nsisWeb?: NsisWebOptions | null\n  /** Portable executable options (no installation required). */\n  readonly portable?: PortableOptions | null\n  /** Windows Store (AppX) package options. */\n  readonly appx?: AppXOptions | null\n  /**\n   * MSI package options.\n   */\n  readonly msi?: MsiOptions | null\n  /**\n   * MSI-wrapped installer options.\n   */\n  readonly msiWrapped?: MsiWrappedOptions | null\n  /**\n   * Squirrel.Windows installer options. Requires the `electron-builder-squirrel-windows` dependency.\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  readonly linux?: LinuxConfiguration | null\n  /**\n   * Debian package options. Targets Debian, Ubuntu, and Debian-based distributions.\n   * Produces a `.deb` archive installable via `dpkg -i` or `apt install`.\n   */\n  readonly deb?: DebOptions | null\n  /**\n   * Snap package options. Requires [snapcraft](https://snapcraft.io/) to be installed.\n   */\n  readonly snap?: SnapOptions | null\n  /**\n   * AppImage options. AppImage is a portable application format that bundles the app\n   * and its dependencies into a single self-contained executable that runs on most\n   * Linux distributions without installation.\n   */\n  readonly appImage?: AppImageOptions | null\n  /**\n   * Flatpak options. Flatpak is a sandboxed application distribution format for Linux\n   * that runs in a controlled environment and is distributed via [Flathub](https://flathub.org/)\n   * or other Flatpak repositories.\n   */\n  readonly flatpak?: FlatpakOptions | null\n  /**\n   * Pacman package options. Targets Arch Linux and Arch-based distributions\n   * (Manjaro, EndeavourOS, etc.). Produces a `.pacman` archive installable via `pacman -U`.\n   */\n  readonly pacman?: PacmanOptions | null\n  /**\n   * RPM package options. Targets Fedora, Red Hat Enterprise Linux, SUSE, and related\n   * distributions. Produces a `.rpm` archive installable via `rpm` or `dnf`.\n   */\n  readonly rpm?: RpmOptions | null\n  /**\n   * FreeBSD package options. Produces a `.pkg` archive for the FreeBSD `pkg` package manager.\n   */\n  readonly freebsd?: LinuxTargetSpecificOptions | null\n  /**\n   * Solaris IPS package options. Produces a `.p5p` archive for the Solaris Image Packaging\n   * System (`pkg`).\n   */\n  readonly p5p?: LinuxTargetSpecificOptions | null\n  /**\n   * Alpine Linux APK package options. Produces an `.apk` archive installable via `apk add`.\n   */\n  readonly apk?: LinuxTargetSpecificOptions | null\n\n  /**\n   * Whether to build the application native dependencies from source.\n   * @default false\n   */\n  buildDependenciesFromSource?: boolean\n  /**\n   * Whether to execute `node-gyp rebuild` before starting to package the app.\n   *\n   * Don't [use](https://github.com/electron-userland/electron-builder/issues/683#issuecomment-241214075) [npm](http://electron.atom.io/docs/tutorial/using-native-node-modules/#using-npm) (neither `.npmrc`) for configuring electron headers. Use `electron-builder node-gyp-rebuild` instead.\n   * @default false\n   */\n  readonly nodeGypRebuild?: boolean\n  /**\n   * Additional command line arguments to use when installing app native deps.\n   */\n  readonly npmArgs?: Array<string> | string | null\n  /**\n   * Whether to [rebuild](https://docs.npmjs.com/cli/rebuild) native dependencies before starting to package the app.\n   * @default true\n   */\n  readonly npmRebuild?: boolean\n  /**\n   * Use `legacy` app-builder binary for installing native dependencies, or `@electron/rebuild` in `sequential` or `parallel` compilation modes.\n   * @default sequential\n   */\n  readonly nativeRebuilder?: \"legacy\" | \"sequential\" | \"parallel\" | null\n\n  /**\n   * The build number. Maps to the `--iteration` flag for builds using FPM on Linux.\n   * If not defined, then it will fallback to `BUILD_NUMBER` or `TRAVIS_BUILD_NUMBER` or `APPVEYOR_BUILD_NUMBER` or `CIRCLE_BUILD_NUM` or `BUILD_BUILDNUMBER` or `CI_PIPELINE_IID` env.\n   */\n  readonly buildNumber?: string | null\n\n  /**\n   * The build version. Maps to the `CFBundleVersion` on macOS, and `FileVersion` metadata property on Windows. Defaults to the `version`.\n   * If `buildVersion` is not defined and `buildNumber` (or one of the `buildNumber` envs) is defined, it will be used as a build version (`version.buildNumber`).\n   */\n  readonly buildVersion?: string | null\n\n  /**\n   * Whether to download the alternate FFmpeg library from Electron's release assets and replace the default FFmpeg library prior to signing\n   */\n  readonly downloadAlternateFFmpeg?: boolean\n\n  /**\n   * Inject properties to `package.json`.\n   */\n  readonly extraMetadata?: any\n\n  /**\n   * Whether to fail if the application is not signed (to prevent unsigned app if code signing configuration is not correct).\n   * @default false\n   */\n  readonly forceCodeSigning?: boolean\n\n  /**\n   * Whether to include PDB files.\n   * @default false\n   */\n  readonly includePdb?: boolean\n\n  /**\n   * Whether to remove `scripts` field from `package.json` files.\n   *\n   * @default true\n   */\n  readonly removePackageScripts?: boolean\n\n  /**\n   * Whether to remove `keywords` field from `package.json` files.\n   *\n   * @default true\n   */\n  readonly removePackageKeywords?: boolean\n\n  /**\n   * Options to pass to `@electron/fuses`\n   * Ref: https://github.com/electron/fuses\n   */\n  readonly electronFuses?: FuseOptionsV1 | null\n\n  /**\n   * [Experimental] Configuration for concurrent builds.\n   */\n  readonly concurrency?: Concurrency | null\n}\n\nexport interface Configuration extends CommonConfiguration, PlatformSpecificBuildOptions, Hooks {\n  /**\n   * Whether to use [electron-compile](http://github.com/electron/electron-compile) to compile app. Defaults to `true` if `electron-compile` in the dependencies. And `false` if in the `devDependencies` or doesn't specified.\n   * @deprecated `electron-compile` is no longer maintained. Compile your app with a modern bundler (webpack, vite, etc.) instead.\n   */\n  readonly electronCompile?: boolean\n\n  /**\n   * The [electron-download](https://github.com/electron-userland/electron-download#usage) options. (legacy)\n   * Alternatively, you can use [electron/get](https://github.com/electron/get#usage) options.\n   */\n  readonly electronDownload?: ElectronDownloadOptions | ElectronGetOptions | null\n\n  /**\n   * The branding used by Electron's distributables. This is needed if a fork has modified Electron's BRANDING.json file.\n   */\n  readonly electronBranding?: ElectronBrandingOptions\n\n  /**\n   * The version of electron you are packaging for. Defaults to version of `electron`, `electron-prebuilt` or `electron-prebuilt-compile` dependency.\n   */\n  electronVersion?: string | null\n\n  /**\n   * The name of a built-in configuration preset (currently, only `react-cra` is supported) or any number of paths to config files (relative to project dir).\n   *\n   * The latter allows to mixin a config from multiple other configs, as if you `Object.assign` them, but properly combine `files` glob patterns.\n   *\n   * If `react-scripts` in the app dependencies, `react-cra` will be set automatically. Set to `null` to disable automatic detection.\n   */\n  extends?: Array<string> | string | null\n\n  /**\n   * *libui-based frameworks only* The version of NodeJS you are packaging for.\n   * You can set it to `current` to set the Node.js version that you use to run.\n   * @deprecated libui-based frameworks (proton-native, etc.) are no longer actively maintained. This option has no effect when using Electron.\n   */\n  readonly nodeVersion?: string | null\n\n  /**\n   * *libui-based frameworks only* The version of LaunchUI you are packaging for. Applicable for Windows only. Defaults to version suitable for used framework version.\n   * @deprecated libui-based frameworks (proton-native, etc.) are no longer actively maintained. This option has no effect when using Electron.\n   */\n  readonly launchUiVersion?: boolean | string | null\n\n  /**\n   * The framework name. One of `electron`, `proton`, `libui`. Defaults to `electron`.\n   * @deprecated `proton` and `libui` framework support is no longer actively maintained. Use `electron` (the default).\n   */\n  readonly framework?: string | null\n\n  /**\n   * Whether to disable sanity check asar package (useful for custom electron forks that implement their own encrypted integrity validation)\n   * @default false\n   */\n  readonly disableSanityCheckAsar?: boolean\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 * Configuration of toolsets utilized by electron-builder\n */\nexport interface ToolsetConfig {\n  /**\n   * `win-codesign` version to use for signing Windows artifacts.\n   * Located at https://github.com/electron-userland/electron-builder-binaries/releases?q=win-codesign&expanded=true\n   *\n   * Stable:\n   * v0.0.0 (winCodeSign)\n   *\n   * Beta:\n   * Windows Kits 10.0.26100.0\n   * v1.0.0, v1.1.0\n   *\n   * @default \"0.0.0\"\n   */\n  readonly winCodeSign?: \"0.0.0\" | \"1.0.0\" | \"1.1.0\" | null\n\n  /**\n   * `appimage` bundle version to use for Appimage packaging and runtime.\n   * Located at https://github.com/electron-userland/electron-builder-binaries/releases?q=appimage&expanded=true\n   * 0.0.0 - legacy toolset (appimage)\n   *\n   * Betas:\n   * 1.0.2 - Runtime 20251108\n   * 1.0.3 - Runtime 20251108 (Resolves GH issue #9598)\n   *\n   * @default \"0.0.0\"\n   */\n  readonly appimage?: \"0.0.0\" | \"1.0.2\" | \"1.0.3\" | null\n}\n\nexport interface Hooks {\n  /**\n   * The function (or path to file or module id) to be run before pack.\n   * Receives a {@link BeforePackContext}.\n   *\n   * Can be specified inline as a function in JavaScript configs:\n   * ```js\n   * // electron-builder.config.js\n   * module.exports = {\n   *   beforePack: async (context) => {\n   *     // your code\n   *   }\n   * }\n   * ```\n   *\n   * Or as a path to a module that exports the function as its default export:\n   * ```json\n   * { \"build\": { \"beforePack\": \"./myBeforePackHook.js\" } }\n   * ```\n   * ```js\n   * // myBeforePackHook.js\n   * exports.default = async function(context) {\n   *   // your custom code\n   * }\n   * ```\n   */\n  readonly beforePack?: Hook<BeforePackContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be run after the prebuilt Electron binary has been extracted to the output directory.\n   * Receives an {@link AfterExtractContext}. For file/module setup, see {@link beforePack}.\n   */\n  readonly afterExtract?: Hook<AfterExtractContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be run after pack but before pack into distributable format and sign.\n   * Receives an {@link AfterPackContext}. For file/module setup, see {@link beforePack}.\n   */\n  readonly afterPack?: Hook<AfterPackContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be run after pack and sign but before pack into distributable format.\n   * Receives an {@link AfterPackContext}. For file/module setup, see {@link beforePack}.\n   */\n  readonly afterSign?: Hook<AfterPackContext, void> | string | null\n\n  /**\n   * The function (or path to file or module id) to be run when an individual artifact build starts.\n   * Receives an {@link ArtifactBuildStarted}. For file/module setup, see {@link beforePack}.\n   */\n  readonly artifactBuildStarted?: Hook<ArtifactBuildStarted, void> | string | null\n  /**\n   * The function (or path to file or module id) to be run when an individual artifact build completes.\n   * Receives an {@link ArtifactCreated}. For file/module setup, see {@link beforePack}.\n   */\n  readonly artifactBuildCompleted?: Hook<ArtifactCreated, void> | string | null\n  /**\n   * The function (or path to file or module id) to be run after all artifacts are built.\n   * Receives a {@link BuildResult}. May return an array of additional file paths to publish.\n   *\n   * For file/module setup, see {@link beforePack}.\n   *\n   * @example\n   * ```js\n   * exports.default = function () {\n   *   // return additional files to publish\n   *   return [\"/path/to/additional/result/file\"]\n   * }\n   * ```\n   */\n  readonly afterAllArtifactBuild?: Hook<BuildResult, Array<string>> | string | null\n  /**\n   * The function (or path to file or module id) to be run after MSI project created on disk - not packed into .msi package yet.\n   */\n  readonly msiProjectCreated?: Hook<string, void> | string | null\n  /**\n   * The function (or path to file or module id) to be run after Appx manifest created on disk - not packed into .appx package yet.\n   */\n  readonly appxManifestCreated?: Hook<string, void> | string | null\n  /**\n   * The function (or path to file or module id) to be [run on each node module](#onnodemodulefile) file. Returning `true`/`false` will determine whether to force include or to use the default copier logic\n   */\n  readonly onNodeModuleFile?: Hook<string, void | boolean> | string | null\n  /**\n   * The function (or path to file or module id) to be run before dependencies are installed or rebuilt. Works when `npmRebuild` is set to `true`. Resolving to `false` will skip dependencies install or rebuild.\n   *\n   * If provided and `node_modules` are missing, it will not invoke production dependencies check.\n   */\n  readonly beforeBuild?: Hook<BeforeBuildContext, boolean | void> | string | null\n  /**\n   * The function (or path to file or module id) to be run when staging the electron artifact environment.\n   * Returns the path to custom Electron build (e.g. `~/electron/out/R`) or folder of electron zips.\n   *\n   * Zip files must follow the pattern `electron-v${version}-${platformName}-${arch}.zip`, otherwise it will be assumed to be an unpacked Electron app directory\n   */\n  readonly electronDist?: Hook<PrepareApplicationStageDirectoryOptions, string> | string | null\n}\n\nexport interface MetadataDirectories {\n  /**\n   * The path to build resources.\n   *\n   * Please note — build resources are not packed into the app. If you need to use some files, e.g. as tray icon, please include required files explicitly: `\"files\": [\"**\\/*\", \"build/icon.*\"]`\n   * @default build\n   */\n  readonly buildResources?: string | null\n\n  /**\n   * The output directory. [File macros](https://www.electron.build/file-patterns#file-macros) are supported.\n   * @default dist\n   */\n  readonly output?: string | null\n\n  /**\n   * The application directory (containing the application package.json), defaults to `app`, `www` or working directory.\n   */\n  readonly app?: string | null\n}\n\n/**\n * All options come from [@electron/fuses](https://github.com/electron/fuses)\n * Ref: https://raw.githubusercontent.com/electron/electron/refs/heads/main/docs/tutorial/fuses.md\n */\nexport interface FuseOptionsV1 {\n  /**\n   *The runAsNode fuse toggles whether the `ELECTRON_RUN_AS_NODE` environment variable is respected or not.  Please note that if this fuse is disabled then `process.fork` in the main process will not function as expected as it depends on this environment variable to function. Instead, we recommend that you use [Utility Processes](https://github.com/electron/electron/blob/main/docs/api/utility-process.md), which work for many use cases where you need a standalone Node.js process (like a Sqlite server process or similar scenarios).\n   */\n  runAsNode?: boolean\n  /**\n   * The cookieEncryption fuse toggles whether the cookie store on disk is encrypted using OS level cryptography keys.  By default the sqlite database that Chromium uses to store cookies stores the values in plaintext.  If you wish to ensure your apps cookies are encrypted in the same way Chrome does then you should enable this fuse.  Please note it is a one-way transition, if you enable this fuse existing unencrypted cookies will be encrypted-on-write but if you then disable the fuse again your cookie store will effectively be corrupt and useless.  Most apps can safely enable this fuse.\n   */\n  enableCookieEncryption?: boolean\n  /**\n   * The nodeOptions fuse toggles whether the [`NODE_OPTIONS`](https://nodejs.org/api/cli.html#node_optionsoptions)  and [`NODE_EXTRA_CA_CERTS`](https://github.com/nodejs/node/blob/main/doc/api/cli.md#node_extra_ca_certsfile) environment variables are respected.  The `NODE_OPTIONS` environment variable can be used to pass all kinds of custom options to the Node.js runtime and isn't typically used by apps in production.  Most apps can safely disable this fuse.\n   */\n  enableNodeOptionsEnvironmentVariable?: boolean\n  /**\n   * The nodeCliInspect fuse toggles whether the `--inspect`, `--inspect-brk`, etc. flags are respected or not.  When disabled it also ensures that `SIGUSR1` signal does not initialize the main process inspector.  Most apps can safely disable this fuse.\n   */\n  enableNodeCliInspectArguments?: boolean\n  /**\n   * The embeddedAsarIntegrityValidation fuse toggles an experimental feature on macOS that validates the content of the `app.asar` file when it is loaded.  This feature is designed to have a minimal performance impact but may marginally slow down file reads from inside the `app.asar` archive.\n   * Currently, ASAR integrity checking is supported on:\n   *\n   *  - macOS as of electron>=16.0.0\n   *  - Windows as of electron>=30.0.0\n   *\n   * For more information on how to use asar integrity validation please read the [Asar Integrity](https://github.com/electron/electron/blob/main/docs/tutorial/asar-integrity.md) documentation.\n   */\n  enableEmbeddedAsarIntegrityValidation?: boolean\n  /**\n   * The onlyLoadAppFromAsar fuse changes the search system that Electron uses to locate your app code.  By default Electron will search in the following order `app.asar` -> `app` -> `default_app.asar`.  When this fuse is enabled the search order becomes a single entry `app.asar` thus ensuring that when combined with the `embeddedAsarIntegrityValidation` fuse it is impossible to load non-validated code.\n   */\n  onlyLoadAppFromAsar?: boolean\n  /**\n   * The loadBrowserProcessSpecificV8Snapshot fuse changes which V8 snapshot file is used for the browser process.  By default Electron's processes will all use the same V8 snapshot file.  When this fuse is enabled the browser process uses the file called `browser_v8_context_snapshot.bin` for its V8 snapshot. The other processes will use the V8 snapshot file that they normally do.\n   */\n  loadBrowserProcessSpecificV8Snapshot?: boolean\n  /**\n   * The grantFileProtocolExtraPrivileges fuse changes whether pages loaded from the `file://` protocol are given privileges beyond what they would receive in a traditional web browser.  This behavior was core to Electron apps in original versions of Electron but is no longer required as apps should be [serving local files from custom protocols](https://github.com/electron/electron/blob/main/docs/tutorial/security.md#18-avoid-usage-of-the-file-protocol-and-prefer-usage-of-custom-protocols) now instead.  If you aren't serving pages from `file://` you should disable this fuse.\n   * The extra privileges granted to the `file://` protocol by this fuse are incompletely documented below:\n   *\n   *  - `file://` protocol pages can use `fetch` to load other assets over `file://`\n   *  - `file://` protocol pages can use service workers\n   *  - `file://` protocol pages have universal access granted to child frames also running on `file://` protocols regardless of sandbox settings\n   */\n  grantFileProtocolExtraPrivileges?: boolean\n  /**\n   * Resets the app signature, specifically used for macOS.\n   * Note: This should be unneeded since electron-builder signs the app directly after flipping the fuses.\n   * Ref: https://github.com/electron/fuses?tab=readme-ov-file#apple-silicon\n   */\n  resetAdHocDarwinSignature?: boolean\n}\n\nexport interface Concurrency {\n  /**\n   * The maximum number of concurrent jobs to run.\n   * @default 1\n   */\n  jobs: number\n}\n"]}

package/out/core.d.ts

@@ -31,14 +31,14 @@ export declare abstract class Target {
     abstract readonly outDir: string;
     abstract readonly options: TargetSpecificOptions | Nullish;
     readonly buildQueueManager: AsyncTaskManager;
-    protected constructor(name: string, isAsyncSupported?: boolean);
+    constructor(name: string, isAsyncSupported?: boolean);
     checkOptions(): Promise<any>;
     abstract build(appOutDir: string, arch: Arch): Promise<any>;
     finishBuild(): Promise<any>;
 }
 export interface TargetSpecificOptions {
     /**
-     The [artifact file name template](./configuration.md#artifact-file-name-template).
+     The [artifact file name template](https://www.electron.build/configuration#artifact-file-name-template).
      */
     readonly artifactName?: string | null;
     publish?: Publish;

package/out/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arch, archFromString, ArchType, AsyncTaskManager } from \"builder-util\"\nimport { AllPublishOptions, CancellationToken, Nullish } from \"builder-util-runtime\"\n\n// https://github.com/YousefED/typescript-json-schema/issues/80\nexport type Publish = AllPublishOptions | Array<AllPublishOptions> | null\n\nexport type TargetConfigType = Array<string | TargetConfiguration> | string | TargetConfiguration | null\n\nexport interface TargetConfiguration {\n  /**\n   * The target name. e.g. `snap`.\n   */\n  readonly target: string\n\n  /**\n   * The arch or list of archs.\n   */\n  readonly arch?: Array<ArchType> | ArchType\n}\n\nexport class Platform {\n  static MAC = new Platform(\"mac\", \"mac\", \"darwin\")\n  static LINUX = new Platform(\"linux\", \"linux\", \"linux\")\n  static WINDOWS = new Platform(\"windows\", \"win\", \"win32\")\n\n  constructor(\n    public name: string,\n    public buildConfigurationKey: string,\n    public nodeName: NodeJS.Platform\n  ) {}\n\n  toString() {\n    return this.name\n  }\n\n  createTarget(type?: string | Array<string> | null, ...archs: Array<Arch>): Map<Platform, Map<Arch, Array<string>>> {\n    if (type == null && (archs == null || archs.length === 0)) {\n      return new Map([[this, new Map()]])\n    }\n\n    const archToType = new Map()\n\n    for (const arch of archs == null || archs.length === 0 ? [archFromString(process.arch)] : archs) {\n      archToType.set(arch, type == null ? [] : Array.isArray(type) ? type : [type])\n    }\n    return new Map([[this, archToType]])\n  }\n\n  static current(): Platform {\n    return Platform.fromString(process.platform)\n  }\n\n  static fromString(name: string): Platform {\n    name = name.toLowerCase()\n    switch (name) {\n      case Platform.MAC.nodeName:\n      case Platform.MAC.name:\n        return Platform.MAC\n\n      case Platform.WINDOWS.nodeName:\n      case Platform.WINDOWS.name:\n      case Platform.WINDOWS.buildConfigurationKey:\n        return Platform.WINDOWS\n\n      case Platform.LINUX.nodeName:\n        return Platform.LINUX\n\n      default:\n        throw new Error(`Unknown platform: ${name}`)\n    }\n  }\n}\n\nexport abstract class Target {\n  abstract readonly outDir: string\n  abstract readonly options: TargetSpecificOptions | Nullish\n\n  // use only for tasks that cannot be executed in parallel (such as signing on windows and hdiutil on macOS due to file locking)\n  readonly buildQueueManager = new AsyncTaskManager(new CancellationToken())\n\n  protected constructor(\n    readonly name: string,\n    readonly isAsyncSupported: boolean = true\n  ) {}\n\n  async checkOptions(): Promise<any> {\n    // ignore\n  }\n\n  abstract build(appOutDir: string, arch: Arch): Promise<any>\n\n  async finishBuild(): Promise<any> {\n    await this.buildQueueManager.awaitTasks()\n  }\n}\n\nexport interface TargetSpecificOptions {\n  /**\n   The [artifact file name template](./configuration.md#artifact-file-name-template).\n   */\n  readonly artifactName?: string | null\n\n  publish?: Publish\n}\n\nexport const DEFAULT_TARGET = \"default\"\nexport const DIR_TARGET = \"dir\"\n\nexport type CompressionLevel = \"store\" | \"normal\" | \"maximum\"\n\nexport interface BeforeBuildContext {\n  readonly appDir: string\n  readonly electronVersion: string\n  readonly platform: Platform\n  readonly arch: string\n}\n\nexport interface SourceRepositoryInfo {\n  type?: string\n  domain?: string\n  user: string\n  project: string\n}\n"]}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arch, archFromString, ArchType, AsyncTaskManager } from \"builder-util\"\nimport { AllPublishOptions, CancellationToken, Nullish } from \"builder-util-runtime\"\n\n// https://github.com/YousefED/typescript-json-schema/issues/80\nexport type Publish = AllPublishOptions | Array<AllPublishOptions> | null\n\nexport type TargetConfigType = Array<string | TargetConfiguration> | string | TargetConfiguration | null\n\nexport interface TargetConfiguration {\n  /**\n   * The target name. e.g. `snap`.\n   */\n  readonly target: string\n\n  /**\n   * The arch or list of archs.\n   */\n  readonly arch?: Array<ArchType> | ArchType\n}\n\nexport class Platform {\n  static MAC = new Platform(\"mac\", \"mac\", \"darwin\")\n  static LINUX = new Platform(\"linux\", \"linux\", \"linux\")\n  static WINDOWS = new Platform(\"windows\", \"win\", \"win32\")\n\n  constructor(\n    public name: string,\n    public buildConfigurationKey: string,\n    public nodeName: NodeJS.Platform\n  ) {}\n\n  toString() {\n    return this.name\n  }\n\n  createTarget(type?: string | Array<string> | null, ...archs: Array<Arch>): Map<Platform, Map<Arch, Array<string>>> {\n    if (type == null && (archs == null || archs.length === 0)) {\n      return new Map([[this, new Map()]])\n    }\n\n    const archToType = new Map()\n\n    for (const arch of archs == null || archs.length === 0 ? [archFromString(process.arch)] : archs) {\n      archToType.set(arch, type == null ? [] : Array.isArray(type) ? type : [type])\n    }\n    return new Map([[this, archToType]])\n  }\n\n  static current(): Platform {\n    return Platform.fromString(process.platform)\n  }\n\n  static fromString(name: string): Platform {\n    name = name.toLowerCase()\n    switch (name) {\n      case Platform.MAC.nodeName:\n      case Platform.MAC.name:\n        return Platform.MAC\n\n      case Platform.WINDOWS.nodeName:\n      case Platform.WINDOWS.name:\n      case Platform.WINDOWS.buildConfigurationKey:\n        return Platform.WINDOWS\n\n      case Platform.LINUX.nodeName:\n        return Platform.LINUX\n\n      default:\n        throw new Error(`Unknown platform: ${name}`)\n    }\n  }\n}\n\nexport abstract class Target {\n  abstract readonly outDir: string\n  abstract readonly options: TargetSpecificOptions | Nullish\n\n  // use only for tasks that cannot be executed in parallel (such as signing on windows and hdiutil on macOS due to file locking)\n  readonly buildQueueManager = new AsyncTaskManager(new CancellationToken())\n\n  public constructor(\n    readonly name: string,\n    readonly isAsyncSupported: boolean = true\n  ) {}\n\n  async checkOptions(): Promise<any> {\n    // ignore\n  }\n\n  abstract build(appOutDir: string, arch: Arch): Promise<any>\n\n  async finishBuild(): Promise<any> {\n    await this.buildQueueManager.awaitTasks()\n  }\n}\n\nexport interface TargetSpecificOptions {\n  /**\n   The [artifact file name template](https://www.electron.build/configuration#artifact-file-name-template).\n   */\n  readonly artifactName?: string | null\n\n  publish?: Publish\n}\n\nexport const DEFAULT_TARGET = \"default\"\nexport const DIR_TARGET = \"dir\"\n\nexport type CompressionLevel = \"store\" | \"normal\" | \"maximum\"\n\nexport interface BeforeBuildContext {\n  readonly appDir: string\n  readonly electronVersion: string\n  readonly platform: Platform\n  readonly arch: string\n}\n\nexport interface SourceRepositoryInfo {\n  type?: string\n  domain?: string\n  user: string\n  project: string\n}\n"]}

package/out/electron/ElectronFramework.d.ts

@@ -1,6 +1,8 @@
 import { Configuration } from "../configuration";
 import { Framework } from "../Framework";
 import { Packager } from "../index";
+import { ElectronDownloadOptions } from "../util/electronGet";
+export { ElectronDownloadOptions };
 export type ElectronPlatformName = "darwin" | "linux" | "win32" | "mas";
 /**
  * Electron distributables branding options.
@@ -11,23 +13,4 @@ export interface ElectronBrandingOptions {
     productName?: string;
 }
 export declare function createBrandingOpts(opts: Configuration): Required<ElectronBrandingOptions>;
-export interface ElectronDownloadOptions {
-    version?: string;
-    /**
-     * The [cache location](https://github.com/electron-userland/electron-download#cache-location).
-     */
-    cache?: string | null;
-    /**
-     * The mirror.
-     */
-    mirror?: string | null;
-    /** @private */
-    customDir?: string | null;
-    /** @private */
-    customFilename?: string | null;
-    strictSSL?: boolean;
-    isVerifyChecksum?: boolean;
-    platform?: ElectronPlatformName;
-    arch?: string;
-}
 export declare function createElectronFrameworkSupport(configuration: Configuration, packager: Packager): Promise<Framework>;