react-x11 2.8.0 → 2.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-x11",
-  "version": "2.8.0",
+  "version": "2.8.1",
   "description": "react renderer with X11 as a target",
   "main": "./src/index.js",
   "files": [

package/src/cocoa/app.js

@@ -612,9 +612,15 @@ export class CocoaApp {
     );
   }
 
-  _tickFrames() {
+  /**
+   * Run every frame that is due at `now`. The pump tick and the frame
+   * timer read the clock; a test names the moment, so that what a tick
+   * decides is a fact about that moment and not about how long the test
+   * took to ask — a shared runner stalls for milliseconds between two
+   * lines.
+   */
+  _tickFrames(now = performance.now()) {
     if (!this._rafQueue.length) return;
-    const now = performance.now();
     // Each window keeps its own clock, so a window on a 120Hz panel paints
     // every refresh while one on a 60Hz monitor paints every other pump
     // tick. Decided once per clock per tick: every frame a window queued

package/src/nodes.js

@@ -10473,8 +10473,18 @@ export class WindowNode extends Scrollable(Node) {
    * and advertising lazily would race sources that cache the window list
    * at drag start. A window with no registered drop targets answers "not
    * accepting" once per entry instead (DropSession).
+   *
+   * The one exception is a `<popup dragPreview>`. It follows the pointer,
+   * so for the whole gesture it is the frontmost window under it, and it
+   * must never be what the drag is over. Where react-x11 picks the target
+   * itself (src/dnd.js `topLevelAt`) it is skipped by name; where the OS
+   * picks — AppKit routes a drag to the frontmost window registered for a
+   * type it carries, and looks past one that registered none — the only
+   * way to say so is to register nothing (#488). So a preview gets none of
+   * this: no session, no registry entry, no property.
    */
   _initDnd() {
+    if (this.props.dragPreview) return;
     const wnd = this.window;
     const X = this.app?.X;
     // A backend with drop machinery of its own (the cocoa backend's

package/src/types/elements.d.ts

@@ -436,8 +436,11 @@ export interface WindowProps
   xi2?: boolean | 'auto';
   /**
    * Mark this window as a drag preview: the drag router never treats it as
-   * the window under the pointer, so a `<popup dragPreview>` can follow the
-   * pointer without swallowing its own drag. See `useDragSource`.
+   * the window under the pointer, and it is never a drop destination — on
+   * the cocoa backend, where AppKit picks the destination, that is what
+   * lets a drop reach the window beneath it. A `<popup dragPreview>` can
+   * therefore follow the pointer without swallowing its own drag. Read when
+   * the window is created. See `useDragSource`.
    */
   dragPreview?: boolean;
   /**