craft-native 0.0.104 → 0.0.107

package/dist/index.cjs

@@ -310,7 +310,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.104";
+var version = "0.0.107";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -322,6 +322,7 @@ var import_fs = require("fs");
 var import_os = require("os");
 var import_path = require("path");
 var import_zlib = require("zlib");
+var DEFAULT_DEB_DEPENDENCIES = ["libgtk-3-0", "libwebkit2gtk-4.1-37", "libnotify-bin"];
 var CRC32_TABLE = (() => {
   const table = new Uint32Array(256);
   for (let n = 0;n < 256; n++) {
@@ -553,6 +554,9 @@ async function packageWindows(config, outDir) {
       outputPath: import_path.join(outDir, `${name}-${version2}.msi`),
       manufacturer: config.author || "Unknown",
       architecture: opts.architecture || windowsArchitecture(process.arch),
+      additionalFiles: opts.additionalFiles,
+      urlSchemes: opts.urlSchemes,
+      launchUrl: opts.launchUrl,
       certificatePath: opts.certificatePath,
       certificatePassword: opts.certificatePassword
     });
@@ -568,7 +572,9 @@ async function packageWindows(config, outDir) {
     const zipResult = await createZIP({
       name,
       version: version2,
+      manufacturer: config.author || "Unknown",
       binaryPath: config.binaryPath,
+      additionalFiles: opts.additionalFiles,
       outputPath: import_path.join(outDir, `${name}-${version2}-windows.zip`)
     });
     results.push({
@@ -593,7 +599,9 @@ async function packageLinux(config, outDir) {
       outputPath: import_path.join(outDir, `${name}_${version2}_amd64.deb`),
       description: config.description || "",
       maintainer: config.author || "Unknown",
-      dependencies: opts.debDependencies || ["libgtk-3-0", "libwebkit2gtk-4.1-37"]
+      dependencies: opts.debDependencies || [...DEFAULT_DEB_DEPENDENCIES],
+      urlSchemes: opts.urlSchemes,
+      launchUrl: opts.launchUrl
     });
     results.push({
       success: debResult.success,
@@ -640,17 +648,7 @@ async function packageLinux(config, outDir) {
 }
 var URL_SCHEME = /^[a-z][a-z0-9+.-]*$/i;
 function urlTypesEntry(bundleId, schemes) {
-  const seen = new Set;
-  const unique = [];
-  for (const scheme of schemes) {
-    if (!URL_SCHEME.test(scheme))
-      throw new Error(`Invalid URL scheme ${JSON.stringify(scheme)}: must start with a letter and contain only letters, digits, "+", "-" or "."`);
-    const key = scheme.toLowerCase();
-    if (seen.has(key))
-      continue;
-    seen.add(key);
-    unique.push(scheme);
-  }
+  const unique = uniqueUrlSchemes(schemes);
   if (unique.length === 0)
     return null;
   const list = unique.map((scheme) => `          <string>${xml(scheme)}</string>`).join(`
@@ -669,6 +667,46 @@ ${list}
       </dict>
     </array>`;
 }
+function uniqueUrlSchemes(schemes) {
+  const seen = new Set;
+  const unique = [];
+  for (const scheme of schemes) {
+    if (!URL_SCHEME.test(scheme))
+      throw new Error(`Invalid URL scheme ${JSON.stringify(scheme)}: must start with a letter and contain only letters, digits, "+", "-" or "."`);
+    const key = scheme.toLowerCase();
+    if (seen.has(key))
+      continue;
+    seen.add(key);
+    unique.push(scheme);
+  }
+  return unique;
+}
+function launchPageUrl(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error(`Invalid packaged app launch URL: ${JSON.stringify(value)}`);
+  }
+  if (!["http:", "https:", "file:"].includes(url.protocol))
+    throw new Error(`Unsupported packaged app launch URL protocol: ${url.protocol}`);
+  return url.href;
+}
+function desktopExecArgument(value) {
+  return `"${value.replaceAll("%", "%%").replaceAll("\\", "\\\\").replaceAll('"', "\\\"").replaceAll("$", "\\$").replaceAll("`", "\\`")}"`;
+}
+function linuxDesktopEntry(name, binaryName, urlSchemes = [], launchUrl) {
+  const schemes = uniqueUrlSchemes(urlSchemes);
+  const page = launchUrl ? ` --url ${desktopExecArgument(launchPageUrl(launchUrl))}` : "";
+  return `[Desktop Entry]
+Type=Application
+Name=${name}
+Exec=/usr/bin/${binaryName}${page}${schemes.length ? " --deep-link %u" : ""}
+Terminal=false
+Categories=Utility;
+${schemes.length ? `MimeType=${schemes.map((scheme) => `x-scheme-handler/${scheme.toLowerCase()};`).join("")}
+` : ""}`;
+}
 function macOSInfoPlist(metadata) {
   const entries = [
     ["CFBundleExecutable", metadata.name],
@@ -706,7 +744,7 @@ function codesignArguments(opts) {
     "--force",
     "--sign",
     opts.identity,
-    "--timestamp",
+    ...opts.identity === "-" ? [] : ["--timestamp"],
     ...opts.hardenedRuntime ? ["--options", "runtime"] : [],
     ...opts.entitlements ? ["--entitlements", opts.entitlements] : [],
     "--deep",
@@ -934,6 +972,10 @@ function deterministicGuid(value) {
   const hex = digest.join("").toUpperCase();
   return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
+var WINDOWS_NOTIFICATION_ID_FILE = "craft-notification-id.txt";
+function windowsNotificationAppId(name, manufacturer) {
+  return `Craft.${deterministicGuid(`${manufacturer.trim() || "Unknown"}/${name}`)}`;
+}
 function windowsArchitecture(architecture) {
   if (architecture === "ia32" || architecture === "x86")
     return "x86";
@@ -941,7 +983,7 @@ function windowsArchitecture(architecture) {
     return architecture;
   throw new Error(`Unsupported Windows package architecture: ${architecture}`);
 }
-function renderWixSource(opts, sourceName) {
+function renderWixSource(opts, sourceName, additionalFileNames = []) {
   if (!/^[0-9]+\.[0-9]+\.[0-9]+(?:\.[0-9]+)?$/.test(opts.version))
     throw new Error(`MSI version must have 3 or 4 numeric parts: ${opts.version}`);
   const id = wixIdentifier(opts.name);
@@ -949,6 +991,9 @@ function renderWixSource(opts, sourceName) {
   const upgradeCode = deterministicGuid(`${manufacturer}/${opts.name}`);
   const programFilesFolder = opts.architecture === "x86" ? "ProgramFilesFolder" : "ProgramFiles64Folder";
   const win64 = opts.architecture === "x86" ? "no" : "yes";
+  const notificationAppId = windowsNotificationAppId(opts.name, manufacturer);
+  const schemes = uniqueUrlSchemes(opts.urlSchemes || []);
+  const page = opts.launchUrl ? ` --url &quot;${xml(launchPageUrl(opts.launchUrl))}&quot;` : "";
   return `<?xml version="1.0" encoding="UTF-8"?>
 <Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
   <Product Id="*" Name="${xml(opts.name)}" Language="1033" Version="${opts.version}" Manufacturer="${xml(manufacturer)}" UpgradeCode="${upgradeCode}">
@@ -959,18 +1004,59 @@ function renderWixSource(opts, sourceName) {
       <Directory Id="${programFilesFolder}">
         <Directory Id="INSTALLFOLDER" Name="${xml(opts.name)}">
           <Component Id="${id}Executable" Guid="*" Win64="${win64}">
-            <File Id="${id}File" Source="${xml(sourceName)}" KeyPath="yes" />
+            <File Id="${id}File" Source="${xml(sourceName)}" KeyPath="yes">
+              <Shortcut Id="${id}StartMenuShortcut" Directory="ProgramMenuFolder" Name="${xml(opts.name)}" WorkingDirectory="INSTALLFOLDER"${page ? ` Arguments="${page.trim()}"` : ""}>
+                <ShortcutProperty Key="System.AppUserModel.ID" Value="${notificationAppId}" />
+              </Shortcut>
+            </File>
+          </Component>
+          <Component Id="${id}NotificationIdentity" Guid="*" Win64="${win64}">
+            <File Id="${id}NotificationIdentityFile" Source="${WINDOWS_NOTIFICATION_ID_FILE}" KeyPath="yes" />
           </Component>
+${additionalFileNames.map((name, index) => `          <Component Id="${id}Extra${index}" Guid="*" Win64="${win64}">
+            <File Id="${id}ExtraFile${index}" Source="${xml(name)}" KeyPath="yes" />
+          </Component>`).join(`
+`)}
+${schemes.map((scheme, index) => `          <Component Id="${id}Protocol${index}" Guid="${deterministicGuid(`${manufacturer}/${opts.name}/protocol/${scheme.toLowerCase()}`)}" Win64="${win64}">
+            <RegistryKey Root="HKLM" Key="Software\\Classes\\${xml(scheme.toLowerCase())}" Action="createAndRemoveOnUninstall">
+              <RegistryValue Type="string" Value="URL:${xml(opts.name)} Protocol" KeyPath="yes" />
+              <RegistryValue Type="string" Name="URL Protocol" Value="" />
+              <RegistryKey Key="shell\\open\\command">
+                <RegistryValue Type="string" Value="&quot;[#${id}File]&quot;${page} --deep-link &quot;%1&quot;" />
+              </RegistryKey>
+            </RegistryKey>
+          </Component>`).join(`
+`)}
         </Directory>
       </Directory>
+      <Directory Id="ProgramMenuFolder" />
     </Directory>
     <Feature Id="ProductFeature" Title="${xml(opts.name)}" Level="1">
       <ComponentRef Id="${id}Executable" />
+      <ComponentRef Id="${id}NotificationIdentity" />
+${additionalFileNames.map((_, index) => `      <ComponentRef Id="${id}Extra${index}" />`).join(`
+`)}
+${schemes.map((_, index) => `      <ComponentRef Id="${id}Protocol${index}" />`).join(`
+`)}
     </Feature>
   </Product>
 </Wix>
 `;
 }
+function windowsCompanionFiles(paths, executableName) {
+  const seen = new Set([executableName.toLowerCase(), WINDOWS_NOTIFICATION_ID_FILE.toLowerCase()]);
+  return (paths || []).map((path) => {
+    const name = import_path.basename(path);
+    if (!name || /[<>:"/\\|?*\u0000-\u001F]/.test(name) || /[. ]$/.test(name) || /^(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i.test(name))
+      throw new Error(`Invalid Windows companion file name: ${JSON.stringify(name)}`);
+    if (seen.has(name.toLowerCase()))
+      throw new Error(`Duplicate Windows package file: ${name}`);
+    seen.add(name.toLowerCase());
+    if (!import_fs.existsSync(path) || import_fs.lstatSync(path).isDirectory())
+      throw new Error(`Windows companion file not found: ${path}`);
+    return { path, name };
+  });
+}
 function windowsExecutableName(name) {
   if (name.length === 0 || name.trim() !== name || /[<>:"/\\|?*\u0000-\u001F]/.test(name) || /[. ]$/.test(name))
     throw new Error(`Invalid Windows application name: ${JSON.stringify(name)}`);
@@ -992,11 +1078,15 @@ async function createMSI(opts) {
   const tempDir = import_fs.mkdtempSync(import_path.join(import_os.tmpdir(), "craft-msi-"));
   try {
     const binaryName = windowsExecutableName(opts.name);
+    const additionalFiles = windowsCompanionFiles(opts.additionalFiles, binaryName);
     const sourcePath = import_path.join(tempDir, binaryName);
     const wxsPath = import_path.join(tempDir, "installer.wxs");
     const wixobjPath = import_path.join(tempDir, "installer.wixobj");
     import_fs.copyFileSync(opts.binaryPath, sourcePath);
-    import_fs.writeFileSync(wxsPath, renderWixSource(opts, binaryName));
+    import_fs.writeFileSync(import_path.join(tempDir, WINDOWS_NOTIFICATION_ID_FILE), windowsNotificationAppId(opts.name, opts.manufacturer));
+    for (const file of additionalFiles)
+      import_fs.copyFileSync(file.path, import_path.join(tempDir, file.name));
+    import_fs.writeFileSync(wxsPath, renderWixSource(opts, binaryName, additionalFiles.map((file) => file.name)));
     await runCommand("candle.exe", candleArguments(opts.architecture, wixobjPath, wxsPath), tempDir);
     await runCommand("light.exe", ["-nologo", "-sval", "-out", opts.outputPath, wixobjPath], tempDir);
     if (opts.certificatePath) {
@@ -1018,8 +1108,13 @@ async function createMSI(opts) {
 }
 async function createZIP(opts) {
   try {
-    const data = new Uint8Array(import_fs.readFileSync(opts.binaryPath));
-    const zip = buildZip([{ name: `${opts.name}.exe`, data }]);
+    const binaryName = windowsExecutableName(opts.name);
+    const additionalFiles = windowsCompanionFiles(opts.additionalFiles, binaryName);
+    const entries = [{ name: binaryName, data: new Uint8Array(import_fs.readFileSync(opts.binaryPath)) }];
+    entries.push({ name: WINDOWS_NOTIFICATION_ID_FILE, data: new TextEncoder().encode(windowsNotificationAppId(opts.name, opts.manufacturer)) });
+    for (const file of additionalFiles)
+      entries.push({ name: file.name, data: new Uint8Array(import_fs.readFileSync(file.path)) });
+    const zip = buildZip(entries);
     import_fs.writeFileSync(opts.outputPath, zip);
     return { success: true, outputPath: opts.outputPath };
   } catch (err) {
@@ -1049,6 +1144,7 @@ async function createDEB(opts) {
           return;
         }
       }
+      const desktopContent = linuxDesktopEntry(opts.name, sanitizedName, opts.urlSchemes, opts.launchUrl);
       const tempDir = import_fs.mkdtempSync(import_path.join(import_os.tmpdir(), "craft-deb-"));
       const debianDir = import_path.join(tempDir, "DEBIAN");
       const binDir = import_path.join(tempDir, "usr", "bin");
@@ -1069,13 +1165,6 @@ Maintainer: ${maintainer}
 Description: ${description || opts.name}
 `;
       import_fs.writeFileSync(import_path.join(debianDir, "control"), controlContent);
-      const desktopContent = `[Desktop Entry]
-Type=Application
-Name=${opts.name}
-Exec=/usr/bin/${binaryName}
-Terminal=false
-Categories=Utility;
-`;
       import_fs.writeFileSync(import_path.join(applicationsDir, `${binaryName}.desktop`), desktopContent);
       const proc = import_child_process.spawn("dpkg-deb", ["--build", tempDir, opts.outputPath]);
       proc.on("close", (code) => {

package/dist/index.js

@@ -58,7 +58,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.104";
+var version = "0.0.107";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -82,6 +82,7 @@ import {
 import { homedir, tmpdir } from "os";
 import { basename, join } from "path";
 import { deflateRawSync } from "zlib";
+var DEFAULT_DEB_DEPENDENCIES = ["libgtk-3-0", "libwebkit2gtk-4.1-37", "libnotify-bin"];
 var CRC32_TABLE = (() => {
   const table = new Uint32Array(256);
   for (let n = 0;n < 256; n++) {
@@ -313,6 +314,9 @@ async function packageWindows(config, outDir) {
       outputPath: join(outDir, `${name}-${version2}.msi`),
       manufacturer: config.author || "Unknown",
       architecture: opts.architecture || windowsArchitecture(process.arch),
+      additionalFiles: opts.additionalFiles,
+      urlSchemes: opts.urlSchemes,
+      launchUrl: opts.launchUrl,
       certificatePath: opts.certificatePath,
       certificatePassword: opts.certificatePassword
     });
@@ -328,7 +332,9 @@ async function packageWindows(config, outDir) {
     const zipResult = await createZIP({
       name,
       version: version2,
+      manufacturer: config.author || "Unknown",
       binaryPath: config.binaryPath,
+      additionalFiles: opts.additionalFiles,
       outputPath: join(outDir, `${name}-${version2}-windows.zip`)
     });
     results.push({
@@ -353,7 +359,9 @@ async function packageLinux(config, outDir) {
       outputPath: join(outDir, `${name}_${version2}_amd64.deb`),
       description: config.description || "",
       maintainer: config.author || "Unknown",
-      dependencies: opts.debDependencies || ["libgtk-3-0", "libwebkit2gtk-4.1-37"]
+      dependencies: opts.debDependencies || [...DEFAULT_DEB_DEPENDENCIES],
+      urlSchemes: opts.urlSchemes,
+      launchUrl: opts.launchUrl
     });
     results.push({
       success: debResult.success,
@@ -400,17 +408,7 @@ async function packageLinux(config, outDir) {
 }
 var URL_SCHEME = /^[a-z][a-z0-9+.-]*$/i;
 function urlTypesEntry(bundleId, schemes) {
-  const seen = new Set;
-  const unique = [];
-  for (const scheme of schemes) {
-    if (!URL_SCHEME.test(scheme))
-      throw new Error(`Invalid URL scheme ${JSON.stringify(scheme)}: must start with a letter and contain only letters, digits, "+", "-" or "."`);
-    const key = scheme.toLowerCase();
-    if (seen.has(key))
-      continue;
-    seen.add(key);
-    unique.push(scheme);
-  }
+  const unique = uniqueUrlSchemes(schemes);
   if (unique.length === 0)
     return null;
   const list = unique.map((scheme) => `          <string>${xml(scheme)}</string>`).join(`
@@ -429,6 +427,46 @@ ${list}
       </dict>
     </array>`;
 }
+function uniqueUrlSchemes(schemes) {
+  const seen = new Set;
+  const unique = [];
+  for (const scheme of schemes) {
+    if (!URL_SCHEME.test(scheme))
+      throw new Error(`Invalid URL scheme ${JSON.stringify(scheme)}: must start with a letter and contain only letters, digits, "+", "-" or "."`);
+    const key = scheme.toLowerCase();
+    if (seen.has(key))
+      continue;
+    seen.add(key);
+    unique.push(scheme);
+  }
+  return unique;
+}
+function launchPageUrl(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error(`Invalid packaged app launch URL: ${JSON.stringify(value)}`);
+  }
+  if (!["http:", "https:", "file:"].includes(url.protocol))
+    throw new Error(`Unsupported packaged app launch URL protocol: ${url.protocol}`);
+  return url.href;
+}
+function desktopExecArgument(value) {
+  return `"${value.replaceAll("%", "%%").replaceAll("\\", "\\\\").replaceAll('"', "\\\"").replaceAll("$", "\\$").replaceAll("`", "\\`")}"`;
+}
+function linuxDesktopEntry(name, binaryName, urlSchemes = [], launchUrl) {
+  const schemes = uniqueUrlSchemes(urlSchemes);
+  const page = launchUrl ? ` --url ${desktopExecArgument(launchPageUrl(launchUrl))}` : "";
+  return `[Desktop Entry]
+Type=Application
+Name=${name}
+Exec=/usr/bin/${binaryName}${page}${schemes.length ? " --deep-link %u" : ""}
+Terminal=false
+Categories=Utility;
+${schemes.length ? `MimeType=${schemes.map((scheme) => `x-scheme-handler/${scheme.toLowerCase()};`).join("")}
+` : ""}`;
+}
 function macOSInfoPlist(metadata) {
   const entries = [
     ["CFBundleExecutable", metadata.name],
@@ -466,7 +504,7 @@ function codesignArguments(opts) {
     "--force",
     "--sign",
     opts.identity,
-    "--timestamp",
+    ...opts.identity === "-" ? [] : ["--timestamp"],
     ...opts.hardenedRuntime ? ["--options", "runtime"] : [],
     ...opts.entitlements ? ["--entitlements", opts.entitlements] : [],
     "--deep",
@@ -694,6 +732,10 @@ function deterministicGuid(value) {
   const hex = digest.join("").toUpperCase();
   return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
+var WINDOWS_NOTIFICATION_ID_FILE = "craft-notification-id.txt";
+function windowsNotificationAppId(name, manufacturer) {
+  return `Craft.${deterministicGuid(`${manufacturer.trim() || "Unknown"}/${name}`)}`;
+}
 function windowsArchitecture(architecture) {
   if (architecture === "ia32" || architecture === "x86")
     return "x86";
@@ -701,7 +743,7 @@ function windowsArchitecture(architecture) {
     return architecture;
   throw new Error(`Unsupported Windows package architecture: ${architecture}`);
 }
-function renderWixSource(opts, sourceName) {
+function renderWixSource(opts, sourceName, additionalFileNames = []) {
   if (!/^[0-9]+\.[0-9]+\.[0-9]+(?:\.[0-9]+)?$/.test(opts.version))
     throw new Error(`MSI version must have 3 or 4 numeric parts: ${opts.version}`);
   const id = wixIdentifier(opts.name);
@@ -709,6 +751,9 @@ function renderWixSource(opts, sourceName) {
   const upgradeCode = deterministicGuid(`${manufacturer}/${opts.name}`);
   const programFilesFolder = opts.architecture === "x86" ? "ProgramFilesFolder" : "ProgramFiles64Folder";
   const win64 = opts.architecture === "x86" ? "no" : "yes";
+  const notificationAppId = windowsNotificationAppId(opts.name, manufacturer);
+  const schemes = uniqueUrlSchemes(opts.urlSchemes || []);
+  const page = opts.launchUrl ? ` --url &quot;${xml(launchPageUrl(opts.launchUrl))}&quot;` : "";
   return `<?xml version="1.0" encoding="UTF-8"?>
 <Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
   <Product Id="*" Name="${xml(opts.name)}" Language="1033" Version="${opts.version}" Manufacturer="${xml(manufacturer)}" UpgradeCode="${upgradeCode}">
@@ -719,18 +764,59 @@ function renderWixSource(opts, sourceName) {
       <Directory Id="${programFilesFolder}">
         <Directory Id="INSTALLFOLDER" Name="${xml(opts.name)}">
           <Component Id="${id}Executable" Guid="*" Win64="${win64}">
-            <File Id="${id}File" Source="${xml(sourceName)}" KeyPath="yes" />
+            <File Id="${id}File" Source="${xml(sourceName)}" KeyPath="yes">
+              <Shortcut Id="${id}StartMenuShortcut" Directory="ProgramMenuFolder" Name="${xml(opts.name)}" WorkingDirectory="INSTALLFOLDER"${page ? ` Arguments="${page.trim()}"` : ""}>
+                <ShortcutProperty Key="System.AppUserModel.ID" Value="${notificationAppId}" />
+              </Shortcut>
+            </File>
+          </Component>
+          <Component Id="${id}NotificationIdentity" Guid="*" Win64="${win64}">
+            <File Id="${id}NotificationIdentityFile" Source="${WINDOWS_NOTIFICATION_ID_FILE}" KeyPath="yes" />
           </Component>
+${additionalFileNames.map((name, index) => `          <Component Id="${id}Extra${index}" Guid="*" Win64="${win64}">
+            <File Id="${id}ExtraFile${index}" Source="${xml(name)}" KeyPath="yes" />
+          </Component>`).join(`
+`)}
+${schemes.map((scheme, index) => `          <Component Id="${id}Protocol${index}" Guid="${deterministicGuid(`${manufacturer}/${opts.name}/protocol/${scheme.toLowerCase()}`)}" Win64="${win64}">
+            <RegistryKey Root="HKLM" Key="Software\\Classes\\${xml(scheme.toLowerCase())}" Action="createAndRemoveOnUninstall">
+              <RegistryValue Type="string" Value="URL:${xml(opts.name)} Protocol" KeyPath="yes" />
+              <RegistryValue Type="string" Name="URL Protocol" Value="" />
+              <RegistryKey Key="shell\\open\\command">
+                <RegistryValue Type="string" Value="&quot;[#${id}File]&quot;${page} --deep-link &quot;%1&quot;" />
+              </RegistryKey>
+            </RegistryKey>
+          </Component>`).join(`
+`)}
         </Directory>
       </Directory>
+      <Directory Id="ProgramMenuFolder" />
     </Directory>
     <Feature Id="ProductFeature" Title="${xml(opts.name)}" Level="1">
       <ComponentRef Id="${id}Executable" />
+      <ComponentRef Id="${id}NotificationIdentity" />
+${additionalFileNames.map((_, index) => `      <ComponentRef Id="${id}Extra${index}" />`).join(`
+`)}
+${schemes.map((_, index) => `      <ComponentRef Id="${id}Protocol${index}" />`).join(`
+`)}
     </Feature>
   </Product>
 </Wix>
 `;
 }
+function windowsCompanionFiles(paths, executableName) {
+  const seen = new Set([executableName.toLowerCase(), WINDOWS_NOTIFICATION_ID_FILE.toLowerCase()]);
+  return (paths || []).map((path) => {
+    const name = basename(path);
+    if (!name || /[<>:"/\\|?*\u0000-\u001F]/.test(name) || /[. ]$/.test(name) || /^(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$)/i.test(name))
+      throw new Error(`Invalid Windows companion file name: ${JSON.stringify(name)}`);
+    if (seen.has(name.toLowerCase()))
+      throw new Error(`Duplicate Windows package file: ${name}`);
+    seen.add(name.toLowerCase());
+    if (!existsSync2(path) || lstatSync(path).isDirectory())
+      throw new Error(`Windows companion file not found: ${path}`);
+    return { path, name };
+  });
+}
 function windowsExecutableName(name) {
   if (name.length === 0 || name.trim() !== name || /[<>:"/\\|?*\u0000-\u001F]/.test(name) || /[. ]$/.test(name))
     throw new Error(`Invalid Windows application name: ${JSON.stringify(name)}`);
@@ -752,11 +838,15 @@ async function createMSI(opts) {
   const tempDir = mkdtempSync(join(tmpdir(), "craft-msi-"));
   try {
     const binaryName = windowsExecutableName(opts.name);
+    const additionalFiles = windowsCompanionFiles(opts.additionalFiles, binaryName);
     const sourcePath = join(tempDir, binaryName);
     const wxsPath = join(tempDir, "installer.wxs");
     const wixobjPath = join(tempDir, "installer.wixobj");
     copyFileSync(opts.binaryPath, sourcePath);
-    writeFileSync(wxsPath, renderWixSource(opts, binaryName));
+    writeFileSync(join(tempDir, WINDOWS_NOTIFICATION_ID_FILE), windowsNotificationAppId(opts.name, opts.manufacturer));
+    for (const file of additionalFiles)
+      copyFileSync(file.path, join(tempDir, file.name));
+    writeFileSync(wxsPath, renderWixSource(opts, binaryName, additionalFiles.map((file) => file.name)));
     await runCommand("candle.exe", candleArguments(opts.architecture, wixobjPath, wxsPath), tempDir);
     await runCommand("light.exe", ["-nologo", "-sval", "-out", opts.outputPath, wixobjPath], tempDir);
     if (opts.certificatePath) {
@@ -778,8 +868,13 @@ async function createMSI(opts) {
 }
 async function createZIP(opts) {
   try {
-    const data = new Uint8Array(readFileSync(opts.binaryPath));
-    const zip = buildZip([{ name: `${opts.name}.exe`, data }]);
+    const binaryName = windowsExecutableName(opts.name);
+    const additionalFiles = windowsCompanionFiles(opts.additionalFiles, binaryName);
+    const entries = [{ name: binaryName, data: new Uint8Array(readFileSync(opts.binaryPath)) }];
+    entries.push({ name: WINDOWS_NOTIFICATION_ID_FILE, data: new TextEncoder().encode(windowsNotificationAppId(opts.name, opts.manufacturer)) });
+    for (const file of additionalFiles)
+      entries.push({ name: file.name, data: new Uint8Array(readFileSync(file.path)) });
+    const zip = buildZip(entries);
     writeFileSync(opts.outputPath, zip);
     return { success: true, outputPath: opts.outputPath };
   } catch (err) {
@@ -809,6 +904,7 @@ async function createDEB(opts) {
           return;
         }
       }
+      const desktopContent = linuxDesktopEntry(opts.name, sanitizedName, opts.urlSchemes, opts.launchUrl);
       const tempDir = mkdtempSync(join(tmpdir(), "craft-deb-"));
       const debianDir = join(tempDir, "DEBIAN");
       const binDir = join(tempDir, "usr", "bin");
@@ -829,13 +925,6 @@ Maintainer: ${maintainer}
 Description: ${description || opts.name}
 `;
       writeFileSync(join(debianDir, "control"), controlContent);
-      const desktopContent = `[Desktop Entry]
-Type=Application
-Name=${opts.name}
-Exec=/usr/bin/${binaryName}
-Terminal=false
-Categories=Utility;
-`;
       writeFileSync(join(applicationsDir, `${binaryName}.desktop`), desktopContent);
       const proc = spawn("dpkg-deb", ["--build", tempDir, opts.outputPath]);
       proc.on("close", (code) => {

package/dist/ios/src/index.d.ts

@@ -7,6 +7,8 @@ export type CraftAppearance = 'light' | 'dark' | 'system';
 export interface CraftConfig {
     appName: string;
     bundleId: string;
+    /** Opt in to UIKit + JavaScriptCore instead of the default WebView. */
+    renderer?: 'web' | 'native';
     version?: string;
     buildNumber?: string;
     darkMode?: boolean;
@@ -108,6 +110,8 @@ export interface InitOptions {
 }
 export interface BuildOptions {
     htmlPath?: string;
+    /** JavaScript bundle emitted by `stx-native compile Screen.stx --format bundle`. */
+    nativeBundlePath?: string;
     devServer?: string;
     output: string;
     generateProject?: boolean;

package/dist/ios/src/index.js

@@ -5,6 +5,7 @@ import { dirname, join, resolve } from "path";
 var {$ } = globalThis.Bun;
 var TEMPLATES_DIR = join(dirname(import.meta.dir), "templates");
 var DEFAULT_CONFIG = {
+  renderer: "web",
   version: "1.0.0",
   buildNumber: "1",
   darkMode: true,
@@ -393,12 +394,17 @@ async function init(options) {
     teamId: teamId || "",
     ...given
   };
+  if (config.renderer !== "web" && config.renderer !== "native") {
+    throw new Error(`Unknown iOS renderer: ${config.renderer}. Expected web or native.`);
+  }
   if (config.enableBackgroundLocation)
     config.enableGeolocation = true;
   writeFileSync(join(output, "craft.config.json"), JSON.stringify(config, null, 2));
   const swiftTemplate = readFileSync(join(TEMPLATES_DIR, "CraftApp.swift"), "utf-8");
   const swiftSource = swiftTemplate.replace(/CraftApp/g, `${name}App`).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
   writeFileSync(join(output, "Sources", `${name}App.swift`), swiftSource);
+  cpSync(join(TEMPLATES_DIR, "CraftNativeScreen.swift"), join(output, "Sources", "CraftNativeScreen.swift"));
+  cpSync(join(TEMPLATES_DIR, "CraftNativeActions.swift"), join(output, "Sources", "CraftNativeActions.swift"));
   const infoPlistTemplate = readFileSync(join(TEMPLATES_DIR, "Info.plist.template"), "utf-8");
   const infoPlist = infoPlistTemplate.replace(/\{\{APP_NAME\}\}/g, xmlEscape(displayName)).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId).replace(/\{\{VERSION\}\}/g, config.version || "1.0.0").replace(/\{\{BUILD_NUMBER\}\}/g, config.buildNumber || "1").replace(/\{\{UI_STYLE\}\}/g, renderAppearance(config).interfaceStyle).replace(/\{\{STATUS_BAR_STYLE\}\}/g, renderAppearance(config).statusBarStyle).replace(/\{\{ORIENTATIONS\}\}/g, renderOrientations(config)).replace(/\{\{USAGE_DESCRIPTIONS\}\}/g, renderUsageDescriptions(config)).replace(/\{\{URL_TYPES\}\}/g, renderUrlTypes(config)).replace(/\{\{BACKGROUND_MODES\}\}/g, renderBackgroundModes(config)).replace(/\{\{LIVE_ACTIVITY_SUPPORT\}\}/g, config.enableLiveActivities ? `    <key>NSSupportsLiveActivities</key>
     <true/>
@@ -533,13 +539,18 @@ ${nativeDependencies.join(`
   console.log("");
   console.log("Next steps:");
   console.log(`  1. cd ${output}`);
-  console.log("  2. Add your web content to dist/index.html");
-  console.log("  3. Run: craft ios build");
+  if (config.renderer === "native") {
+    console.log("  2. Compile your screen: stx-native compile Screen.stx --format bundle --output screen.js");
+    console.log("  3. Run: craft ios build --native-bundle screen.js");
+  } else {
+    console.log("  2. Add your web content to dist/index.html");
+    console.log("  3. Run: craft ios build");
+  }
   console.log("  4. Run: craft ios open");
   console.log("");
 }
 async function build(options) {
-  const { htmlPath, devServer, output, generateProject = true } = options;
+  const { htmlPath, nativeBundlePath, devServer, output, generateProject = true } = options;
   console.log(`
 \uD83D\uDCE6 Building Craft iOS project...`);
   const configPath = join(output, "craft.config.json");
@@ -547,6 +558,24 @@ async function build(options) {
     throw new Error(`No craft.config.json found in ${output}. Run 'craft ios init' first.`);
   }
   const config = JSON.parse(readFileSync(configPath, "utf-8"));
+  if (config.renderer !== undefined && config.renderer !== "web" && config.renderer !== "native") {
+    throw new Error(`Unknown iOS renderer: ${config.renderer}. Expected web or native.`);
+  }
+  if (config.renderer === "native") {
+    if (htmlPath || devServer) {
+      throw new Error("A native iOS screen cannot use --html-path or --dev-server.");
+    }
+    if (nativeBundlePath) {
+      const destination = join(output, "dist", "native-screen.js");
+      if (resolve(nativeBundlePath) !== resolve(destination))
+        cpSync(nativeBundlePath, destination);
+    }
+    if (!existsSync(join(output, "dist", "native-screen.js"))) {
+      throw new Error("Native iOS mode needs dist/native-screen.js. Compile a .stx screen with stx-native first.");
+    }
+  } else if (nativeBundlePath) {
+    throw new Error('--native-bundle requires renderer: "native" in craft.config.json.');
+  }
   if (devServer) {
     config.devServerURL = devServer;
     const origin = new URL(devServer).origin;