feat: handle Electron lazy binary download + on-device file picker

Electron no longer downloads its binary on npm install (postinstall removed
for supply-chain security; ELECTRON_SKIP_BINARY_DOWNLOAD is gone). It now
downloads on first launch (npm run dev). Add a 'download:electron' script
(install-electron bin) to pre-fetch deterministically; document in README.

Resolve mobile protocol import: add @capawesome/capacitor-file-picker and wire
beginLocalProtocolImport's Capacitor branch to pick a .netcanvas (readData),
and implement extractProtocol's Capacitor branch (JSZip + Filesystem, unzipping
into Directory.Data/protocols/<uid>). JSZip is dynamic-imported so it is not
bundled into the Electron renderer. Plugin synced into ios/ and android/.

Lint clean; 540 tests pass; web + electron builds green.

Author: jthrilly

README.md

@@ -22,6 +22,8 @@ This project requires Node.js 24 (LTS). A `.node-version` / `.nvmrc` file is pro
 2. Install the project dependencies by typing `npm install`.
 3. Refer to the development tasks section below to learn how to test and build the app.
 
+> **Note:** As of recent versions, Electron no longer downloads its binary during `npm install` (the `postinstall` step was removed for supply-chain security). The binary is fetched automatically the first time Electron is launched (e.g. `npm run dev`). To pre-download it explicitly, run `npm run download:electron`. Use `ELECTRON_INSTALL_PLATFORM` / `ELECTRON_INSTALL_ARCH` to fetch a binary for a different target.
+
 ## Development Tasks
 
 |`npm run <script>`|Description|

android/app/capacitor.build.gradle

@@ -16,6 +16,7 @@ dependencies {
     implementation project(':capacitor-keyboard')
     implementation project(':capacitor-network')
     implementation project(':capacitor-status-bar')
+    implementation project(':capawesome-capacitor-file-picker')
 
 }
 

android/capacitor.settings.gradle

