@gtkx/react 0.13.3 → 0.15.0

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type * as Gdk from "@gtkx/ffi/gdk";
+import type * as GObject from "@gtkx/ffi/gobject";
 import type * as Gtk from "@gtkx/ffi/gtk";
 export type Container = Gtk.Widget | Gtk.Application;
 export type Props = Record<string, unknown>;
@@ -7,7 +8,7 @@ export type ContainerClass = typeof Gtk.Widget | typeof Gtk.Application;
  * Props for EventController-based event handlers.
  *
  * These props attach EventControllers to widgets for handling
- * pointer motion, clicks, and keyboard events.
+ * pointer motion, clicks, keyboard events, and drag-and-drop.
  */
 export interface EventControllerProps {
     /** Called when the pointer enters the widget */
@@ -27,3 +28,111 @@ export interface EventControllerProps {
     /** Called when the widget is scrolled */
     onScroll?: (dx: number, dy: number) => boolean;
 }
+/**
+ * Props for DragSource controller.
+ *
+ * Enables dragging content from a widget. Attach a DragSource to make
+ * a widget draggable.
+ */
+export interface DragSourceProps {
+    /**
+     * Called when a drag is about to start. Return a ContentProvider with the data
+     * to be dragged, or null to cancel the drag.
+     * @param x - X coordinate where drag started
+     * @param y - Y coordinate where drag started
+     */
+    onDragPrepare?: (x: number, y: number) => Gdk.ContentProvider | null;
+    /**
+     * Called when the drag operation begins.
+     * @param drag - The Gdk.Drag object representing the ongoing drag
+     */
+    onDragBegin?: (drag: Gdk.Drag) => void;
+    /**
+     * Called when the drag operation ends.
+     * @param drag - The Gdk.Drag object
+     * @param deleteData - Whether the data should be deleted (for move operations)
+     */
+    onDragEnd?: (drag: Gdk.Drag, deleteData: boolean) => void;
+    /**
+     * Called when the drag operation is cancelled.
+     * @param drag - The Gdk.Drag object
+     * @param reason - The reason for cancellation
+     * @returns true if the cancel was handled
+     */
+    onDragCancel?: (drag: Gdk.Drag, reason: Gdk.DragCancelReason) => boolean;
+    /**
+     * The allowed drag actions (COPY, MOVE, LINK, ASK).
+     * Defaults to Gdk.DragAction.COPY if not specified.
+     */
+    dragActions?: Gdk.DragAction;
+}
+/**
+ * Props for DropTarget controller.
+ *
+ * Enables dropping content onto a widget. Attach a DropTarget to make
+ * a widget accept drops.
+ */
+export interface DropTargetProps {
+    /**
+     * Called when content is dropped on the widget.
+     * @param value - The dropped value (use value.getTypeName() to check type, then extract)
+     * @param x - X coordinate of drop
+     * @param y - Y coordinate of drop
+     * @returns true if the drop was accepted
+     */
+    onDrop?: (value: GObject.Value, x: number, y: number) => boolean;
+    /**
+     * Called when a drag enters the widget bounds.
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @returns The preferred action, or 0 to reject
+     */
+    onDropEnter?: (x: number, y: number) => Gdk.DragAction;
+    /**
+     * Called when a drag leaves the widget bounds.
+     */
+    onDropLeave?: () => void;
+    /**
+     * Called when a drag moves within the widget bounds.
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @returns The preferred action, or 0 to reject
+     */
+    onDropMotion?: (x: number, y: number) => Gdk.DragAction;
+    /**
+     * The allowed drop actions (COPY, MOVE, LINK, ASK).
+     * Defaults to Gdk.DragAction.COPY if not specified.
+     */
+    dropActions?: Gdk.DragAction;
+    /**
+     * Array of GTypes that this drop target accepts.
+     * Use typeFromName() to get GType values (e.g., typeFromName("gchararray") for strings).
+     */
+    dropTypes?: number[];
+}
+/**
+ * Props for GestureDrag controller.
+ *
+ * Enables tracking drag gestures (mouse/touch drag movements) on a widget.
+ * Use this for drawing, panning, or any interaction that tracks movement from a start point.
+ */
+export interface GestureDragProps {
+    /**
+     * Called when a drag gesture begins.
+     * @param startX - X coordinate where the drag started
+     * @param startY - Y coordinate where the drag started
+     */
+    onGestureDragBegin?: (startX: number, startY: number) => void;
+    /**
+     * Called as the drag gesture continues.
+     * @param offsetX - Horizontal offset from the start point
+     * @param offsetY - Vertical offset from the start point
+     */
+    onGestureDragUpdate?: (offsetX: number, offsetY: number) => void;
+    /**
+     * Called when the drag gesture ends.
+     * @param offsetX - Final horizontal offset from the start point
+     * @param offsetY - Final vertical offset from the start point
+     */
+    onGestureDragEnd?: (offsetX: number, offsetY: number) => void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/react",
-  "version": "0.13.3",
+  "version": "0.15.0",
   "description": "Build GTK4 desktop applications with React and TypeScript",
   "keywords": [
     "gtkx",
@@ -37,8 +37,8 @@
   ],
   "dependencies": {
     "react-reconciler": "^0.33.0",
-    "@gtkx/gir": "0.13.3",
-    "@gtkx/ffi": "0.13.3"
+    "@gtkx/gir": "0.15.0",
+    "@gtkx/ffi": "0.15.0"
   },
   "devDependencies": {
     "@types/react-reconciler": "^0.32.3"