@geastack/apple 0.2.8 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/apple",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Generated Apple SDK bindings plus the macOS and iOS native build targets for Gea apps.",
   "license": "Apache-2.0",
   "repository": {
@@ -102,14 +102,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@geastack/compiler": "^1.0.12",
-    "@geastack/core": "^0.1.21",
-    "@geastack/elements": "^0.1.0",
-    "@geastack/engine": "^0.1.2",
-    "@geastack/geaos": "^0.1.1",
-    "@geastack/geatsc-plugin-apple-native": "^0.1.0",
-    "@geastack/geatsc-plugin-gea": "^0.1.3",
-    "@geastack/host": "^0.1.6"
+    "@geastack/compiler": "^1.0.18",
+    "@geastack/core": "^0.1.23",
+    "@geastack/elements": "^0.1.2",
+    "@geastack/engine": "^0.1.5",
+    "@geastack/geaos": "^0.1.3",
+    "@geastack/geatsc-plugin-apple-native": "^0.1.3",
+    "@geastack/geatsc-plugin-gea": "^0.1.6",
+    "@geastack/host": "^0.1.8"
   },
   "scripts": {
     "prepublishOnly": "npm run build",

package/targets/ios/README.md

@@ -2,12 +2,27 @@
 
 Build a gea-embedded JSX app as a native UIKit app.
 
-First milestone:
+From an app that depends on `@geastack/apple` (every iOS example does, and
+`gea create --targets ios` adds it), the CLI drives this target:
 
 ```bash
-targets/ios/build-ios.sh bouncing-balls-jsx simulator
+npx gea build --target ios                 # simulator .app, no launch
+npx gea build --target ios --mode device   # unsigned iphoneos .app
+npx gea run --target ios                   # build, install and launch on a simulator
+npx gea run --target ios --mode device     # build, sign, install and launch on an iPhone
 ```
 
+The same script can be run directly from the app folder; the CLI passes the
+app id and destination through unchanged:
+
+```bash
+node_modules/@geastack/apple/targets/ios/build-ios.sh <app-id> simulator
+```
+
+The script resolves `@geastack/core`, `@geastack/compiler`, the apple-native
+geatsc plugin and `@geastack/cli` by walking up `node_modules` from the app
+folder, so it works on a hoisted npm install and on a linked checkout alike.
+
 The simulator path auto-picks an available iPhone simulator. Set
 `GEA_IOS_SIMULATOR_UDID` to force a specific device. By default, the script
 also opens Simulator.app for the selected device; set
@@ -18,7 +33,7 @@ team when it can find one. You can also set your Apple development team
 explicitly:
 
 ```bash
-GEA_IOS_DEVELOPMENT_TEAM=ABCDE12345 targets/ios/build-ios.sh bouncing-balls-jsx device
+GEA_IOS_DEVELOPMENT_TEAM=ABCDE12345 npx gea run --target ios --mode device
 ```
 
 To see the automatically detected team id:
@@ -37,7 +52,7 @@ To only verify that the app compiles for the iPhone device SDK, skip launch
 without a development team:
 
 ```bash
-GEA_IOS_SKIP_LAUNCH=1 targets/ios/build-ios.sh bouncing-balls-jsx device
+npx gea build --target ios --mode device
 ```
 
 The Xcode project is generated under

package/targets/ios/build-ios.sh

@@ -4,32 +4,84 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
 IOS_DIR="$ROOT_DIR/targets/ios"
 
-# Resolve the gea framework through npm.
-GEA_CORE="$(node -e "process.stdout.write(require('fs').realpathSync('$ROOT_DIR/node_modules/@geastack/core'))" 2>/dev/null || true)"
-[ -n "$GEA_CORE" ] && [ -f "$GEA_CORE/package.json" ] || { echo "Cannot resolve @geastack/core via node_modules — run 'npm install' in $ROOT_DIR" >&2; exit 1; }
-GEA_COMPILER="$(node -e "process.stdout.write(require('fs').realpathSync('$ROOT_DIR/node_modules/@geastack/compiler'))" 2>/dev/null || true)"
-[ -n "$GEA_COMPILER" ] && [ -f "$GEA_COMPILER/package.json" ] || { echo "Cannot resolve @geastack/compiler via node_modules — run 'npm install' in $ROOT_DIR" >&2; exit 1; }
+# The project is the directory this script was started in -- `gea build
+# --target ios` spawns it with the app's own folder as cwd, and a direct run is
+# made from the app folder. Captured once, before anything can move. Every
+# nested `gea` call inherits the same cwd and resolves the same project, so
+# none carry --project.
+BUILD_INVOCATION_CWD="$(pwd -P)"
+
+# Resolve the gea framework through npm plus the shared manifest, the same way
+# build-macos.sh does. `apple` is a native npm package whose @geastack/* deps
+# npm HOISTS to the app's node_modules, one or more levels above this package,
+# while a linked checkout has them under its own. Looking one level below this
+# package -- what this script did before -- finds nothing in either installed
+# layout, so walk the node_modules chain from the app first, then from here.
+resolve_gea_package_from() {
+  node -e '
+const fs = require("node:fs")
+const path = require("node:path")
+let dir = process.argv[1]
+while (true) {
+  const candidate = path.join(dir, "node_modules", process.argv[2])
+  if (fs.existsSync(path.join(candidate, "package.json"))) {
+    process.stdout.write(fs.realpathSync(candidate))
+    break
+  }
+  const parent = path.dirname(dir)
+  if (parent === dir) break
+  dir = parent
+}
+' "$1" "$2" 2>/dev/null || true
+}
+resolve_gea_package() {
+  local start found
+  for start in "${2:-$BUILD_INVOCATION_CWD}" "${2:-$ROOT_DIR}"; do
+    found="$(resolve_gea_package_from "$start" "$1")"
+    if [[ -n "$found" ]]; then
+      printf '%s' "$found"
+      return 0
+    fi
+  done
+}
+GEA_CORE="$(resolve_gea_package @geastack/core)"
+[ -n "$GEA_CORE" ] && [ -f "$GEA_CORE/package.json" ] || { echo "Cannot resolve @geastack/core from $BUILD_INVOCATION_CWD — add @geastack/apple to the app's dependencies and run 'npm install' there" >&2; exit 1; }
+GEA_COMPILER="$(resolve_gea_package @geastack/compiler)"
+[ -n "$GEA_COMPILER" ] && [ -f "$GEA_COMPILER/package.json" ] || { echo "Cannot resolve @geastack/compiler from $BUILD_INVOCATION_CWD — add @geastack/apple to the app's dependencies and run 'npm install' there" >&2; exit 1; }
+# An app that installs @geastack/apple gets the plugin from node_modules; inside
+# this repository it is a sibling package that nothing links, so name it there.
+GEA_APPLE_NATIVE_PLUGIN="$(resolve_gea_package @geastack/geatsc-plugin-apple-native)"
+if [[ -z "$GEA_APPLE_NATIVE_PLUGIN" && -d "$ROOT_DIR/../geatsc-plugin-apple-native" ]]; then
+  GEA_APPLE_NATIVE_PLUGIN="$(cd "$ROOT_DIR/../geatsc-plugin-apple-native" && pwd)"
+fi
+[ -n "$GEA_APPLE_NATIVE_PLUGIN" ] && [ -f "$GEA_APPLE_NATIVE_PLUGIN/dist/index.js" ] || { echo "Cannot resolve @geastack/geatsc-plugin-apple-native from $BUILD_INVOCATION_CWD" >&2; exit 1; }
 GEA_HOST_DIR="${GEA_HOST_DIR:-$GEA_CORE/../host}"
 GEA_ENGINE_DIR="${GEA_ENGINE_DIR:-$GEA_CORE/../engine}"
 GEA_ELEMENTS_DIR="${GEA_ELEMENTS_DIR:-$GEA_CORE/../elements}"
 GEA_GEAOS_PACKAGE_DIR="${GEA_GEAOS_PACKAGE_DIR:-$GEA_CORE/../geaos}"
-# The project is the directory this script was started in -- `gea build` spawns
-# it with the app's own folder as cwd, and a direct run is made from the app
-# folder. Captured once, before anything can move. Every nested `gea` call
-# inherits the same cwd and resolves the same project, so none carry --project.
-BUILD_INVOCATION_CWD="$(pwd -P)"
+# The source manifest reads these from the ENVIRONMENT: gea_sources.sh is a
+# front end for gea_sources.mjs, which runs as a child process. A plain shell
+# variable never reaches it and it reports "<name> unset" while the include
+# roots come back empty.
+export GEA_CORE GEA_HOST_DIR GEA_ENGINE_DIR GEA_ELEMENTS_DIR GEA_GEAOS_PACKAGE_DIR
 # This script IS @geastack/apple, so the generator must bind against this
 # working copy rather than whatever installed copy it would resolve from the app.
 export GEA_APPLE_ROOT="$ROOT_DIR"
-GEA_CLI="${GEA_CLI_BIN:-$(node -e "process.stdout.write(require('path').join(require('fs').realpathSync('$ROOT_DIR/node_modules/@geastack/cli'), 'bin', 'gea.mjs'))" 2>/dev/null || true)}"
-[ -n "$GEA_CLI" ] && [ -f "$GEA_CLI" ] || { echo "Cannot resolve @geastack/cli via node_modules — run 'npm install' in $ROOT_DIR" >&2; exit 1; }
+# Prefer an explicit override, then the package the app installed, then gea on PATH.
+GEA_CLI="${GEA_CLI_BIN:-}"
+if [[ -z "$GEA_CLI" ]]; then
+  GEA_CLI="$(node -e 'process.stdout.write(require("path").join(process.argv[1], "bin", "gea.mjs"))' "$(resolve_gea_package @geastack/cli)" 2>/dev/null || true)"
+  if [[ ! -f "$GEA_CLI" ]]; then
+    GEA_CLI="$(command -v gea || true)"
+  fi
+fi
+[ -n "$GEA_CLI" ] && [ -f "$GEA_CLI" ] || { echo "Cannot locate GeaStack CLI — set GEA_CLI_BIN to gea.mjs, install @geastack/cli locally, or add gea to PATH" >&2; exit 1; }
 
 # Framework sources/includes from the shared manifest (iOS keeps camera — ios_camera.mm
-# provides it — but has no resident-app/OTA/diagnostics services or single-app
-# runtime shell, so exclude those). generate-xcode-project.mjs consumes these.
+# provides it — but has no OTA/diagnostics services or single-app runtime
+# shell, so exclude those). generate-xcode-project.mjs consumes these.
 # shellcheck source=/dev/null
 source "$GEA_CORE/gea_sources.sh"
-export GEA_CORE
 export GEA_FW_CXX_SOURCES="$(gea_fw_cxx_sources | grep -vE "/(runtime|services/[a-z_]+)\.cpp\$")"
 export GEA_FW_C_SOURCES="$(gea_fw_c_sources)"
 export GEA_FW_INCLUDE_DIRS="$(gea_fw_include_flags | sed "s/^-I//")"
@@ -83,7 +135,6 @@ build_font_args=(
 generate_app() {
   local app_id="$1"
   local out_dir="$2"
-  local prefix="${3:-}"
   local info
   local root
   local entry
@@ -91,7 +142,7 @@ generate_app() {
   info="$(node "$GEA_CLI" apps inspect "$app_id" --format shell)" || return 1
   IFS=$'\t' read -r root entry runtime _name <<< "$info"
   if [[ "$runtime" != "gea" ]]; then
-    echo "Skipping resident $app_id: runtime=$runtime is not supported by iOS resident build" >&2
+    echo "iOS target only supports runtime=gea apps: $app_id is runtime=$runtime" >&2
     return 1
   fi
   local args=(
@@ -103,10 +154,9 @@ generate_app() {
     # function no iOS target defines. `build-macos.sh` passes `macos` for the
     # same reason; iOS was simply never given its half.
     --apple-platform ios
-    # The plugin resolves itself from `@geastack/geatsc-plugin-apple-native`,
-    # which is not installed in this repo's node_modules -- so, as
-    # `build-macos.sh` already does, name the in-repo build directly.
-    --geatsc-apple-native-plugin "$ROOT_DIR/packages/geatsc-plugin-apple-native/dist/index.js"
+    # The plugin is resolved above the way build-macos.sh resolves it: from the
+    # app's node_modules, or the sibling package inside this repository.
+    --geatsc-apple-native-plugin "$GEA_APPLE_NATIVE_PLUGIN/dist/index.js"
     --app-dir "$root"
     --entry "$entry"
     --out-dir "$out_dir"
@@ -116,14 +166,6 @@ generate_app() {
   if [[ -f "$native_plugin" ]]; then
     args+=(--extra-geatsc-plugin "$native_plugin")
   fi
-  if [[ -n "$prefix" ]]; then
-    args+=(
-      --entry-symbol "${prefix}_top_level"
-      --cpp-prelude-symbol "${prefix}_register_styles"
-      --font-symbol-prefix "$prefix"
-      --isolate-symbols
-    )
-  fi
   node "$GEA_CORE/scripts/build-gea-vite-geatsc.mjs" "${args[@]}"
 }
 
@@ -214,33 +256,7 @@ pick_ios_device() {
   rm -f "$output_json"
 }
 
-RESIDENT_IDS=()
-if [[ "$APP_ID" == "app-launcher" && "${GEA_IOS_RESIDENT_APPS:-auto}" != "none" ]]; then
-  if [[ -n "${GEA_IOS_RESIDENT_APPS:-}" && "${GEA_IOS_RESIDENT_APPS:-}" != "auto" ]]; then
-    read -r -a RESIDENT_IDS <<< "${GEA_IOS_RESIDENT_APPS//,/ }"
-  else
-    mapfile -t RESIDENT_IDS < <(
-      node "$GEA_CLI" apps list --target esp32 | grep -vx 'direct-psram-balls' || true
-    )
-  fi
-fi
-
-if [[ ${#RESIDENT_IDS[@]} -eq 0 ]]; then
-  generate_app "$APP_ID" "$GENERATED_DIR" ""
-else
-  ACTUAL_RESIDENTS=()
-  for id in "${RESIDENT_IDS[@]}"; do
-    safe="${id//[^A-Za-z0-9_]/_}"
-    prefix="gea_resident_${safe}"
-    resident_dir="$GENERATED_DIR/residents/$id"
-    mkdir -p "$resident_dir"
-    generate_app "$id" "$resident_dir" "$prefix" || continue
-    node "$IOS_DIR/generate-resident-entry.mjs" "$prefix" "$resident_dir/entry.cpp"
-    ACTUAL_RESIDENTS+=("$id")
-  done
-  RESIDENT_IDS=("${ACTUAL_RESIDENTS[@]}")
-  node "$IOS_DIR/generate-resident-registry.mjs" "$GENERATED_DIR/resident_registry.cpp" "$APP_ID" "${RESIDENT_IDS[@]}"
-fi
+generate_app "$APP_ID" "$GENERATED_DIR"
 
 if [[ ! -f "$GENERATED_DIR/gea_runtime.cpp" ]]; then
   echo "#include \"$GEA_COMPILER/dist/targets/cpp/runtime/runtime.cpp\"" > "$GENERATED_DIR/gea_runtime.cpp"

package/targets/ios/generate-xcode-project.mjs

@@ -40,6 +40,10 @@ if (!appId || !appName || !bundleId || !generatedDir || !projectPath) {
 }
 
 const iosDir = scriptDir  // apple/targets/ios — this script's own directory, not the apps repo
+// The framework packages are wherever build-ios.sh resolved them (the app's
+// hoisted node_modules, or a linked checkout); it exports the roots it found.
+const geaCore = process.env.GEA_CORE || ''
+if (!geaCore) fail('GEA_CORE is not set: run this generator through build-ios.sh, which resolves @geastack/core for it.')
 const plistOut = path.join(projectPath, 'Info.plist')
 let appMeta
 try {
@@ -140,25 +144,6 @@ function findFontResources() {
     .sort()
 }
 
-function findResidentSources() {
-  const residentsDir = path.join(generatedDir, 'residents')
-  if (!fs.existsSync(residentsDir)) return []
-  return fs.readdirSync(residentsDir, { withFileTypes: true })
-    .filter((entry) => entry.isDirectory())
-    .flatMap((entry) => {
-      const dir = path.join(residentsDir, entry.name)
-      return [
-        ...readGeatscSources(dir),
-        source(path.join(dir, 'entry.cpp')),
-        source(path.join(dir, 'gea_embedded_font_generated.cpp')),
-        source(path.join(dir, 'gea_embedded_assets_generated.cpp')),
-      ].filter(existing)
-    })
-}
-
-const residentRegistry = source(path.join(generatedDir, 'resident_registry.cpp'))
-const hasResidentRegistry = existing(residentRegistry)
-const residentSources = hasResidentRegistry ? [residentRegistry, ...findResidentSources()] : []
 const appleNativeBridgeSource = source(path.join(generatedDir, 'gea/apple/native_bridge.mm'), 'sourcecode.cpp.objcpp')
 const generatedProgramSources = readGeatscSources(
   generatedDir,
@@ -194,25 +179,21 @@ const sources = [
   ...appNativeSources,
   // Framework C/C++ sources come from @geastack/core/gea_sources.sh,
   // passed by build-ios.sh via env (iOS-curated: camera kept since ios_camera.mm
-  // provides it; resident-app/OTA/diagnostics services + the single-app runtime
+  // provides it; OTA/diagnostics services + the single-app runtime
   // shell excluded — iOS uses its own UIKit run loop). Single source of truth.
   ...(process.env.GEA_FW_C_SOURCES || '').split('\n').filter(Boolean).map((f) => source(f, 'sourcecode.c.c')),
   ...(process.env.GEA_FW_CXX_SOURCES || '').split('\n').filter(Boolean).map((f) => source(f)),
-  // gea_app_entry / resident_apps are mode-specific (deliberately not in the manifest).
-  ...(hasResidentRegistry
-    ? []
-    : [
-      source(path.join(geaCore, 'gea_app_entry.cpp')),
-      source(path.join(geaCore, '../geaos/resident_apps.cpp')),
-    ]),
-  ...(hasResidentRegistry ? residentSources : generatedProgramSources),
+  // gea_app_entry.cpp provides Application::init/frame, which calls the one
+  // __gea_top_level geatsc emitted (deliberately not in the manifest).
+  source(path.join(geaCore, 'gea_app_entry.cpp')),
+  ...generatedProgramSources,
   appleNativeBridgeSource,
 ].filter(existing)
 
 const fontGenerated = source(path.join(generatedDir, 'gea_embedded_font_generated.cpp'))
-if (!hasResidentRegistry && existing(fontGenerated)) sources.push(fontGenerated)
+if (existing(fontGenerated)) sources.push(fontGenerated)
 const assetsGenerated = source(path.join(generatedDir, 'gea_embedded_assets_generated.cpp'))
-if (!hasResidentRegistry && existing(assetsGenerated)) sources.push(assetsGenerated)
+if (existing(assetsGenerated)) sources.push(assetsGenerated)
 const hasGeneratedFonts = sources.some((entry) => path.basename(entry.file) === 'gea_embedded_font_generated.cpp')
 
 const fontResources = findFontResources().map((file) => resource(file))

package/targets/ios/main/ios_main.mm

@@ -10,7 +10,6 @@
 #include "font_registry.h"
 #include "image.h"
 #include "ios_renderer.h"
-#include "resident_apps.h"
 #include "ios_root_background.h"
 #include "pixel.h"
 #include "ui/tree_internal.h"
@@ -60,19 +59,6 @@ NSString *NSStringFromAttr(const char *value)
 	return [NSString stringWithUTF8String:value ? value : ""] ?: @"";
 }
 
-void queueInitialResidentAppFromProcessArguments()
-{
-	if (!gea::framework::apps::ResidentApps::isEnabled()) return;
-	NSArray<NSString *> *arguments = NSProcessInfo.processInfo.arguments;
-	for (NSUInteger i = 0; i + 1 < arguments.count; ++i) {
-		if (![arguments[i] isEqualToString:@"--gea-initial-app"]) continue;
-		NSString *appId = arguments[i + 1];
-		if (appId.length > 0) gea::framework::apps::ResidentApps::requestLaunch(appId.UTF8String);
-	}
-	const char *envAppId = std::getenv("GEA_IOS_INITIAL_APP");
-	if (envAppId && envAppId[0]) gea::framework::apps::ResidentApps::requestLaunch(envAppId);
-}
-
 NSTextAlignment textAlignmentForStyle(int align)
 {
 	switch (align) {
@@ -567,49 +553,12 @@ bool attributedStringHasTextDecoration(NSAttributedString *value)
 @property(nonatomic, strong) UIView *rootView;
 @property(nonatomic, strong) GeaDisplayView *displayView;
 @property(nonatomic, strong) UIView *nativeRootView;
-@property(nonatomic, strong) UIButton *launcherButton;
 @property(nonatomic, strong) CADisplayLink *displayLink;
 - (void)installNativeRootView:(UIView *)view;
 @end
 
 @implementation GeaAppDelegate
 
-- (BOOL)shouldShowLauncherButton
-{
-	if (!gea::framework::apps::ResidentApps::isEnabled()) return NO;
-	const char *activeId = gea::framework::apps::ResidentApps::activeId();
-	return activeId && std::strcmp(activeId, gea::framework::apps::AppManager::launcherAppId()) != 0;
-}
-
-- (void)syncLauncherButton
-{
-	if (!self.launcherButton || !self.rootView) return;
-	const BOOL show = [self shouldShowLauncherButton];
-	UIEdgeInsets safeInsets = self.rootView.safeAreaInsets;
-	const CGRect bounds = self.rootView.bounds;
-	const CGFloat size = 52.0;
-	const CGFloat bottomMargin = 12.0;
-	const CGFloat x = (bounds.size.width - size) * 0.5;
-	const CGFloat y = bounds.size.height - safeInsets.bottom - bottomMargin - size;
-	self.launcherButton.frame = CGRectMake(std::max<CGFloat>(safeInsets.left, x),
-	                                       std::max<CGFloat>(safeInsets.top, y),
-	                                       size,
-	                                       size);
-	self.launcherButton.layer.cornerRadius = size * 0.5;
-	self.launcherButton.hidden = !show;
-	self.launcherButton.userInteractionEnabled = show;
-	if (show) [self.rootView bringSubviewToFront:self.launcherButton];
-}
-
-- (void)returnToLauncher:(id)sender
-{
-	(void)sender;
-	if (gea::framework::apps::AppManager::returnRunningAppToLauncher("iOS launcher button")) {
-		self.launcherButton.hidden = YES;
-		self.launcherButton.userInteractionEnabled = NO;
-	}
-}
-
 - (void)layoutDisplayViewInSafeArea
 {
 	if (!self.rootView || !self.displayView) return;
@@ -620,7 +569,6 @@ bool attributedStringHasTextDecoration(NSAttributedString *value)
 	if (frame.size.width <= 0 || frame.size.height <= 0) frame = self.rootView.bounds;
 	self.displayView.frame = frame;
 	if (self.nativeRootView) self.nativeRootView.frame = self.rootView.bounds;
-	[self syncLauncherButton];
 }
 
 - (void)installNativeRootView:(UIView *)view
@@ -636,13 +584,8 @@ bool attributedStringHasTextDecoration(NSAttributedString *value)
 	view.userInteractionEnabled = YES;
 	self.displayView.hidden = YES;
 	self.displayView.userInteractionEnabled = NO;
-	if (self.launcherButton.superview == self.rootView) {
-		[self.rootView insertSubview:view belowSubview:self.launcherButton];
-	} else {
-		[self.rootView addSubview:view];
-	}
+	[self.rootView addSubview:view];
 	[view setNeedsLayout];
-	[self syncLauncherButton];
 }
 
 - (CGSize)viewportSize
@@ -686,23 +629,6 @@ bool attributedStringHasTextDecoration(NSAttributedString *value)
 	self.displayView = [[GeaDisplayView alloc] initWithFrame:CGRectZero];
 	self.displayView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
 	[self.rootView addSubview:self.displayView];
-	self.launcherButton = [UIButton buttonWithType:UIButtonTypeSystem];
-	self.launcherButton.backgroundColor = [UIColor colorWithWhite:0.0 alpha:0.62];
-	self.launcherButton.tintColor = UIColor.whiteColor;
-	self.launcherButton.layer.borderWidth = 1.0;
-	self.launcherButton.layer.borderColor = [UIColor colorWithWhite:1.0 alpha:0.22].CGColor;
-	self.launcherButton.clipsToBounds = YES;
-	self.launcherButton.hidden = YES;
-	self.launcherButton.accessibilityLabel = @"App Launcher";
-	if (@available(iOS 13.0, *)) {
-		UIImage *image = [UIImage systemImageNamed:@"square.grid.2x2"];
-		[self.launcherButton setImage:image forState:UIControlStateNormal];
-	} else {
-		[self.launcherButton setTitle:@"Apps" forState:UIControlStateNormal];
-		self.launcherButton.titleLabel.font = [UIFont boldSystemFontOfSize:13.0];
-	}
-	[self.launcherButton addTarget:self action:@selector(returnToLauncher:) forControlEvents:UIControlEventTouchUpInside];
-	[self.rootView addSubview:self.launcherButton];
 	controller.view = self.rootView;
 	self.window.rootViewController = controller;
 	[self.window makeKeyAndVisible];
@@ -731,7 +657,6 @@ bool attributedStringHasTextDecoration(NSAttributedString *value)
 	// ImageStore decodes straight to full-colour RGBA8888 native pixels (no 565
 	// quantization, no separate retained buffer) for native UIImageView.
 	gea::framework::app::Application::init(viewportWidth, viewportHeight, devicePixelRatio);
-	queueInitialResidentAppFromProcessArguments();
 	[self syncAppBackgroundColor];
 	[self tick:nil];
 
@@ -748,27 +673,8 @@ bool attributedStringHasTextDecoration(NSAttributedString *value)
 - (void)tick:(CADisplayLink *)link
 {
 	(void)link;
-	{
-		char pendingId[64] = "";
-		if (gea::framework::apps::ResidentApps::consumeLaunch(pendingId, sizeof(pendingId)) &&
-		    gea::framework::apps::ResidentApps::select(pendingId)) {
-			CGSize viewport = [self viewportSize];
-			const CGFloat viewportScale = [self viewportScale];
-			self.displayView.contentScaleFactor = viewportScale;
-			const int viewportWidth = std::max(1, static_cast<int>(std::ceil(viewport.width)));
-			const int viewportHeight = std::max(1, static_cast<int>(std::ceil(viewport.height)));
-			// gea's internal CSS device-pixel-ratio stays 1 (see init above): the
-			// layout is logical points; UIKit handles retina via contentScaleFactor.
-			const int devicePixelRatio = 1;
-			gea::ios::IosRenderer::instance().teardown();
-			gea_ios_display_set_viewport_size(viewportWidth, viewportHeight);
-			gea::platform::display::Display::init();
-			gea::framework::app::Application::init(viewportWidth, viewportHeight, devicePixelRatio);
-		}
-	}
 	gea::framework::app::Application::frame(gea_embedded_now_ms());
 	[self syncAppBackgroundColor];
-	[self syncLauncherButton];
 	auto &tree = gea::embedded::ui::Tree::instance();
 	const int root = tree.mountedRoot();
 	if (!self.nativeRootView && root >= 0) {

package/targets/ios/generate-resident-entry.mjs

@@ -1,67 +0,0 @@
-#!/usr/bin/env node
-// Per-resident-app entry.cpp generator for the iOS in-process app launcher.
-
-import { writeFileSync } from 'node:fs'
-
-const [, , prefix, outPath] = process.argv
-if (!prefix || !outPath) {
-  console.error('Usage: generate-resident-entry.mjs <prefix> <out-cpp>')
-  process.exit(1)
-}
-
-const code = `// Auto-generated by targets/ios/generate-resident-entry.mjs. Do not edit.
-#include "app.h"
-#include "gea/embedded.h"
-#include "graphics/font.h"
-#include "host/rtc.h"
-#include "host/timers.h"
-#include "host/websocket.h"
-#include "ui/document.h"
-#include "ui/style.h"
-
-extern void ${prefix}_top_level();
-extern void ${prefix}_register_styles();
-extern void gea_cpp_clear_microtasks();
-
-namespace gea::framework::app::generated::${prefix} {
-void drainMicrotasks();
-}  // namespace gea::framework::app::generated::${prefix}
-
-void __attribute__((weak)) ${prefix}_register_styles() {}
-
-void ${prefix}_init(int width, int height, double devicePixelRatio)
-{
-\tgea::embedded::ui::Document::setPreferredMountSize(width, height);
-\tgea::embedded::ui::setViewportMetrics(width, height, devicePixelRatio);
-\tgea::host::resetAnimationFrameCallbacks();
-\tgea::host::resetScheduledTimers();
-\tgea_cpp_clear_microtasks();
-\tgea::embedded::ui::StyleSheet::instance().clear();
-\t${prefix}_register_styles();
-\tgea::embedded::ui::Document::instance().clear();
-\t${prefix}_top_level();
-\tgea::embedded::ui::Document::instance().refreshMountedIfDirty();
-}
-
-void ${prefix}_frame(int timestampMs)
-{
-\tgea::framework::app::generated::${prefix}::drainMicrotasks();
-\tgea::host::runAnimationFrameCallbacks(static_cast<double>(timestampMs));
-\tgea::framework::app::generated::${prefix}::drainMicrotasks();
-\tgea::host::websocket::runCallbacks();
-\tgea::host::rtc::runCallbacks();
-\tgea::embedded::ui::Document::instance().frame(timestampMs);
-\tgea::embedded::ui::Document::instance().refreshMountedIfDirty();
-}
-
-void ${prefix}_settings_toggle() {}
-int ${prefix}_mirror_begin_snapshot() { return 0; }
-int ${prefix}_mirror_begin_diff() { return 0; }
-int ${prefix}_mirror_next_record(unsigned char *, int) { return 0; }
-void ${prefix}_mirror_clear_dirty() {}
-void ${prefix}_ble_connected() {}
-void ${prefix}_ble_disconnected() {}
-void ${prefix}_ble_bound() {}
-`
-
-writeFileSync(outPath, code)

package/targets/ios/generate-resident-registry.mjs

@@ -1,162 +0,0 @@
-#!/usr/bin/env node
-// Generates the iOS resident-app registry used by app-launcher simulator builds.
-
-import { writeFileSync } from 'node:fs'
-
-const [, , outPath, launcherId, ...appIds] = process.argv
-if (!outPath || !launcherId || appIds.length === 0) {
-  console.error('Usage: generate-resident-registry.mjs <out-cpp> <launcher-id> <app-id...>')
-  process.exit(1)
-}
-
-const safe = (id) => id.replace(/[^A-Za-z0-9_]/g, '_')
-const prefix = (id) => `gea_resident_${safe(id)}`
-const quote = (s) => s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')
-
-const lines = []
-lines.push('// Auto-generated by targets/ios/generate-resident-registry.mjs.')
-lines.push('// Do not edit.')
-lines.push('#include "app.h"')
-lines.push('#include "resident_apps.h"')
-lines.push('#include "graphics/font.h"')
-lines.push('')
-lines.push('#include <cstdio>')
-lines.push('#include <cstring>')
-lines.push('#include <mutex>')
-lines.push('')
-
-for (const id of appIds) {
-  const p = prefix(id)
-  lines.push(`extern void ${p}_init(int width, int height, double devicePixelRatio);`)
-  lines.push(`extern void ${p}_frame(int timestampMs);`)
-  lines.push(`extern void ${p}_settings_toggle();`)
-  lines.push(`extern const gea::framework::graphics::RasterizedFontData *${p}_lookup_font(int fontId);`)
-  lines.push(`extern const gea::framework::graphics::RasterizedFontData *${p}_lookup_font_for_family(int familyId, int sizePx);`)
-  lines.push(`extern int ${p}_lookup_font_family(const char *family);`)
-  lines.push(`extern const char *${p}_lookup_font_family_name(int familyId);`)
-}
-lines.push('')
-
-lines.push('namespace gea::framework::apps {')
-lines.push('namespace {')
-lines.push(`constexpr const char *kLauncherAppId = "${quote(launcherId)}";`)
-lines.push('std::mutex &pendingLock() { static std::mutex lock; return lock; }')
-lines.push('char pendingLaunchAppId[64] = "";')
-lines.push('bool pendingLaunchValid = false;')
-lines.push('')
-lines.push('const ResidentApp residentApps[] = {')
-for (const id of appIds) {
-  const p = prefix(id)
-  lines.push('\t{')
-  lines.push(`\t\t.id = "${quote(id)}",`)
-  lines.push('\t\t.displayFlushChunkRows = 0,')
-  lines.push('\t\t.displayFlushQueueDepth = 0,')
-  lines.push(`\t\t.init = ${p}_init,`)
-  lines.push(`\t\t.frame = ${p}_frame,`)
-  lines.push(`\t\t.settingsToggle = ${p}_settings_toggle,`)
-  lines.push(`\t\t.lookupFont = ${p}_lookup_font,`)
-  lines.push(`\t\t.lookupFontForFamily = ${p}_lookup_font_for_family,`)
-  lines.push(`\t\t.lookupFontFamily = ${p}_lookup_font_family,`)
-  lines.push(`\t\t.lookupFontFamilyName = ${p}_lookup_font_family_name,`)
-  lines.push('\t},')
-}
-lines.push('};')
-lines.push(`constexpr int kResidentAppCount = ${appIds.length};`)
-lines.push('const ResidentApp *activeApp = &residentApps[0];')
-lines.push('')
-lines.push('const ResidentApp *findApp(const char *appId)')
-lines.push('{')
-lines.push("\tif (!appId || appId[0] == '\\0') return nullptr;")
-lines.push('\tfor (int i = 0; i < kResidentAppCount; i++) {')
-lines.push('\t\tif (std::strcmp(residentApps[i].id, appId) == 0) return &residentApps[i];')
-lines.push('\t}')
-lines.push('\treturn nullptr;')
-lines.push('}')
-lines.push('}  // namespace')
-lines.push('')
-lines.push('namespace generated {')
-lines.push('const ResidentApp *activeResidentApp() { return activeApp; }')
-lines.push('}  // namespace generated')
-lines.push('')
-lines.push('bool ResidentApps::isEnabled() { return kResidentAppCount > 0; }')
-lines.push('const char *ResidentApps::activeId() { return activeApp ? activeApp->id : nullptr; }')
-lines.push('')
-lines.push('bool ResidentApps::select(const char *appId)')
-lines.push('{')
-lines.push('\tconst ResidentApp *next = findApp(appId);')
-lines.push('\tif (!next) return false;')
-lines.push('\tactiveApp = next;')
-lines.push('\treturn true;')
-lines.push('}')
-lines.push('')
-lines.push('bool ResidentApps::requestLaunch(const char *appId)')
-lines.push('{')
-lines.push('\tif (!findApp(appId)) return false;')
-lines.push('\tstd::lock_guard guard(pendingLock());')
-lines.push('\tstd::snprintf(pendingLaunchAppId, sizeof(pendingLaunchAppId), "%s", appId);')
-lines.push('\tpendingLaunchValid = true;')
-lines.push('\treturn true;')
-lines.push('}')
-lines.push('')
-lines.push('bool ResidentApps::consumeLaunch(char *dst, std::size_t cap)')
-lines.push('{')
-lines.push('\tstd::lock_guard guard(pendingLock());')
-lines.push('\tif (!pendingLaunchValid) return false;')
-lines.push('\tif (dst && cap > 0) std::snprintf(dst, cap, "%s", pendingLaunchAppId);')
-lines.push('\tpendingLaunchValid = false;')
-lines.push("\tpendingLaunchAppId[0] = '\\0';")
-lines.push('\treturn true;')
-lines.push('}')
-lines.push('')
-lines.push('bool ResidentApps::returnToLauncher(const char *trigger)')
-lines.push('{')
-lines.push('\t(void)trigger;')
-lines.push('\tif (!activeApp || std::strcmp(activeApp->id, kLauncherAppId) == 0) return false;')
-lines.push('\treturn ResidentApps::requestLaunch(kLauncherAppId);')
-lines.push('}')
-lines.push('')
-lines.push('}  // namespace gea::framework::apps')
-lines.push('')
-lines.push('namespace gea::framework::app {')
-lines.push('void Application::init(int width, int height, double devicePixelRatio)')
-lines.push('{')
-lines.push('\tconst auto *active = gea::framework::apps::generated::activeResidentApp();')
-lines.push('\tif (active && active->init) active->init(width, height, devicePixelRatio);')
-lines.push('}')
-lines.push('void Application::frame(int timestampMs)')
-lines.push('{')
-lines.push('\tconst auto *active = gea::framework::apps::generated::activeResidentApp();')
-lines.push('\tif (active && active->frame) active->frame(timestampMs);')
-lines.push('}')
-lines.push('void Application::toggleSettings()')
-lines.push('{')
-lines.push('\tconst auto *active = gea::framework::apps::generated::activeResidentApp();')
-lines.push('\tif (active && active->settingsToggle) active->settingsToggle();')
-lines.push('}')
-lines.push('}  // namespace gea::framework::app')
-lines.push('')
-lines.push('namespace gea::framework::graphics::generated {')
-lines.push('void ensureLinked() {}')
-lines.push('const RasterizedFontData *lookupFont(int fontId)')
-lines.push('{')
-lines.push('\tconst auto *active = gea::framework::apps::generated::activeResidentApp();')
-lines.push('\treturn active && active->lookupFont ? active->lookupFont(fontId) : nullptr;')
-lines.push('}')
-lines.push('const RasterizedFontData *lookupFontForFamily(int familyId, int sizePx)')
-lines.push('{')
-lines.push('\tconst auto *active = gea::framework::apps::generated::activeResidentApp();')
-lines.push('\treturn active && active->lookupFontForFamily ? active->lookupFontForFamily(familyId, sizePx) : nullptr;')
-lines.push('}')
-lines.push('int lookupFontFamily(const char *family)')
-lines.push('{')
-lines.push('\tconst auto *active = gea::framework::apps::generated::activeResidentApp();')
-lines.push('\treturn active && active->lookupFontFamily ? active->lookupFontFamily(family) : -1;')
-lines.push('}')
-lines.push('const char *lookupFontFamilyName(int familyId)')
-lines.push('{')
-lines.push('\tconst auto *active = gea::framework::apps::generated::activeResidentApp();')
-lines.push('\treturn active && active->lookupFontFamilyName ? active->lookupFontFamilyName(familyId) : nullptr;')
-lines.push('}')
-lines.push('}  // namespace gea::framework::graphics::generated')
-
-writeFileSync(outPath, lines.join('\n') + '\n')