@legendapp/spark 0.0.1-next.2

package/vendor/node_modules/@legendapp/spark-desktop-config/config.cjs

@@ -0,0 +1,161 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const { createHash } = require("node:crypto");
+const { validateWindow } = require("@legendapp/spark-window-options");
+const { identity } = require("./identity.cjs");
+const filename = "desktop.config.json";
+const managedConfig = "// Generated by spark: universal Expo configuration";
+function isExpoProject(root) {
+  const file = path.join(root, filename);
+  return fs.existsSync(file) && JSON.parse(fs.readFileSync(file, "utf8")).extends === "expo";
+}
+function isUniversal(root) {
+  const file = path.join(root, filename);
+  return fs.existsSync(file) && (JSON.parse(fs.readFileSync(file, "utf8")).platforms?.length ?? 1) > 1;
+}
+function statePath(root, name, target = process.env.SPARK_PLATFORM) {
+  if (!isUniversal(root)) return path.join(root, ".spark", name);
+  const value = JSON.parse(fs.readFileSync(path.join(root, filename), "utf8"));
+  target = selectTarget(value.platforms, target);
+  return path.join(root, ".spark", "platforms", target, name);
+}
+function selectTarget(platforms, target) {
+  const selected = target ?? (platforms.includes(process.platform === "win32" ? "windows" : "macos") ? (process.platform === "win32" ? "windows" : "macos") : platforms[0]);
+  if (!platforms.includes(selected)) throw new Error(`Platform ${selected} is not supported by this project`);
+  return selected;
+}
+function readConfig(root, target = process.env.SPARK_PLATFORM) {
+  const file = path.join(root, filename);
+  if (isExpoProject(root)) {
+    const value = JSON.parse(fs.readFileSync(file, "utf8"));
+    const selected = selectTarget(value.platforms, target);
+    const previous = process.env.SPARK_PLATFORM;
+    try {
+      process.env.SPARK_PLATFORM = selected;
+      // Resolve Expo's own reader from the application's installed Expo version.
+      const { createRequire } = require("node:module");
+      const appRequire = createRequire(path.join(root, "package.json"));
+      const expoRequire = createRequire(appRequire.resolve("expo/package.json"));
+      const { getConfig } = expoRequire("@expo/config");
+      // Expo's reader metadata contains absolute config paths, not app settings.
+      // Keep it out of native compatibility signatures (e.g. /tmp vs /private/tmp).
+      const { _internal, ...expo } = getConfig(root, { skipPlugins: true }).exp;
+      if (["macos", "windows"].includes(selected) && expo.extra?.spark?.projectId !== value.projectId) throw new Error("Compose app.config with withSparkExpo before running desktop commands");
+      return { expo: { ...expo, platforms: [selected] } };
+    } finally {
+      if (previous === undefined) delete process.env.SPARK_PLATFORM; else process.env.SPARK_PLATFORM = previous;
+    }
+  }
+  if (!fs.existsSync(file)) return JSON.parse(fs.readFileSync(path.join(root, "app.json"), "utf8"));
+  const result = toExpo(JSON.parse(fs.readFileSync(file, "utf8")), target);
+  return result;
+}
+function supportedPlatforms(root) {
+  const file = path.join(root, filename);
+  if (fs.existsSync(file)) return JSON.parse(fs.readFileSync(file, "utf8")).platforms ?? ["macos"];
+  return readConfig(root).expo.platforms ?? ["ios", "android", "web"];
+}
+// A live server has no single build target. Platform build overlays (notably
+// native autolinking exclusions) must not leak into other platforms' JS graphs.
+function developmentConfig(value, target) {
+  const result = toExpo({ ...value, expoByPlatform: {} }, target).expo;
+  result.platforms = value.platforms ?? ["macos"];
+  return result;
+}
+function expoConfig(root) {
+  if (process.env.SPARK_DEV_SESSION === "1") {
+    return developmentConfig(JSON.parse(fs.readFileSync(path.join(root, filename), "utf8")), process.env.SPARK_PLATFORM);
+  }
+  const result = readConfig(root);
+  return applySelection(root, result.expo);
+}
+function applySelection(root, expo) {
+  if (isUniversal(root)) {
+    const selection = statePath(root, "native-selection.json", expo.platforms[0]);
+    if (expo.platforms[0] === "macos" && fs.existsSync(selection)) {
+      const excluded = JSON.parse(fs.readFileSync(selection, "utf8")).excluded ?? [];
+      expo.autolinking = { ...expo.autolinking, exclude: [...new Set([...(expo.autolinking?.exclude ?? []), ...excluded])] };
+    }
+  }
+  return expo;
+}
+function toExpo(value, target) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Desktop config must be an object");
+  const allowed = ["$schema", "name", "projectId", "version", "window", "macos", "platforms", "scheme", "documentTypes", "menuBarOnly", "updates", "include", "signing", "helpers", "expo", "expoByPlatform"];
+  for (const key of Object.keys(value)) if (!allowed.includes(key)) throw new Error(`Unknown desktop configuration field: ${key}`);
+  for (const key of ["name", "projectId", "version"]) if (typeof value[key] !== "string" || !value[key].trim()) throw new Error(`Desktop config needs ${key}`);
+  const platforms = value.platforms ?? ["macos"];
+  if (!Array.isArray(platforms) || !platforms.length || new Set(platforms).size !== platforms.length || platforms.some(p => !["macos", "windows", "ios", "android", "web"].includes(p))) throw new Error("platforms must list unique supported targets: macos, windows, ios, android, web");
+  const selected = selectTarget(platforms, target);
+  if (platforms.includes("macos") && (!value.macos || typeof value.macos.bundleIdentifier !== "string" || !/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(value.macos.bundleIdentifier))) throw new Error("macos.bundleIdentifier must be a reverse-DNS identifier");
+  validateWindow(value.window ?? {});
+  if (value.include !== undefined && (!Array.isArray(value.include) || value.include.some(x => typeof x !== "string"))) throw new Error("include must be a list of package names");
+  require("./helpers.cjs").validateHelpers(value.helpers);
+  const extra = { projectId: value.projectId };
+  for (const key of ["window", "documentTypes", "menuBarOnly", "updates", "include", "signing", "helpers"]) if (value[key] !== undefined) extra[key] = value[key];
+  const overrides = value.expoByPlatform ?? {};
+  if (!overrides || typeof overrides !== "object" || Array.isArray(overrides) || Object.keys(overrides).some(p => !platforms.includes(p))) throw new Error("expoByPlatform keys must be supported platforms");
+  const backend = merge(value.expo ?? {}, overrides[selected] ?? {});
+  if (!backend || typeof backend !== "object" || Array.isArray(backend)) throw new Error("expo overrides must be an object");
+  const hex = createHash("sha256").update(value.projectId).digest("hex");
+  const guid = `${hex.slice(0,8)}-${hex.slice(8,12)}-5${hex.slice(13,16)}-a${hex.slice(17,20)}-${hex.slice(20,32)}`;
+  const config = {
+    ...backend,
+    name: value.name, slug: backend.slug ?? value.name.toLowerCase().replace(/[^a-z0-9-]/g, "-"), version: value.version,
+    platforms: [selected], newArchEnabled: true,
+    ...(value.macos ? { macos: { ...value.macos, infoPlist: { CFBundleName: value.name, ...value.macos.infoPlist } } } : {}),
+    ...(value.scheme !== undefined ? { scheme: value.scheme } : {}),
+    extra: { ...backend.extra, spark: { ...extra, ...(platforms.length > 1 ? { supportedPlatforms: platforms } : {}) } },
+    experiments: { ...backend.experiments, outOfTreePlatforms: true },
+    windows: backend.windows ?? { namespace: "DesktopApp", displayName: value.name, packageGuid: guid, projectGuid: guid },
+    plugins: [...(["macos", "windows"].includes(selected) ? ["@legendapp/spark/config-plugin"] : []), ...(backend.plugins ?? []).filter(p => (Array.isArray(p) ? p[0] : p) !== "@legendapp/spark-desktop-config" && (Array.isArray(p) ? p[0] : p) !== "@legendapp/spark/config-plugin")],
+  };
+  identity(config);
+  return { expo: config };
+}
+function merge(base, override) {
+  if (!base || typeof base !== "object" || Array.isArray(base) || !override || typeof override !== "object" || Array.isArray(override)) throw new Error("Expo overrides must be objects");
+  const result = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (["__proto__", "constructor", "prototype"].includes(key)) throw new Error("Invalid Expo override key");
+    result[key] = value && typeof value === "object" && !Array.isArray(value) && result[key] && typeof result[key] === "object" && !Array.isArray(result[key]) ? merge(result[key], value) : value;
+  }
+  return result;
+}
+// Expo tools read this generated transport file. All framework consumers resolve
+// the canonical source; the generated file is never edited by SDK commands.
+function prepareConfig(root) {
+  if (isExpoProject(root)) return readConfig(root);
+  if (isUniversal(root)) {
+    const file = path.join(root, "app.config.js");
+    if (fs.existsSync(path.join(root, "app.config.ts")) || (fs.existsSync(file) && !fs.readFileSync(file, "utf8").startsWith(managedConfig))) throw new Error("Universal configuration needs a spark-managed app.config.js; preserve custom configuration under expo or expoByPlatform");
+    const result = readConfig(root);
+    if (!fs.existsSync(file)) fs.writeFileSync(file, `${managedConfig}\nmodule.exports = () => require("@legendapp/spark/config").expoConfig(__dirname);\n`);
+    return result;
+  }
+  if (fs.existsSync(path.join(root, filename)) && ["app.config.js", "app.config.ts"].some(name => fs.existsSync(path.join(root, name)))) throw new Error("desktop.config.json cannot be combined with an Expo app.config file; put backend overrides under expo in desktop.config.json");
+  const result = readConfig(root);
+  if (fs.existsSync(path.join(root, filename))) {
+    const file = path.join(root, "app.json");
+    const content = JSON.stringify(result, null, 2) + "\n";
+    if (!fs.existsSync(file) || fs.readFileSync(file, "utf8") !== content) {
+      const temporary = `${file}.${process.pid}.tmp`;
+      fs.writeFileSync(temporary, content); fs.renameSync(temporary, file);
+    }
+  }
+  return result;
+}
+function writeUpdates(root, updates) {
+  const file = path.join(root, filename);
+  if (fs.existsSync(file)) {
+    const value = JSON.parse(fs.readFileSync(file, "utf8")); value.updates = updates;
+    if (value.extends !== "expo") toExpo(value);
+    const temporary = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(temporary, JSON.stringify(value, null, 2) + "\n"); fs.renameSync(temporary, file);
+  } else {
+    const value = readConfig(root); value.expo.extra ??= {}; value.expo.extra.spark ??= {}; value.expo.extra.spark.updates = updates;
+    const target = path.join(root, "app.json"); const temporary = `${target}.${process.pid}.tmp`;
+    fs.writeFileSync(temporary, JSON.stringify(value, null, 2) + "\n"); fs.renameSync(temporary, target);
+  }
+}
+module.exports = { readConfig, toExpo, prepareConfig, writeUpdates, statePath, isUniversal, isExpoProject, selectTarget, expoConfig, applySelection, supportedPlatforms, developmentConfig };