@@ -22,3 +22,6 @@ project(':capacitor-network').projectDir = new File('../node_modules/@capacitor/
 
 include ':capacitor-status-bar'
 project(':capacitor-status-bar').projectDir = new File('../node_modules/@capacitor/status-bar/android')
+
+include ':capawesome-capacitor-file-picker'
+project(':capawesome-capacitor-file-picker').projectDir = new File('../node_modules/@capawesome/capacitor-file-picker/android')

ios/App/CapApp-SPM/Package.swift

@@ -18,7 +18,8 @@ let package = Package(
         .package(name: "CapacitorFilesystem", path: "../../../node_modules/@capacitor/filesystem"),
         .package(name: "CapacitorKeyboard", path: "../../../node_modules/@capacitor/keyboard"),
         .package(name: "CapacitorNetwork", path: "../../../node_modules/@capacitor/network"),
-        .package(name: "CapacitorStatusBar", path: "../../../node_modules/@capacitor/status-bar")
+        .package(name: "CapacitorStatusBar", path: "../../../node_modules/@capacitor/status-bar"),
+        .package(name: "CapawesomeCapacitorFilePicker", path: "../../../node_modules/@capawesome/capacitor-file-picker")
     ],
     targets: [
         .target(
@@ -32,7 +33,8 @@ let package = Package(
                 .product(name: "CapacitorFilesystem", package: "CapacitorFilesystem"),
                 .product(name: "CapacitorKeyboard", package: "CapacitorKeyboard"),
                 .product(name: "CapacitorNetwork", package: "CapacitorNetwork"),
-                .product(name: "CapacitorStatusBar", package: "CapacitorStatusBar")
+                .product(name: "CapacitorStatusBar", package: "CapacitorStatusBar"),
+                .product(name: "CapawesomeCapacitorFilePicker", package: "CapawesomeCapacitorFilePicker")
             ]
         )
     ]

out/renderer/assets/index-Cuaf_r63.js out/renderer/assets/index-CebN_nE7.jsout/renderer/assets/index-Cuaf_r63.js renamed to out/renderer/assets/index-CebN_nE7.js

@@ -24803,7 +24803,7 @@ var Encoding;
   Encoding2["UTF16"] = "utf16";
 })(Encoding || (Encoding = {}));
 const Filesystem = registerPlugin("Filesystem", {
-  web: () => __vitePreload(() => import("./web-DUFlwq02.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.FilesystemWeb())
+  web: () => __vitePreload(() => import("./web-2fBXITDz.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.FilesystemWeb())
 });
 f$V();
 const trimPath = fpExports.trimChars("/ ");
@@ -76177,7 +76177,7 @@ actions.untouch;
 actions.updateSyncWarnings;
 actions.updateSyncErrors;
 const Device = registerPlugin("Device", {
-  web: () => __vitePreload(() => import("./web-Cbp09VvC.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.DeviceWeb())
+  web: () => __vitePreload(() => import("./web-CPdKRLiP.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.DeviceWeb())
 });
 let cachedDeviceInfo = null;
 const initDeviceInfo = async () => {
@@ -76837,6 +76837,115 @@ const store$1 = createStore(
   )
 );
 persistor = persistStore(store$1, { manualPersist: true });
+class FilePickerWeb extends WebPlugin {
+  constructor() {
+    super(...arguments);
+    this.ERROR_PICK_FILE_CANCELED = "pickFiles canceled.";
+  }
+  async checkPermissions() {
+    throw this.unimplemented("Not implemented on web.");
+  }
+  async convertHeicToJpeg(_options) {
+    throw this.unimplemented("Not implemented on web.");
+  }
+  async copyFile(_options) {
+    throw this.unimplemented("Not implemented on web.");
+  }
+  async pickFiles(options) {
+    const pickedFiles = await this.openFilePicker(options);
+    if (!pickedFiles) {
+      throw new Error(this.ERROR_PICK_FILE_CANCELED);
+    }
+    const result = {
+      files: []
+    };
+    for (const pickedFile of pickedFiles) {
+      const file = {
+        blob: pickedFile,
+        modifiedAt: pickedFile.lastModified,
+        mimeType: this.getMimeTypeFromUrl(pickedFile),
+        name: this.getNameFromUrl(pickedFile),
+        path: void 0,
+        size: this.getSizeFromUrl(pickedFile)
+      };
+      if (options === null || options === void 0 ? void 0 : options.readData) {
+        file.data = await this.getDataFromFile(pickedFile);
+      }
+      result.files.push(file);
+    }
+    return result;
+  }
+  async pickDirectory() {
+    throw this.unimplemented("Not implemented on web.");
+  }
+  async pickImages(options) {
+    return this.pickFiles(Object.assign({ types: ["image/*"] }, options));
+  }
+  async pickMedia(options) {
+    return this.pickFiles(Object.assign({ types: ["image/*", "video/*"] }, options));
+  }
+  async pickVideos(options) {
+    return this.pickFiles(Object.assign({ types: ["video/*"] }, options));
+  }
+  async requestPermissions(_options) {
+    throw this.unimplemented("Not implemented on web.");
+  }
+  async openFilePicker(options) {
+    var _a2;
+    const accept2 = ((_a2 = options === null || options === void 0 ? void 0 : options.types) === null || _a2 === void 0 ? void 0 : _a2.join(",")) || "";
+    const limit = (options === null || options === void 0 ? void 0 : options.limit) === void 0 ? 0 : options.limit;
+    return new Promise((resolve) => {
+      let onChangeFired = false;
+      const input = document.createElement("input");
+      input.type = "file";
+      input.accept = accept2;
+      input.multiple = limit === 0;
+      input.addEventListener("change", () => {
+        onChangeFired = true;
+        const files = Array.from(input.files || []);
+        resolve(files);
+      }, { once: true });
+      window.addEventListener("focus", async () => {
+        await this.wait(1e3);
+        if (onChangeFired) {
+          return;
+        }
+        resolve(void 0);
+      }, { once: true });
+      input.click();
+    });
+  }
+  async getDataFromFile(file) {
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.readAsDataURL(file);
+      reader.onload = () => {
+        const result = typeof reader.result === "string" ? reader.result : "";
+        const splittedResult = result.split("base64,");
+        const base64 = splittedResult[1] || "";
+        resolve(base64);
+      };
+      reader.onerror = (error) => {
+        reject(error);
+      };
+    });
+  }
+  getNameFromUrl(file) {
+    return file.name;
+  }
+  getMimeTypeFromUrl(file) {
+    return file.type;
+  }
+  getSizeFromUrl(file) {
+    return file.size;
+  }
+  async wait(delayMs) {
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+  }
+}
+const FilePicker = registerPlugin("FilePicker", {
+  web: () => new FilePickerWeb()
+});
 var classnames = { exports: {} };
 var hasRequiredClassnames;
 function requireClassnames() {
@@ -118396,6 +118505,40 @@ const extractProtocol = inEnvironment((environment) => {
       return window.NCAPI.protocol.extract(protocolFile, destination).then(() => protocolName);
     };
   }
+  if (environment === environments.CAPACITOR) {
+    return async (protocolData) => {
+      if (!protocolData) {
+        throw new Error("protocolFile is required");
+      }
+      const protocolName = uuid$1();
+      const baseDir = `protocols/${protocolName}`;
+      const { default: JSZip } = await __vitePreload(async () => {
+        const { default: JSZip2 } = await import("./jszip.min-CIKoWVI7.js").then((n2) => n2.j);
+        return { default: JSZip2 };
+      }, true ? [] : void 0, import.meta.url);
+      const zip = await JSZip.loadAsync(protocolData, { base64: true });
+      const entries = Object.values(zip.files);
+      await Filesystem.mkdir({ path: baseDir, directory: Directory.Data, recursive: true }).catch(() => {
+      });
+      for (let i2 = 0; i2 < entries.length; i2 += 1) {
+        const entry = entries[i2];
+        const target2 = `${baseDir}/${entry.name}`;
+        if (entry.dir) {
+          await Filesystem.mkdir({ path: target2, directory: Directory.Data, recursive: true }).catch(() => {
+          });
+        } else {
+          const data = await entry.async("base64");
+          await Filesystem.writeFile({
+            path: target2,
+            data,
+            directory: Directory.Data,
+            recursive: true
+          });
+        }
+      }
+      return protocolName;
+    };
+  }
   return () => Promise.reject(new Error("extractProtocol() not available on platform"));
 });
 var helpers;
@@ -178405,6 +178548,13 @@ const beginLocalProtocolImport = () => {
     return void 0;
   }
   if (isCapacitor()) {
+    FilePicker.pickFiles({ limit: 1, readData: true }).then((result) => {
+      const file = result.files && result.files[0];
+      if (file && file.data) {
+        importProtocolFromFile(file.data, file.name);
+      }
+    }).catch(() => {
+    });
     return void 0;
   }
   return Error("Environment not supported");
@@ -178414,7 +178564,7 @@ const importProtocolFromFile = (filePath, name) => {
   let protocolUid;
   let previousUid;
   const filename = filenameFromPath(filePath);
-  const protocolName = protocolNameFromFilename(filename);
+  const protocolName = protocolNameFromFilename(name || filename);
   const toastUUID = uuid$1();
   dispatch$1(actionCreators$9.addToast({
     id: toastUUID,
@@ -230647,7 +230797,7 @@ function requireCompareVersions() {
 var compareVersionsExports = requireCompareVersions();
 const compareVersions = /* @__PURE__ */ getDefaultExportFromCjs$1(compareVersionsExports);
 const App$2 = registerPlugin("App", {
-  web: () => __vitePreload(() => import("./web-DwVQYyxD.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.AppWeb())
+  web: () => __vitePreload(() => import("./web-CP4kXA_q.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.AppWeb())
 });
 const getVersion = () => {
   if (isElectron()) {
@@ -230659,7 +230809,7 @@ const getVersion = () => {
   return Promise.resolve("0.0.0");
 };
 const Browser = registerPlugin("Browser", {
-  web: () => __vitePreload(() => import("./web-DGsySVkC.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.BrowserWeb())
+  web: () => __vitePreload(() => import("./web-DLfIk6vV.js"), true ? [] : void 0, import.meta.url).then((m2) => new m2.BrowserWeb())
 });
 const openExternalLink = (href) => {
   if (isElectron()) {
@@ -262989,7 +263139,11 @@ if (document.readyState === "complete") {
   };
 }
 export {
+  Buffer as B,
   Encoding as E,
   WebPlugin as W,
-  buildRequestInit as b
+  buildRequestInit as b,
+  commonjsGlobal$1 as c,
+  getDefaultExportFromCjs$1 as g,
+  process$1 as p
 };