eclipse-platform · Copilot · Oct 4, 2025 · Oct 4, 2025 · Oct 4, 2025 · Oct 4, 2025
diff --git a/binaries/org.eclipse.swt.headless/.project b/binaries/org.eclipse.swt.headless/.project
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>org.eclipse.swt.headless</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.ManifestBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.SchemaBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.api.tools.apiAnalysisBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+		<nature>org.eclipse.pde.PluginNature</nature>
+		<nature>org.eclipse.pde.api.tools.apiAnalysisNature</nature>
+	</natures>
+	<linkedResources>
+		<link>
+			<name>Eclipse SWT</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT Accessibility</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20Accessibility</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT AWT</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20AWT</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT Browser</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20Browser</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT Custom Widgets</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20Custom%20Widgets</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT Drag and Drop</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20Drag%20and%20Drop</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT OpenGL</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20OpenGL</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT Printing</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20Printing</locationURI>
+		</link>
+		<link>
+			<name>Eclipse SWT Program</name>
+			<type>2</type>
+			<locationURI>SWT_HOST_PLUGIN/Eclipse%20SWT%20Program</locationURI>
+		</link>
+	</linkedResources>
+	<variableList>
+		<variable>
+			<name>SWT_HOST_PLUGIN</name>
+			<value>$%7BPARENT-2-PROJECT_LOC%7D/bundles/org.eclipse.swt</value>
+		</variable>
+	</variableList>
+</projectDescription>
diff --git a/binaries/org.eclipse.swt.headless/META-INF/MANIFEST.MF b/binaries/org.eclipse.swt.headless/META-INF/MANIFEST.MF
@@ -0,0 +1,25 @@
+Manifest-Version: 1.0
+Fragment-Host: org.eclipse.swt;bundle-version="[3.128.0,4.0.0)"
+Bundle-Name: %fragmentName
+Bundle-Vendor: %providerName
+Bundle-SymbolicName: org.eclipse.swt.headless; singleton:=true
+Bundle-Version: 3.132.0.qualifier
+Bundle-ManifestVersion: 2
+Bundle-Localization: fragment
+Export-Package: 
+ org.eclipse.swt,
+ org.eclipse.swt.accessibility,
+ org.eclipse.swt.awt,
+ org.eclipse.swt.browser,
+ org.eclipse.swt.custom,
+ org.eclipse.swt.dnd,
+ org.eclipse.swt.events,
+ org.eclipse.swt.graphics,
+ org.eclipse.swt.layout,
+ org.eclipse.swt.opengl,
+ org.eclipse.swt.printing,
+ org.eclipse.swt.program,
+ org.eclipse.swt.widgets,
+ org.eclipse.swt.internal; x-friends:="org.eclipse.ui",
+ org.eclipse.swt.internal.image; x-internal:=true
+Automatic-Module-Name: org.eclipse.swt.headless
diff --git a/binaries/org.eclipse.swt.headless/README.md b/binaries/org.eclipse.swt.headless/README.md
@@ -0,0 +1,211 @@
+# SWT Headless Fragment
+
+## Overview
+
+The `org.eclipse.swt.headless` fragment provides a headless implementation of SWT (Standard Widget Toolkit) that allows applications to run without requiring a native windowing system or display. This is similar to Java AWT's headless mode (`java.awt.headless`).
+
+## Purpose
+
+The headless fragment is useful for:
+
+- **Server-side applications** that need to reference UI code but don't display a UI
+- **Testing** UI applications without requiring a display
+- **Continuous Integration** environments where no display is available
+- **Headless rendering** of UI layouts for documentation or screenshots
+- **Command-line tools** that use SWT libraries but don't require actual UI display
+
+## Key Features
+
+### Detection
+
+You can check if SWT is running in headless mode:
+
+```java
+if (Display.isHeadless()) {
+    // Running in headless mode
+}
+```
+
+### Behavior
+
+In headless mode:
+
+- **Widget creation**: Widgets can be created and configured normally
+- **State management**: Widget properties (text, selection, bounds, etc.) are stored and can be retrieved
+- **Layout**: Layout managers work normally and calculate sizes
+- **Parent-child relationships**: Composite widgets maintain their child lists correctly
+- **Events**: Event listeners can be registered (though events are not automatically triggered)
+- **No rendering**: No actual native widgets are created, no drawing occurs
+- **No user interaction**: Mouse and keyboard events don't occur naturally
+
+## Supported Widgets
+
+The headless implementation provides the following core widgets:
+
+### Containers
+- `Display` - The main display object
+- `Shell` - Top-level window
+- `Composite` - Container for other controls
+- `Canvas` - Drawing surface (no actual drawing)
+- `Decorations` - Base for decorated containers
+
+### Controls
+- `Button` - Push button, checkbox, radio, toggle, arrow
+- `Label` - Text or image label
+- `Control` - Base class for all controls
+
+### Supporting Classes
+- `Widget` - Base class for all widgets
+- `Scrollable` - Base for scrollable controls
+- `Menu` - Menu bar and popup menus
+- `MenuItem` - Individual menu items
+- `Item` - Base for items
+- `Caret` - Text cursor
+- `ScrollBar` - Scrollbar widget
+
+## Limitations
+
+The headless implementation has the following limitations:
+
+### Not Implemented
+
+The following features are **not** currently implemented:
+
+1. **Native rendering**: No actual drawing to screen or images
+2. **User input**: No keyboard or mouse events
+3. **System integration**: 
+   - No system tray
+   - No clipboard
+   - No drag and drop
+   - No native file/color/font dialogs
+4. **Advanced widgets**: Many complex widgets are not yet implemented:
+   - Table, Tree, List
+   - Text, StyledText
+   - Browser
+   - And many others
+5. **Graphics operations**: GC (Graphics Context) drawing operations are no-ops
+6. **Images**: Image loading and manipulation is limited
+7. **Fonts and colors**: System fonts and colors return defaults
+
+### Default Behavior
+
+- `Display.getDefault()` creates a headless display
+- `Display.isHeadless()` returns `true`
+- Widget methods that can't be implemented return default values:
+  - `computeSize()` returns reasonable defaults (64x64 or based on content)
+  - `getBounds()` returns stored bounds
+  - System queries return sensible defaults
+- Operations that require native resources are no-ops:
+  - `redraw()` does nothing
+  - `update()` does nothing
+  - Event loops don't wait for user input
+
+## Usage Example
+
+```java
+// Create a headless display
+Display display = new Display();
+System.out.println("Headless: " + Display.isHeadless()); // true
+
+// Create a shell
+Shell shell = new Shell(display);
+shell.setText("Test Shell");
+shell.setSize(400, 300);
+
+// Create controls
+Composite composite = new Composite(shell, SWT.NONE);
+composite.setLayout(new FillLayout());
+
+Button button = new Button(composite, SWT.PUSH);
+button.setText("Click Me");
+
+Label label = new Label(composite, SWT.NONE);
+label.setText("Hello Headless SWT!");
+
+// Layout works normally
+shell.layout();
+
+// Can query widget properties
+System.out.println("Button text: " + button.getText());
+System.out.println("Label text: " + label.getText());
+System.out.println("Shell size: " + shell.getSize());
+
+// Cleanup
+shell.dispose();
+display.dispose();
+```
+
+## Installation
+
+The headless fragment is automatically available when:
+
+1. The `org.eclipse.swt` bundle is present
+2. The `org.eclipse.swt.headless` fragment is in the classpath
+3. No platform-specific fragment (gtk, cocoa, win32) is available
+
+The OSGi framework will automatically select the headless fragment when no native platform is available.
+
+## Building
+
+The headless fragment is built as part of the normal SWT build process:
+
+```bash
+mvn clean install
+```
+
+The fragment is located in `binaries/org.eclipse.swt.headless/`.
+
+## Contributing
+
+When extending the headless implementation:
+
+1. **Keep it simple**: Headless implementations should be minimal
+2. **Store and return**: Store values set via setters, return them from getters
+3. **No-op when necessary**: Operations that require native resources should be no-ops
+4. **Parent-child tracking**: Maintain widget hierarchies properly
+5. **Follow patterns**: Look at existing headless widgets for consistency
+
+### Adding New Widgets
+
+To add a new widget to the headless implementation:
+
+1. Create the widget class in `bundles/org.eclipse.swt/Eclipse SWT/headless/org/eclipse/swt/widgets/`
+2. Implement the public API from the platform-specific versions
+3. Store state in private fields
+4. Handle parent-child relationships for Composite widgets
+5. Return sensible defaults for queries
+
+## Testing
+
+The headless implementation can be tested using JUnit tests that don't require a display:
+
+```java
+@Test
+public void testHeadlessButton() {
+    Display display = new Display();
+    assertTrue(Display.isHeadless());
+
+    Shell shell = new Shell(display);
+    Button button = new Button(shell, SWT.PUSH);
+    button.setText("Test");
+
+    assertEquals("Test", button.getText());
+    assertFalse(button.getSelection());
+
+    button.setSelection(true);
+    assertTrue(button.getSelection());
+
+    shell.dispose();
+    display.dispose();
+}
+```
+
+## See Also
+
+- [Java AWT Headless Mode](https://www.oracle.com/technical-resources/articles/javase/headless.html)
+- [SWT API Documentation](https://help.eclipse.org/latest/index.jsp)
+- [Eclipse SWT Project](https://www.eclipse.org/swt/)
+
+## License
+
+Eclipse Public License 2.0 (EPL-2.0)
diff --git a/binaries/org.eclipse.swt.headless/build.properties b/binaries/org.eclipse.swt.headless/build.properties
@@ -0,0 +1,29 @@
+###############################################################################
+# Copyright (c) 2025 IBM Corporation and others.
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# Contributors:
+#     IBM Corporation - initial API and implementation
+###############################################################################
+custom = true
+bin.includes = .,fragment.properties
+source.. = \
+	../../bundles/org.eclipse.swt/Eclipse SWT/headless,\
+	../../bundles/org.eclipse.swt/Eclipse SWT/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT/emulated/bidi,\
+	../../bundles/org.eclipse.swt/Eclipse SWT/emulated/coolbar,\
+	../../bundles/org.eclipse.swt/Eclipse SWT/emulated/taskbar,\
+	../../bundles/org.eclipse.swt/Eclipse SWT/emulated/tooltip,\
+	../../bundles/org.eclipse.swt/Eclipse SWT/emulated/expand,\
+	../../bundles/org.eclipse.swt/Eclipse SWT Accessibility/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT AWT/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT Printing/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT Program/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT Browser/common,\
+	../../bundles/org.eclipse.swt/Eclipse SWT OpenGL/common
+output.. = bin/
diff --git a/binaries/org.eclipse.swt.headless/forceQualifierUpdate.txt b/binaries/org.eclipse.swt.headless/forceQualifierUpdate.txt
@@ -0,0 +1,2 @@
+# To force a version qualifier update add the bug here
+Bug 577498 - Initial headless implementation
diff --git a/binaries/org.eclipse.swt.headless/fragment.properties b/binaries/org.eclipse.swt.headless/fragment.properties
@@ -0,0 +1,12 @@
+###############################################################################
+# Copyright (c) 2025 IBM Corporation and others.
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# Contributors:
+#     IBM Corporation - initial API and implementation
+###############################################################################
+fragmentName = Standard Widget Toolkit Headless Implementation
+providerName = Eclipse.org
diff --git a/binaries/pom.xml b/binaries/pom.xml
@@ -40,6 +40,7 @@
 		<module>org.eclipse.swt.gtk.linux.x86_64</module>
 		<module>org.eclipse.swt.win32.win32.aarch64</module>
 		<module>org.eclipse.swt.win32.win32.x86_64</module>
+		<module>org.eclipse.swt.headless</module>
 	</modules>
 
 	<build>
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# To force a version qualifier update add the bug here
		Bug 577498 - Initial headless implementation