package/vendor/node_modules/@legendapp/spark-desktop-config/config.d.cts

@@ -0,0 +1,13 @@
+export function readConfig(root: string, target?: string): any;
+export function prepareConfig(root: string): any;
+export function toExpo(value: unknown, target?: string): any;
+export function writeUpdates(root: string, updates: unknown): void;
+
+export function isUniversal(root: string): boolean;
+export function isExpoProject(root: string): boolean;
+export function statePath(root: string, name: string, target?: string): string;
+export function selectTarget(platforms: string[], target?: string): string;
+export function expoConfig(root: string): any;
+
+export function supportedPlatforms(root: string): string[];
+export function developmentConfig(value: any, target?: string): any;

package/vendor/node_modules/@legendapp/spark-desktop-config/entitlements.cjs

@@ -0,0 +1,23 @@
+function mergeEntitlements(...sources) {
+  const result = {};
+  for (const source of sources) {
+    if (!source || typeof source !== "object" || Array.isArray(source)) throw new Error("Entitlements must be an object.");
+    for (const [key, value] of Object.entries(source)) {
+      if (value === null || !["boolean", "string", "number", "object"].includes(typeof value)) throw new Error(`Invalid entitlement: ${key}`);
+      if (key in result && JSON.stringify(result[key]) !== JSON.stringify(value)) {
+        if (Array.isArray(result[key]) && Array.isArray(value)) result[key] = [...new Set([...result[key], ...value])];
+        else throw new Error(`Conflicting entitlement requirements: ${key}`);
+      } else result[key] = value;
+    }
+  }
+  return result;
+}
+
+function resolveEntitlements(config, packages) {
+  const expo = config.expo ?? config;
+  return mergeEntitlements(
+    ...packages.map((pkg) => pkg.spark?.entitlements?.macos ?? {}),
+    expo.macos?.entitlements ?? {},
+  );
+}
+module.exports = { mergeEntitlements, resolveEntitlements };

