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

package/dist/targets/linux/LinuxTargetHelper.js

@@ -0,0 +1,332 @@
+import { asArray, exists, InvalidConfigurationError, isEmptyOrSpaces, log } from "builder-util";
+import { deepAssign } from "builder-util-runtime";
+import { Lazy } from "lazy-val";
+import { join } from "path";
+import * as semver from "semver";
+import { SnapCore24 } from "./snap/core24.js";
+import { SnapCoreCustom } from "./snap/coreCustom.js";
+import { SnapCoreLegacy } from "./snap/coreLegacy.js";
+import _fsExtra from "fs-extra";
+const { outputFile } = _fsExtra;
+/**
+ * Escape a string value for use in a freedesktop .desktop file string field
+ * (Name, Comment, StartupWMClass, etc.).
+ *
+ * The freedesktop Desktop Entry Specification requires that the following
+ * characters be escaped in string / localestring values:
+ *   \n  →  \\n      (newline — would inject new key=value lines otherwise)
+ *   \r  →  \\r
+ *   \t  →  \\t
+ *   \\  →  \\\\
+ *
+ * Without escaping, a productName or description containing a literal newline
+ * can inject arbitrary key=value pairs into the generated .desktop file,
+ * potentially overriding the Exec key.
+ *
+ * @see https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#value-types
+ */
+function desktopStringEscape(value) {
+    return value.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+}
+/**
+ * Characters that require an Exec argument to be double-quoted per the
+ * freedesktop Desktop Entry Specification.  Plain alphanumeric args and
+ * field codes must NOT be wrapped in quotes.
+ *
+ * @see https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables
+ */
+const EXEC_RESERVED_RE = /[\s"'`\\<>~|&;$*?#()]/;
+/**
+ * Quote a single argument for use in a .desktop file Exec key.
+ *
+ * Field codes (`%f`, `%u`, `%F`, `%U`, etc.) MUST be left unquoted — the
+ * desktop launcher only expands them in unquoted token positions.  Wrapping
+ * them in `"…"` causes the launcher to treat them as literal strings, which
+ * breaks file-association / drag-and-drop functionality.
+ *
+ * For all other arguments, double-quoting is used when the argument contains
+ * any character that would be misinterpreted by the launcher without quoting
+ * (spaces, shell metacharacters, etc.).  Safe plain-word args are passed
+ * through unchanged to keep the Exec line readable.
+ *
+ * @see https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables
+ */
+function desktopExecArgEscape(arg) {
+    // Field codes (%f, %u, %F, %U, %i, %c, %k, …) must never be quoted.
+    if (/^%[a-zA-Z]$/.test(arg)) {
+        return arg;
+    }
+    // Only quote when the arg actually contains characters that need it.
+    if (EXEC_RESERVED_RE.test(arg)) {
+        return `"${arg.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+    }
+    return arg;
+}
+function mapLinuxCompressionToSnap(level) {
+    if (level === "store") {
+        return "lzo";
+    }
+    if (level === "maximum") {
+        return "xz";
+    }
+    return undefined;
+}
+export const installPrefix = "/opt";
+export class LinuxTargetHelper {
+    constructor(packager) {
+        this.packager = packager;
+        this.iconPromise = new Lazy(() => this.computeDesktopIcons());
+        this.mimeTypeFilesPromise = new Lazy(() => this.computeMimeTypeFiles());
+        this.maxIconPath = null;
+    }
+    get icons() {
+        return this.iconPromise.value;
+    }
+    get mimeTypeFiles() {
+        return this.mimeTypeFilesPromise.value;
+    }
+    getSnapCore() {
+        const { snapcraft } = this.packager.config;
+        // Merge linux-level options (category, description, mimeTypes, etc.) as the base so they
+        // propagate into the generated snapcraft.yaml and .desktop file without requiring users to
+        // duplicate them under core24/core18/etc. Per-core options always win for conflicts.
+        // linux.compression is a CompressionLevel ("store"/"normal"/"maximum"); snap compression is an
+        // algorithm ("xz"/"lzo"). Map the level to the nearest algorithm; per-core options override.
+        const { compression: linuxCompression, ...linuxOptions } = this.packager.platformOptions;
+        const snapLinuxOptions = { ...linuxOptions, compression: mapLinuxCompressionToSnap(linuxCompression) };
+        if (snapcraft != null) {
+            const core = snapcraft.base;
+            const options = snapcraft[core] || {};
+            switch (core) {
+                case "core18":
+                case "core20":
+                case "core22":
+                    if (!this.isElectronVersionGreaterOrEqualThan("4.0.0")) {
+                        if (!this.isElectronVersionGreaterOrEqualThan("2.0.0-beta.1")) {
+                            throw new InvalidConfigurationError("Electron 2 and higher is required to build Snap with core18/core20/core22");
+                        }
+                        log.warn(null, "electron 4 and higher is highly recommended for Snap with core18/core20/core22");
+                    }
+                    return new SnapCoreLegacy(this.packager, this, deepAssign({ base: core }, snapLinuxOptions, options));
+                case "core24":
+                    if (!this.isElectronVersionGreaterOrEqualThan("28.0.0")) {
+                        if (!this.isElectronVersionGreaterOrEqualThan("25.0.0")) {
+                            throw new InvalidConfigurationError("Electron 25 and higher is required to build Snap with core24");
+                        }
+                        log.warn(null, "electron 28 and higher is highly recommended for Snap with core24");
+                    }
+                    return new SnapCore24(this.packager, this, deepAssign({}, snapLinuxOptions, options));
+                case "custom":
+                    // Pass-through: do not inject linux options into user-supplied yaml
+                    return new SnapCoreCustom(this.packager, this, snapcraft.custom || {});
+            }
+        }
+        return new SnapCoreLegacy(this.packager, this, deepAssign({ base: "core20" }, snapLinuxOptions, {}));
+    }
+    isElectronVersionGreaterOrEqualThan(version, fallback) {
+        const electronVersion = this.packager.config.electronVersion;
+        if (!electronVersion) {
+            return fallback ? semver.gte(fallback, version) : true;
+        }
+        return semver.gte(electronVersion, version);
+    }
+    async computeMimeTypeFiles() {
+        const items = [];
+        for (const fileAssociation of this.packager.fileAssociations) {
+            if (!fileAssociation.mimeType) {
+                continue;
+            }
+            const data = `<mime-type type="${fileAssociation.mimeType}">
+  <glob pattern="*.${fileAssociation.ext}"/>
+    ${fileAssociation.description ? `<comment>${fileAssociation.description}</comment>` : ""}
+  <icon name="x-office-document" />
+</mime-type>`;
+            items.push(data);
+        }
+        if (items.length === 0) {
+            return null;
+        }
+        const file = await this.packager.getTempFile(".xml");
+        await outputFile(file, '<?xml version="1.0" encoding="utf-8"?>\n<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">\n' + items.join("\n") + "\n</mime-info>");
+        return file;
+    }
+    // must be name without spaces and other special characters, but not product name used
+    async computeDesktopIcons() {
+        const packager = this.packager;
+        const { config } = packager;
+        const platformOptions = packager.platformOptions;
+        const sources = [platformOptions.icon, config.mac?.icon ?? config.icon].filter(str => !!str);
+        // If no explicit sources are defined, fallback to buildResources directory, then default framework icon
+        let fallbackSources = [...asArray(packager.getDefaultFrameworkIcon())];
+        const buildResources = config.directories?.buildResources;
+        if (buildResources && (await exists(join(buildResources, "icons")))) {
+            fallbackSources = [buildResources, ...fallbackSources];
+        }
+        // need to put here and not as default because need to resolve image size
+        const result = await packager.resolveIcon(sources, fallbackSources, "set");
+        this.maxIconPath = result[result.length - 1].file;
+        // Ignore .icon files for linux (they are exclusive for macOS)
+        return result.filter(icon => !icon.file.endsWith(".icon"));
+    }
+    getDescription(options) {
+        return options.description || this.packager.appInfo.description;
+    }
+    getSanitizedVersion(target) {
+        const { appInfo: { version }, } = this.packager;
+        switch (target) {
+            case "pacman":
+                return version.replace(/-/g, "_");
+            case "rpm":
+            case "deb":
+                return version.replace(/-/g, "~");
+            default:
+                return version;
+        }
+    }
+    async writeDesktopEntry(targetSpecificOptions, exec, destination, extra) {
+        const data = await this.computeDesktopEntry(targetSpecificOptions, exec, extra);
+        const file = destination || (await this.packager.getTempFile(`${this.packager.appInfo.productFilename}.desktop`));
+        await outputFile(file, data);
+        return file;
+    }
+    getDesktopFileName(fallback = this.packager.executableName) {
+        if (!this.packager.platformOptions.syncDesktopName) {
+            return fallback;
+        }
+        const trimmedDesktopName = this.packager.metadata.desktopName?.trim();
+        if (isEmptyOrSpaces(trimmedDesktopName)) {
+            return fallback;
+        }
+        const basename = trimmedDesktopName.replace(/\.desktop$/, "");
+        // Guard against path traversal: desktopName flows into filesystem paths
+        // (snap/gui/<name>.desktop, /usr/share/applications/<name>.desktop, etc.).
+        if (/[/\\]/.test(basename) || [...basename].some(c => c.charCodeAt(0) === 0)) {
+            throw new InvalidConfigurationError(`desktopName "${trimmedDesktopName}" produces an invalid .desktop filename — remove any path separators or NUL characters`);
+        }
+        return basename;
+    }
+    computeDesktopEntry(targetSpecificOptions, exec, extra) {
+        if (exec != null && exec.length === 0) {
+            throw new Error("Specified exec is empty");
+        }
+        // https://github.com/electron-userland/electron-builder/issues/3418
+        if (targetSpecificOptions.desktop?.entry?.Exec) {
+            throw new Error("Please specify executable name as linux.executableName instead of linux.desktop.Exec");
+        }
+        const packager = this.packager;
+        const appInfo = packager.appInfo;
+        const executableArgs = targetSpecificOptions.executableArgs;
+        if (exec == null) {
+            exec = `${installPrefix}/${appInfo.sanitizedProductName}/${packager.executableName}`;
+            if (!/^[/0-9A-Za-z._-]+$/.test(exec)) {
+                exec = `"${exec}"`;
+            }
+            if (executableArgs) {
+                exec += " ";
+                // Each arg is double-quoted per the freedesktop Exec key spec so that
+                // spaces, $, ;, & and other reserved characters are not misinterpreted.
+                exec += executableArgs.map(desktopExecArgEscape).join(" ");
+            }
+            // https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables
+            const execCodes = ["%f", "%u", "%F", "%U"];
+            if (executableArgs == null || executableArgs.findIndex(arg => execCodes.includes(arg)) === -1) {
+                exec += " %U";
+            }
+        }
+        // https://github.com/electron-userland/electron-builder/issues/9103
+        // Electron derives app_id from desktopName in package.json; StartupWMClass must match.
+        // https://github.com/electron/electron/blob/9a7b73b5334f1d72c08e2d5e94106706ed751186/lib/browser/init.ts#L128-L133
+        const trimmedDesktopName = packager.metadata.desktopName?.trim();
+        if (isEmptyOrSpaces(trimmedDesktopName)) {
+            log.warn({
+                reason: "desktopName is not set in package.json",
+                docs: "https://www.electron.build/linux#window-association-desktopname--syncdesktopname",
+            }, "electron uses desktopName as app_id / WM_CLASS for window association. Without it desktop environments may not link running windows to this .desktop entry. Set desktopName in package.json and linux.syncDesktopName: true to fix.");
+        }
+        const wmClass = !isEmptyOrSpaces(trimmedDesktopName) ? trimmedDesktopName.replace(/\.desktop$/, "") : appInfo.productName;
+        const desktopMeta = deepAssign({
+            // String values are escaped per the freedesktop spec (\\, \n, \r, \t)
+            // so that a product name containing a newline cannot inject new key=value
+            // pairs into the .desktop file (e.g. overriding the Exec key).
+            Name: desktopStringEscape(appInfo.productName),
+            Exec: exec,
+            Terminal: "false",
+            Type: "Application",
+            Icon: packager.executableName,
+            // https://askubuntu.com/questions/367396/what-represent-the-startupwmclass-field-of-a-desktop-file
+            // Set to desktopName (minus .desktop suffix) when provided, so it matches Electron's
+            // app_id and desktop environments can associate running windows with this entry.
+            // Falls back to productName for apps that don't set desktopName.
+            // to get WM_CLASS of running window: xprop WM_CLASS
+            // StartupWMClass doesn't work for unicode
+            // https://github.com/electron/electron/blob/2-0-x/atom/browser/native_window_views.cc#L226
+            StartupWMClass: desktopStringEscape(wmClass),
+        }, extra, targetSpecificOptions.desktop?.entry ?? {});
+        const description = this.getDescription(targetSpecificOptions);
+        if (!isEmptyOrSpaces(description)) {
+            desktopMeta.Comment = desktopStringEscape(description);
+        }
+        const mimeTypes = asArray(targetSpecificOptions.mimeTypes);
+        for (const fileAssociation of packager.fileAssociations) {
+            if (fileAssociation.mimeType != null) {
+                mimeTypes.push(fileAssociation.mimeType);
+            }
+        }
+        for (const protocol of asArray(packager.config.protocols).concat(asArray(packager.platformOptions.protocols))) {
+            for (const scheme of asArray(protocol.schemes)) {
+                mimeTypes.push(`x-scheme-handler/${scheme}`);
+            }
+        }
+        if (mimeTypes.length !== 0) {
+            desktopMeta.MimeType = mimeTypes.join(";") + ";";
+        }
+        let category = targetSpecificOptions.category;
+        if (isEmptyOrSpaces(category)) {
+            const macCategory = (packager.config.mac || {}).category;
+            if (macCategory != null) {
+                category = macToLinuxCategory[macCategory];
+            }
+            if (category == null) {
+                // https://github.com/develar/onshape-desktop-shell/issues/48
+                if (macCategory != null) {
+                    log.warn({ macCategory }, "cannot map macOS category to Linux. If possible mapping is known for you, please file issue to add it.");
+                }
+                log.warn({
+                    reason: "linux.category is not set and cannot map from macOS",
+                    docs: "https://www.electron.build/linux",
+                }, 'application Linux category is set to default "Utility"');
+                category = "Utility";
+            }
+        }
+        desktopMeta.Categories = `${category}${category.endsWith(";") ? "" : ";"}`;
+        let data = `[Desktop Entry]`;
+        for (const name of Object.keys(desktopMeta)) {
+            data += `\n${name}=${desktopMeta[name]}`;
+        }
+        data += "\n";
+        const desktopActions = targetSpecificOptions.desktop?.desktopActions ?? {};
+        for (const [actionName, config] of Object.entries(desktopActions)) {
+            if (!Object.keys(config ?? {}).length) {
+                continue;
+            }
+            data += `\n[Desktop Action ${actionName}]`;
+            for (const [key, value] of Object.entries(config ?? {})) {
+                data += `\n${key}=${value}`;
+            }
+            data += "\n";
+        }
+        return Promise.resolve(data);
+    }
+}
+const macToLinuxCategory = {
+    "public.app-category.graphics-design": "Graphics",
+    "public.app-category.developer-tools": "Development",
+    "public.app-category.education": "Education",
+    "public.app-category.games": "Game",
+    "public.app-category.video": "Video;AudioVideo",
+    "public.app-category.utilities": "Utility",
+    "public.app-category.social-networking": "Network;Chat",
+    "public.app-category.finance": "Office;Finance",
+    "public.app-category.music": "Audio;AudioVideo",
+};
+//# sourceMappingURL=LinuxTargetHelper.js.map

package/dist/targets/linux/LinuxTargetHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinuxTargetHelper.js","sourceRoot":"","sources":["../../../src/targets/linux/LinuxTargetHelper.ts"],"names":[],"mappings":"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","sourcesContent":["import { asArray, exists, InvalidConfigurationError, isEmptyOrSpaces, log } from \"builder-util\"\nimport { deepAssign } from \"builder-util-runtime\"\n\nimport { Lazy } from \"lazy-val\"\nimport { join } from \"path\"\nimport * as semver from \"semver\"\nimport { CompressionLevel } from \"../../core.js\"\nimport { LinuxPackager } from \"../../linuxPackager.js\"\nimport { CommonLinuxOptions } from \"../../options/linuxOptions.js\"\nimport { SnapCore } from \"./snap/SnapTarget.js\"\nimport { SnapCore24 } from \"./snap/core24.js\"\nimport { SnapCoreCustom } from \"./snap/coreCustom.js\"\nimport { SnapCoreLegacy } from \"./snap/coreLegacy.js\"\nimport { IconInfo } from \"../../util/iconConverter.js\"\nimport _fsExtra from \"fs-extra\"\nconst { outputFile } = _fsExtra\n\n/**\n * Escape a string value for use in a freedesktop .desktop file string field\n * (Name, Comment, StartupWMClass, etc.).\n *\n * The freedesktop Desktop Entry Specification requires that the following\n * characters be escaped in string / localestring values:\n *   \\n  →  \\\\n      (newline — would inject new key=value lines otherwise)\n *   \\r  →  \\\\r\n *   \\t  →  \\\\t\n *   \\\\  →  \\\\\\\\\n *\n * Without escaping, a productName or description containing a literal newline\n * can inject arbitrary key=value pairs into the generated .desktop file,\n * potentially overriding the Exec key.\n *\n * @see https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#value-types\n */\nfunction desktopStringEscape(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\n/g, \"\\\\n\").replace(/\\r/g, \"\\\\r\").replace(/\\t/g, \"\\\\t\")\n}\n\n/**\n * Characters that require an Exec argument to be double-quoted per the\n * freedesktop Desktop Entry Specification.  Plain alphanumeric args and\n * field codes must NOT be wrapped in quotes.\n *\n * @see https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables\n */\nconst EXEC_RESERVED_RE = /[\\s\"'`\\\\<>~|&;$*?#()]/\n\n/**\n * Quote a single argument for use in a .desktop file Exec key.\n *\n * Field codes (`%f`, `%u`, `%F`, `%U`, etc.) MUST be left unquoted — the\n * desktop launcher only expands them in unquoted token positions.  Wrapping\n * them in `\"…\"` causes the launcher to treat them as literal strings, which\n * breaks file-association / drag-and-drop functionality.\n *\n * For all other arguments, double-quoting is used when the argument contains\n * any character that would be misinterpreted by the launcher without quoting\n * (spaces, shell metacharacters, etc.).  Safe plain-word args are passed\n * through unchanged to keep the Exec line readable.\n *\n * @see https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables\n */\nfunction desktopExecArgEscape(arg: string): string {\n  // Field codes (%f, %u, %F, %U, %i, %c, %k, …) must never be quoted.\n  if (/^%[a-zA-Z]$/.test(arg)) {\n    return arg\n  }\n  // Only quote when the arg actually contains characters that need it.\n  if (EXEC_RESERVED_RE.test(arg)) {\n    return `\"${arg.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"')}\"`\n  }\n  return arg\n}\n\nfunction mapLinuxCompressionToSnap(level: CompressionLevel | null | undefined): \"xz\" | \"lzo\" | undefined {\n  if (level === \"store\") {\n    return \"lzo\"\n  }\n  if (level === \"maximum\") {\n    return \"xz\"\n  }\n  return undefined\n}\n\nexport const installPrefix = \"/opt\"\n\nexport class LinuxTargetHelper {\n  private readonly iconPromise = new Lazy(() => this.computeDesktopIcons())\n\n  private readonly mimeTypeFilesPromise = new Lazy(() => this.computeMimeTypeFiles())\n\n  maxIconPath: string | null = null\n\n  constructor(private packager: LinuxPackager) {}\n\n  get icons(): Promise<Array<IconInfo>> {\n    return this.iconPromise.value\n  }\n\n  get mimeTypeFiles(): Promise<string | null> {\n    return this.mimeTypeFilesPromise.value\n  }\n\n  getSnapCore(): SnapCore<any> {\n    const { snapcraft } = this.packager.config\n\n    // Merge linux-level options (category, description, mimeTypes, etc.) as the base so they\n    // propagate into the generated snapcraft.yaml and .desktop file without requiring users to\n    // duplicate them under core24/core18/etc. Per-core options always win for conflicts.\n    // linux.compression is a CompressionLevel (\"store\"/\"normal\"/\"maximum\"); snap compression is an\n    // algorithm (\"xz\"/\"lzo\"). Map the level to the nearest algorithm; per-core options override.\n    const { compression: linuxCompression, ...linuxOptions } = this.packager.platformOptions\n    const snapLinuxOptions = { ...linuxOptions, compression: mapLinuxCompressionToSnap(linuxCompression) }\n\n    if (snapcraft != null) {\n      const core = snapcraft.base\n      const options = snapcraft[core] || {}\n      switch (core) {\n        case \"core18\":\n        case \"core20\":\n        case \"core22\":\n          if (!this.isElectronVersionGreaterOrEqualThan(\"4.0.0\")) {\n            if (!this.isElectronVersionGreaterOrEqualThan(\"2.0.0-beta.1\")) {\n              throw new InvalidConfigurationError(\"Electron 2 and higher is required to build Snap with core18/core20/core22\")\n            }\n            log.warn(null, \"electron 4 and higher is highly recommended for Snap with core18/core20/core22\")\n          }\n          return new SnapCoreLegacy(this.packager, this, deepAssign({ base: core }, snapLinuxOptions, options))\n        case \"core24\":\n          if (!this.isElectronVersionGreaterOrEqualThan(\"28.0.0\")) {\n            if (!this.isElectronVersionGreaterOrEqualThan(\"25.0.0\")) {\n              throw new InvalidConfigurationError(\"Electron 25 and higher is required to build Snap with core24\")\n            }\n            log.warn(null, \"electron 28 and higher is highly recommended for Snap with core24\")\n          }\n          return new SnapCore24(this.packager, this, deepAssign({}, snapLinuxOptions, options))\n        case \"custom\":\n          // Pass-through: do not inject linux options into user-supplied yaml\n          return new SnapCoreCustom(this.packager, this, snapcraft.custom || {})\n      }\n    }\n    return new SnapCoreLegacy(this.packager, this, deepAssign({ base: \"core20\" as const }, snapLinuxOptions, {}))\n  }\n\n  isElectronVersionGreaterOrEqualThan(version: string, fallback?: string): boolean {\n    const electronVersion = this.packager.config.electronVersion\n    if (!electronVersion) {\n      return fallback ? semver.gte(fallback, version) : true\n    }\n    return semver.gte(electronVersion, version)\n  }\n\n  private async computeMimeTypeFiles(): Promise<string | null> {\n    const items: Array<string> = []\n    for (const fileAssociation of this.packager.fileAssociations) {\n      if (!fileAssociation.mimeType) {\n        continue\n      }\n\n      const data = `<mime-type type=\"${fileAssociation.mimeType}\">\n  <glob pattern=\"*.${fileAssociation.ext}\"/>\n    ${fileAssociation.description ? `<comment>${fileAssociation.description}</comment>` : \"\"}\n  <icon name=\"x-office-document\" />\n</mime-type>`\n      items.push(data)\n    }\n\n    if (items.length === 0) {\n      return null\n    }\n\n    const file = await this.packager.getTempFile(\".xml\")\n    await outputFile(\n      file,\n      '<?xml version=\"1.0\" encoding=\"utf-8\"?>\\n<mime-info xmlns=\"http://www.freedesktop.org/standards/shared-mime-info\">\\n' + items.join(\"\\n\") + \"\\n</mime-info>\"\n    )\n    return file\n  }\n\n  // must be name without spaces and other special characters, but not product name used\n  private async computeDesktopIcons(): Promise<Array<IconInfo>> {\n    const packager = this.packager\n    const { config } = packager\n    const platformOptions = packager.platformOptions\n\n    const sources = [platformOptions.icon, config.mac?.icon ?? config.icon].filter(str => !!str) as string[]\n\n    // If no explicit sources are defined, fallback to buildResources directory, then default framework icon\n    let fallbackSources = [...asArray(packager.getDefaultFrameworkIcon())]\n    const buildResources = config.directories?.buildResources\n    if (buildResources && (await exists(join(buildResources, \"icons\")))) {\n      fallbackSources = [buildResources, ...fallbackSources]\n    }\n\n    // need to put here and not as default because need to resolve image size\n    const result = await packager.resolveIcon(sources, fallbackSources, \"set\")\n    this.maxIconPath = result[result.length - 1].file\n\n    // Ignore .icon files for linux (they are exclusive for macOS)\n    return result.filter(icon => !icon.file.endsWith(\".icon\"))\n  }\n\n  getDescription(options: CommonLinuxOptions) {\n    return options.description || this.packager.appInfo.description\n  }\n\n  getSanitizedVersion(target: string) {\n    const {\n      appInfo: { version },\n    } = this.packager\n    switch (target) {\n      case \"pacman\":\n        return version.replace(/-/g, \"_\")\n      case \"rpm\":\n      case \"deb\":\n        return version.replace(/-/g, \"~\")\n      default:\n        return version\n    }\n  }\n\n  async writeDesktopEntry(targetSpecificOptions: CommonLinuxOptions, exec?: string, destination?: string | null, extra?: Record<string, string>): Promise<string> {\n    const data = await this.computeDesktopEntry(targetSpecificOptions, exec, extra)\n    const file = destination || (await this.packager.getTempFile(`${this.packager.appInfo.productFilename}.desktop`))\n    await outputFile(file, data)\n    return file\n  }\n\n  getDesktopFileName(fallback: string = this.packager.executableName): string {\n    if (!this.packager.platformOptions.syncDesktopName) {\n      return fallback\n    }\n    const trimmedDesktopName = this.packager.metadata.desktopName?.trim()\n    if (isEmptyOrSpaces(trimmedDesktopName)) {\n      return fallback\n    }\n    const basename = trimmedDesktopName.replace(/\\.desktop$/, \"\")\n    // Guard against path traversal: desktopName flows into filesystem paths\n    // (snap/gui/<name>.desktop, /usr/share/applications/<name>.desktop, etc.).\n    if (/[/\\\\]/.test(basename) || [...basename].some(c => c.charCodeAt(0) === 0)) {\n      throw new InvalidConfigurationError(`desktopName \"${trimmedDesktopName}\" produces an invalid .desktop filename — remove any path separators or NUL characters`)\n    }\n    return basename\n  }\n\n  computeDesktopEntry(targetSpecificOptions: CommonLinuxOptions, exec?: string, extra?: Record<string, string>): Promise<string> {\n    if (exec != null && exec.length === 0) {\n      throw new Error(\"Specified exec is empty\")\n    }\n    // https://github.com/electron-userland/electron-builder/issues/3418\n    if (targetSpecificOptions.desktop?.entry?.Exec) {\n      throw new Error(\"Please specify executable name as linux.executableName instead of linux.desktop.Exec\")\n    }\n\n    const packager = this.packager\n    const appInfo = packager.appInfo\n\n    const executableArgs = targetSpecificOptions.executableArgs\n    if (exec == null) {\n      exec = `${installPrefix}/${appInfo.sanitizedProductName}/${packager.executableName}`\n      if (!/^[/0-9A-Za-z._-]+$/.test(exec)) {\n        exec = `\"${exec}\"`\n      }\n      if (executableArgs) {\n        exec += \" \"\n        // Each arg is double-quoted per the freedesktop Exec key spec so that\n        // spaces, $, ;, & and other reserved characters are not misinterpreted.\n        exec += executableArgs.map(desktopExecArgEscape).join(\" \")\n      }\n      // https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables\n      const execCodes = [\"%f\", \"%u\", \"%F\", \"%U\"]\n      if (executableArgs == null || executableArgs.findIndex(arg => execCodes.includes(arg)) === -1) {\n        exec += \" %U\"\n      }\n    }\n\n    // https://github.com/electron-userland/electron-builder/issues/9103\n    // Electron derives app_id from desktopName in package.json; StartupWMClass must match.\n    // https://github.com/electron/electron/blob/9a7b73b5334f1d72c08e2d5e94106706ed751186/lib/browser/init.ts#L128-L133\n    const trimmedDesktopName = packager.metadata.desktopName?.trim()\n    if (isEmptyOrSpaces(trimmedDesktopName)) {\n      log.warn(\n        {\n          reason: \"desktopName is not set in package.json\",\n          docs: \"https://www.electron.build/linux#window-association-desktopname--syncdesktopname\",\n        },\n        \"electron uses desktopName as app_id / WM_CLASS for window association. Without it desktop environments may not link running windows to this .desktop entry. Set desktopName in package.json and linux.syncDesktopName: true to fix.\"\n      )\n    }\n    const wmClass = !isEmptyOrSpaces(trimmedDesktopName) ? trimmedDesktopName.replace(/\\.desktop$/, \"\") : appInfo.productName\n\n    const desktopMeta = deepAssign<any>(\n      {\n        // String values are escaped per the freedesktop spec (\\\\, \\n, \\r, \\t)\n        // so that a product name containing a newline cannot inject new key=value\n        // pairs into the .desktop file (e.g. overriding the Exec key).\n        Name: desktopStringEscape(appInfo.productName),\n        Exec: exec,\n        Terminal: \"false\",\n        Type: \"Application\",\n        Icon: packager.executableName,\n        // https://askubuntu.com/questions/367396/what-represent-the-startupwmclass-field-of-a-desktop-file\n        // Set to desktopName (minus .desktop suffix) when provided, so it matches Electron's\n        // app_id and desktop environments can associate running windows with this entry.\n        // Falls back to productName for apps that don't set desktopName.\n        // to get WM_CLASS of running window: xprop WM_CLASS\n        // StartupWMClass doesn't work for unicode\n        // https://github.com/electron/electron/blob/2-0-x/atom/browser/native_window_views.cc#L226\n        StartupWMClass: desktopStringEscape(wmClass),\n      },\n      extra,\n      targetSpecificOptions.desktop?.entry ?? {}\n    )\n\n    const description = this.getDescription(targetSpecificOptions)\n    if (!isEmptyOrSpaces(description)) {\n      desktopMeta.Comment = desktopStringEscape(description)\n    }\n\n    const mimeTypes: Array<string> = asArray(targetSpecificOptions.mimeTypes)\n    for (const fileAssociation of packager.fileAssociations) {\n      if (fileAssociation.mimeType != null) {\n        mimeTypes.push(fileAssociation.mimeType)\n      }\n    }\n\n    for (const protocol of asArray(packager.config.protocols).concat(asArray(packager.platformOptions.protocols))) {\n      for (const scheme of asArray(protocol.schemes)) {\n        mimeTypes.push(`x-scheme-handler/${scheme}`)\n      }\n    }\n\n    if (mimeTypes.length !== 0) {\n      desktopMeta.MimeType = mimeTypes.join(\";\") + \";\"\n    }\n\n    let category = targetSpecificOptions.category\n    if (isEmptyOrSpaces(category)) {\n      const macCategory = (packager.config.mac || {}).category\n      if (macCategory != null) {\n        category = macToLinuxCategory[macCategory]\n      }\n\n      if (category == null) {\n        // https://github.com/develar/onshape-desktop-shell/issues/48\n        if (macCategory != null) {\n          log.warn({ macCategory }, \"cannot map macOS category to Linux. If possible mapping is known for you, please file issue to add it.\")\n        }\n        log.warn(\n          {\n            reason: \"linux.category is not set and cannot map from macOS\",\n            docs: \"https://www.electron.build/linux\",\n          },\n          'application Linux category is set to default \"Utility\"'\n        )\n        category = \"Utility\"\n      }\n    }\n    desktopMeta.Categories = `${category}${category.endsWith(\";\") ? \"\" : \";\"}`\n\n    let data = `[Desktop Entry]`\n    for (const name of Object.keys(desktopMeta)) {\n      data += `\\n${name}=${desktopMeta[name]}`\n    }\n    data += \"\\n\"\n    const desktopActions = targetSpecificOptions.desktop?.desktopActions ?? {}\n    for (const [actionName, config] of Object.entries(desktopActions)) {\n      if (!Object.keys(config ?? {}).length) {\n        continue\n      }\n      data += `\\n[Desktop Action ${actionName}]`\n      for (const [key, value] of Object.entries(config ?? {})) {\n        data += `\\n${key}=${value}`\n      }\n      data += \"\\n\"\n    }\n    return Promise.resolve(data)\n  }\n}\n\nconst macToLinuxCategory: any = {\n  \"public.app-category.graphics-design\": \"Graphics\",\n  \"public.app-category.developer-tools\": \"Development\",\n  \"public.app-category.education\": \"Education\",\n  \"public.app-category.games\": \"Game\",\n  \"public.app-category.video\": \"Video;AudioVideo\",\n  \"public.app-category.utilities\": \"Utility\",\n  \"public.app-category.social-networking\": \"Network;Chat\",\n  \"public.app-category.finance\": \"Office;Finance\",\n  \"public.app-category.music\": \"Audio;AudioVideo\",\n}\n"]}

package/dist/targets/linux/appimage/AppImageTarget.d.ts

@@ -0,0 +1,16 @@
+import { Arch } from "builder-util";
+import { Target } from "../../../core.js";
+import { LinuxPackager } from "../../../linuxPackager.js";
+import { AppImageOptions } from "../../../options/linuxOptions.js";
+import { LinuxTargetHelper } from "../LinuxTargetHelper.js";
+export declare const APP_RUN_ENTRYPOINT = "AppRun";
+export default class AppImageTarget extends Target {
+    private readonly packager;
+    private readonly helper;
+    readonly outDir: string;
+    readonly options: AppImageOptions;
+    private readonly desktopEntry;
+    constructor(_ignored: string, packager: LinuxPackager, helper: LinuxTargetHelper, outDir: string);
+    build(appOutDir: string, arch: Arch): Promise<any>;
+}
+//# sourceMappingURL=AppImageTarget.d.ts.map

package/dist/targets/linux/appimage/AppImageTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppImageTarget.d.ts","sourceRoot":"","sources":["../../../../src/targets/linux/appimage/AppImageTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAwB,MAAM,cAAc,CAAA;AAIzD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAGlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAS3D,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,MAAM;IAO9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IARzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAgE;IAEjG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAGzC,QAAQ,EAAE,MAAM,EACC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,iBAAiB,EACjC,MAAM,EAAE,MAAM;IAenB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;CA4HzD"}

package/dist/targets/linux/appimage/AppImageTarget.js

@@ -0,0 +1,141 @@
+import { log, serializeToYaml } from "builder-util";
+import { Lazy } from "lazy-val";
+import * as path from "path";
+import { Target } from "../../../core.js";
+import { getAppUpdatePublishConfiguration } from "../../../publish/PublishManager.js";
+import { getNotLocalizedLicenseFile } from "../../../util/license.js";
+import { createStageDir } from "../../targetUtil.js";
+import { buildLegacyFuse2AppImage, buildStaticRuntimeAppImage } from "./appImageUtil.js";
+import _fsExtra from "fs-extra";
+const { outputFile } = _fsExtra;
+// https://unix.stackexchange.com/questions/375191/append-to-sub-directory-inside-squashfs-file
+export const APP_RUN_ENTRYPOINT = "AppRun";
+export default class AppImageTarget extends Target {
+    constructor(_ignored, packager, helper, outDir) {
+        super("appImage");
+        this.packager = packager;
+        this.helper = helper;
+        this.outDir = outDir;
+        this.options = this.packager.getOptionsForTarget(this.name);
+        this.desktopEntry = new Lazy(() => {
+            const appimageTool = packager.config.toolsets?.appimage;
+            const defaultArgs = appimageTool == null || appimageTool === "0.0.0" ? ["--no-sandbox"] : [];
+            const args = this.options.executableArgs ?? defaultArgs;
+            const exec = [APP_RUN_ENTRYPOINT, ...args, "%U"].join(" ");
+            return helper.computeDesktopEntry(this.options, exec, {
+                "X-AppImage-Version": `${packager.appInfo.buildVersion}`,
+            });
+        });
+    }
+    async build(appOutDir, arch) {
+        const packager = this.packager;
+        const options = this.options;
+        // https://github.com/electron-userland/electron-builder/issues/775
+        // https://github.com/electron-userland/electron-builder/issues/1726
+        const artifactName = packager.expandArtifactNamePattern(options, "AppImage", arch);
+        const artifactPath = path.join(this.outDir, artifactName);
+        await packager.emitArtifactBuildStarted({
+            targetPresentableName: "AppImage",
+            file: artifactPath,
+            arch,
+        });
+        // Parallelize independent async operations
+        const [publishConfig, stageDir, desktopEntry, icons, license] = await Promise.all([
+            getAppUpdatePublishConfiguration(packager, options, arch, false),
+            createStageDir(this, packager, arch),
+            this.desktopEntry.value,
+            this.helper.icons,
+            getNotLocalizedLicenseFile(options.license, this.packager, ["txt", "html"]),
+        ]);
+        if (publishConfig != null) {
+            await outputFile(path.join(packager.getResourcesDir(appOutDir), "app-update.yml"), serializeToYaml(publishConfig));
+        }
+        // Validated once here; throws InvalidConfigurationError for path traversal / NUL.
+        const desktopBaseName = this.helper.getDesktopFileName();
+        if (this.packager.packagerOptions.effectiveOptionComputed != null &&
+            (await this.packager.packagerOptions.effectiveOptionComputed({ desktop: desktopEntry, desktopFileName: `${desktopBaseName}.desktop` }))) {
+            await stageDir.cleanup();
+            return;
+        }
+        let updateInfo;
+        try {
+            const appimageTool = this.packager.config.toolsets?.appimage;
+            if (appimageTool === "0.0.0") {
+                updateInfo = await buildLegacyFuse2AppImage({
+                    appDir: appOutDir,
+                    stageDir: stageDir.dir,
+                    arch,
+                    output: artifactPath,
+                    options: {
+                        productName: packager.appInfo.productName,
+                        productFilename: packager.appInfo.productFilename,
+                        executableName: packager.executableName,
+                        license,
+                        desktopEntry,
+                        icons,
+                        fileAssociations: packager.fileAssociations,
+                        desktopBaseName,
+                        compression: (() => {
+                            const c = options.compression;
+                            if (c === "xz" || c === "gzip") {
+                                return c;
+                            }
+                            if (packager.compression === "maximum") {
+                                return "xz";
+                            }
+                            return undefined; // normal/store/unset/zstd → mksquashfs defaults to gzip
+                        })(),
+                    },
+                }, packager.buildResourcesDir);
+            }
+            else {
+                updateInfo = await buildStaticRuntimeAppImage(appimageTool, {
+                    appDir: appOutDir,
+                    stageDir: stageDir.dir,
+                    arch,
+                    output: artifactPath,
+                    options: {
+                        productName: packager.appInfo.productName,
+                        productFilename: packager.appInfo.productFilename,
+                        executableName: packager.executableName,
+                        license,
+                        desktopEntry,
+                        icons,
+                        fileAssociations: packager.fileAssociations,
+                        desktopBaseName,
+                        compression: (() => {
+                            const c = options.compression;
+                            if (c === "gzip" || c === "zstd") {
+                                return c;
+                            }
+                            if (c === "xz") {
+                                return "zstd"; // nearest equivalent; static runtime does not support xz
+                            }
+                            if (packager.compression === "store") {
+                                return "gzip";
+                            }
+                            return "zstd"; // maximum/normal/unset → zstd for static runtime
+                        })(),
+                    },
+                }, packager.buildResourcesDir);
+            }
+        }
+        catch (error) {
+            log.error({ error: error.message }, "failed to build AppImage");
+            throw error;
+        }
+        finally {
+            await stageDir.cleanup().catch(() => { });
+        }
+        await packager.emitArtifactBuildCompleted({
+            file: artifactPath,
+            safeArtifactName: packager.computeSafeArtifactName(artifactName, "AppImage", arch, false),
+            target: this,
+            arch,
+            packager,
+            isWriteUpdateInfo: true,
+            updateInfo,
+        });
+    }
+}
+//# sourceMappingURL=AppImageTarget.js.map

package/dist/targets/linux/appimage/AppImageTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppImageTarget.js","sourceRoot":"","sources":["../../../../src/targets/linux/appimage/AppImageTarget.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arch, log, serializeToYaml } from \"builder-util\"\n\nimport { Lazy } from \"lazy-val\"\nimport * as path from \"path\"\nimport { Target } from \"../../../core.js\"\nimport { LinuxPackager } from \"../../../linuxPackager.js\"\nimport { AppImageOptions } from \"../../../options/linuxOptions.js\"\nimport { getAppUpdatePublishConfiguration } from \"../../../publish/PublishManager.js\"\nimport { getNotLocalizedLicenseFile } from \"../../../util/license.js\"\nimport { LinuxTargetHelper } from \"../LinuxTargetHelper.js\"\nimport { createStageDir } from \"../../targetUtil.js\"\nimport { buildLegacyFuse2AppImage, buildStaticRuntimeAppImage } from \"./appImageUtil.js\"\nimport { BlockMapDataHolder } from \"builder-util-runtime\"\nimport _fsExtra from \"fs-extra\"\nconst { outputFile } = _fsExtra\n\n// https://unix.stackexchange.com/questions/375191/append-to-sub-directory-inside-squashfs-file\n\nexport const APP_RUN_ENTRYPOINT = \"AppRun\"\n\nexport default class AppImageTarget extends Target {\n  readonly options: AppImageOptions = this.packager.getOptionsForTarget<AppImageOptions>(this.name)\n\n  private readonly desktopEntry: Lazy<string>\n\n  constructor(\n    _ignored: string,\n    private readonly packager: LinuxPackager,\n    private readonly helper: LinuxTargetHelper,\n    readonly outDir: string\n  ) {\n    super(\"appImage\")\n\n    this.desktopEntry = new Lazy<string>(() => {\n      const appimageTool = packager.config.toolsets?.appimage\n      const defaultArgs = appimageTool == null || appimageTool === \"0.0.0\" ? [\"--no-sandbox\"] : []\n      const args = this.options.executableArgs ?? defaultArgs\n      const exec = [APP_RUN_ENTRYPOINT, ...args, \"%U\"].join(\" \")\n      return helper.computeDesktopEntry(this.options, exec, {\n        \"X-AppImage-Version\": `${packager.appInfo.buildVersion}`,\n      })\n    })\n  }\n\n  async build(appOutDir: string, arch: Arch): Promise<any> {\n    const packager = this.packager\n\n    const options = this.options\n    // https://github.com/electron-userland/electron-builder/issues/775\n    // https://github.com/electron-userland/electron-builder/issues/1726\n    const artifactName = packager.expandArtifactNamePattern(options, \"AppImage\", arch)\n    const artifactPath = path.join(this.outDir, artifactName)\n\n    await packager.emitArtifactBuildStarted({\n      targetPresentableName: \"AppImage\",\n      file: artifactPath,\n      arch,\n    })\n\n    // Parallelize independent async operations\n    const [publishConfig, stageDir, desktopEntry, icons, license] = await Promise.all([\n      getAppUpdatePublishConfiguration(packager, options, arch, false),\n      createStageDir(this, packager, arch),\n      this.desktopEntry.value,\n      this.helper.icons,\n      getNotLocalizedLicenseFile(options.license, this.packager, [\"txt\", \"html\"]),\n    ])\n\n    if (publishConfig != null) {\n      await outputFile(path.join(packager.getResourcesDir(appOutDir), \"app-update.yml\"), serializeToYaml(publishConfig))\n    }\n\n    // Validated once here; throws InvalidConfigurationError for path traversal / NUL.\n    const desktopBaseName = this.helper.getDesktopFileName()\n\n    if (\n      this.packager.packagerOptions.effectiveOptionComputed != null &&\n      (await this.packager.packagerOptions.effectiveOptionComputed({ desktop: desktopEntry, desktopFileName: `${desktopBaseName}.desktop` }))\n    ) {\n      await stageDir.cleanup()\n      return\n    }\n\n    let updateInfo: BlockMapDataHolder\n    try {\n      const appimageTool = this.packager.config.toolsets?.appimage\n      if (appimageTool === \"0.0.0\") {\n        updateInfo = await buildLegacyFuse2AppImage(\n          {\n            appDir: appOutDir,\n            stageDir: stageDir.dir,\n            arch,\n            output: artifactPath,\n            options: {\n              productName: packager.appInfo.productName,\n              productFilename: packager.appInfo.productFilename,\n              executableName: packager.executableName,\n              license,\n              desktopEntry,\n              icons,\n              fileAssociations: packager.fileAssociations,\n              desktopBaseName,\n              compression: (() => {\n                const c = options.compression\n                if (c === \"xz\" || c === \"gzip\") {\n                  return c\n                }\n                if (packager.compression === \"maximum\") {\n                  return \"xz\"\n                }\n                return undefined // normal/store/unset/zstd → mksquashfs defaults to gzip\n              })(),\n            },\n          },\n          packager.buildResourcesDir\n        )\n      } else {\n        updateInfo = await buildStaticRuntimeAppImage(\n          appimageTool,\n          {\n            appDir: appOutDir,\n            stageDir: stageDir.dir,\n            arch,\n            output: artifactPath,\n            options: {\n              productName: packager.appInfo.productName,\n              productFilename: packager.appInfo.productFilename,\n              executableName: packager.executableName,\n              license,\n              desktopEntry,\n              icons,\n              fileAssociations: packager.fileAssociations,\n              desktopBaseName,\n              compression: (() => {\n                const c = options.compression\n                if (c === \"gzip\" || c === \"zstd\") {\n                  return c\n                }\n                if (c === \"xz\") {\n                  return \"zstd\" // nearest equivalent; static runtime does not support xz\n                }\n                if (packager.compression === \"store\") {\n                  return \"gzip\"\n                }\n                return \"zstd\" // maximum/normal/unset → zstd for static runtime\n              })(),\n            },\n          },\n          packager.buildResourcesDir\n        )\n      }\n    } catch (error: any) {\n      log.error({ error: error.message }, \"failed to build AppImage\")\n      throw error\n    } finally {\n      await stageDir.cleanup().catch(() => {})\n    }\n\n    await packager.emitArtifactBuildCompleted({\n      file: artifactPath,\n      safeArtifactName: packager.computeSafeArtifactName(artifactName, \"AppImage\", arch, false),\n      target: this,\n      arch,\n      packager,\n      isWriteUpdateInfo: true,\n      updateInfo,\n    })\n  }\n}\n"]}

