First draft of DeepLinkBridge.m

Author: ntwigg

.gitattributes

@@ -1,3 +1,4 @@
 * text=auto eol=lf
 *.MF text eol=crlf
 *.jar binary
+*.dylib binary

CLAUDE.md

@@ -0,0 +1,39 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build Commands
+
+This is a Gradle-based Java/Kotlin project focused on SWT (Standard Widget Toolkit) utilities. Standard gradle tasks.
+
+### macOS-specific Requirements
+- On macOS, SWT tests require the `-XstartOnFirstThread` JVM argument (automatically configured in build.gradle).
+
+## Project Architecture
+### Multi-Module Structure
+DurianSwt is organized as a multi-module Gradle project with platform-specific implementations:
+
+- **durian-swt.os**: Platform detection utilities (OS, Arch, SwtPlatform) - no SWT dependencies
+- **durian-swt**: Main module with core SWT utilities and builders
+- **platform-specific modules**: (durian-swt.cocoa.macosx.aarch64, durian-swt.cocoa.macosx.x86_64, durian-swt.gtk.linux.x86_64, durian-swt.win32.win32.x86_64)
+
+## Native Components
+
+### macOS Deep Link Support (`natives/mac-deep-link/`)
+
+Contains Objective-C code for handling deep links via a custom `diffplug://` protocol on macOS without breaking SWT:
+
+- **DeepLinkBridge.m**: JNI bridge that intercepts URL open events from macOS
+- **compile-one.sh**: Compiles the native library for a specific architecture (x86_64 or arm64)
+- **clean-and-build.sh**: Builds for both architectures and deploys to appropriate module resources
+
+To rebuild native libraries:
+```bash
+cd natives/mac-deep-link
+./clean-and-build.sh  # Builds for both architectures
+# Or compile for specific architecture:
+./compile-one.sh arm64    # Apple Silicon
+./compile-one.sh x86_64   # Intel
+```
+
+The resulting `DeepLinkBridge.dylib` files are placed in the platform-specific modules under `src/main/resources/durian-swt-natives/`.

build.gradle

@@ -69,6 +69,7 @@ subprojects { subProject ->
 		}
 		dependencies {
 			api project(':durian-swt')
+			implementation "com.diffplug.durian:durian-core:$VER_DURIAN"
 		}
 		configurations.all {
 			resolutionStrategy.eachDependency { DependencyResolveDetails details ->

durian-swt.cocoa.macosx.aarch64/src/main/java/com/diffplug/common/swt/widgets/MacDeepLink.java

@@ -0,0 +1,76 @@
+/*
+ * Copyright (C) 2025 DiffPlug
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.diffplug.common.swt.widgets;
+
+import com.diffplug.common.base.Preconditions;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.atomic.AtomicReference;
+import java.util.function.Consumer;
+import org.jetbrains.annotations.Nullable;
+
+public class MacDeepLink {
+	private static volatile @Nullable Consumer<String> urlHandler;
+	private static final AtomicReference<@Nullable List<String>> backlogUrls = new AtomicReference<>();
+
+	static {
+		// Load the native library - try multiple strategies
+		String libPath = System.getProperty("durian-swt.library.path");
+		if (libPath != null) {
+			System.load(libPath + "/durian-swt-natives/DeepLinkBridge.dylib");
+		} else {
+			throw new IllegalArgumentException("You need to set 'durian-swt.library.path'");
+		}
+	}
+
+	public static void setURLHandler(Consumer<String> handler) {
+		Preconditions.checkArgument(urlHandler == null, "URL handler can only be set once");
+		urlHandler = handler;
+	}
+
+	public static void applicationStartBeforeSwt() {
+		Preconditions.checkArgument(urlHandler != null, "Call `setURLHandler()` first");
+		backlogUrls.set(new ArrayList<>());
+		nativeBeforeSwt();
+	}
+
+	public static void applicationStartAfterSwt() {
+		Preconditions.checkArgument(backlogUrls.get() != null, "Call `applicationStartBeforeSwt()` first.");
+		nativeAfterSwt();
+		var accumulatedBacklog = backlogUrls.getAndSet(null);
+		accumulatedBacklog.forEach(urlHandler);
+	}
+
+	// Native method declarations - implemented in DeepLinkBridge.m
+	private static native void nativeBeforeSwt();
+
+	private static native void nativeAfterSwt();
+
+	/**
+	 * Called from native code when a URL is received.
+	 * This method is invoked on various threads by the native code.
+	 * 
+	 * @param url The URL string received from the operating system
+	 */
+	public static void deliverURL(String url) {
+		var backlog = backlogUrls.get();
+		if (backlog != null) {
+			backlog.add(url);
+		} else {
+			urlHandler.accept(url);
+		}
+	}
+}

durian-swt.cocoa.macosx.aarch64/src/main/resources/durian-swt-natives/DeepLinkBridge.dylib

@@ -0,0 +1,76 @@
+/*
+ * Copyright (C) 2025 DiffPlug
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.diffplug.common.swt.widgets;
+
+import com.diffplug.common.base.Preconditions;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.atomic.AtomicReference;
+import java.util.function.Consumer;
+import org.jetbrains.annotations.Nullable;
+
+public class MacDeepLink {
+	private static volatile @Nullable Consumer<String> urlHandler;
+	private static final AtomicReference<@Nullable List<String>> backlogUrls = new AtomicReference<>();
+
+	static {
+		// Load the native library - try multiple strategies
+		String libPath = System.getProperty("durian-swt.library.path");
+		if (libPath != null) {
+			System.load(libPath + "/durian-swt-natives/DeepLinkBridge.dylib");
+		} else {
+			throw new IllegalArgumentException("You need to set 'durian-swt.library.path'");
+		}
+	}
+
+	public static void setURLHandler(Consumer<String> handler) {
+		Preconditions.checkArgument(urlHandler == null, "URL handler can only be set once");
+		urlHandler = handler;
+	}
+
+	public static void applicationStartBeforeSwt() {
+		Preconditions.checkArgument(urlHandler != null, "Call `setURLHandler()` first");
+		backlogUrls.set(new ArrayList<>());
+		nativeBeforeSwt();
+	}
+
+	public static void applicationStartAfterSwt() {
+		Preconditions.checkArgument(backlogUrls.get() != null, "Call `applicationStartBeforeSwt()` first.");
+		nativeAfterSwt();
+		var accumulatedBacklog = backlogUrls.getAndSet(null);
+		accumulatedBacklog.forEach(urlHandler);
+	}
+
+	// Native method declarations - implemented in DeepLinkBridge.m
+	private static native void nativeBeforeSwt();
+
+	private static native void nativeAfterSwt();
+
+	/**
+	 * Called from native code when a URL is received.
+	 * This method is invoked on various threads by the native code.
+	 *
+	 * @param url The URL string received from the operating system
+	 */
+	public static void deliverURL(String url) {
+		var backlog = backlogUrls.get();
+		if (backlog != null) {
+			backlog.add(url);
+		} else {
+			urlHandler.accept(url);
+		}
+	}
+}