package/vendor/node_modules/@legendapp/spark-desktop-config/expo.cjs

@@ -0,0 +1,26 @@
+const fs = require('node:fs');
+const path = require('node:path');
+
+// Existing Expo projects keep their Expo configuration as the source of truth.
+// Only an explicitly selected desktop command applies the Spark overlay.
+function withSparkExpo(original, root) {
+  return context => {
+    const base = typeof original === 'function' ? original(context) : original;
+    const target = process.env.SPARK_PLATFORM;
+    const development = process.env.SPARK_DEV_SESSION === '1';
+    if (!development && target !== 'macos' && target !== 'windows') return base;
+    const { extends: source, ...desktop } = JSON.parse(fs.readFileSync(path.join(root, 'desktop.config.json'), 'utf8'));
+    if (source !== 'expo') throw new Error('Expected an Expo-owned desktop configuration');
+    const { toExpo, applySelection, developmentConfig } = require('./config.cjs');
+    const value = {
+      ...desktop,
+      name: base.name,
+      version: base.version ?? '1.0.0',
+      expo: { ...base, ...desktop.expo },
+      macos: { ...base.macos, ...desktop.macos },
+    };
+    if (development) return developmentConfig(value, target);
+    return applySelection(root, toExpo(value, target).expo);
+  };
+}
+module.exports = { withSparkExpo };

