vxrn 2.14.2 → 2.15.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vxrn",
-  "version": "2.14.2",
+  "version": "2.15.1",
   "sideEffects": false,
   "type": "module",
   "exports": {
@@ -80,14 +80,14 @@
     "@react-native-community/cli": "^20.2.0",
     "@react-native-community/cli-config": "^20.2.0",
     "@react-native/dev-middleware": "^0.88.0",
-    "@vxrn/compiler": "2.14.2",
-    "@vxrn/debug": "2.14.2",
-    "@vxrn/query-string": "2.14.2",
-    "@vxrn/resolve": "2.14.2",
-    "@vxrn/url-parse": "2.14.2",
-    "@vxrn/utils": "2.14.2",
-    "@vxrn/vendor": "2.14.2",
-    "@vxrn/vite-flow": "2.14.2",
+    "@vxrn/compiler": "2.15.1",
+    "@vxrn/debug": "2.15.1",
+    "@vxrn/query-string": "2.15.1",
+    "@vxrn/resolve": "2.15.1",
+    "@vxrn/url-parse": "2.15.1",
+    "@vxrn/utils": "2.15.1",
+    "@vxrn/vendor": "2.15.1",
+    "@vxrn/vite-flow": "2.15.1",
     "citty": "^0.1.6",
     "dotenv": "^17.2.1",
     "dotenv-expand": "^12.0.2",
@@ -112,7 +112,7 @@
   "devDependencies": {
     "@biomejs/biome": "2.5.15",
     "@jridgewell/gen-mapping": "^0.3.5",
-    "@tamagui/build": "3.2.3",
+    "@tamagui/build": "3.3.0",
     "@types/node": "^24.10.0",
     "@types/ws": "^8.18.1",
     "depcheck": "^1.4.7",
@@ -121,20 +121,20 @@
     "react-native": "0.88.0",
     "typescript": "7.0.2",
     "vitest": "^4.1.0",
-    "@vxrn/vite-plugin-metro": "2.14.2"
+    "@vxrn/vite-plugin-metro": "2.15.1"
   },
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "@vxrn/vite-plugin-metro": "2.14.2"
+    "@vxrn/vite-plugin-metro": "2.15.1"
   },
   "peerDependenciesMeta": {
     "@vxrn/vite-plugin-metro": {
       "optional": true
     }
   },
-  "releaseSourceCommit": "16175b9a93e540cad20b5a9c625a904f923e4ddd",
+  "releaseSourceCommit": "84d72d51f9619c438190e70050d616a67c5f5bd1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/onejs/one.git",

package/src/exports/prebuild.ts

@@ -1,4 +1,5 @@
 import { detectPackageManager, type PackageManagerName } from '@vxrn/utils'
+import { existsSync, lstatSync, readdirSync, readFileSync, renameSync, rmSync } from 'node:fs'
 import { readFile, writeFile } from 'node:fs/promises'
 import path from 'node:path'
 import { fillOptions } from '../config/getOptionsFilled'