package/dist/targets/linux/appimage/appImageUtil.d.ts

@@ -0,0 +1,57 @@
+import { Arch } from "builder-util";
+import { FileAssociation } from "../../../options/FileAssociation.js";
+import { BlockMapDataHolder } from "builder-util-runtime";
+import { ToolsetConfig } from "../../../configuration.js";
+import { IconInfo } from "../../../util/iconConverter.js";
+interface Options {
+    productName: string;
+    productFilename: string;
+    executableName: string;
+    desktopEntry: string;
+    icons: IconInfo[];
+    license?: string | null;
+    fileAssociations: FileAssociation[];
+    /**
+     * The compression type available for static runtime is limited as it's only compiled with support for gzip and zstd.
+     * "xz" is only valid for the legacy FUSE2 (0.0.0) toolset.
+     *
+     * [stderr] Squashfs image uses lzo compression, this version supports only zlib, zstd.
+     * Failed to open squashfs image
+     * Failed to extract AppImage
+     *
+     */
+    compression?: "gzip" | "zstd" | "xz";
+    /** Pre-computed desktop basename (already validated). When absent, falls back to `executableName`. */
+    desktopBaseName?: string;
+}
+export interface AppImageBuilderOptions {
+    appDir: string;
+    stageDir: string;
+    arch: Arch;
+    output: string;
+    options: Options;
+}
+export declare function buildStaticRuntimeAppImage(appimageToolVersion: ToolsetConfig["appimage"], opts: AppImageBuilderOptions, resourcesDir: string): Promise<BlockMapDataHolder>;
+export declare function buildLegacyFuse2AppImage(opts: AppImageBuilderOptions, resourcesDir: string): Promise<BlockMapDataHolder>;
+/**
+ * Validates that critical path fields (executable name, product filename, license filename)
+ * contain only characters that are safe for use in filesystem paths and embedded bash strings.
+ * Allowed: Unicode letters, digits, dots, underscores, hyphens, and spaces.
+ */
+export declare function validateCriticalPathString(str: string, fieldName: string): void;
+export type AppRunScriptBase = {
+    ExecutableName: string;
+    DesktopFileName: string;
+    ProductFilename: string;
+    ProductName: string;
+    ResourceName: string;
+    MimeTypeFile?: string;
+};
+export type AppRunScriptWithEula = AppRunScriptBase & {
+    EulaFile: string;
+    IsHtmlEula: boolean;
+};
+export type AppRunScript = AppRunScriptBase | AppRunScriptWithEula;
+export declare function generateAppRunScript(config: AppRunScript): string;
+export {};
+//# sourceMappingURL=appImageUtil.d.ts.map