package/vendor/node_modules/@legendapp/spark-desktop-config/fabric-lifecycle.cjs

@@ -0,0 +1,125 @@
+// Compatibility fix for the pinned RN macOS Fabric start/stop race.
+// Keep the native lifecycle replacement explicit and fail on changed upstream code.
+const fs = require("node:fs");
+const path = require("node:path");
+const originalLifecycle = `- (void)start
+{
+  std::lock_guard<std::mutex> lock(_surfaceMutex);
+
+  if (_surfaceHandler->getStatus() != SurfaceHandler::Status::Registered) {
+    return;
+  }
+
+  // We need to register a root view component here synchronously because right after
+  // we start a surface, it can initiate an update that can query the root component.
+  RCTExecuteOnMainQueue(^{
+    [self->_surfacePresenter.mountingManager attachSurfaceToView:self.view
+                                                       surfaceId:self->_surfaceHandler->getSurfaceId()];
+    dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INTERACTIVE, 0), ^{
+      self->_surfaceHandler->start();
+      [self _propagateStageChange];
+
+      [self->_surfacePresenter setupAnimationDriverWithSurfaceHandler:*self->_surfaceHandler];
+    });
+  });
+}
+
+- (void)stop
+{
+  std::lock_guard<std::mutex> lock(_surfaceMutex);
+
+  if (_surfaceHandler->getStatus() != SurfaceHandler::Status::Running) {
+    return;
+  }
+
+  _surfaceHandler->stop();
+  [self _propagateStageChange];
+
+  RCTExecuteOnMainQueue(^{
+    [self->_surfacePresenter.mountingManager detachSurfaceFromView:self.view
+                                                         surfaceId:self->_surfaceHandler->getSurfaceId()];
+  });
+}
+`;
+const fixedLifecycle = `- (void)start
+{
+  NSUInteger generation;
+  {
+    std::lock_guard<std::mutex> lock(_surfaceMutex);
+    if (_surfaceHandler->getStatus() != SurfaceHandler::Status::Registered) {
+      return;
+    }
+    generation = ++_surfaceLifecycleGeneration;
+  }
+
+  RCTExecuteOnMainQueue(^{
+    std::lock_guard<std::mutex> lock(self->_surfaceMutex);
+    if (generation != self->_surfaceLifecycleGeneration) {
+      return;
+    }
+    if (!self->_surfaceViewAttached) {
+      [self->_surfacePresenter.mountingManager attachSurfaceToView:self.view
+                                                         surfaceId:self->_surfaceHandler->getSurfaceId()];
+      self->_surfaceViewAttached = YES;
+    }
+    dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INTERACTIVE, 0), ^{
+      std::lock_guard<std::mutex> lock(self->_surfaceMutex);
+      if (generation != self->_surfaceLifecycleGeneration ||
+          self->_surfaceHandler->getStatus() != SurfaceHandler::Status::Registered) {
+        return;
+      }
+      self->_surfaceHandler->start();
+      // Stop must not destroy the shadow tree before the animation driver uses it.
+      [self->_surfacePresenter setupAnimationDriverWithSurfaceHandler:*self->_surfaceHandler];
+      [self _propagateStageChange];
+    });
+  });
+}
+
+- (void)stop
+{
+  NSUInteger generation;
+  {
+    std::lock_guard<std::mutex> lock(_surfaceMutex);
+    // Cancel queued starts even if the surface has not reached Running yet.
+    generation = ++_surfaceLifecycleGeneration;
+    if (_surfaceHandler->getStatus() == SurfaceHandler::Status::Running) {
+      _surfaceHandler->stop();
+      [self _propagateStageChange];
+    }
+  }
+
+  RCTExecuteOnMainQueue(^{
+    std::lock_guard<std::mutex> lock(self->_surfaceMutex);
+    // A later start owns the view now; an older stop must not detach it.
+    if (generation != self->_surfaceLifecycleGeneration || !self->_surfaceViewAttached) {
+      return;
+    }
+    self->_surfaceViewAttached = NO;
+    [self->_surfacePresenter.mountingManager detachSurfaceFromView:self->_view
+                                                         surfaceId:self->_surfaceHandler->getSurfaceId()];
+  });
+}
+`;
+const originalMutex = "  std::mutex _surfaceMutex;";
+const fixedMutex = originalMutex + "\n  NSUInteger _surfaceLifecycleGeneration;\n  BOOL _surfaceViewAttached;";
+function patchSurface(source) {
+  if (source.includes(fixedLifecycle) && source.includes(fixedMutex)) return source;
+  if (!source.includes(originalLifecycle) || !source.includes(originalMutex) || source.includes("_surfaceLifecycleGeneration"))
+    throw new Error("React Native macOS Fabric source changed; review the Spark surface lifecycle patch before building.");
+  return source.replace(originalLifecycle, fixedLifecycle).replace(originalMutex, fixedMutex);
+}
+function installSurfaceLifecyclePatch(root) {
+  const manifest = require.resolve("react-native-macos/package.json", { paths: [root] });
+  const version = JSON.parse(fs.readFileSync(manifest, "utf8")).version;
+  if (version !== "0.81.7") throw new Error(`spark's Fabric lifecycle patch requires react-native-macos@0.81.7; found ${version}.`);
+  const file = path.join(path.dirname(manifest), "React/Fabric/Surface/RCTFabricSurface.mm");
+  const before = fs.readFileSync(file, "utf8"), after = patchSurface(before);
+  if (before !== after) {
+    // Never mutate a package-manager cache through a hardlinked installed file.
+    const temporary = `${file}.spark-${process.pid}.tmp`;
+    fs.writeFileSync(temporary, after);
+    fs.renameSync(temporary, file);
+  }
+}
+module.exports = { patchSurface, installSurfaceLifecyclePatch };