@@ -64,6 +65,12 @@ export const prebuild = async ({
     throw new Error('package.json checks are failing:\n' + error)
   }
 
+  const ios = path.join(root, 'ios')
+  const previousIos = `${ios}.previous`
+  rmSync(previousIos, { recursive: true, force: true })
+  const reusesIos = (platform == 'ios' || !platform) && existsSync(ios)
+  if (reusesIos) renameSync(ios, previousIos)
+
   if (platform == 'ios' || !platform) {
     await generateForPlatform(root, 'ios', app)
   }
@@ -73,6 +80,8 @@ export const prebuild = async ({
 
   await beforeInstall?.()
 
+  if (reusesIos) reuseUnchangedIosProject(previousIos, ios)
+
   // community config reads the generated projects, so discover after generation
   // and before installation. `--no-install` never fakes the linked package set.
   const inventory = await getNativeDependencyInventory(root)
@@ -121,6 +130,27 @@ Android:
   }
 }
 
+// xcode keys each build input on its file identity and modification time, so a
+// regenerated file it already compiled must be the same file, not equal bytes.
+// what pod install and xcodebuild wrote stays too, so both resume incrementally.
+function reuseUnchangedIosProject(previous: string, next: string) {
+  for (const entry of readdirSync(next, { recursive: true, withFileTypes: true })) {
+    if (!entry.isFile()) continue
+    const file = path.join(entry.parentPath, entry.name)
+    const old = path.join(previous, path.relative(next, file))
+    if (!existsSync(old) || !lstatSync(old).isFile()) continue
+    if (lstatSync(old).size !== lstatSync(file).size) continue
+    if (!readFileSync(old).equals(readFileSync(file))) continue
+    renameSync(old, file)
+  }
+  for (const name of ['Pods', 'Podfile.lock', 'build']) {
+    const from = path.join(previous, name)
+    const to = path.join(next, name)
+    if (existsSync(from) && !existsSync(to)) renameSync(from, to)
+  }
+  rmSync(previous, { recursive: true, force: true })
+}
+
 export async function replaceInUTF8File(
   filePath: string,
   findThis: string,

package/src/exports/prebuildWithoutExpo.test.ts

@@ -23,6 +23,7 @@ import {
   generateForPlatform,
   generateKotlinSources,
   getNativeDependencyInventory,
+  renderIosAppIntentsSwift,
   renderPrebuildFile,
   renderSceneDelegateSwift,
   type PrebuildAppConfig,
@@ -1286,6 +1287,65 @@ describe('ios scene lifecycle', () => {
     expect(sceneDelegate).toContain('RCTLinkingManager.scene(scene, continue: userActivity)')
   })
 
+  it('runs native.app.patches on the generated files and fails on a missing anchor', async () => {
+    const workspaceRoot = fileURLToPath(new URL('../../../..', import.meta.url))
+    const output = mkdtempSync(join(tmpdir(), 'vxrn-prebuild-patches-'))
+    const replaceOnce = (from: string, to: string) => (content: string) => {
+      if (content.includes(to)) return content
+      if (!content.includes(from)) throw new Error(`missing anchor: ${from}`)
+      return content.replace(from, to)
+    }
+    const patches = [
+      {
+        platform: 'ios' as const,
+        file: 'AppDelegate.swift',
+        patch: replaceOnce(
+          'Bundle.main.url(forResource: "main", withExtension: "jsbundle")',
+          'HotUpdater.bundleURL()'
+        ),
+      },
+      {
+        platform: 'ios' as const,
+        file: 'MyApp/Info.plist',
+        patch: replaceOnce('<dict>', '<dict>\n\t<key>HotUpdaterChannel</key>\n\t<string>production</string>'),
+      },
+      {
+        platform: 'android' as const,
+        file: 'MainApplication.kt',
+        patch: replaceOnce(
+          'getDefaultReactHost(\n      context = applicationContext,',
+          'getDefaultReactHost(\n      context = applicationContext,\n      jsBundleFilePath = HotUpdater.getJSBundleFile(applicationContext),'
+        ),
+      },
+    ]
+    await generateForPlatform(workspaceRoot, 'ios', { ...app, patches }, join(output, 'ios'))
+    await generateForPlatform(workspaceRoot, 'android', { ...app, patches }, join(output, 'android'))
+    expect(readFileSync(join(output, 'ios', 'MyApp', 'AppDelegate.swift'), 'utf8')).toContain(
+      'HotUpdater.bundleURL()'
+    )
+    expect(readFileSync(join(output, 'ios', 'MyApp', 'Info.plist'), 'utf8')).toContain(
+      'HotUpdaterChannel'
+    )
+    expect(
+      readFileSync(
+        join(output, 'android', 'app/src/main/java/dev/one/myapp/MainApplication.kt'),
+        'utf8'
+      )
+    ).toContain('jsBundleFilePath = HotUpdater.getJSBundleFile(applicationContext)')
+
+    await expect(
+      generateForPlatform(
+        workspaceRoot,
+        'ios',
+        {
+          ...app,
+          patches: [{ platform: 'ios', file: 'AppDelegate.swift', patch: replaceOnce('nope-anchor', 'replacement-text') }],
+        },
+        join(output, 'ios2')
+      )
+    ).rejects.toThrow('missing anchor')
+  })
+
   it('bundles native.app fonts into both platforms from the real template', async () => {
     const workspaceRoot = fileURLToPath(new URL('../../../..', import.meta.url))
     const output = mkdtempSync(join(tmpdir(), 'vxrn-prebuild-fonts-'))
@@ -2139,9 +2199,12 @@ describe('ios widgets', () => {
       'rectangle',
       'rounded-rectangle',
       'link',
+      'button',
     ]) {
       expect(rendered).toContain(`case "${type}":`)
     }
+    expect(rendered).toContain('struct OneWidgetButtonIntent: AppIntent')
+    expect(rendered).toContain('.supportedFamilies([.systemSmall, .systemMedium])')
     // every ActivityView slot needs a decode path in both presentations
     for (const slot of [
       'lockScreen',
@@ -2155,13 +2218,81 @@ describe('ios widgets', () => {
       expect(rendered).toContain(slot)
     }
     // the JSX bridge methods exist on both sides of the React Native bridge
-    for (const method of ['writeView', 'startView', 'updateView']) {
+    for (const method of ['writeView', 'startView', 'updateView', 'claimActions']) {
       expect(readGenerated('MyApp/OneWidgetsBridge.swift')).toContain(method)
       expect(readGenerated('MyApp/OneWidgetsBridge.m')).toContain(method)
     }
-    // the shared contract carries the serialized layouts
+    expect(readGenerated('MyApp/OneWidgetsBridge.swift')).toContain('"oneWidgetAction"')
+    // the shared contract carries the serialized layouts and interactive actions
     const contract = readGenerated('MyApp/OneWidgetContract.swift')
     expect(contract.match(/let layout: String\?/g)).toHaveLength(2)
+    expect(contract).toContain('static let actionKeyPrefix = "one.widget.action."')
+    expect(contract).toContain('struct Action: Codable')
+    expect(rendered).toContain('OneWidgetContract.actionKeyPrefix + item.id')
+    expect(rendered).toContain('OneWidgetButtonIntent(action: action, value: node.value?.string)')
+    expect(readGenerated('MyApp/OneWidgetsBridge.swift')).toContain(
+      'key.hasPrefix(OneWidgetContract.actionKeyPrefix)'
+    )
+  }, 180000)
+
+  it('emits configured widget families and App Intents spoken dialog metadata', async () => {
+    const workspaceRoot = fileURLToPath(new URL('../../../..', import.meta.url))
+    const output = mkdtempSync(join(tmpdir(), 'vxrn-prebuild-widgets-families-'))
+    await generateForPlatform(
+      workspaceRoot,
+      'ios',
+      {
+        ...widgetsApp,
+        ios: {
+          ...widgetsApp.ios,
+          widgets: {
+            ...widgetsApp.ios.widgets,
+            families: ['systemSmall', 'systemLarge', 'accessoryCircular', 'accessoryRectangular'],
+          },
+        },
+      },
+      join(output, 'ios')
+    )
+    const renderedWidget = readFileSync(
+      join(output, 'ios', 'OneWidgets', 'OneWidget.swift'),
+      'utf8'
+    )
+    expect(renderedWidget).toContain(
+      '.supportedFamilies([.systemSmall, .systemLarge, .accessoryCircular, .accessoryRectangular])'
+    )
+
+    const swift = renderIosAppIntentsSwift([
+      {
+        id: 'dev.one.myapp.ask',
+        title: 'Ask assistant',
+        description: 'Run a voice query and speak the answer.',
+        textParameterTitle: 'Prompt',
+        shortcutPhrase: 'Ask {app} a question',
+        shortcutPhrases: ['Query {app}', 'Ask {app} a question'],
+        systemImageName: 'waveform.circle.fill',
+        openAppWhenRun: true,
+      },
+      {
+        id: 'dev.one.myapp.ping',
+        title: 'Ping',
+        shortcutPhrase: 'Ping {app}',
+      },
+    ])
+    expect(swift).toContain(
+      'func perform() async throws -> some IntentResult & ReturnsValue<String> & ProvidesDialog'
+    )
+    expect(swift).toContain(
+      'return .result(value: result, dialog: IntentDialog(stringLiteral: result))'
+    )
+    expect(swift).toContain(
+      'static let description = IntentDescription("Run a voice query and speak the answer.")'
+    )
+    expect(swift).toContain('static let openAppWhenRun: Bool = true')
+    expect(swift).toContain(
+      'phrases: ["Ask \\(.applicationName) a question", "Query \\(.applicationName)"]'
+    )
+    expect(swift).toContain('systemImageName: "waveform.circle.fill"')
+    expect(swift).toContain('systemImageName: "bolt.fill"')
   }, 180000)
 
   it('regenerates byte-identical widget projects and adds nothing without the config', async () => {

package/src/exports/prebuildWithoutExpo.ts

@@ -372,6 +372,12 @@ function swiftShortcutPhrase(value: string): string {
 export function renderIosAppIntentsSwift(actions: NonNullable<NonNullable<NativeAppManifest['ios']>['appIntents']>['actions']): string {
   const types = actions.map((action, index) => {
     const summaryTitle = swiftLiteral(action.title).slice(1, -1)
+    const description =
+      action.description === undefined
+        ? ''
+        : `\n  static let description = IntentDescription(${swiftLiteral(action.description)})`
+    const openAppWhenRun =
+      action.openAppWhenRun === true ? '\n  static let openAppWhenRun: Bool = true' : ''
     const text = action.textParameterTitle === undefined ? '' : `
   @Parameter(title: ${swiftLiteral(action.textParameterTitle)}) var text: String
 
@@ -380,20 +386,25 @@ export function renderIosAppIntentsSwift(actions: NonNullable<NonNullable<Native
   }
 `
     return `struct OneAppIntent${index}: AppIntent {
-  static let title: LocalizedStringResource = ${swiftLiteral(action.title)}
+  static let title: LocalizedStringResource = ${swiftLiteral(action.title)}${description}${openAppWhenRun}
 ${text}
-  func perform() async throws -> some IntentResult & ReturnsValue<String> {
+  func perform() async throws -> some IntentResult & ReturnsValue<String> & ProvidesDialog {
     let result = try await oneAppIntentsRun(${swiftLiteral(action.id)}, ${text ? 'text' : 'nil'})
-    return .result(value: result)
+    return .result(value: result, dialog: IntentDialog(stringLiteral: result))
   }
 }`
   })
-  const shortcuts = actions.map((action, index) => `    AppShortcut(
+  const shortcuts = actions.map((action, index) => {
+    const phrases = Array.from(
+      new Set([action.shortcutPhrase, ...(action.shortcutPhrases ?? [])])
+    ).map(swiftShortcutPhrase)
+    return `    AppShortcut(
       intent: OneAppIntent${index}(),
-      phrases: [${swiftShortcutPhrase(action.shortcutPhrase)}],
+      phrases: [${phrases.join(', ')}],
       shortTitle: ${swiftLiteral(action.title)},
-      systemImageName: "bolt.fill"
-    )`).join('\n')
+      systemImageName: ${swiftLiteral(action.systemImageName ?? 'bolt.fill')}
+    )`
+  }).join('\n')
   return `import AppIntents
 import Foundation
 
@@ -871,6 +882,9 @@ function generateIosWidgets(dest: string, app: NativeAppManifest): void {
 </dict></plist>
 `
   )
+  const supportedFamilies = (widgets.families ?? ['systemSmall', 'systemMedium'])
+    .map((family) => `.${family}`)
+    .join(', ')
   writeFileSync(
     path.join(appDir, 'OneWidgetContract.swift'),
     `import Foundation
@@ -880,6 +894,7 @@ enum OneWidgetContract {
   static let appGroup = ${JSON.stringify(widgets.appGroup)}
   static let kind = ${JSON.stringify(widgets.kind)}
   static let dataKey = "one.widget.data"
+  static let actionKeyPrefix = "one.widget.action."
 
   struct Data: Codable {
     let title: String
@@ -888,6 +903,13 @@ enum OneWidgetContract {
     let layout: String?
   }
 
+  struct Action: Codable {
+    let id: String
+    let action: String
+    let value: String?
+    let timestampMs: Double
+  }
+
   struct Attributes: ActivityAttributes {
     struct ContentState: Codable, Hashable {
       let status: String
@@ -904,6 +926,7 @@ enum OneWidgetContract {
     `import SwiftUI
 import WidgetKit
 import ActivityKit
+import AppIntents
 
 struct OneWidgetNode: Decodable {
   let type: String
@@ -911,11 +934,36 @@ struct OneWidgetNode: Decodable {
   let style: Style?
   let children: [OneWidgetNode]?
   let systemName: String?
-  let value: Double?
+  let value: Value?
   let total: Double?
   let fill: String?
   let cornerRadius: Double?
   let url: String?
+  let action: String?
+
+  enum Value: Decodable {
+    case number(Double)
+    case string(String)
+
+    var number: Double? {
+      if case .number(let value) = self { return value }
+      return nil
+    }
+
+    var string: String? {
+      if case .string(let value) = self { return value }
+      return nil
+    }
+
+    init(from decoder: Decoder) throws {
+      let container = try decoder.singleValueContainer()
+      if let number = try? container.decode(Double.self) {
+        self = .number(number)
+      } else {
+        self = .string(try container.decode(String.self))
+      }
+    }
+  }
 
   struct Style: Decodable {
     let color: String?
@@ -934,6 +982,43 @@ struct OneWidgetNode: Decodable {
   }
 }
 
+struct OneWidgetButtonIntent: AppIntent {
+  static var title: LocalizedStringResource = "Widget Action"
+
+  @Parameter(title: "Action") var action: String
+  @Parameter(title: "Value") var value: String?
+
+  init() {}
+
+  init(action: String, value: String?) {
+    self.action = action
+    self.value = value
+  }
+
+  func perform() async throws -> some IntentResult {
+    if let defaults = UserDefaults(suiteName: OneWidgetContract.appGroup) {
+      let item = OneWidgetContract.Action(
+        id: UUID().uuidString,
+        action: action,
+        value: value,
+        timestampMs: Date().timeIntervalSince1970 * 1000
+      )
+      if let encoded = try? JSONEncoder().encode(item) {
+        defaults.set(encoded, forKey: OneWidgetContract.actionKeyPrefix + item.id)
+      }
+      CFNotificationCenterPostNotification(
+        CFNotificationCenterGetDarwinNotifyCenter(),
+        CFNotificationName("dev.onejs.widget.action" as CFString),
+        nil,
+        nil,
+        true
+      )
+    }
+    WidgetCenter.shared.reloadTimelines(ofKind: OneWidgetContract.kind)
+    return .result()
+  }
+}
+
 struct OneActivityView: Decodable {
   let lockScreen: OneWidgetNode
   let compactLeading: OneWidgetNode?
@@ -1026,10 +1111,10 @@ struct OneWidgetRendered: View {
             .font(.system(size: CGFloat(node.style?.fontSize ?? 20), weight: weight))
         }
       case "progress":
-        ProgressView(value: node.value ?? 0, total: node.total ?? 1)
+        ProgressView(value: node.value?.number ?? 0, total: node.total ?? 1)
           .tint(oneColor(node.style?.color))
       case "gauge":
-        Gauge(value: node.value ?? 0, in: 0...(node.total ?? 1)) { EmptyView() }
+        Gauge(value: node.value?.number ?? 0, in: 0...(node.total ?? 1)) { EmptyView() }
           .gaugeStyle(.accessoryCircular)
           .tint(oneColor(node.style?.color))
       case "circle":
@@ -1047,6 +1132,15 @@ struct OneWidgetRendered: View {
             }
           }
         }
+      case "button":
+        if let action = node.action {
+          Button(intent: OneWidgetButtonIntent(action: action, value: node.value?.string)) {
+            ForEach(Array((node.children ?? []).enumerated()), id: \\.offset) { _, child in
+              OneWidgetRendered(node: child)
+            }
+          }
+          .buttonStyle(.plain)
+        }
       default: EmptyView()
       }
     }
@@ -1107,7 +1201,7 @@ struct OneWidget: Widget {
     }
     .configurationDisplayName(${JSON.stringify(widgets.displayName)})
     .description(${JSON.stringify(widgets.description)})
-    .supportedFamilies([.systemSmall, .systemMedium])
+    .supportedFamilies([${supportedFamilies}])
   }
 }
 
@@ -1204,31 +1298,120 @@ RCT_EXTERN_METHOD(update:(NSString *)identifier status:(NSString *)status value:
 RCT_EXTERN_METHOD(updateView:(NSString *)identifier layout:(NSString *)layout resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 RCT_EXTERN_METHOD(end:(NSString *)identifier resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 RCT_EXTERN_METHOD(pushToken:(NSString *)identifier resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(claimActions:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 @end
 `
   )
   writeFileSync(
     path.join(appDir, 'OneWidgetsBridge.swift'),
     `import Foundation
+import UIKit
 import React
 import WidgetKit
 import ActivityKit
 
+private func oneWidgetsDarwinCallback(
+  _ center: CFNotificationCenter?,
+  _ observer: UnsafeMutableRawPointer?,
+  _ name: CFNotificationName?,
+  _ object: UnsafeRawPointer?,
+  _ userInfo: CFDictionary?
+) {
+  guard let observer else { return }
+  let bridge = Unmanaged<OneWidgetsBridge>.fromOpaque(observer).takeUnretainedValue()
+  bridge.flushObservedActions()
+}
+
 @objc(OneWidgetsBridge)
 class OneWidgetsBridge: RCTEventEmitter {
   private var tokenTasks: [String: Task<Void, Never>] = [:]
+  private var isObservingEvents = false
+  private var foregroundObserver: NSObjectProtocol?
+  private let actionLock = NSLock()
 
-  override func supportedEvents() -> [String]! { ["oneLiveActivityPushToken"] }
+  override func supportedEvents() -> [String]! { ["oneLiveActivityPushToken", "oneWidgetAction"] }
 
   override func startObserving() {
+    isObservingEvents = true
     for activity in Activity<OneWidgetContract.Attributes>.activities {
       observeToken(activity)
     }
+    CFNotificationCenterAddObserver(
+      CFNotificationCenterGetDarwinNotifyCenter(),
+      Unmanaged.passUnretained(self).toOpaque(),
+      oneWidgetsDarwinCallback,
+      "dev.onejs.widget.action" as CFString,
+      nil,
+      .deliverImmediately
+    )
+    foregroundObserver = NotificationCenter.default.addObserver(
+      forName: UIApplication.didBecomeActiveNotification,
+      object: nil,
+      queue: .main
+    ) { [weak self] _ in
+      self?.flushObservedActions()
+    }
+    flushObservedActions()
   }
 
   override func stopObserving() {
+    isObservingEvents = false
     for task in tokenTasks.values { task.cancel() }
     tokenTasks.removeAll()
+    CFNotificationCenterRemoveObserver(
+      CFNotificationCenterGetDarwinNotifyCenter(),
+      Unmanaged.passUnretained(self).toOpaque(),
+      CFNotificationName("dev.onejs.widget.action" as CFString),
+      nil
+    )
+    if let foregroundObserver {
+      NotificationCenter.default.removeObserver(foregroundObserver)
+      self.foregroundObserver = nil
+    }
+  }
+
+  deinit {
+    CFNotificationCenterRemoveObserver(
+      CFNotificationCenterGetDarwinNotifyCenter(),
+      Unmanaged.passUnretained(self).toOpaque(),
+      CFNotificationName("dev.onejs.widget.action" as CFString),
+      nil
+    )
+    if let foregroundObserver {
+      NotificationCenter.default.removeObserver(foregroundObserver)
+    }
+  }
+
+  fileprivate func flushObservedActions() {
+    guard isObservingEvents else { return }
+    for item in drainStoredActions() {
+      sendEvent(withName: "oneWidgetAction", body: item)
+    }
+  }
+
+  private func drainStoredActions() -> [[String: Any]] {
+    actionLock.lock()
+    defer { actionLock.unlock() }
+    guard let defaults = UserDefaults(suiteName: OneWidgetContract.appGroup) else {
+      return []
+    }
+    var actions: [OneWidgetContract.Action] = []
+    for key in defaults.dictionaryRepresentation().keys where key.hasPrefix(OneWidgetContract.actionKeyPrefix) {
+      guard let data = defaults.data(forKey: key) else { continue }
+      defaults.removeObject(forKey: key)
+      if let action = try? JSONDecoder().decode(OneWidgetContract.Action.self, from: data) {
+        actions.append(action)
+      }
+    }
+    actions.sort { $0.timestampMs < $1.timestampMs }
+    return actions.map { action in
+      [
+        "id": action.id,
+        "action": action.action,
+        "value": action.value ?? NSNull(),
+        "timestampMs": action.timestampMs,
+      ]
+    }
   }
 
   private func observeToken(_ activity: Activity<OneWidgetContract.Attributes>) {
@@ -1370,6 +1553,15 @@ class OneWidgetsBridge: RCTEventEmitter {
       resolve(NSNull())
     }
   }
+
+  @objc(claimActions:rejecter:)
+  func claimActions(_ resolve: RCTPromiseResolveBlock, rejecter reject: RCTPromiseRejectBlock) {
+    guard UserDefaults(suiteName: OneWidgetContract.appGroup) != nil else {
+      reject("app_group", "Cannot open the configured App Group", nil)
+      return
+    }
+    resolve(drainStoredActions())
+  }
 }
 `
   )
@@ -2972,6 +3164,36 @@ export const generateForPlatform = async (
   if (platform === 'ios') await generateSwiftPackages({ root, dest })
   if (platform === 'android') generateAndroidIconForwarder(dest, app)
   if (platform === 'android') await generateKotlinSources({ root, dest })
+  applyAppPatches(dest, platform, app)
+}
+
+function listFiles(dir: string): string[] {
+  return readdirSync(dir, { withFileTypes: true }).flatMap((entry) =>
+    entry.isDirectory() ? listFiles(path.join(dir, entry.name)) : [path.join(dir, entry.name)]
+  )
+}
+
+function applyAppPatches(dest: string, platform: 'ios' | 'android', app: NativeAppManifest) {
+  const patches = (app.patches ?? []).filter((entry) => entry.platform === platform)
+  if (patches.length === 0) return
+  const files = listFiles(dest)
+  for (const { file, patch } of patches) {
+    const matches = files.filter((candidate) => {
+      const relative = path.relative(dest, candidate).split(path.sep).join('/')
+      return relative === file || relative.endsWith('/' + file)
+    })
+    if (matches.length !== 1) {
+      throw new Error(
+        `[vxrn] native.app.patches: "${file}" matched ${matches.length} ${platform} files, expected exactly one`
+      )
+    }
+    const before = readFileSync(matches[0], 'utf8')
+    const after = patch(before)
+    if (patch(after) !== after) {
+      throw new Error(`[vxrn] native.app.patches: patch for "${file}" is not idempotent`)
+    }
+    writeFileSync(matches[0], after)
+  }
 }
 
 // an imported kotlin source can reach past the base ui/foundation/material3

package/types/exports/prebuild.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prebuild.d.ts","sourceRoot":"","sources":["../../src/exports/prebuild.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAA;AAK9B,eAAO,MAAM,QAAQ,qEAMlB;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAA;IACrC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,GAAG,EAAE,iBAAiB,CAAA;IAGtB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC,kBA0FA,CAAA;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,iBAOpB"}
+{"version":3,"file":"prebuild.d.ts","sourceRoot":"","sources":["../../src/exports/prebuild.ts"],"names":[],"mappings":"AAMA,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAA;AAK9B,eAAO,MAAM,QAAQ,qEAMlB;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAA;IACrC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,GAAG,EAAE,iBAAiB,CAAA;IAGtB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC,kBAkGA,CAAA;AAuBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,iBAOpB"}

package/types/exports/prebuildWithoutExpo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prebuildWithoutExpo.d.ts","sourceRoot":"","sources":["../../src/exports/prebuildWithoutExpo.ts"],"names":[],"mappings":"AAkBA,OAAO,EAKL,iBAAiB,EAEjB,KAAK,iBAAiB,EAEvB,MAAM,+BAA+B,CAAA;AAwEtC,YAAY,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAE3F,eAAO,MAAM,mBAAmB,0BAAoB,CAAA;AA6EpD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwChE;AAyJD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CA8CrI;AAg8BD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AA6sBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,iBAAiB,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,oBAAoB,CA0xBvB;AAED,eAAO,MAAM,mBAAmB,SACxB,MAAM,YACF,KAAK,GAAG,SAAS,OACtB,iBAAiB,WACd,MAAM,kBAuEf,CAAA;AAgCD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,QA6EvD;AAID,wBAAsB,qBAAqB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,iBAsDzF;AAyFD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,iBAAiB,CAAA;IACtB,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAChD,GAAG,IAAI,CAmCP;AAID,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA+BtC;AAKD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAA;CACtC,GAAG,IAAI,CAaP"}
+{"version":3,"file":"prebuildWithoutExpo.d.ts","sourceRoot":"","sources":["../../src/exports/prebuildWithoutExpo.ts"],"names":[],"mappings":"AAkBA,OAAO,EAKL,iBAAiB,EAEjB,KAAK,iBAAiB,EAEvB,MAAM,+BAA+B,CAAA;AAwEtC,YAAY,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAE3F,eAAO,MAAM,mBAAmB,0BAAoB,CAAA;AA6EpD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwChE;AAyJD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CAyDrI;AAqnCD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AA6sBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,iBAAiB,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,oBAAoB,CA0xBvB;AAED,eAAO,MAAM,mBAAmB,SACxB,MAAM,YACF,KAAK,GAAG,SAAS,OACtB,iBAAiB,WACd,MAAM,kBAwEf,CAAA;AA6DD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,QA6EvD;AAID,wBAAsB,qBAAqB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,iBAsDzF;AAyFD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,iBAAiB,CAAA;IACtB,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAChD,GAAG,IAAI,CAmCP;AAID,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA+BtC;AAKD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAA;CACtC,GAAG,IAAI,CAaP"}