@todesktop/cli 1.12.3 → 1.13.0-0

package/dist/cli.js

@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/index.ts
 var import_commander = require("commander");
 var import_ink39 = require("ink");
-var import_react25 = require("react");
+var import_react24 = require("react");
 var import_register = require("source-map-support/register");
 
 // src/commands/build/components/Build.tsx
@@ -1511,24 +1511,125 @@ var schema_default = {
     required: ["id", "icon", "schemaVersion"]
   },
   properties: {
+    $schema: {
+      type: "string",
+      description: "To enable JSON validation and IntelliSense for your `todesktop.json` file in compatible code editors, your editor needs to know where the schema file is located. You can add a `$schema` property to the top of your `todesktop.json` file, pointing to a version of the schema. This can be a local path or a hosted URL.",
+      examples: [
+        "https://unpkg.com/@todesktop/cli@1.12.5/schemas/schema.json",
+        "./node_modules/@todesktop/cli/schemas/schema.json"
+      ]
+    },
     appBuilderLibVersion: {
+      $ref: "#/definitions/appBuilderLibVersionProperty"
+    },
+    appId: { $ref: "#/definitions/appIdProperty" },
+    appFiles: { $ref: "#/definitions/appFilesProperty" },
+    appProtocolScheme: { $ref: "#/definitions/appProtocolSchemeProperty" },
+    appPath: { $ref: "#/definitions/appPathProperty" },
+    asar: { $ref: "#/definitions/asarProperty" },
+    asarUnpack: { $ref: "#/definitions/asarUnpackProperty" },
+    buildVersion: { $ref: "#/definitions/buildVersionProperty" },
+    copyright: { $ref: "#/definitions/copyrightProperty" },
+    electronMirror: { $ref: "#/definitions/electronMirrorProperty" },
+    electronVersion: { $ref: "#/definitions/electronVersionProperty" },
+    extends: {
+      type: "string",
+      minLength: 1,
+      description: "This is the path to a base configuration file. This is especially useful for configuration sharing between staging and production builds. The base configuration file can be a relative path from the project root or an absolute path.",
+      examples: ["./todesktop.staging.json"],
+      default: null
+    },
+    extraContentFiles: { $ref: "#/definitions/extraContentFilesProperty" },
+    extraResources: { $ref: "#/definitions/extraResourcesProperty" },
+    fileAssociations: { $ref: "#/definitions/fileAssociationsProperty" },
+    updateUrlBase: { $ref: "#/definitions/updateUrlBaseProperty" },
+    filesForDistribution: {
+      $ref: "#/definitions/filesForDistributionProperty"
+    },
+    icon: {
+      type: "string",
+      description: "The path to your application's desktop icon. It must be an ICNS or PNG.",
+      examples: ["./appIcon.png"],
+      file: {
+        extensions: ["icns", "png"],
+        mustBeFile: true
+      },
+      minLength: 3
+    },
+    linux: { $ref: "#/definitions/linuxConfigProperty" },
+    id: {
+      type: "string",
+      minLength: 1,
+      description: "Your ToDesktop application ID. This is used to identify your app. This would have been generated when you first created your ToDesktop application via the web interface.",
+      examples: ["2005223bd1nqpl7"]
+    },
+    includeSubNodeModules: {
+      $ref: "#/definitions/includeSubNodeModulesProperty"
+    },
+    mac: { $ref: "#/definitions/macConfigProperty" },
+    mas: { $ref: "#/definitions/masConfigProperty" },
+    dmg: { $ref: "#/definitions/dmgConfigProperty" },
+    nodeVersion: { $ref: "#/definitions/nodeVersionProperty" },
+    npmVersion: { $ref: "#/definitions/npmVersionProperty" },
+    pnpmVersion: { $ref: "#/definitions/pnpmVersionProperty" },
+    packageJson: { $ref: "#/definitions/packageJsonProperty" },
+    packageManager: { $ref: "#/definitions/packageManagerProperty" },
+    rebuildLibrary: { $ref: "#/definitions/rebuildLibraryProperty" },
+    schemaVersion: {
+      type: "number",
+      minimum: 1,
+      maximum: 1,
+      description: "This is the `todesktop.json` schema version. This must be `1`.",
+      examples: [1]
+    },
+    snap: { $ref: "#/definitions/snapConfigProperty" },
+    uploadSizeLimit: { $ref: "#/definitions/uploadSizeLimitProperty" },
+    windows: { $ref: "#/definitions/windowsConfigProperty" },
+    platformOverrides: {
+      type: "object",
+      additionalProperties: false,
+      description: "This option allows you to specify platform-specific configurations for Windows, macOS, and Linux builds. Most top-level configuration fields available in `todesktop.json` can be overridden within the `windows`, `mac`, or `linux` objects under `platformOverrides`.",
+      default: {},
+      properties: {
+        windows: {
+          $ref: "#/definitions/platformOverridableProperties"
+        },
+        mac: {
+          $ref: "#/definitions/platformOverridableProperties"
+        },
+        linux: {
+          $ref: "#/definitions/platformOverridableProperties"
+        }
+      }
+    }
+  },
+  definitions: {
+    appBuilderLibVersionProperty: {
       type: "string",
       validSemver: {},
-      minLength: 1
+      minLength: 1,
+      description: "The version of app-builder-lib that ToDesktop should use for building your app. This can be useful if you need to use a specific version that includes certain features or fixes.",
+      examples: ["22.14.13"]
     },
-    appId: {
+    appIdProperty: {
       type: "string",
-      minLength: 1
+      minLength: 1,
+      description: "Your application ID. Omit this unless you know what you're doing. It's used as the [CFBundleIdentifier](https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-102070) for MacOS and as the [Application User Model ID](<https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx>) for Windows.",
+      examples: ["com.microsoft.word"],
+      default: "auto-generated"
     },
-    appFiles: {
+    appFilesProperty: {
       type: "array",
+      description: "This option allows you to decide which files get uploaded to be built on the ToDesktop servers. By default, all files in your app path are included in your app, except for `node_modules` and `.git`. Dependencies are installed on our build servers as there could be platform-specific postinstall steps.",
+      default: ["**"],
+      examples: ['["dist/**", "!static/**"]'],
       items: {
         type: "string",
         minLength: 1
       },
       minItems: 1
     },
-    appProtocolScheme: {
+    appProtocolSchemeProperty: {
       oneOf: [
         {
           type: "string",
@@ -1542,20 +1643,27 @@ var schema_default = {
           },
           minItems: 1
         }
-      ]
+      ],
+      description: 'If you want to register a protocol for your application (e.g. `example://`) and or support deeplinking, you will need to use this option. If your desired protocol is `example://`, you would set `"appProtocolScheme": "example"`. NOTE: these features also require additional application logic.',
+      examples: ["word", '["word", "excel"]'],
+      default: "no protocol scheme is registered"
     },
-    appPath: {
+    appPathProperty: {
       type: "string",
+      description: "This is the path to your Electron application directory. Omit this unless your project setup is complicated. This is the directory that the CLI uploads.",
+      default: ".",
+      examples: ["./dist"],
       file: {
         isOptional: true,
         mustBeElectronApp: true
       }
     },
-    asar: {
+    asarProperty: {
       type: "boolean",
-      default: true
+      default: true,
+      description: "Whether to package your application's source code within an asar archive. You should only turn this off if you have a good reason to."
     },
-    asarUnpack: {
+    asarUnpackProperty: {
       oneOf: [
         {
           type: "boolean"
@@ -1568,30 +1676,41 @@ var schema_default = {
           },
           minItems: 1
         }
-      ]
+      ],
+      description: "This option allows you to decide which files get unpacked from the asar archive. By default we unpack all native `*.node` files.",
+      default: ["**/*.node"]
     },
-    buildVersion: {
+    buildVersionProperty: {
       type: "string",
-      minLength: 1
+      minLength: 1,
+      description: "The build version. Maps to the CFBundleVersion on macOS, and FileVersion metadata property on Windows.",
+      default: "auto-generated from build id"
     },
-    copyright: {
+    copyrightProperty: {
       type: "string",
-      minLength: 1
+      minLength: 1,
+      description: "The human-readable copyright line for the app.",
+      examples: ["Copyright \xA9 1995 Walt Disney"],
+      default: "The `package.json` [productName](#recommendations-for-app-packagejson) / `name`."
     },
-    electronMirror: {
+    electronMirrorProperty: {
       type: "string",
-      format: "uri"
+      format: "uri",
+      description: "The base URL of the mirror to download Electron from. This may be a mirror geographically closer to you or even your own mirror which contains custom Electron builds. The version downloaded is the Electron version specified in `devDependencies` in your app's `package.json`. Alternatively you can explicitly specify an `electronVersion` in `todesktop.json` as described below.",
+      examples: ["https://cdn.npm.taobao.org/dist/electron/"],
+      default: "Electron is downloaded from the main official source."
     },
-    electronVersion: {
+    electronVersionProperty: {
       type: "string",
-      minLength: 1
+      minLength: 1,
+      description: "The version of Electron to use. In most cases you should not specify an `electronVersion` property. Only specify this option if you wish to override the version that is specified in `package.json`.",
+      examples: ["12.0.7-beta.17"],
+      default: "Electron version specified in `devDependencies` in your app's `package.json`"
     },
-    extends: {
-      type: "string",
-      minLength: 1
-    },
-    extraContentFiles: {
+    extraContentFilesProperty: {
       type: "array",
+      description: "This option allows you specify files to be copied into the application's content directory (`Contents` for MacOS, root directory for Linux and Windows).",
+      default: [],
       items: {
         type: "object",
         required: ["from"],
@@ -1607,8 +1726,10 @@ var schema_default = {
         }
       }
     },
-    extraResources: {
+    extraResourcesProperty: {
       type: "array",
+      description: "This option allows you to specify files to be copied into the application's resources directory (`Contents/Resources` for MacOS, `resources` for Linux and Windows). It works just like the `extraContentFiles` option, except the files go to a different directory.",
+      default: [],
       items: {
         type: "object",
         required: ["from"],
@@ -1626,8 +1747,9 @@ var schema_default = {
         }
       }
     },
-    fileAssociations: {
+    fileAssociationsProperty: {
       type: "array",
+      description: "Associate a file type with your Electron app.",
       items: {
         type: "object",
         required: ["ext"],
@@ -1646,69 +1768,84 @@ var schema_default = {
                   minLength: 1
                 }
               }
-            ]
+            ],
+            description: "The extension (minus the leading period). e.g. png."
           },
           description: {
             type: "string",
-            minLength: 1
+            minLength: 1,
+            description: "windows-only. The description."
           },
           name: {
             type: "string",
-            minLength: 1
+            minLength: 1,
+            description: "The name. e.g. PNG. Defaults to value of `ext`."
           },
           mimeType: {
             type: "string",
-            minLength: 1
+            minLength: 1,
+            description: "linux-only. The mime-type."
           },
           icon: {
             type: "string",
-            minLength: 1
+            minLength: 1,
+            description: 'macOS and windows. Icon file name without extension. It points to ico file for Windows and icns for macOS. For example, if the `icon` value is `"icons/py"` then it will look for both `"icons/py.ico"` and `"icons/py.icns"` in your project directory.'
           },
           role: {
             type: "string",
-            minLength: 1
+            minLength: 1,
+            description: "macOS-only. The app's role with respect to the type. The value can be `Editor`, `Viewer`, `Shell`, or `None`. Corresponds to `CFBundleTypeRole`.",
+            default: "Editor"
           },
           isPackage: {
-            type: "boolean"
+            type: "boolean",
+            description: "macOS-only. Whether the document is distributed as a bundle. If set to true, the bundle directory is treated as a file. Corresponds to `LSTypeIsPackage`."
           },
           rank: {
             type: "string",
-            enum: ["Owner", "Default", "Alternate", "None"]
+            enum: ["Owner", "Default", "Alternate", "None"],
+            description: "macOS-only. Determines how Launch Services ranks this app among the apps that declare themselves editors or viewers of files of this type. The possible values are: `Owner` (this app is the primary creator of files of this type), `Default` (this app is an opener of files of this type; this value is also used if no rank is specified), `Alternate` (this app is a secondary viewer of files of this type), and `None` (this app is never selected to open files of this type, but it accepts drops of files of this type).",
+            default: "Default"
           }
         }
       },
       minItems: 1
     },
-    updateUrlBase: {
+    updateUrlBaseProperty: {
       type: "string",
-      format: "uri"
+      format: "uri",
+      description: "The URL to check for updates. You should only set this if you want to use your own self-hosted update server instead of ToDesktop's built-in update service. See https://www.github.com/ToDesktop/self-hosted for more information.",
+      examples: ["https://example.com/updates"],
+      default: "ToDesktop's auto-update URL."
     },
-    filesForDistribution: {
+    filesForDistributionProperty: {
       type: "array",
+      description: "This option allows you to explicitly exclude or include certain files in the packaged version of your app. These files are filtered _after_ the build step which happens on the ToDesktop servers.",
+      examples: [
+        '["!**/node_modules/realm/android/**", "!**/design/**"]'
+      ],
       items: {
         type: "string",
         minLength: 1
       },
       minItems: 1
     },
-    icon: {
-      type: "string",
-      file: {
-        extensions: ["icns", "png"],
-        mustBeFile: true
-      },
-      minLength: 3
-    },
-    linux: {
+    linuxConfigProperty: {
       type: "object",
+      description: "This object contains some options that only apply to the building & releasing for Linux.",
+      examples: ['{ "category": "Utility"}'],
       additionalProperties: false,
       properties: {
         category: {
           type: "string",
-          minLength: 1
+          minLength: 1,
+          description: "The [application category](https://specifications.freedesktop.org/menu-spec/latest/apa.html#main-category-registry).",
+          examples: ["Utility"]
         },
         icon: {
           type: "string",
+          description: "The path to your application's Linux desktop icon. It must be an ICNS or PNG.",
+          examples: ["./linux-icon.png"],
           file: {
             extensions: ["icns", "png"],
             mustBeFile: true
@@ -1717,31 +1854,40 @@ var schema_default = {
         },
         imageVersion: {
           type: "string",
-          minLength: 1
+          minLength: 1,
+          description: "The version of the Linux image that ToDesktop should use to build your app.",
+          examples: ["0.1.0"],
+          default: "0.0.11"
         },
         noSandbox: {
-          type: "boolean"
+          type: "boolean",
+          description: "This option allows you to configure whether your app should run in a sandboxed environment.",
+          default: true
         }
       }
     },
-    id: {
-      type: "string",
-      minLength: 1
-    },
-    includeSubNodeModules: {
+    includeSubNodeModulesProperty: {
       type: "boolean",
-      default: false
+      default: false,
+      description: "Whether to include **all** of the submodules node_modules directories"
     },
-    mac: {
+    macConfigProperty: {
       type: "object",
+      description: "This object contains some options that only apply to the building & releasing for MacOS.",
+      examples: ['{ "entitlements": "./entitlements.mac.plist" }'],
       additionalProperties: false,
       properties: {
         category: {
           type: "string",
-          minLength: 1
+          minLength: 1,
+          description: "The application category type, as shown in the Finder via _View -> Arrange by Application Category_ when viewing the Applications directory.",
+          examples: ["public.app-category.productivity"]
         },
         additionalBinariesToSign: {
           type: "array",
+          description: "Paths of any extra binaries that need to be signed. These could be files in your own app code or `node_modules`.",
+          examples: ['["./node_modules/example-package/example-file"]'],
+          default: [],
           items: {
             type: "string",
             minLength: 1
@@ -1749,6 +1895,9 @@ var schema_default = {
         },
         entitlements: {
           type: "string",
+          description: "The path to an entitlements file for signing your application. It must be a plist file.",
+          examples: ["./entitlements.mac.plist"],
+          default: "A sane minimal entitlements file we've put together.",
           file: {
             extensions: ["plist"],
             mustBeFile: true
@@ -1757,6 +1906,9 @@ var schema_default = {
         },
         entitlementsInherit: {
           type: "string",
+          description: "The path to a child entitlements file for signing your application. It must be a plist file.",
+          examples: ["./entitlementsInherit.mac.plist"],
+          default: "No entitlements file is provided by default.",
           file: {
             extensions: ["plist"],
             mustBeFile: true
@@ -1764,10 +1916,15 @@ var schema_default = {
           minLength: 1
         },
         extendInfo: {
-          type: "object"
+          type: "object",
+          description: "Extra entries for `Info.plist`.",
+          examples: ['{ "NSUserNotificationAlertStyle": "alert" }'],
+          default: {}
         },
         icon: {
           type: "string",
+          description: "The path to your application's Mac desktop icon. It must be an ICNS or PNG.",
+          examples: ["./mac-icon.png"],
           file: {
             extensions: ["icns", "png"],
             mustBeFile: true
@@ -1776,6 +1933,9 @@ var schema_default = {
         },
         requirements: {
           type: "string",
+          description: "The path to the [requirements file](https://developer.apple.com/library/archive/documentation/Security/Conceptual/CodeSigningGuide/RequirementLang/RequirementLang.html) used when signing your application.",
+          examples: ["./requirements.txt"],
+          default: "No requirements file is used by default.",
           file: {
             extensions: ["txt"],
             mustBeFile: true
@@ -1784,12 +1944,17 @@ var schema_default = {
         }
       }
     },
-    mas: {
+    masConfigProperty: {
       type: "object",
+      description: "This object contains options that only apply to building the application for Mac App Store.",
+      examples: ['{ "type": "development" }'],
       additionalProperties: false,
       properties: {
         entitlements: {
           type: "string",
+          description: "The path to an entitlements file for signing your application. It must be a plist file.",
+          examples: ["./entitlements.mas.plist"],
+          default: "No entitlements file is provided by default.",
           file: {
             extensions: ["plist"],
             mustBeFile: true
@@ -1798,6 +1963,9 @@ var schema_default = {
         },
         entitlementsInherit: {
           type: "string",
+          description: "The path to a child entitlements file for signing your application. It must be a plist file.",
+          examples: ["./entitlementsInherit.mas.plist"],
+          default: "No entitlements file is provided by default.",
           file: {
             extensions: ["plist"],
             mustBeFile: true
@@ -1806,6 +1974,9 @@ var schema_default = {
         },
         provisioningProfile: {
           type: "string",
+          description: "The path to a provisioning profile for authorizing your application.",
+          examples: ["./mas.provisionprofile"],
+          default: "No provisioning profile is used by default.",
           file: {
             extensions: ["provisionprofile"],
             mustBeFile: true
@@ -1814,19 +1985,29 @@ var schema_default = {
         },
         type: {
           type: "string",
-          enum: ["development", "distribution"]
+          enum: ["development", "distribution"],
+          description: "Whether to sign app for development or for distribution.",
+          examples: ["distribution"],
+          default: "development"
         },
         x64ArchFiles: {
-          type: "string"
+          type: "string",
+          description: "Minimatch pattern of paths that are allowed to be x64 binaries in both ASAR files.",
+          examples: ["Contents/Resources/foobar/**"],
+          default: "not defined"
         }
       }
     },
-    dmg: {
+    dmgConfigProperty: {
       type: "object",
+      description: "Options for customizing the macOS DMG (disk image) installer.",
       additionalProperties: false,
       properties: {
         background: {
           type: "string",
+          description: "The path to the DMG installer's background image. It must be a `.tiff` file. The resolution of this file determines the resolution of the installer window. Typically, backgrounds are 540x380.",
+          examples: ["./mac-dmg-background.tiff"],
+          default: "undefined",
           file: {
             extensions: ["tiff"],
             mustBeFile: true
@@ -1835,94 +2016,124 @@ var schema_default = {
         },
         artifactName: {
           type: "string",
-          minLength: 1
+          minLength: 1,
+          description: "The artifact name of the DMG file. Macros ${productName}, ${version}, ${name} are supported."
         },
         backgroundColor: {
           type: "string",
-          minLength: 1
+          minLength: 1,
+          description: 'The background color (accepts css colors). Defaults to "`#ffffff`" (white) if no background image.',
+          default: "#ffffff"
         },
         iconSize: {
-          type: "number"
+          type: "number",
+          description: "The size of all the icons inside the DMG. Defaults to `80`.",
+          default: 80
         },
         iconTextSize: {
-          type: "number"
+          type: "number",
+          description: "The size of all the icon texts inside the DMG. Defaults to `12`.",
+          default: 12
         },
         title: {
           type: "string",
-          minLength: 1
+          minLength: 1,
+          description: "The title of the produced DMG, which will be shown when mounted (volume name). Macro `${productName}`, `${version}` and `${name}` are supported.",
+          default: "${productName} ${version}"
         },
         contents: {
           type: "array",
+          description: "Customize icon locations. The x and y coordinates refer to the position of the center of the icon (at 1x scale), and do not take the label into account.",
           items: {
             type: "object",
             additionalProperties: false,
             properties: {
               x: {
-                type: "number"
+                type: "number",
+                description: "The device-independent pixel offset from the left of the window to the center of the icon."
               },
               y: {
-                type: "number"
+                type: "number",
+                description: "The device-independent pixel offset from the top of the window to the center of the icon."
               }
             }
           }
         },
         window: {
           type: "object",
+          description: "The DMG windows position and size. In most cases, you will only want to specify a `height` and `width` value but not `x` and `y`.",
           additionalProperties: false,
           properties: {
             x: {
-              type: "number"
+              type: "number",
+              description: "The X position relative to left of the screen."
             },
             y: {
-              type: "number"
+              type: "number",
+              description: "The Y position relative to top of the screen."
             },
             width: {
-              type: "number"
+              type: "number",
+              description: "The width. Defaults to background image width or 540."
             },
             height: {
-              type: "number"
+              type: "number",
+              description: "The height. Defaults to background image height or 380."
             }
           }
         }
       }
     },
-    nodeVersion: {
+    nodeVersionProperty: {
       type: "string",
       validSemver: {},
-      minLength: 1
+      minLength: 1,
+      description: "The version of Node.js that ToDesktop should use to build your app.",
+      examples: ["18.12.1"]
     },
-    npmVersion: {
+    npmVersionProperty: {
       type: "string",
       validSemver: {},
-      minLength: 1
+      minLength: 1,
+      description: "The version of NPM that ToDesktop should use for installation.",
+      examples: ["9.8.1"]
     },
-    pnpmVersion: {
+    pnpmVersionProperty: {
       type: "string",
       validSemver: {},
-      minLength: 1
+      minLength: 1,
+      description: "The version of pnpm that ToDesktop should use for installation.",
+      examples: ["8.10.5"]
     },
-    packageJson: {
-      type: "object"
+    packageJsonProperty: {
+      type: "object",
+      description: "If you want to override the default `package.json` configuration, use the `packageJson` property. For example, you can use this to override the `productName` or `version` properties.",
+      default: {}
     },
-    packageManager: {
+    packageManagerProperty: {
       type: "string",
-      enum: ["npm", "yarn", "pnpm"]
+      enum: ["npm", "yarn", "pnpm"],
+      description: "The package manager to use when installing dependencies. Valid values are `npm`, `yarn` or `pnpm`.",
+      examples: ["yarn"],
+      default: "If `yarn.lock` exists, `yarn` is used. If `pnpm-lock.yaml` or `shrinkwrap.yaml` exists, `pnpm` is used. Otherwise, `npm` is used."
     },
-    rebuildLibrary: {
+    rebuildLibraryProperty: {
       type: "string",
-      enum: ["app-builder", "@electron/rebuild"]
-    },
-    schemaVersion: {
-      type: "number",
-      minimum: 1,
-      maximum: 1
+      enum: ["app-builder", "@electron/rebuild"],
+      description: "The library that ToDesktop should use for rebuilding native modules. Valid values are `app-builder` or `@electron/rebuild`.",
+      default: "app-builder"
     },
-    snap: {
+    snapConfigProperty: {
       type: "object",
+      description: "This object contains some options that only apply to the building for the [Snap Store](https://snapcraft.io/store).",
+      examples: ['{ "confinement": "classic", "grade": "devel" }'],
       additionalProperties: false,
       properties: {
         after: {
           type: "array",
+          description: "Ensures that all the part names listed are staged before the app part begins its [lifecycle](https://snapcraft.io/docs/parts-lifecycle#heading--steps).",
+          default: ["desktop-gtk2"],
+          examples: ['["launch-scripts"]'],
           items: {
             type: "string",
             minLength: 1
@@ -1930,6 +2141,9 @@ var schema_default = {
         },
         appPartStage: {
           type: "array",
+          description: "Specifies which files from the app part to stage and which to exclude. Individual files, directories, wildcards, globstars, and exclusions are accepted. See [Snapcraft filesets](https://snapcraft.io/docs/snapcraft-filesets) to learn more about the format.",
+          examples: ['["-usr/lib/python*"]'],
+          default: "See [snap.ts](https://github.com/electron-userland/electron-builder/blob/master/packages/app-builder-lib/templates/snap/snapcraft.yaml#L29).",
           items: {
             type: "string",
             minLength: 1
@@ -1948,16 +2162,30 @@ var schema_default = {
                 minLength: 1
               }
             }
-          ]
+          ],
+          description: "The list of features that must be supported by the core in order for this snap to install. To learn more, see the [Snapcraft docs](https://snapcraft.io/docs/snapcraft-top-level-metadata#heading--assumes).",
+          examples: ["snapd2.38"],
+          default: "undefined"
         },
         autoStart: {
-          type: "boolean"
+          type: "boolean",
+          description: "Whether or not the snap should automatically start on login.",
+          default: false,
+          examples: [true]
         },
         base: {
-          type: "string"
+          type: "string",
+          description: "The base snap to use for building this snap.",
+          default: "core18",
+          examples: ["core20"]
         },
         buildPackages: {
           type: "array",
+          description: "The list of debian packages needs to be installed for building this snap.",
+          default: [],
+          examples: [
+            '["libssl-dev", "libssh-dev", "libncursesw5-dev"]'
+          ],
           items: {
             type: "string",
             minLength: 1
@@ -1965,20 +2193,50 @@ var schema_default = {
         },
         confinement: {
           type: "string",
-          enum: ["classic", "devmode", "strict"]
+          enum: ["classic", "devmode", "strict"],
+          description: "The type of [confinement](https://snapcraft.io/docs/reference/confinement) supported by the snap. `devmode`, `strict`, or `classic`.",
+          default: "strict",
+          examples: ["classic"]
         },
         environment: {
-          type: "object"
+          type: "object",
+          description: "The custom environment. If you set this, it will be merged with the default.",
+          default: { TMPDIR: "$XDG_RUNTIME_DIR" },
+          examples: ['{"TMPDIR": "$XDG_RUNTIME_DIR"}']
         },
         grade: {
           type: "string",
-          enum: ["devel", "stable"]
+          enum: ["devel", "stable"],
+          description: 'The quality grade of the snap. It can be either `devel` (i.e. a development version of the snap, so not to be published to the "stable" or "candidate" channels) or `stable` (i.e. a stable release or release candidate, which can be released to all channels).',
+          default: "stable",
+          examples: ["devel"]
         },
         layout: {
-          type: "object"
+          type: "object",
+          description: "Specifies any files to make accessible from locations such as `/usr`, `/var`, and `/etc`. See [snap layouts](https://snapcraft.io/docs/snap-layouts) to learn more.",
+          default: "undefined",
+          examples: [
+            '{ "/var/lib/foo": { "bind": "$SNAP_DATA/var/lib/foo" } }'
+          ]
         },
         plugs: {
           type: "array",
+          description: 'The list of [plugs](https://snapcraft.io/docs/reference/interfaces). If list contains `default`, it will be replaced with the default list, so, `["default", "foo"]` can be used to add a custom plug `foo` in addition to the default list.',
+          default: [
+            "desktop",
+            "desktop-legacy",
+            "home",
+            "x11",
+            "unity7",
+            "browser-support",
+            "network",
+            "gsettings",
+            "pulseaudio",
+            "opengl"
+          ],
+          examples: [
+            '[ "default", { "browser-sandbox": { "interface": "browser-support", "allow-sandbox": true } }, "another-simple-plug-name" ]'
+          ],
           items: {
             anyOf: [
               {
@@ -1993,6 +2251,19 @@ var schema_default = {
         },
         stagePackages: {
           type: "array",
+          description: 'The list of Ubuntu packages to use that are needed to support the app part creation. Like `depends` for deb. If list contains `default`, it will be replaced with the default list, so, `["default", "foo"]` can be used to add custom package `foo` in addition to the defaults.',
+          default: [
+            "libasound2",
+            "libgconf2-4",
+            "libnotify4",
+            "libnspr4",
+            "libnss3",
+            "libpcre3",
+            "libpulse0",
+            "libxss1",
+            "libxtst6"
+          ],
+          examples: ['["default", "depends"]'],
           items: {
             type: "string",
             minLength: 1
@@ -2000,22 +2271,35 @@ var schema_default = {
         },
         summary: {
           type: "string",
-          maxLength: 78
+          maxLength: 78,
+          description: "A sentence summarising the snap. Max len. 78 characters, describing the snap in short and simple terms.",
+          default: "The [productName](#recommendations-for-app-packagejson).",
+          examples: ["The super cat generator"]
         },
         useTemplateApp: {
-          type: "boolean"
+          type: "boolean",
+          description: "Whether to use a template snap.",
+          default: "true if `stagePackages` is not specified.",
+          examples: [false]
         }
       }
     },
-    uploadSizeLimit: {
-      type: "number"
+    uploadSizeLimitProperty: {
+      type: "number",
+      description: "The max upload size (in MB). Before uploading your files to our servers, we check that the total file size is less than this number. If you are accidentally including unneccesary files in your app, check out the `appPath` and `appFiles` options.",
+      default: 20,
+      examples: [35]
     },
-    windows: {
+    windowsConfigProperty: {
       type: "object",
+      description: "This object contains some options that only apply to the building & releasing for Windows.",
+      examples: ['{ "icon": "./icon.ico" }'],
       additionalProperties: false,
       properties: {
         icon: {
           type: "string",
+          description: "The path to your application's Windows desktop icon. It must be an ICO, ICNS, or PNG.",
+          examples: ["./icon.ico"],
           file: {
             extensions: ["icns", "png", "icon"],
             mustBeFile: true
@@ -2024,24 +2308,33 @@ var schema_default = {
         },
         nsisCustomBinary: {
           type: "object",
+          description: "Allows you to provide your own makensis, such as one with support for debug logging via LogSet and LogText. (Logging also requires option debugLogging = true). It's not recommended to use it for production build.",
+          default: "undefined",
           additionalProperties: false,
           properties: {
             checksum: {
-              type: "string"
+              type: "string",
+              description: "Checksum for the custom NSIS binary."
             },
             debugLogging: {
-              type: "boolean"
+              type: "boolean",
+              description: "Enable debug logging with the custom NSIS binary."
             },
             url: {
-              type: "string"
+              type: "string",
+              description: "URL to download the custom NSIS binary (e.g., a .7z archive)."
             },
             version: {
-              type: "string"
+              type: "string",
+              description: "Version of the custom NSIS binary."
             }
           }
         },
         nsisInclude: {
           type: "string",
+          description: "The path to NSIS script to customize installer.",
+          examples: ["build/installer.nsh"],
+          default: "undefined",
           file: {
             extensions: ["nsh"],
             mustBeFile: true
@@ -2049,12 +2342,64 @@ var schema_default = {
         },
         publisherName: {
           type: "array",
+          description: "The publisher name, exactly as in your code signing certificate. Several names can be provided. Defaults to common name from your code signing certificate. You should typically not include this property in your configuration unless you wish to transition to a new certificate in the future.",
+          examples: ['["ABC Limited"]'],
+          default: "Default to the common name from your code signing certificate.",
           items: {
             type: "string",
             minLength: 1
           }
         }
       }
+    },
+    platformOverridableProperties: {
+      type: "object",
+      additionalProperties: false,
+      description: "Defines properties that can be overridden on a per-platform basis under the 'platformOverrides' field.",
+      properties: {
+        appBuilderLibVersion: {
+          $ref: "#/definitions/appBuilderLibVersionProperty"
+        },
+        appId: { $ref: "#/definitions/appIdProperty" },
+        appFiles: { $ref: "#/definitions/appFilesProperty" },
+        appProtocolScheme: {
+          $ref: "#/definitions/appProtocolSchemeProperty"
+        },
+        appPath: { $ref: "#/definitions/appPathProperty" },
+        asar: { $ref: "#/definitions/asarProperty" },
+        asarUnpack: { $ref: "#/definitions/asarUnpackProperty" },
+        buildVersion: { $ref: "#/definitions/buildVersionProperty" },
+        copyright: { $ref: "#/definitions/copyrightProperty" },
+        electronMirror: { $ref: "#/definitions/electronMirrorProperty" },
+        electronVersion: { $ref: "#/definitions/electronVersionProperty" },
+        extraContentFiles: {
+          $ref: "#/definitions/extraContentFilesProperty"
+        },
+        extraResources: { $ref: "#/definitions/extraResourcesProperty" },
+        fileAssociations: {
+          $ref: "#/definitions/fileAssociationsProperty"
+        },
+        updateUrlBase: { $ref: "#/definitions/updateUrlBaseProperty" },
+        filesForDistribution: {
+          $ref: "#/definitions/filesForDistributionProperty"
+        },
+        linux: { $ref: "#/definitions/linuxConfigProperty" },
+        includeSubNodeModules: {
+          $ref: "#/definitions/includeSubNodeModulesProperty"
+        },
+        mac: { $ref: "#/definitions/macConfigProperty" },
+        mas: { $ref: "#/definitions/masConfigProperty" },
+        dmg: { $ref: "#/definitions/dmgConfigProperty" },
+        nodeVersion: { $ref: "#/definitions/nodeVersionProperty" },
+        npmVersion: { $ref: "#/definitions/npmVersionProperty" },
+        pnpmVersion: { $ref: "#/definitions/pnpmVersionProperty" },
+        packageJson: { $ref: "#/definitions/packageJsonProperty" },
+        packageManager: { $ref: "#/definitions/packageManagerProperty" },
+        rebuildLibrary: { $ref: "#/definitions/rebuildLibraryProperty" },
+        snap: { $ref: "#/definitions/snapConfigProperty" },
+        uploadSizeLimit: { $ref: "#/definitions/uploadSizeLimitProperty" },
+        windows: { $ref: "#/definitions/windowsConfigProperty" }
+      }
     }
   }
 };
@@ -2904,35 +3249,24 @@ function Build({
   }
 }
 
-// src/utilities/checkIfReactIsUsable.ts
-var import_react7 = require("react");
-var checkIfReactIsUsable_default = ({ cons = console, proc = process } = {}) => {
-  try {
-    (0, import_react7.useState)(null);
-  } catch (e) {
-    cons.error(e);
-    proc.exit(1);
-  }
-};
-
 // src/components/LoginHOC.tsx
 var import_ink16 = require("ink");
-var import_react10 = require("react");
+var import_react9 = require("react");
 var import_prop_types9 = __toESM(require("prop-types"));
 var import_is_ci4 = __toESM(require("is-ci"));
 
 // src/components/Login.tsx
 var import_ink14 = require("ink");
 var import_prop_types8 = __toESM(require("prop-types"));
-var import_react9 = require("react");
+var import_react8 = require("react");
 var import_react_final_form = require("react-final-form");
 
 // src/components/TextInput.tsx
 var import_ink_text_input = __toESM(require("ink-text-input"));
-var import_react8 = __toESM(require("react"));
+var import_react7 = __toESM(require("react"));
 var import_jsx_runtime13 = require("react/jsx-runtime");
 var TextInput = ({ onBlur, onFocus, ...props }) => {
-  import_react8.default.useEffect(() => {
+  import_react7.default.useEffect(() => {
     onFocus();
     return onBlur;
   }, [onFocus, onBlur]);
@@ -2966,10 +3300,10 @@ var loginFields = [
   }
 ];
 var Login = ({ setIsLoggedIn }) => {
-  const [activeField, setActiveField] = (0, import_react9.useState)(0);
-  const [error, setError] = (0, import_react9.useState)(null);
-  const [failureMessage, setFailureMessage] = (0, import_react9.useState)(null);
-  const [isSubmittingForm, setIsSubmittingForm] = (0, import_react9.useState)(false);
+  const [activeField, setActiveField] = (0, import_react8.useState)(0);
+  const [error, setError] = (0, import_react8.useState)(null);
+  const [failureMessage, setFailureMessage] = (0, import_react8.useState)(null);
+  const [isSubmittingForm, setIsSubmittingForm] = (0, import_react8.useState)(false);
   const onFailure = (message2) => {
     setIsSubmittingForm(false);
     setFailureMessage(message2);
@@ -3068,11 +3402,11 @@ var LoadingText_default = LoadingText;
 // src/components/LoginHOC.tsx
 var import_jsx_runtime16 = require("react/jsx-runtime");
 var LoginHOC = ({ children, isInteractive = true }) => {
-  const [isLoggedIn, setIsLoggedIn] = (0, import_react10.useState)(false);
-  const [isEffectDone, setEffectDone] = (0, import_react10.useState)(false);
-  const [error, setError] = (0, import_react10.useState)(null);
+  const [isLoggedIn, setIsLoggedIn] = (0, import_react9.useState)(false);
+  const [isEffectDone, setEffectDone] = (0, import_react9.useState)(false);
+  const [error, setError] = (0, import_react9.useState)(null);
   const { isRawModeSupported } = (0, import_ink16.useStdin)();
-  (0, import_react10.useEffect)(() => {
+  (0, import_react9.useEffect)(() => {
     async function isAccessTokenValid() {
       const { accessToken, email, jwtToken } = getAuthConfig();
       let userCreds = null;
@@ -3149,9 +3483,9 @@ LoginHOC.propTypes = {
 var LoginHOC_default = LoginHOC;
 
 // src/components/ErrorBoundary.tsx
-var import_react11 = __toESM(require("react"));
+var import_react10 = __toESM(require("react"));
 var Sentry2 = __toESM(require("@sentry/node"));
-var ErrorBoundary = class extends import_react11.default.Component {
+var ErrorBoundary = class extends import_react10.default.Component {
   constructor(props) {
     super(props);
     this.state = { eventId: null, error: null };
@@ -3179,7 +3513,7 @@ var ErrorBoundary_default = ErrorBoundary;
 var import_ink20 = require("ink");
 var import_ink_select_input = __toESM(require("ink-select-input"));
 var import_prop_types11 = __toESM(require("prop-types"));
-var import_react13 = require("react");
+var import_react12 = require("react");
 
 // src/components/CustomSelectInputIndicator.tsx
 var import_ink17 = require("ink");
@@ -3206,7 +3540,7 @@ function CustomSelectInputItem({
 // src/components/ViewBuild.tsx
 var import_ink19 = require("ink");
 var import_prop_types10 = __toESM(require("prop-types"));
-var import_react12 = require("react");
+var import_react11 = require("react");
 
 // src/utilities/getLatestBuildId.ts
 async function getLatestBuildId({
@@ -3301,7 +3635,7 @@ var ViewBuild = ({ commandUsed, id, configPath }) => {
       isLoading
     },
     setState
-  ] = (0, import_react12.useState)({
+  ] = (0, import_react11.useState)({
     appId: null,
     arbitraryMessageComponent: null,
     build: null,
@@ -3317,7 +3651,7 @@ var ViewBuild = ({ commandUsed, id, configPath }) => {
       error: error2
     }));
   };
-  (0, import_react12.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     let firebaseUnsubscribe;
     async function viewBuild() {
       let config2;
@@ -3374,12 +3708,12 @@ var ViewBuild = ({ commandUsed, id, configPath }) => {
       }
     };
   }, [id, configPath]);
-  (0, import_react12.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     if (hasBuildEverFailed && shouldExitOnBuildFailure_default(build)) {
       setTimeout(() => exit(new Error("Build has failed")), 10);
     }
   }, [build, exit, hasBuildEverFailed]);
-  (0, import_react12.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     if (arbitraryMessageComponent) {
       setTimeout(() => exit(new Error("Validation failed")), 10);
     }
@@ -3458,14 +3792,14 @@ var OngoingBuildGuard = ({
   const { isRawModeSupported } = (0, import_ink20.useStdin)();
   const onInput = useInput_default();
   const exit = useExit_default();
-  const [{ appId, builds, error, isLoading, itemChosen }, setState] = (0, import_react13.useState)({
+  const [{ appId, builds, error, isLoading, itemChosen }, setState] = (0, import_react12.useState)({
     appId: null,
     builds: [],
     error: null,
     isLoading: true,
     itemChosen: null
   });
-  (0, import_react13.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     if (!isLoading) {
       return;
     }
@@ -3588,9 +3922,9 @@ OngoingBuildGuard.propTypes = {
 var OngoingBuildGuard_default = OngoingBuildGuard;
 
 // src/utilities/useAnalytics.ts
-var import_react14 = require("react");
+var import_react13 = require("react");
 var useAnalyticsCommand = (command, flags = {}, properties = {}) => {
-  const [hasAttemptedTracking, setTrackingAttempt] = (0, import_react14.useState)(false);
+  const [hasAttemptedTracking, setTrackingAttempt] = (0, import_react13.useState)(false);
   logger_default.info({ command, flags, properties }, "useAnalyticsCommand");
   try {
     if (flags.projectPath) {
@@ -3601,7 +3935,7 @@ var useAnalyticsCommand = (command, flags = {}, properties = {}) => {
     }
   } catch (err) {
   }
-  (0, import_react14.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     const authUnsubscribe = onUserAuth(async (user) => {
       if (user.uid) {
         identify(
@@ -3636,7 +3970,6 @@ function BuildCommand({
   configPath,
   flags
 }) {
-  checkIfReactIsUsable_default();
   useAnalyticsCommand("build", {
     async: flags.exitAfterUploading,
     codeSign: flags.shouldCodeSign,
@@ -3657,7 +3990,7 @@ function BuildCommand({
 // src/components/ViewBuilds.tsx
 var import_ink26 = require("ink");
 var import_prop_types17 = __toESM(require("prop-types"));
-var import_react16 = require("react");
+var import_react15 = require("react");
 
 // src/components/Table.tsx
 var import_ink24 = require("ink");
@@ -3681,7 +4014,7 @@ var TableEnd_default = TableEnd;
 // src/components/TableHead.tsx
 var import_ink22 = require("ink");
 var import_prop_types13 = __toESM(require("prop-types"));
-var import_react15 = require("react");
+var import_react14 = require("react");
 var import_jsx_runtime23 = require("react/jsx-runtime");
 var TableHead = ({ keyDetails, ...props }) => {
   let topLine = "\u250C";
@@ -3689,7 +4022,7 @@ var TableHead = ({ keyDetails, ...props }) => {
   topLine += "\u2510";
   const contentLineElements = Object.values(keyDetails).map(
     ({ key, width }, index) => {
-      return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(import_react15.Fragment, { children: [
+      return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(import_react14.Fragment, { children: [
         index > 0 ? /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_ink22.Text, { children: " \u2502 " }) : null,
         /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_ink22.Box, { width, children: /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_ink22.Text, { bold: true, children: key }) })
       ] }, key);
@@ -3923,7 +4256,7 @@ var ViewBuilds = ({
       user
     },
     setState
-  ] = (0, import_react16.useState)({
+  ] = (0, import_react15.useState)({
     builds: [],
     error: null,
     hasMoreToLoad: true,
@@ -3948,7 +4281,7 @@ var ViewBuilds = ({
       }));
     }
   });
-  (0, import_react16.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     async function viewBuilds() {
       if (error || isLoading || isInitialLoadComplete && (!hasMoreToLoad || !startAfter)) {
         return;
@@ -4023,12 +4356,12 @@ var ViewBuilds = ({
     format,
     count
   ]);
-  (0, import_react16.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     if (!hasMoreToLoad) {
       setTimeout(exit, 10);
     }
   }, [exit, hasMoreToLoad]);
-  (0, import_react16.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     if (!isLoading && isInitialLoadComplete && shouldExitAfterViewingBuilds) {
       setTimeout(exit, 10);
     }
@@ -4114,7 +4447,6 @@ var BuildsCommand = ({
   format = "table",
   exit
 }) => {
-  checkIfReactIsUsable_default();
   useAnalyticsCommand("builds", {
     id,
     shouldViewLatest,
@@ -4156,15 +4488,14 @@ var BuildsCommand = ({
 var BuildsCommand_default = BuildsCommand;
 
 // src/commands/LogoutCommand.tsx
-var import_react17 = require("react");
+var import_react16 = require("react");
 var import_ink27 = require("ink");
 var import_jsx_runtime30 = require("react/jsx-runtime");
 var Logout = () => {
   const exit = useExit_default();
   const { hasAttemptedTracking } = useAnalyticsCommand("logout");
-  checkIfReactIsUsable_default();
   deleteAuthConfig();
-  (0, import_react17.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     if (hasAttemptedTracking) {
       exit();
     }
@@ -4178,7 +4509,7 @@ var LogoutCommand_default = LogoutWrapper;
 
 // src/components/BuildPicker.tsx
 var import_ink29 = require("ink");
-var import_react18 = require("react");
+var import_react17 = require("react");
 
 // src/components/SelectTable.tsx
 var import_ink28 = require("ink");
@@ -4296,11 +4627,11 @@ function BuildPicker({
   const exit = useExit_default();
   const onInput = useInput_default();
   const isRealIdPassed = buildId && buildId !== "latest";
-  const [state, setState] = (0, import_react18.useState)({
+  const [state, setState] = (0, import_react17.useState)({
     selectedBuildId: isRealIdPassed ? buildId : void 0,
     state: isRealIdPassed ? "selected" : "loading"
   });
-  (0, import_react18.useEffect)(() => {
+  (0, import_react17.useEffect)(() => {
     loadData({
       buildFilter,
       buildId,
@@ -4415,7 +4746,7 @@ async function getBuildItems({
 }
 
 // src/commands/release/components/ReleaseBuildLogic.tsx
-var import_react19 = require("react");
+var import_react18 = require("react");
 
 // src/utilities/getBuildAttributes.ts
 async function getBuildAttributes({
@@ -4552,8 +4883,8 @@ function ReleaseBuildLogic({
   configPath
 }) {
   const exit = useExit_default();
-  const [state, setState] = (0, import_react19.useState)({ state: "loading" });
-  (0, import_react19.useEffect)(() => {
+  const [state, setState] = (0, import_react18.useState)({ state: "loading" });
+  (0, import_react18.useEffect)(() => {
     releaseBuildWorkflow({ configPath, buildId, updateState }).catch(
       logger_default.error
     );
@@ -4591,7 +4922,7 @@ async function releaseBuildWorkflow({
 
 // src/commands/release/components/ReleaseConfirmation.tsx
 var import_ink34 = require("ink");
-var import_react21 = require("react");
+var import_react20 = require("react");
 
 // src/commands/smoke-test/utilities/build.ts
 var import_semver = __toESM(require("semver"));
@@ -4750,15 +5081,15 @@ function analyzeRelease({
 // src/commands/release/components/DowngradeConfirmation.tsx
 var import_ink32 = require("ink");
 var import_ink_text_input2 = __toESM(require("ink-text-input"));
-var import_react20 = require("react");
+var import_react19 = require("react");
 var import_jsx_runtime36 = require("react/jsx-runtime");
 function DowngradeConfirmation({
   build,
   latestReleasedBuild,
   confirmDowngrade: confirmDowngrade2
 }) {
-  const [confirmText, setConfirmText] = (0, import_react20.useState)("");
-  const [showError, setShowError] = (0, import_react20.useState)(false);
+  const [confirmText, setConfirmText] = (0, import_react19.useState)("");
+  const [showError, setShowError] = (0, import_react19.useState)(false);
   const buildVersion = build.appVersion;
   const latestVersion2 = latestReleasedBuild.appVersion;
   function onType(text) {
@@ -4843,10 +5174,10 @@ function ReleaseConfirmation({
   loadData = loadBuildsData
 }) {
   var _a;
-  const [state, setState] = (0, import_react21.useState)({
+  const [state, setState] = (0, import_react20.useState)({
     state: disabled ? "bypass" : "loading"
   });
-  (0, import_react21.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     confirmationWorkflow({
       buildId,
       configPath,
@@ -5026,7 +5357,6 @@ function ReleaseCommand({
   configPath,
   shouldConfirm
 }) {
-  checkIfReactIsUsable_default();
   useAnalyticsCommand("release", {
     buildId,
     shouldConfirm,
@@ -5069,11 +5399,11 @@ function isBuildReleasable(opts) {
 }
 
 // src/commands/smoke-test/SmokeTestCommand.tsx
-var import_react23 = require("react");
+var import_react22 = require("react");
 
 // src/commands/smoke-test/components/Cancellation.tsx
 var import_ink35 = require("ink");
-var import_react22 = require("react");
+var import_react21 = require("react");
 var import_jsx_runtime40 = require("react/jsx-runtime");
 function Cancellation({
   children,
@@ -5093,8 +5423,8 @@ function Cancellation({
   renderError = (e) => /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(ErrorDisplay, { error: e }),
   subject
 }) {
-  const [state, setState] = (0, import_react22.useState)("normal");
-  const [error, setError] = (0, import_react22.useState)();
+  const [state, setState] = (0, import_react21.useState)("normal");
+  const [error, setError] = (0, import_react21.useState)();
   const onInput = useInput_default();
   const exit = useExit_default();
   onInput(async (input, key) => {
@@ -5331,7 +5661,6 @@ function SmokeTestCommand({
   buildId,
   configPath
 }) {
-  checkIfReactIsUsable_default();
   useAnalyticsCommand("smoke-test", { buildId, configPath });
   const command = `todesktop release ${buildId === "latest" ? "--latest" : "<id>"}`;
   return /* @__PURE__ */ (0, import_jsx_runtime44.jsx)(ErrorBoundary_default, { children: /* @__PURE__ */ (0, import_jsx_runtime44.jsx)(LoginHOC_default, { children: /* @__PURE__ */ (0, import_jsx_runtime44.jsx)(
@@ -5359,13 +5688,13 @@ function SmokeTestContainer({
   configPath
 }) {
   const exit = useExit_default();
-  const [state, setState] = (0, import_react23.useState)({
+  const [state, setState] = (0, import_react22.useState)({
     buildId,
     state: "loading"
   });
-  const [abortController] = (0, import_react23.useState)(new AbortController());
+  const [abortController] = (0, import_react22.useState)(new AbortController());
   const abortSignal = abortController.signal;
-  (0, import_react23.useEffect)(() => {
+  (0, import_react22.useEffect)(() => {
     smokeTestWorkflow({ abortSignal, buildId, configPath, updateState }).catch(
       logger_default.error
     );
@@ -5456,15 +5785,14 @@ function isCancelable(state) {
 }
 
 // src/commands/WhoamiCommand.tsx
-var import_react24 = require("react");
+var import_react23 = require("react");
 var import_ink38 = require("ink");
 var import_jsx_runtime45 = require("react/jsx-runtime");
 var WhoAmI = () => {
   const exit = useExit_default();
-  checkIfReactIsUsable_default();
   const auth = getAuthConfig();
   const { hasAttemptedTracking } = useAnalyticsCommand("whoami", {}, {});
-  (0, import_react24.useEffect)(() => {
+  (0, import_react23.useEffect)(() => {
     if (hasAttemptedTracking) {
       exit();
     }
@@ -5515,7 +5843,7 @@ var package_default = {
     access: "public"
   },
   name: "@todesktop/cli",
-  version: "1.12.2",
+  version: "1.12.5",
   license: "MIT",
   author: "Dave Jeffery <dave@todesktop.com> (http://www.todesktop.com/)",
   homepage: "https://todesktop.com/cli",
@@ -5539,20 +5867,18 @@ var package_default = {
     format: "prettier --write .",
     "lint:types": "tsc && tsc-strict",
     "lint--fix": "eslint src test --fix",
-    release: "npm run build && npx np --tag=latest",
-    "release-beta": "npm run build && npx np --any-branch --no-tests --tag=beta",
+    "docs:generate": "node scripts/generate-readme.js",
+    release: "npm run docs:generate && npm run build && npx np --tag=latest",
+    "release-beta": "npm run docs:generate && npm run build && npx np --any-branch --no-tests --tag=beta",
     test: "ava",
     "test--watch": "npm test -- --watch",
     postinstall: "node scripts/postinstall.js"
   },
   files: [
-    "scripts",
+    "scripts/postinstall.js",
     "schemas",
     "dist",
-    "docs",
-    ".env",
-    "LICENSE",
-    "README.md"
+    ".env"
   ],
   dependencies: {
     "@sentry/node": "^8.35.0",
@@ -5816,7 +6142,7 @@ import_commander.program.command("whoami").description("Prints the email of the
 });
 var runCommand = (component, props = null, { exitIfOutOfDate = true } = {}) => {
   onCommand_default({ exitIfOutOfDate });
-  const { waitUntilExit } = (0, import_ink39.render)((0, import_react25.createElement)(component, props));
+  const { waitUntilExit } = (0, import_ink39.render)((0, import_react24.createElement)(component, props));
   waitUntilExit().catch((error) => {
     console.error(error.stack);
   });