package/vendor/node_modules/@legendapp/spark-desktop-config/helpers.cjs

@@ -0,0 +1,20 @@
+// Shared by Expo configuration and the CLI; filesystem checks happen at build time.
+const targets = ["macos-arm64", "macos-x64", "windows-arm64", "windows-x64"];
+function relative(value) {
+  return typeof value === "string" && value.length > 0 && !/[\\\0:]/.test(value) && !value.startsWith("/") && value.split("/").every(part => part && part !== "." && part !== "..");
+}
+function validateHelpers(helpers = {}) {
+  if (!helpers || typeof helpers !== "object" || Array.isArray(helpers)) throw new Error("helpers must be an object");
+  const names = Object.keys(helpers).map(name => name.toLowerCase());
+  if (new Set(names).size !== names.length) throw new Error("Helper names must be unique ignoring case");
+  for (const [name, value] of Object.entries(helpers)) {
+    if (!/^[A-Za-z0-9_-]+$/.test(name)) throw new Error("Helpers need simple names");
+    if (typeof value === "string") { if (!relative(value)) throw new Error(`Helper ${name} needs a project-relative file`); continue; }
+    if (!value || typeof value !== "object" || Array.isArray(value) || !Object.keys(value).length) throw new Error(`Helper ${name} needs target bundles`);
+    for (const [target, bundle] of Object.entries(value)) {
+      if (!targets.includes(target) || !bundle || typeof bundle !== "object" || Array.isArray(bundle) || Object.keys(bundle).some(key => !["directory", "executable"].includes(key)) || !relative(bundle.directory) || !relative(bundle.executable)) throw new Error(`Invalid helper bundle: ${name}/${target}; expected directory and executable relative paths`);
+    }
+  }
+  return helpers;
+}
+module.exports = { validateHelpers };

