@atom-js-org/runtime 0.5.0-alpha.0 → 0.5.2-alpha.0

package/index.d.ts

@@ -61,6 +61,7 @@ export class BrowserWindow extends EventEmitter {
   hide(): void;
   isVisible(): boolean;
   focus(): void;
+  startDrag(): void;
   blur(): void;
   close(): void;
   destroy(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atom-js-org/runtime",
-  "version": "0.5.0-alpha.0",
+  "version": "0.5.2-alpha.0",
   "description": "Electron-like desktop runtime powered by the operating system WebView.",
   "main": "src/index.cjs",
   "types": "index.d.ts",

package/src/bridge-script.cjs

@@ -39,6 +39,68 @@ function generateBridgeScript({ websocketUrl, preloadCode = '' }) {
     }
   }
 
+  function normalizeAppRegion(value) {
+    const normalized = String(value || '').trim().toLowerCase();
+    return normalized === 'drag' || normalized === 'no-drag' ? normalized : '';
+  }
+
+  function appRegionForElement(element) {
+    if (!(element instanceof Element)) return '';
+    if (element.hasAttribute('data-atom-no-drag')) return 'no-drag';
+    if (element.hasAttribute('data-atom-drag-region')) return 'drag';
+
+    const attribute = normalizeAppRegion(
+      element.getAttribute('data-atom-app-region') || element.getAttribute('data-app-region')
+    );
+    if (attribute) return attribute;
+
+    const inline = normalizeAppRegion(
+      element.style && (
+        element.style.getPropertyValue('-webkit-app-region') ||
+        element.style.getPropertyValue('app-region')
+      )
+    );
+    if (inline) return inline;
+
+    try {
+      const computed = getComputedStyle(element);
+      return normalizeAppRegion(
+        computed.getPropertyValue('-webkit-app-region') ||
+        computed.getPropertyValue('app-region')
+      );
+    } catch {
+      return '';
+    }
+  }
+
+  function isInteractiveDragTarget(element) {
+    return element instanceof Element && Boolean(element.closest(
+      'button, input, textarea, select, option, a[href], [contenteditable=""], [contenteditable="true"], [role="button"]'
+    ));
+  }
+
+  function shouldStartWindowDrag(event) {
+    if (event.button !== 0 || event.defaultPrevented) return false;
+    const path = typeof event.composedPath === 'function' ? event.composedPath() : [event.target];
+    let draggable = false;
+
+    for (const entry of path) {
+      if (!(entry instanceof Element)) continue;
+      const region = appRegionForElement(entry);
+      if (region === 'no-drag') return false;
+      if (region === 'drag') draggable = true;
+    }
+
+    if (!draggable || isInteractiveDragTarget(event.target)) return false;
+    return true;
+  }
+
+  document.addEventListener('mousedown', (event) => {
+    if (!shouldStartWindowDrag(event)) return;
+    event.preventDefault();
+    sendNow({ type: 'system', command: 'start-window-drag' });
+  }, true);
+
   function makeEvent(channel) {
     return Object.freeze({
       channel,

package/src/bridge-server.cjs

@@ -163,6 +163,11 @@ class BridgeServer {
       return;
     }
 
+    if (message.type === 'system') {
+      if (message.command === 'start-window-drag') win._startNativeDrag();
+      return;
+    }
+
     if (message.type === 'send') {
       const event = createIpcEvent(win);
       ipcMain.emit(message.channel, event, ...(Array.isArray(message.args) ? message.args : []));

package/src/browser-window.cjs

@@ -219,6 +219,11 @@ class BrowserWindow extends EventEmitter {
     return false;
   }
 
+  _startNativeDrag() {
+    if (this._destroyed) return false;
+    return this._sendHostCommand({ command: 'start-drag' });
+  }
+
   _markRendererReady(details) {
     this._notifyDidFinishLoad(details && details.href ? details.href : this._currentUrl, 'bridge');
   }
@@ -334,6 +339,12 @@ class BrowserWindow extends EventEmitter {
     }
   }
 
+  startDrag() {
+    if (!this._startNativeDrag()) {
+      console.warn('[AtomJS] Native window dragging is not supported by the current platform host.');
+    }
+  }
+
   blur() {}
 
   close() {

package/src/runtime/macos-native-host.m

@@ -70,6 +70,28 @@ static NSColor *AtomJSColor(NSString *hex) {
   return [NSColor colorWithSRGBRed:red green:green blue:blue alpha:alpha];
 }
 
+static void AtomJSConfigureTransparentWebView(WKWebView *webView) {
+  if (!webView) return;
+
+  // `drawsBackground` is not exposed as a public Objective-C property by every
+  // macOS SDK. Use guarded KVC so older SDKs still compile, while retaining the
+  // WebKit behavior needed for genuinely transparent pages.
+  @try {
+    [webView setValue:@NO forKey:@"drawsBackground"];
+  } @catch (__unused NSException *exception) {}
+
+  // Newer WebKit versions expose a public under-page color. Set it through the
+  // Objective-C runtime so the host also compiles against SDKs that predate it.
+  if ([webView respondsToSelector:NSSelectorFromString(@"setUnderPageBackgroundColor:")]) {
+    @try {
+      [webView setValue:[NSColor clearColor] forKey:@"underPageBackgroundColor"];
+    } @catch (__unused NSException *exception) {}
+  }
+
+  webView.wantsLayer = YES;
+  webView.layer.backgroundColor = [NSColor clearColor].CGColor;
+}
+
 static NSImage *AtomJSDefaultApplicationIcon(void) {
   NSSize size = NSMakeSize(512.0, 512.0);
   NSImage *image = [[NSImage alloc] initWithSize:size];
@@ -118,6 +140,7 @@ static void AtomJSConfigureApplicationIdentity(NSApplication *application) {
 @property(nonatomic, assign) BOOL modal;
 - (instancetype)initWithWindowId:(NSNumber *)windowId config:(NSDictionary *)config;
 - (void)navigate:(NSString *)urlString;
+- (void)beginWindowDrag;
 @end
 
 @implementation AtomJSWindowController
@@ -153,6 +176,8 @@ static void AtomJSConfigureApplicationIdentity(NSApplication *application) {
     defer:NO];
   _window.releasedWhenClosed = NO;
   _window.delegate = self;
+  _window.movable = YES;
+  _window.movableByWindowBackground = NO;
   _window.title = AtomJSString(config[@"title"], atomAppName);
   _window.backgroundColor = AtomJSColor(config[@"backgroundColor"]);
   _window.tabbingMode = NSWindowTabbingModeDisallowed;
@@ -208,7 +233,7 @@ static void AtomJSConfigureApplicationIdentity(NSApplication *application) {
   _webView = [[WKWebView alloc] initWithFrame:frame configuration:webConfiguration];
   _webView.navigationDelegate = self;
   _webView.autoresizingMask = NSViewWidthSizable | NSViewHeightSizable;
-  if (AtomJSBoolean(config[@"transparent"], NO)) _webView.drawsBackground = NO;
+  if (AtomJSBoolean(config[@"transparent"], NO)) AtomJSConfigureTransparentWebView(_webView);
   _window.contentView = _webView;
 
   NSNumber *parentWindowId = AtomJSNumber(config[@"parentWindowId"], nil);
@@ -248,6 +273,25 @@ static void AtomJSConfigureApplicationIdentity(NSApplication *application) {
   return self;
 }
 
+- (void)beginWindowDrag {
+  if (!self.window || ([NSEvent pressedMouseButtons] & 1) == 0) return;
+
+  NSPoint screenLocation = [NSEvent mouseLocation];
+  NSPoint windowLocation = [self.window convertPointFromScreen:screenLocation];
+  NSEvent *mouseDown = [NSEvent
+    mouseEventWithType:NSEventTypeLeftMouseDown
+    location:windowLocation
+    modifierFlags:0
+    timestamp:[[NSProcessInfo processInfo] systemUptime]
+    windowNumber:self.window.windowNumber
+    context:nil
+    eventNumber:0
+    clickCount:1
+    pressure:1.0];
+
+  if (mouseDown) [self.window performWindowDragWithEvent:mouseDown];
+}
+
 - (void)navigate:(NSString *)urlString {
   NSURL *url = [NSURL URLWithString:urlString ?: @"about:blank"];
   if (!url) {
@@ -539,6 +583,8 @@ static void AtomJSHandleMessage(NSDictionary *message) {
     [controller.window makeKeyAndOrderFront:nil];
     [controller.window orderFrontRegardless];
     [NSApp activateIgnoringOtherApps:YES];
+  } else if ([command isEqualToString:@"start-drag"]) {
+    [controller beginWindowDrag];
   } else if ([command isEqualToString:@"close"] || [command isEqualToString:@"destroy"]) {
     [controller.window close];
   } else if ([command isEqualToString:@"set-title"]) {