package/vendor/node_modules/@legendapp/spark-desktop-config/identity.cjs

@@ -0,0 +1,28 @@
+const { validateWindow } = require("@legendapp/spark-window-options");
+const { updatePlist } = require("./updates.cjs");
+function identity(config) {
+  const projectId = config.extra?.spark?.projectId ?? config.macos?.bundleIdentifier;
+  if (typeof projectId !== "string" || !projectId.length || projectId.length > 200) throw new Error("Set extra.spark.projectId to a stable project identifier");
+  const schemes = config.scheme === undefined ? [] : Array.isArray(config.scheme) ? config.scheme : [config.scheme];
+  if (schemes.some(value => typeof value !== "string" || !/^[a-zA-Z][a-zA-Z0-9+.-]*$/.test(value))) throw new Error("URL schemes must be valid scheme names without a colon");
+  const documents = config.extra?.spark?.documentTypes ?? [];
+  const types = documents.map(document => {
+    if (typeof document.name !== "string" || !document.name.length || !Array.isArray(document.contentTypes) || !document.contentTypes.length || document.contentTypes.some(type => typeof type !== "string" || !type.includes("."))) throw new Error("Document types need a name and contentTypes containing UTIs");
+    if (document.role && !["Editor", "Viewer"].includes(document.role)) throw new Error("Document role must be Editor or Viewer");
+    return { CFBundleTypeName: document.name, CFBundleTypeRole: document.role ?? "Editor", LSItemContentTypes: document.contentTypes, LSHandlerRank: "Alternate" };
+  });
+  if (config.extra?.spark?.menuBarOnly !== undefined && typeof config.extra.spark.menuBarOnly !== "boolean") throw new Error("menuBarOnly must be a boolean");
+  return {
+    LSUIElement: config.extra?.spark?.menuBarOnly === true,
+    SparkMenuBarOnly: config.extra?.spark?.menuBarOnly === true,
+    SparkProjectIdentifier: projectId,
+    SparkWindowConfiguration: validateWindow(config.extra?.spark?.window ?? {}),
+    ...updatePlist(config),
+    // The app may need JS to save edits before accepting a quit request.
+    NSSupportsAutomaticTermination: false,
+    NSSupportsSuddenTermination: false,
+    ...(schemes.length ? { CFBundleURLTypes: [{ CFBundleURLName: projectId, CFBundleURLSchemes: [...new Set(schemes)] }] } : {}),
+    ...(types.length ? { CFBundleDocumentTypes: types } : {}),
+  };
+}
+module.exports = { identity };

package/vendor/node_modules/@legendapp/spark-desktop-config/keyboard-events.cjs

@@ -0,0 +1,44 @@
+// RN macOS 0.81.7 legacy views embedded in Fabric can have no React tag.
+const fs = require("node:fs");
+const path = require("node:path");
+const replacements = {
+  "React/Views/RCTViewKeyboardEvent.m": [
+    `  // Ignore "dead keys" (key press that waits for another key to make a character)
+  if (!event.charactersIgnoringModifiers.length) {`,
+    `  // Untagged native subviews cannot emit React events. Ignore dead keys too.
+  if (reactTag == nil || !event.charactersIgnoringModifiers.length) {`,
+  ],
+  "React/Views/RCTView.m": [
+    `  if (!alreadyEmitted) {
+    [_eventDispatcher sendEvent:keyboardEvent];`,
+    `  // Do not consume JS delivery when a native subview has no React target/dispatcher.
+  if (keyboardEvent != nil && _eventDispatcher != nil && !alreadyEmitted) {
+    [_eventDispatcher sendEvent:keyboardEvent];`,
+  ],
+};
+function patchKeyboardSource(file, source) {
+  const pair = replacements[file];
+  if (!pair) throw new Error(`Unknown keyboard patch target: ${file}`);
+  const [before, after] = pair;
+  if (source.includes(after) && !source.includes(before)) return source;
+  if (source.split(before).length !== 2 || source.includes(after))
+    throw new Error(`React Native macOS keyboard source changed (${file}); review the compatibility patch before building.`);
+  return source.replace(before, after);
+}
+function installKeyboardEventsPatch(root) {
+  const manifest = require.resolve("react-native-macos/package.json", { paths: [root] });
+  const version = JSON.parse(fs.readFileSync(manifest, "utf8")).version;
+  if (version !== "0.81.7") throw new Error(`spark's keyboard patch requires react-native-macos@0.81.7; found ${version}.`);
+  // Validate all targets before changing either file.
+  const changes = Object.keys(replacements).map(relative => {
+    const file = path.join(path.dirname(manifest), relative);
+    const before = fs.readFileSync(file, "utf8");
+    return {file, before, after: patchKeyboardSource(relative, before)};
+  });
+  for (const {file, before, after} of changes) if (before !== after) {
+    const temporary = `${file}.spark-${process.pid}.tmp`;
+    fs.writeFileSync(temporary, after);
+    fs.renameSync(temporary, file); // Preserve package-manager cache hardlinks.
+  }
+}
+module.exports = {patchKeyboardSource, installKeyboardEventsPatch};

package/vendor/node_modules/@legendapp/spark-desktop-config/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@legendapp/spark-desktop-config",
+  "version": "0.0.1-next.2",
+  "license": "MIT",
+  "main": "app.plugin.cjs",
+  "files": [
+    "*.cjs",
+    "*.json",
+    "*.d.ts",
+    "*.d.cts"
+  ],
+  "dependencies": {
+    "expo-desktop-config-plugins": "1.2.0-beta.1",
+    "@legendapp/spark-desktop-host": "0.0.1-next.2",
+    "@legendapp/spark-window-options": "0.0.1-next.2",
+    "@expo/config-plugins": "54.0.5"
+  },
+  "private": true
+}