react-native-gtkx 0.3.0-alpha.1 → 0.4.0-alpha.2

package/dist/gtkx/bridge/color-scheme-portal.js

@@ -0,0 +1,172 @@
+// The plain-GTK profile's color-scheme source — see
+// .claude/epics/adw-optional/004.md. Two mechanisms, same as the task:
+//
+// 1. org.freedesktop.appearance's "color-scheme" key on the XDG desktop
+//    portal (org.freedesktop.portal.Settings, over D-Bus) — the
+//    cross-desktop standard GNOME, KDE and others implement, with live
+//    updates via its SettingChanged signal. This is what makes the plain
+//    profile report the real system scheme on KDE too, not just GNOME.
+// 2. Gtk.Settings' gtk-application-prefer-dark-theme when the portal never
+//    answers (no xdg-desktop-portal running at all, or it timed out) — the
+//    only other lever plain GTK has, and also the ONLY thing
+//    setPlainColorScheme can honestly write (see its own doc below).
+//
+// The parsing half (unwrapping the portal's double-boxed variant, mapping
+// its uint32 onto "light"/"dark") lives in ./color-scheme-parse instead,
+// which has no @gtkx/gi imports at all — this file is the GTK/D-Bus glue
+// around it, and is NOT unit-testable on its own (constructing a real
+// Gio.DBusProxy needs a real GTK/GLib runtime); see that file's own doc and
+// tests/unit/gtkx/color-scheme-parse.test.ts for what actually is.
+//
+// Deliberately hand-rolled rather than reading GTK's own newer
+// Gtk.Settings:gtk-interface-color-scheme (added in GTK 4.16, and itself
+// backed by this exact same portal internally): that property does not
+// exist before 4.16, silently raising this profile's real minimum past the
+// GTK >= 4.10 baseline Alert's Gtk.AlertDialog fallback already commits to,
+// and — because it is GTK's own opaque internal client — gives us nothing
+// to unit-test if the portal itself can never be reached in this repo's
+// headless test session.
+import * as Gio from "@gtkx/gi/gio";
+import * as GLib from "@gtkx/gi/glib";
+import * as Gtk from "@gtkx/gi/gtk";
+import { parsePortalReadReply, parseSettingChangedValue, } from "./color-scheme-parse";
+const PORTAL_BUS_NAME = "org.freedesktop.portal.Desktop";
+const PORTAL_OBJECT_PATH = "/org/freedesktop/portal/desktop";
+const PORTAL_SETTINGS_INTERFACE = "org.freedesktop.portal.Settings";
+const APPEARANCE_NAMESPACE = "org.freedesktop.appearance";
+const COLOR_SCHEME_KEY = "color-scheme";
+// Bounded so a session with no portal at all (this repo's own headless-sway
+// GTK test session included — see color-scheme-portal.gtk.test.tsx in
+// spike/plain-gtk) fails fast instead of riding D-Bus's own ~25s default
+// method-call timeout. Generous next to a real portal's actual answer time
+// (single-digit milliseconds locally in every manual check during this task).
+const PORTAL_TIMEOUT_MSEC = 2000;
+const settingsDefault = () => Gtk.Settings.getDefault();
+const effectiveScheme = () => settingsDefault()?.gtkApplicationPreferDarkTheme ? "dark" : "light";
+const applyToGtkSettings = (scheme) => {
+    const settings = settingsDefault();
+    if (settings) {
+        // Writing fires notify::gtk-application-prefer-dark-theme (a no-op,
+        // GObject-property-setter style, when the value does not actually
+        // change) — the ONE signal onPlainColorSchemeChange listens on, so this
+        // is also how both setPlainColorScheme and an incoming portal update
+        // reach subscribers, with no separate notify path to keep in sync.
+        settings.gtkApplicationPreferDarkTheme = scheme === "dark";
+    }
+};
+// null = "follow the system" (this profile's equivalent of Adw's
+// ColorScheme.DEFAULT); "light"/"dark" = an explicit local override (this
+// profile's equivalent of Adw's FORCE_LIGHT/FORCE_DARK) — same tri-state
+// shape as AdwStyleManager's own, so getPlainColorScheme/
+// setPlainColorScheme stay consistent with each other exactly the way
+// AdwStyleManager already is (see host.gtkx.ts's setColorScheme/
+// colorScheme(), which both go through the one manager instance).
+let forced = null;
+// The last value this process actually learned FROM the portal, kept even
+// while forced !== null so un-forcing (setPlainColorScheme(null)) can
+// re-apply it immediately rather than waiting for the next SettingChanged.
+let lastPortalScheme = null;
+const applySystemUpdate = (scheme) => {
+    lastPortalScheme = scheme;
+    if (forced === null) {
+        applyToGtkSettings(scheme);
+    }
+};
+let probeStarted = false;
+// One-time, synchronous, memoized — mirrors gtkx/bridge/adw.ts's own
+// probe-once cached shape. Synchronous (not a dynamic import/async probe
+// like adw.ts's) because getPlainColorScheme must answer synchronously on
+// every call per the Host contract (AppearanceHost.getColorScheme is not a
+// Promise) — this is the one place that pays the D-Bus round trip, once,
+// bounded by PORTAL_TIMEOUT_MSEC, the first time appearance is actually
+// touched (not at module load, so an app that never reads/writes
+// Appearance never pays for it at all).
+const ensurePortalProbed = () => {
+    if (probeStarted) {
+        return;
+    }
+    probeStarted = true;
+    try {
+        const proxy = Gio.DBusProxy.newForBusSync(Gio.BusType.SESSION, 
+        // Skips the constructor's own synchronous property-cache GetAll call
+        // (the Settings portal interface has none we care about) — without
+        // this, construction itself can block on bus activation before ever
+        // reaching the bounded callSync below.
+        Gio.DBusProxyFlags.DO_NOT_LOAD_PROPERTIES, null, PORTAL_BUS_NAME, PORTAL_OBJECT_PATH, PORTAL_SETTINGS_INTERFACE, null);
+        const reply = proxy.callSync("Read", GLib.Variant.newTuple([
+            GLib.Variant.newString(APPEARANCE_NAMESPACE),
+            GLib.Variant.newString(COLOR_SCHEME_KEY),
+        ]), Gio.DBusCallFlags.NONE, PORTAL_TIMEOUT_MSEC, null);
+        applySystemUpdate(parsePortalReadReply(reply.getChildValue(0)));
+        proxy.on("g-signal", (_sender, signalName, parameters) => {
+            if (signalName !== "SettingChanged") {
+                return;
+            }
+            const namespace = parameters.getChildValue(0).getString()[0];
+            const key = parameters.getChildValue(1).getString()[0];
+            if (namespace !== APPEARANCE_NAMESPACE || key !== COLOR_SCHEME_KEY) {
+                return;
+            }
+            applySystemUpdate(parseSettingChangedValue(parameters.getChildValue(2)));
+        });
+    }
+    catch {
+        // No session bus, no portal owning org.freedesktop.portal.Desktop, or
+        // it didn't answer inside PORTAL_TIMEOUT_MSEC — Gtk.Settings' own
+        // current value (its GTK/theme default, absent anything else to set it)
+        // is the only honest source left. Not retried: matches adwAvailable()'s
+        // own probe-once verdict, and a portal that is not there at process
+        // start is not expected to appear mid-session either.
+    }
+};
+/** Always "light" | "dark" — see the module doc for how it is sourced. */
+export const getPlainColorScheme = () => {
+    ensurePortalProbed();
+    return effectiveScheme();
+};
+/**
+ * The plain profile's setColorScheme. What Adw's setColorScheme forces is
+ * already only ever an app-local override — AdwStyleManager is per-process,
+ * never a system-wide write — so writing Gtk.Settings'
+ * gtk-application-prefer-dark-theme here (also strictly app-local: it never
+ * reaches outside this process either) is not a lesser feature, just the
+ * plain-GTK lever that does the same job. There is no honest way to make
+ * this profile change the DESKTOP's own preference — no portal write API
+ * exists (the portal is read + notify only, by design) — so "local-only" is
+ * the whole story, not a fallback for a system-wide write that almost
+ * worked.
+ *
+ * null ("follow the system") re-applies the last value actually observed
+ * from the portal, if any. With no portal reachable at all there is no
+ * other system source to revert to, so it is a deliberate no-op — staying
+ * at whatever the toggle already reads rather than guessing a default.
+ */
+export const setPlainColorScheme = (scheme) => {
+    ensurePortalProbed();
+    forced = scheme;
+    applyToGtkSettings(scheme ?? lastPortalScheme ?? effectiveScheme());
+};
+let settingsListenerAttached = false;
+const listeners = new Set();
+const attachSettingsListener = () => {
+    if (settingsListenerAttached) {
+        return;
+    }
+    const settings = settingsDefault();
+    if (!settings) {
+        return;
+    }
+    settingsListenerAttached = true;
+    settings.on("notify::gtk-application-prefer-dark-theme", () => {
+        for (const listener of listeners) {
+            listener();
+        }
+    });
+};
+export const onPlainColorSchemeChange = (notify) => {
+    ensurePortalProbed();
+    attachSettingsListener();
+    listeners.add(notify);
+    return { remove: () => listeners.delete(notify) };
+};
+//# sourceMappingURL=color-scheme-portal.js.map

package/dist/gtkx/bridge/color-scheme-portal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-scheme-portal.js","sourceRoot":"","sources":["../../../src/gtkx/bridge/color-scheme-portal.ts"],"names":[],"mappings":"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","sourcesContent":["// The plain-GTK profile's color-scheme source — see\n// .claude/epics/adw-optional/004.md. Two mechanisms, same as the task:\n//\n// 1. org.freedesktop.appearance's \"color-scheme\" key on the XDG desktop\n//    portal (org.freedesktop.portal.Settings, over D-Bus) — the\n//    cross-desktop standard GNOME, KDE and others implement, with live\n//    updates via its SettingChanged signal. This is what makes the plain\n//    profile report the real system scheme on KDE too, not just GNOME.\n// 2. Gtk.Settings' gtk-application-prefer-dark-theme when the portal never\n//    answers (no xdg-desktop-portal running at all, or it timed out) — the\n//    only other lever plain GTK has, and also the ONLY thing\n//    setPlainColorScheme can honestly write (see its own doc below).\n//\n// The parsing half (unwrapping the portal's double-boxed variant, mapping\n// its uint32 onto \"light\"/\"dark\") lives in ./color-scheme-parse instead,\n// which has no @gtkx/gi imports at all — this file is the GTK/D-Bus glue\n// around it, and is NOT unit-testable on its own (constructing a real\n// Gio.DBusProxy needs a real GTK/GLib runtime); see that file's own doc and\n// tests/unit/gtkx/color-scheme-parse.test.ts for what actually is.\n//\n// Deliberately hand-rolled rather than reading GTK's own newer\n// Gtk.Settings:gtk-interface-color-scheme (added in GTK 4.16, and itself\n// backed by this exact same portal internally): that property does not\n// exist before 4.16, silently raising this profile's real minimum past the\n// GTK >= 4.10 baseline Alert's Gtk.AlertDialog fallback already commits to,\n// and — because it is GTK's own opaque internal client — gives us nothing\n// to unit-test if the portal itself can never be reached in this repo's\n// headless test session.\nimport * as Gio from \"@gtkx/gi/gio\"\nimport * as GLib from \"@gtkx/gi/glib\"\nimport * as Gtk from \"@gtkx/gi/gtk\"\nimport type { SubscriptionHandle } from \"../../contracts\"\nimport {\n  parsePortalReadReply,\n  parseSettingChangedValue,\n  type ColorScheme,\n} from \"./color-scheme-parse\"\n\nexport type { ColorScheme }\n\nconst PORTAL_BUS_NAME = \"org.freedesktop.portal.Desktop\"\nconst PORTAL_OBJECT_PATH = \"/org/freedesktop/portal/desktop\"\nconst PORTAL_SETTINGS_INTERFACE = \"org.freedesktop.portal.Settings\"\nconst APPEARANCE_NAMESPACE = \"org.freedesktop.appearance\"\nconst COLOR_SCHEME_KEY = \"color-scheme\"\n\n// Bounded so a session with no portal at all (this repo's own headless-sway\n// GTK test session included — see color-scheme-portal.gtk.test.tsx in\n// spike/plain-gtk) fails fast instead of riding D-Bus's own ~25s default\n// method-call timeout. Generous next to a real portal's actual answer time\n// (single-digit milliseconds locally in every manual check during this task).\nconst PORTAL_TIMEOUT_MSEC = 2000\n\nconst settingsDefault = (): Gtk.Settings | null => Gtk.Settings.getDefault()\n\nconst effectiveScheme = (): ColorScheme =>\n  settingsDefault()?.gtkApplicationPreferDarkTheme ? \"dark\" : \"light\"\n\nconst applyToGtkSettings = (scheme: ColorScheme): void => {\n  const settings = settingsDefault()\n  if (settings) {\n    // Writing fires notify::gtk-application-prefer-dark-theme (a no-op,\n    // GObject-property-setter style, when the value does not actually\n    // change) — the ONE signal onPlainColorSchemeChange listens on, so this\n    // is also how both setPlainColorScheme and an incoming portal update\n    // reach subscribers, with no separate notify path to keep in sync.\n    settings.gtkApplicationPreferDarkTheme = scheme === \"dark\"\n  }\n}\n\n// null = \"follow the system\" (this profile's equivalent of Adw's\n// ColorScheme.DEFAULT); \"light\"/\"dark\" = an explicit local override (this\n// profile's equivalent of Adw's FORCE_LIGHT/FORCE_DARK) — same tri-state\n// shape as AdwStyleManager's own, so getPlainColorScheme/\n// setPlainColorScheme stay consistent with each other exactly the way\n// AdwStyleManager already is (see host.gtkx.ts's setColorScheme/\n// colorScheme(), which both go through the one manager instance).\nlet forced: ColorScheme | null = null\n// The last value this process actually learned FROM the portal, kept even\n// while forced !== null so un-forcing (setPlainColorScheme(null)) can\n// re-apply it immediately rather than waiting for the next SettingChanged.\nlet lastPortalScheme: ColorScheme | null = null\n\nconst applySystemUpdate = (scheme: ColorScheme): void => {\n  lastPortalScheme = scheme\n  if (forced === null) {\n    applyToGtkSettings(scheme)\n  }\n}\n\nlet probeStarted = false\n\n// One-time, synchronous, memoized — mirrors gtkx/bridge/adw.ts's own\n// probe-once cached shape. Synchronous (not a dynamic import/async probe\n// like adw.ts's) because getPlainColorScheme must answer synchronously on\n// every call per the Host contract (AppearanceHost.getColorScheme is not a\n// Promise) — this is the one place that pays the D-Bus round trip, once,\n// bounded by PORTAL_TIMEOUT_MSEC, the first time appearance is actually\n// touched (not at module load, so an app that never reads/writes\n// Appearance never pays for it at all).\nconst ensurePortalProbed = (): void => {\n  if (probeStarted) {\n    return\n  }\n  probeStarted = true\n  try {\n    const proxy = Gio.DBusProxy.newForBusSync(\n      Gio.BusType.SESSION,\n      // Skips the constructor's own synchronous property-cache GetAll call\n      // (the Settings portal interface has none we care about) — without\n      // this, construction itself can block on bus activation before ever\n      // reaching the bounded callSync below.\n      Gio.DBusProxyFlags.DO_NOT_LOAD_PROPERTIES,\n      null,\n      PORTAL_BUS_NAME,\n      PORTAL_OBJECT_PATH,\n      PORTAL_SETTINGS_INTERFACE,\n      null,\n    )\n    const reply = proxy.callSync(\n      \"Read\",\n      GLib.Variant.newTuple([\n        GLib.Variant.newString(APPEARANCE_NAMESPACE),\n        GLib.Variant.newString(COLOR_SCHEME_KEY),\n      ]),\n      Gio.DBusCallFlags.NONE,\n      PORTAL_TIMEOUT_MSEC,\n      null,\n    )\n    applySystemUpdate(parsePortalReadReply(reply.getChildValue(0)))\n    proxy.on(\"g-signal\", (_sender, signalName, parameters) => {\n      if (signalName !== \"SettingChanged\") {\n        return\n      }\n      const namespace = parameters.getChildValue(0).getString()[0]\n      const key = parameters.getChildValue(1).getString()[0]\n      if (namespace !== APPEARANCE_NAMESPACE || key !== COLOR_SCHEME_KEY) {\n        return\n      }\n      applySystemUpdate(parseSettingChangedValue(parameters.getChildValue(2)))\n    })\n  } catch {\n    // No session bus, no portal owning org.freedesktop.portal.Desktop, or\n    // it didn't answer inside PORTAL_TIMEOUT_MSEC — Gtk.Settings' own\n    // current value (its GTK/theme default, absent anything else to set it)\n    // is the only honest source left. Not retried: matches adwAvailable()'s\n    // own probe-once verdict, and a portal that is not there at process\n    // start is not expected to appear mid-session either.\n  }\n}\n\n/** Always \"light\" | \"dark\" — see the module doc for how it is sourced. */\nexport const getPlainColorScheme = (): ColorScheme => {\n  ensurePortalProbed()\n  return effectiveScheme()\n}\n\n/**\n * The plain profile's setColorScheme. What Adw's setColorScheme forces is\n * already only ever an app-local override — AdwStyleManager is per-process,\n * never a system-wide write — so writing Gtk.Settings'\n * gtk-application-prefer-dark-theme here (also strictly app-local: it never\n * reaches outside this process either) is not a lesser feature, just the\n * plain-GTK lever that does the same job. There is no honest way to make\n * this profile change the DESKTOP's own preference — no portal write API\n * exists (the portal is read + notify only, by design) — so \"local-only\" is\n * the whole story, not a fallback for a system-wide write that almost\n * worked.\n *\n * null (\"follow the system\") re-applies the last value actually observed\n * from the portal, if any. With no portal reachable at all there is no\n * other system source to revert to, so it is a deliberate no-op — staying\n * at whatever the toggle already reads rather than guessing a default.\n */\nexport const setPlainColorScheme = (scheme: ColorScheme | null): void => {\n  ensurePortalProbed()\n  forced = scheme\n  applyToGtkSettings(scheme ?? lastPortalScheme ?? effectiveScheme())\n}\n\nlet settingsListenerAttached = false\nconst listeners = new Set<() => void>()\n\nconst attachSettingsListener = (): void => {\n  if (settingsListenerAttached) {\n    return\n  }\n  const settings = settingsDefault()\n  if (!settings) {\n    return\n  }\n  settingsListenerAttached = true\n  settings.on(\"notify::gtk-application-prefer-dark-theme\", () => {\n    for (const listener of listeners) {\n      listener()\n    }\n  })\n}\n\nexport const onPlainColorSchemeChange = (\n  notify: () => void,\n): SubscriptionHandle => {\n  ensurePortalProbed()\n  attachSettingsListener()\n  listeners.add(notify)\n  return { remove: () => listeners.delete(notify) }\n}\n"]}

package/dist/gtkx/bridge/core.d.ts

@@ -0,0 +1,25 @@
+import * as Gdk from "@gtkx/gi/gdk";
+import * as Gio from "@gtkx/gi/gio";
+import * as GLib from "@gtkx/gi/glib";
+import * as GObject from "@gtkx/gi/gobject";
+import * as Graphene from "@gtkx/gi/graphene";
+import * as Gsk from "@gtkx/gi/gsk";
+import * as Gtk from "@gtkx/gi/gtk";
+import * as Pango from "@gtkx/gi/pango";
+export { Gdk, Gio, GLib, GObject, Graphene, Gsk, Gtk, Pango };
+export { GtkApplication, GtkGestureClick } from "@gtkx/jsx/gtk";
+export { GMenu, GSimpleAction } from "@gtkx/jsx/gio";
+export { GtkAdjustment, GtkDragSource, GtkDropControllerMotion, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "@gtkx/jsx/gtk";
+export * from "./widgets.generated";
+export { createPortal, createRoot, quit, rootElement, useApplication, useBindSetting, useParentWindow, useProperty, useSetting, type Root, type RootElement, } from "@gtkx/react";
+export type { SettingsSchema, SettingsSchemaKeys, SettingValue, } from "@gtkx/react/internal";
+export { useSignal } from "./use-signal";
+export { css, cx, injectGlobal } from "@gtkx/css";
+export { createWidgetCss, type WidgetCss } from "./widget-css";
+export { createTextProbe, measureWidget, toNumber } from "./measure";
+export { computePointIn, computePointInWindow, type Point } from "./geometry";
+export { beginDragLayer, type DragLayerHandle } from "./drag-layer";
+export { createSlotPortal } from "./slot-portal";
+export { cacheChildOrder, getViewBoxComponent, invalidateZOrder, setBoxOnly, setBoxPassthrough, setHitSlop, setPaintOnlyLeaf, setPointerTarget, setZIndex, type HitSlop, } from "./view-box";
+export { getSvgNodeComponent, getSvgNodeDescriptor, queueSvgRedraw, resolveSvgColor, resolveSvgPaint, setSvgNodeDescriptor, type SvgDefsDescriptor, type SvgGradientUnits, type SvgGroupDescriptor, type SvgLinearGradientDescriptor, type SvgNodeDescriptor, type SvgPaintSpec, type SvgRadialGradientDescriptor, type SvgShapeDescriptor, type SvgStopDescriptor, type SvgSvgDescriptor, } from "./svg-node";
+export { allocateChild, attachRnLayout, detachRnLayout, queueAllocate, queueResize, type RnLayoutHooks, type RnLayoutOrientation, } from "./layout-manager";

package/dist/gtkx/bridge/core.js

@@ -0,0 +1,69 @@
+// The core door onto gtkx: everything the RN core (components, APIs,
+// gesture-handler, reanimated, dnd) needs, and NOTHING from @gtkx/gi/adw or
+// @gtkx/jsx/adw — see .claude/epics/adw-optional/001.md. This is what makes
+// `libraries: ["Gtk-4.0"]` alone buildable: an app that never declares
+// "Adw-1" has no "./adw" entry in either package's codegen store at all, so
+// a static import of either specifier fails the whole build regardless of
+// whether it is ever reached at runtime. ./adw.ts is the one place that
+// still reaches for them, behind a probe (adwAvailable()); its absence
+// surfaces as a named throw, not a build failure.
+//
+// Caveats baked into this surface (catalogued in docs/gtkx-rc4-notes.md):
+// - 64-bit FFI values arrive as BigInt → normalize with toNumber() at this boundary
+// import-then-export (not `export * as`): the latter is the one syntax the
+// stock @react-native/babel-preset cannot transform — this form keeps
+// consumer apps on their unmodified RN Babel config.
+import * as Gdk from "@gtkx/gi/gdk";
+import * as Gio from "@gtkx/gi/gio";
+import * as GLib from "@gtkx/gi/glib";
+import * as GObject from "@gtkx/gi/gobject";
+import * as Graphene from "@gtkx/gi/graphene";
+import * as Gsk from "@gtkx/gi/gsk";
+import * as Gtk from "@gtkx/gi/gtk";
+import * as Pango from "@gtkx/gi/pango";
+export { Gdk, Gio, GLib, GObject, Graphene, Gsk, Gtk, Pango };
+// GtkApplication and GtkGestureClick are not Gtk.Widget subclasses (an
+// application object and an event controller, respectively), so the widget
+// surface generator never sees them — kept here by hand, same as before it
+// existed.
+export { GtkApplication, GtkGestureClick } from "@gtkx/jsx/gtk";
+// Auxiliary gtkx JSX elements that are not Gtk.Widget subclasses either,
+// same reason as the pair above — scripts/generate-widget-surface.ts only
+// classifies widgets, so these fall into its "notAWidget" bucket (see
+// scripts/widget-surface/classification.json) and are otherwise
+// unreachable through react-native-gtkx/gtk. Every one of these is a real,
+// necessary building block for a real app: actions and menus (Gio), a text
+// buffer and an adjustment (the model objects GtkTextView/GtkSpinRow etc.
+// bind to), keyboard shortcuts, and the two drag-and-drop controllers.
+// Adwaita's own auxiliary elements (AdwBreakpoint, AdwToggle, the
+// AdwShortcutsDialog leaves) live in ./adw instead.
+export { GMenu, GSimpleAction } from "@gtkx/jsx/gio";
+export { GtkAdjustment, GtkDragSource, GtkDropControllerMotion, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "@gtkx/jsx/gtk";
+// The full GTK widget surface — every GTK class gtkx binds that derives
+// Gtk.Widget, raw. src/gtk/widgets.generated wraps most of them with
+// wrapReactNative; this file is where @gtkx/jsx is still allowed to be
+// imported directly (see the eslint carve-out for src/gtkx/bridge/**), so it
+// pulls the raw widgets from here rather than from @gtkx/jsx itself.
+// Adwaita's raw widgets are the sibling generated file, widgets.generated.adw.ts,
+// exported only from ./adw — see that file's header for why the two cannot
+// share one module.
+export * from "./widgets.generated";
+export { createPortal, createRoot, quit, rootElement, useApplication, useBindSetting, useParentWindow, useProperty, useSetting, } from "@gtkx/react";
+// useSignal comes from ./use-signal, not @gtkx/react — see the workaround note
+// there (rc.3 delivers a stale handler).
+export { useSignal } from "./use-signal";
+export { css, cx, injectGlobal } from "@gtkx/css";
+// The imperative counterpart of `css`: a private provider on one widget,
+// for values that change per frame and must not enter the shared stylesheet.
+export { createWidgetCss } from "./widget-css";
+export { createTextProbe, measureWidget, toNumber } from "./measure";
+export { computePointIn, computePointInWindow } from "./geometry";
+export { beginDragLayer } from "./drag-layer";
+// A portal into a NAMED slot of a remote object (the window's action map,
+// its controllers) rather than into its default child slot — see the file
+// for why gtkx's own createPortal is not enough on its own.
+export { createSlotPortal } from "./slot-portal";
+export { cacheChildOrder, getViewBoxComponent, invalidateZOrder, setBoxOnly, setBoxPassthrough, setHitSlop, setPaintOnlyLeaf, setPointerTarget, setZIndex, } from "./view-box";
+export { getSvgNodeComponent, getSvgNodeDescriptor, queueSvgRedraw, resolveSvgColor, resolveSvgPaint, setSvgNodeDescriptor, } from "./svg-node";
+export { allocateChild, attachRnLayout, detachRnLayout, queueAllocate, queueResize, } from "./layout-manager";
+//# sourceMappingURL=core.js.map

package/dist/gtkx/bridge/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/gtkx/bridge/core.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,4EAA4E;AAC5E,4EAA4E;AAC5E,uEAAuE;AACvE,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AACvE,kDAAkD;AAClD,EAAE;AACF,0EAA0E;AAC1E,oFAAoF;AAEpF,2EAA2E;AAC3E,sEAAsE;AACtE,qDAAqD;AACrD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAEvC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AAE7D,uEAAuE;AACvE,2EAA2E;AAC3E,2EAA2E;AAC3E,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/D,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,gEAAgE;AAChE,2EAA2E;AAC3E,2EAA2E;AAC3E,0EAA0E;AAC1E,uEAAuE;AACvE,kEAAkE;AAClE,oDAAoD;AACpD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EACL,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,eAAe,CAAA;AAEtB,wEAAwE;AACxE,qEAAqE;AACrE,uEAAuE;AACvE,6EAA6E;AAC7E,qEAAqE;AACrE,kFAAkF;AAClF,2EAA2E;AAC3E,oBAAoB;AACpB,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,GAGX,MAAM,aAAa,CAAA;AAcpB,+EAA+E;AAC/E,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEjD,yEAAyE;AACzE,6EAA6E;AAC7E,OAAO,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAA;AAE9D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAc,MAAM,YAAY,CAAA;AAC7E,OAAO,EAAE,cAAc,EAAwB,MAAM,cAAc,CAAA;AACnE,0EAA0E;AAC1E,0EAA0E;AAC1E,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,GAEV,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,GAWrB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,GAGZ,MAAM,kBAAkB,CAAA","sourcesContent":["// The core door onto gtkx: everything the RN core (components, APIs,\n// gesture-handler, reanimated, dnd) needs, and NOTHING from @gtkx/gi/adw or\n// @gtkx/jsx/adw — see .claude/epics/adw-optional/001.md. This is what makes\n// `libraries: [\"Gtk-4.0\"]` alone buildable: an app that never declares\n// \"Adw-1\" has no \"./adw\" entry in either package's codegen store at all, so\n// a static import of either specifier fails the whole build regardless of\n// whether it is ever reached at runtime. ./adw.ts is the one place that\n// still reaches for them, behind a probe (adwAvailable()); its absence\n// surfaces as a named throw, not a build failure.\n//\n// Caveats baked into this surface (catalogued in docs/gtkx-rc4-notes.md):\n// - 64-bit FFI values arrive as BigInt → normalize with toNumber() at this boundary\n\n// import-then-export (not `export * as`): the latter is the one syntax the\n// stock @react-native/babel-preset cannot transform — this form keeps\n// consumer apps on their unmodified RN Babel config.\nimport * as Gdk from \"@gtkx/gi/gdk\"\nimport * as Gio from \"@gtkx/gi/gio\"\nimport * as GLib from \"@gtkx/gi/glib\"\nimport * as GObject from \"@gtkx/gi/gobject\"\nimport * as Graphene from \"@gtkx/gi/graphene\"\nimport * as Gsk from \"@gtkx/gi/gsk\"\nimport * as Gtk from \"@gtkx/gi/gtk\"\nimport * as Pango from \"@gtkx/gi/pango\"\n\nexport { Gdk, Gio, GLib, GObject, Graphene, Gsk, Gtk, Pango }\n\n// GtkApplication and GtkGestureClick are not Gtk.Widget subclasses (an\n// application object and an event controller, respectively), so the widget\n// surface generator never sees them — kept here by hand, same as before it\n// existed.\nexport { GtkApplication, GtkGestureClick } from \"@gtkx/jsx/gtk\"\n\n// Auxiliary gtkx JSX elements that are not Gtk.Widget subclasses either,\n// same reason as the pair above — scripts/generate-widget-surface.ts only\n// classifies widgets, so these fall into its \"notAWidget\" bucket (see\n// scripts/widget-surface/classification.json) and are otherwise\n// unreachable through react-native-gtkx/gtk. Every one of these is a real,\n// necessary building block for a real app: actions and menus (Gio), a text\n// buffer and an adjustment (the model objects GtkTextView/GtkSpinRow etc.\n// bind to), keyboard shortcuts, and the two drag-and-drop controllers.\n// Adwaita's own auxiliary elements (AdwBreakpoint, AdwToggle, the\n// AdwShortcutsDialog leaves) live in ./adw instead.\nexport { GMenu, GSimpleAction } from \"@gtkx/jsx/gio\"\nexport {\n  GtkAdjustment,\n  GtkDragSource,\n  GtkDropControllerMotion,\n  GtkDropTarget,\n  GtkShortcut,\n  GtkShortcutController,\n  GtkTextBuffer,\n} from \"@gtkx/jsx/gtk\"\n\n// The full GTK widget surface — every GTK class gtkx binds that derives\n// Gtk.Widget, raw. src/gtk/widgets.generated wraps most of them with\n// wrapReactNative; this file is where @gtkx/jsx is still allowed to be\n// imported directly (see the eslint carve-out for src/gtkx/bridge/**), so it\n// pulls the raw widgets from here rather than from @gtkx/jsx itself.\n// Adwaita's raw widgets are the sibling generated file, widgets.generated.adw.ts,\n// exported only from ./adw — see that file's header for why the two cannot\n// share one module.\nexport * from \"./widgets.generated\"\n\nexport {\n  createPortal,\n  createRoot,\n  quit,\n  rootElement,\n  useApplication,\n  useBindSetting,\n  useParentWindow,\n  useProperty,\n  useSetting,\n  type Root,\n  type RootElement,\n} from \"@gtkx/react\"\n\n// rc.4 moved the settings-schema types off the public entry point into\n// /internal, with no replacement on `@gtkx/react` — `useSetting`/\n// `useBindSetting` are still public and still typed by them, so a consumer\n// that wants to name the type of a setting has no supported import for it.\n// We re-export them from here, which is the whole point of the bridge; the\n// ask to put them back is filed in docs/upstream-gtkx.md.\nexport type {\n  SettingsSchema,\n  SettingsSchemaKeys,\n  SettingValue,\n} from \"@gtkx/react/internal\"\n\n// useSignal comes from ./use-signal, not @gtkx/react — see the workaround note\n// there (rc.3 delivers a stale handler).\nexport { useSignal } from \"./use-signal\"\n\nexport { css, cx, injectGlobal } from \"@gtkx/css\"\n\n// The imperative counterpart of `css`: a private provider on one widget,\n// for values that change per frame and must not enter the shared stylesheet.\nexport { createWidgetCss, type WidgetCss } from \"./widget-css\"\n\nexport { createTextProbe, measureWidget, toNumber } from \"./measure\"\nexport { computePointIn, computePointInWindow, type Point } from \"./geometry\"\nexport { beginDragLayer, type DragLayerHandle } from \"./drag-layer\"\n// A portal into a NAMED slot of a remote object (the window's action map,\n// its controllers) rather than into its default child slot — see the file\n// for why gtkx's own createPortal is not enough on its own.\nexport { createSlotPortal } from \"./slot-portal\"\nexport {\n  cacheChildOrder,\n  getViewBoxComponent,\n  invalidateZOrder,\n  setBoxOnly,\n  setBoxPassthrough,\n  setHitSlop,\n  setPaintOnlyLeaf,\n  setPointerTarget,\n  setZIndex,\n  type HitSlop,\n} from \"./view-box\"\nexport {\n  getSvgNodeComponent,\n  getSvgNodeDescriptor,\n  queueSvgRedraw,\n  resolveSvgColor,\n  resolveSvgPaint,\n  setSvgNodeDescriptor,\n  type SvgDefsDescriptor,\n  type SvgGradientUnits,\n  type SvgGroupDescriptor,\n  type SvgLinearGradientDescriptor,\n  type SvgNodeDescriptor,\n  type SvgPaintSpec,\n  type SvgRadialGradientDescriptor,\n  type SvgShapeDescriptor,\n  type SvgStopDescriptor,\n  type SvgSvgDescriptor,\n} from \"./svg-node\"\nexport {\n  allocateChild,\n  attachRnLayout,\n  detachRnLayout,\n  queueAllocate,\n  queueResize,\n  type RnLayoutHooks,\n  type RnLayoutOrientation,\n} from \"./layout-manager\"\n"]}

package/dist/gtkx/bridge/drag-layer.d.ts

@@ -0,0 +1,27 @@
+import * as Gtk from "@gtkx/gi/gtk";
+export type DragLayerHandle = {
+    /** Called on every `GtkDropControllerMotion` "motion", already in the
+     *  OVERLAY's own coordinates — no per-call translation, because the
+     *  picture is that overlay's own child. Zero React involvement: a widget
+     *  property write per axis, nothing else. */
+    move: (x: number, y: number) => void;
+    /** The pointer (re)entered this window mid-drag: reveal the ghost and
+     *  place it before the next motion arrives. */
+    show: (x: number, y: number) => void;
+    /** The pointer left this window: nothing further tracks it here, so
+     *  hide rather than leave it stuck at the edge. */
+    hide: () => void;
+    /** The drag ended (dropped or cancelled): remove the ghost and restore
+     *  the original's opacity. */
+    end: () => void;
+};
+/**
+ * Starts the window-level ghost for a drag that just began on `widget`,
+ * grabbed at `(grabX, grabY)` in `widget`'s own coordinates — the same pair
+ * `GtkDragSource.onPrepare` already reports and already feeds `setIcon()`.
+ *
+ * Returns `null` when `widget` has no window yet (nothing to escape) or
+ * shares no transform with it (unrealized) — the same failure mode
+ * `computePointIn` documents for `measure()`.
+ */
+export declare const beginDragLayer: (widget: Gtk.Widget, grabX: number, grabY: number) => DragLayerHandle | null;

package/dist/gtkx/bridge/drag-layer.js

@@ -0,0 +1,177 @@
+// A window-level drag layer: a non-interactive `Gtk.Picture` positioned by
+// pixel margins inside a `Gtk.Overlay` wrapped once around each window's real
+// content, showing a live `Gtk.WidgetPaintable` of whatever is being dragged.
+//
+// Why this exists NEXT TO `GtkDragSource`'s own icon (gtk-controllers.tsx
+// already sets one via `setIcon`): that icon is a compositor-owned surface —
+// real, and already unclipped by this process's own widget tree, but also
+// outside it, so nothing in this process can read its geometry or its
+// pixels. A dragged item escaping an `overflow: hidden` ancestor needs a
+// widget IN OUR OWN TREE to prove that with — geometry a test can measure,
+// pixels a screenshot can read. This is that widget: a second, deliberately
+// redundant representation, added at window level (an `Overlay` child, so no
+// ancestor's clip reaches it) for as long as the drag is over this window,
+// and removed the moment the drag ends. `setIcon`'s own icon is untouched —
+// a drag that leaves this window for another still shows it.
+//
+// REPARENTING THE DRAGGED WIDGET ITSELF was tried first and refused: moving
+// the real node into a different container re-triggers ITS OWN size
+// negotiation under a parent with different constraints (measured: a
+// 100×100 card came out 800×600), and an unmount mid-flight strands the
+// widget outside the tree React still thinks it owns. A `WidgetPaintable`
+// sidesteps both — it is a live VIEW of the widget, not the widget, so the
+// original never moves and never leaves the component tree React manages.
+//
+// Ghosting the original is `Gtk.Widget.setOpacity()`, restored to whatever it
+// was before (not hardcoded to 1), so this composes with an app's own
+// animated or static opacity rather than fighting it. Because
+// `Gtk.WidgetPaintable` renders the widget it observes LIVE, `setIcon`'s own
+// compositor icon and this overlay copy dim along with the original — the
+// three are one underlying render, not three independent ones. Documented in
+// docs/api.md rather than fought: decoupling them would need a frozen
+// texture snapshot taken before the fade, not a live paintable, and a frozen
+// snapshot is not what the spike validated or what this measures.
+import * as Gtk from "@gtkx/gi/gtk";
+import { computePointIn } from "./geometry";
+// Dim, not hidden: RN dnd libraries commonly leave the dragged row at
+// reduced rather than zero opacity (e.g. `react-native-draggable-flatlist`'s
+// `activeOpacity`), and a fully transparent original would take the ghost's
+// own coupled render with it, per the note above.
+const GHOST_OPACITY = 0.35;
+const overlaysByRoot = new WeakMap();
+const asAdwApplicationWindow = (root) => {
+    const candidate = root;
+    return typeof candidate.setContent === "function" &&
+        typeof candidate.getContent === "function"
+        ? candidate
+        : null;
+};
+const setWindowContent = (root, content) => {
+    const adwWindow = asAdwApplicationWindow(root);
+    if (adwWindow) {
+        adwWindow.setContent(content);
+    }
+    else {
+        ;
+        root.setChild(content);
+    }
+};
+/**
+ * Detaches the window's current content and hands it back, rather than
+ * leaving it parented. `Gtk.Overlay.setChild()` asserts its argument is
+ * unparented (or already its own child, or null) — it will not steal a
+ * widget from another parent — so the content has to be unparented BEFORE
+ * the overlay can adopt it, not after.
+ */
+const detachWindowContent = (root) => {
+    const adwWindow = asAdwApplicationWindow(root);
+    const current = adwWindow
+        ? adwWindow.getContent()
+        : root.getChild();
+    if (current) {
+        setWindowContent(root, null);
+    }
+    return current;
+};
+/**
+ * The overlay for `root`, wrapping its real content the first time any drag
+ * asks for it and reused for the window's whole lifetime after that — a
+ * one-time structural change, not a per-drag one, because reparenting a
+ * whole app's content is not something to repeat every time a finger moves.
+ */
+const getOverlayEntry = (root) => {
+    const existing = overlaysByRoot.get(root);
+    if (existing) {
+        return existing;
+    }
+    const current = detachWindowContent(root);
+    const overlay = Gtk.Overlay.new();
+    overlay.setChild(current);
+    setWindowContent(root, overlay);
+    const entry = { overlay, active: null };
+    overlaysByRoot.set(root, entry);
+    // One motion controller per WINDOW rather than per drag or per provider:
+    // GDK stops delivering to the drag source after `drag-begin` (the
+    // compositor owns the pointer from there), and `GtkDropControllerMotion`
+    // is the widget-level replacement `dnd/context.tsx` already relies on, at
+    // provider scope, for the same reason. This is that same technique at
+    // window scope, so the ghost tracks the pointer regardless of which
+    // `DropProvider` — if any — the drag started under.
+    const motion = Gtk.DropControllerMotion.new();
+    motion.connect("motion", (x, y) => {
+        entry.active?.move(x, y);
+    });
+    motion.connect("enter", (x, y) => {
+        entry.active?.show(x, y);
+    });
+    motion.connect("leave", () => {
+        entry.active?.hide();
+    });
+    overlay.addController(motion);
+    return entry;
+};
+/**
+ * Starts the window-level ghost for a drag that just began on `widget`,
+ * grabbed at `(grabX, grabY)` in `widget`'s own coordinates — the same pair
+ * `GtkDragSource.onPrepare` already reports and already feeds `setIcon()`.
+ *
+ * Returns `null` when `widget` has no window yet (nothing to escape) or
+ * shares no transform with it (unrealized) — the same failure mode
+ * `computePointIn` documents for `measure()`.
+ */
+export const beginDragLayer = (widget, grabX, grabY) => {
+    const root = widget.getRoot();
+    if (!root) {
+        return null;
+    }
+    const entry = getOverlayEntry(root);
+    const origin = computePointIn(widget, entry.overlay, 0, 0);
+    const grab = computePointIn(widget, entry.overlay, grabX, grabY);
+    if (!origin || !grab) {
+        return null;
+    }
+    // Constant for the drag's lifetime: how far the pointer sits from the
+    // widget's own top-left, in the overlay's coordinate space. Every later
+    // motion subtracts it back off — the same arithmetic `DropProvider`'s
+    // `onDragging` already does for `tx`/`ty`, one level up.
+    const offsetX = grab.x - origin.x;
+    const offsetY = grab.y - origin.y;
+    const picture = Gtk.Picture.newForPaintable(Gtk.WidgetPaintable.new(widget));
+    picture.setCanTarget(false);
+    picture.setCanFocus(false);
+    picture.setHalign(Gtk.Align.START);
+    picture.setValign(Gtk.Align.START);
+    picture.setMarginStart(Math.round(origin.x));
+    picture.setMarginTop(Math.round(origin.y));
+    entry.overlay.addOverlay(picture);
+    // Neither should ever be true for a floating ghost, but both default open
+    // on a plain overlay child — set explicitly rather than trusted, since
+    // either one being true would let the ghost resize the window it is
+    // supposed to float over (measure) or vanish at its own edge (clip) the
+    // moment it demonstrates the fix this exists for.
+    entry.overlay.setMeasureOverlay(picture, false);
+    entry.overlay.setClipOverlay(picture, false);
+    const previousOpacity = widget.getOpacity();
+    widget.setOpacity(GHOST_OPACITY);
+    const handle = {
+        move: (x, y) => {
+            picture.setMarginStart(Math.round(x - offsetX));
+            picture.setMarginTop(Math.round(y - offsetY));
+        },
+        show: (x, y) => {
+            picture.setVisible(true);
+            handle.move(x, y);
+        },
+        hide: () => picture.setVisible(false),
+        end: () => {
+            entry.overlay.removeOverlay(picture);
+            widget.setOpacity(previousOpacity);
+            if (entry.active === handle) {
+                entry.active = null;
+            }
+        },
+    };
+    entry.active = handle;
+    return handle;
+};
+//# sourceMappingURL=drag-layer.js.map

package/dist/gtkx/bridge/drag-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-layer.js","sourceRoot":"","sources":["../../../src/gtkx/bridge/drag-layer.ts"],"names":[],"mappings":"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","sourcesContent":["// A window-level drag layer: a non-interactive `Gtk.Picture` positioned by\n// pixel margins inside a `Gtk.Overlay` wrapped once around each window's real\n// content, showing a live `Gtk.WidgetPaintable` of whatever is being dragged.\n//\n// Why this exists NEXT TO `GtkDragSource`'s own icon (gtk-controllers.tsx\n// already sets one via `setIcon`): that icon is a compositor-owned surface —\n// real, and already unclipped by this process's own widget tree, but also\n// outside it, so nothing in this process can read its geometry or its\n// pixels. A dragged item escaping an `overflow: hidden` ancestor needs a\n// widget IN OUR OWN TREE to prove that with — geometry a test can measure,\n// pixels a screenshot can read. This is that widget: a second, deliberately\n// redundant representation, added at window level (an `Overlay` child, so no\n// ancestor's clip reaches it) for as long as the drag is over this window,\n// and removed the moment the drag ends. `setIcon`'s own icon is untouched —\n// a drag that leaves this window for another still shows it.\n//\n// REPARENTING THE DRAGGED WIDGET ITSELF was tried first and refused: moving\n// the real node into a different container re-triggers ITS OWN size\n// negotiation under a parent with different constraints (measured: a\n// 100×100 card came out 800×600), and an unmount mid-flight strands the\n// widget outside the tree React still thinks it owns. A `WidgetPaintable`\n// sidesteps both — it is a live VIEW of the widget, not the widget, so the\n// original never moves and never leaves the component tree React manages.\n//\n// Ghosting the original is `Gtk.Widget.setOpacity()`, restored to whatever it\n// was before (not hardcoded to 1), so this composes with an app's own\n// animated or static opacity rather than fighting it. Because\n// `Gtk.WidgetPaintable` renders the widget it observes LIVE, `setIcon`'s own\n// compositor icon and this overlay copy dim along with the original — the\n// three are one underlying render, not three independent ones. Documented in\n// docs/api.md rather than fought: decoupling them would need a frozen\n// texture snapshot taken before the fade, not a live paintable, and a frozen\n// snapshot is not what the spike validated or what this measures.\nimport * as Gtk from \"@gtkx/gi/gtk\"\nimport { computePointIn } from \"./geometry\"\n\n// Dim, not hidden: RN dnd libraries commonly leave the dragged row at\n// reduced rather than zero opacity (e.g. `react-native-draggable-flatlist`'s\n// `activeOpacity`), and a fully transparent original would take the ghost's\n// own coupled render with it, per the note above.\nconst GHOST_OPACITY = 0.35\n\nexport type DragLayerHandle = {\n  /** Called on every `GtkDropControllerMotion` \"motion\", already in the\n   *  OVERLAY's own coordinates — no per-call translation, because the\n   *  picture is that overlay's own child. Zero React involvement: a widget\n   *  property write per axis, nothing else. */\n  move: (x: number, y: number) => void\n  /** The pointer (re)entered this window mid-drag: reveal the ghost and\n   *  place it before the next motion arrives. */\n  show: (x: number, y: number) => void\n  /** The pointer left this window: nothing further tracks it here, so\n   *  hide rather than leave it stuck at the edge. */\n  hide: () => void\n  /** The drag ended (dropped or cancelled): remove the ghost and restore\n   *  the original's opacity. */\n  end: () => void\n}\n\ntype OverlayEntry = {\n  overlay: Gtk.Overlay\n  /** At most one drag is ever in flight per window — GDK serialises drag\n   *  sessions on a seat — so one slot, not a set. */\n  active: DragLayerHandle | null\n}\n\nconst overlaysByRoot = new WeakMap<Gtk.Root, OverlayEntry>()\n\n// `Adw.ApplicationWindow` names its own slot \"content\" and manages Adwaita's\n// toolbar/toast chrome INSIDE the `Gtk.Window` child slot it inherits —\n// writing that slot directly would replace Adwaita's internal structure\n// instead of the app's content. Anything else `AppRegistry.tsx` builds\n// (`Gtk.ApplicationWindow`) is a plain `Gtk.Window`, whose own `child` slot\n// IS the app's content, so `getChild`/`setChild` is right for it.\n//\n// Told apart by DUCK TYPING (does it have setContent/getContent?) rather\n// than `instanceof Adw.ApplicationWindow`: this file backs the RN core's\n// drag-and-drop (react-native-gtkx/dnd), which must build without Adw-1 at\n// all (see .claude/epics/adw-optional/001.md) — `@gtkx/gi/adw` is not\n// something this module can import even just to compare against it. A\n// plain Gtk.Window/GtkApplicationWindow never has these methods, so the\n// check is exactly as precise as the instanceof it replaces.\ntype AdwApplicationWindowLike = {\n  setContent: (content: Gtk.Widget | null) => void\n  getContent: () => Gtk.Widget | null\n}\n\nconst asAdwApplicationWindow = (\n  root: Gtk.Root,\n): AdwApplicationWindowLike | null => {\n  const candidate = root as unknown as Partial<AdwApplicationWindowLike>\n  return typeof candidate.setContent === \"function\" &&\n    typeof candidate.getContent === \"function\"\n    ? (candidate as AdwApplicationWindowLike)\n    : null\n}\n\nconst setWindowContent = (root: Gtk.Root, content: Gtk.Widget | null): void => {\n  const adwWindow = asAdwApplicationWindow(root)\n  if (adwWindow) {\n    adwWindow.setContent(content)\n  } else {\n    ;(root as unknown as Gtk.Window).setChild(content)\n  }\n}\n\n/**\n * Detaches the window's current content and hands it back, rather than\n * leaving it parented. `Gtk.Overlay.setChild()` asserts its argument is\n * unparented (or already its own child, or null) — it will not steal a\n * widget from another parent — so the content has to be unparented BEFORE\n * the overlay can adopt it, not after.\n */\nconst detachWindowContent = (root: Gtk.Root): Gtk.Widget | null => {\n  const adwWindow = asAdwApplicationWindow(root)\n  const current = adwWindow\n    ? adwWindow.getContent()\n    : (root as unknown as Gtk.Window).getChild()\n  if (current) {\n    setWindowContent(root, null)\n  }\n  return current\n}\n\n/**\n * The overlay for `root`, wrapping its real content the first time any drag\n * asks for it and reused for the window's whole lifetime after that — a\n * one-time structural change, not a per-drag one, because reparenting a\n * whole app's content is not something to repeat every time a finger moves.\n */\nconst getOverlayEntry = (root: Gtk.Root): OverlayEntry => {\n  const existing = overlaysByRoot.get(root)\n  if (existing) {\n    return existing\n  }\n\n  const current = detachWindowContent(root)\n  const overlay = Gtk.Overlay.new()\n  overlay.setChild(current)\n  setWindowContent(root, overlay)\n\n  const entry: OverlayEntry = { overlay, active: null }\n  overlaysByRoot.set(root, entry)\n\n  // One motion controller per WINDOW rather than per drag or per provider:\n  // GDK stops delivering to the drag source after `drag-begin` (the\n  // compositor owns the pointer from there), and `GtkDropControllerMotion`\n  // is the widget-level replacement `dnd/context.tsx` already relies on, at\n  // provider scope, for the same reason. This is that same technique at\n  // window scope, so the ghost tracks the pointer regardless of which\n  // `DropProvider` — if any — the drag started under.\n  const motion = Gtk.DropControllerMotion.new()\n  motion.connect(\"motion\", (x: number, y: number) => {\n    entry.active?.move(x, y)\n  })\n  motion.connect(\"enter\", (x: number, y: number) => {\n    entry.active?.show(x, y)\n  })\n  motion.connect(\"leave\", () => {\n    entry.active?.hide()\n  })\n  overlay.addController(motion)\n\n  return entry\n}\n\n/**\n * Starts the window-level ghost for a drag that just began on `widget`,\n * grabbed at `(grabX, grabY)` in `widget`'s own coordinates — the same pair\n * `GtkDragSource.onPrepare` already reports and already feeds `setIcon()`.\n *\n * Returns `null` when `widget` has no window yet (nothing to escape) or\n * shares no transform with it (unrealized) — the same failure mode\n * `computePointIn` documents for `measure()`.\n */\nexport const beginDragLayer = (\n  widget: Gtk.Widget,\n  grabX: number,\n  grabY: number,\n): DragLayerHandle | null => {\n  const root = widget.getRoot()\n  if (!root) {\n    return null\n  }\n  const entry = getOverlayEntry(root)\n\n  const origin = computePointIn(widget, entry.overlay, 0, 0)\n  const grab = computePointIn(widget, entry.overlay, grabX, grabY)\n  if (!origin || !grab) {\n    return null\n  }\n  // Constant for the drag's lifetime: how far the pointer sits from the\n  // widget's own top-left, in the overlay's coordinate space. Every later\n  // motion subtracts it back off — the same arithmetic `DropProvider`'s\n  // `onDragging` already does for `tx`/`ty`, one level up.\n  const offsetX = grab.x - origin.x\n  const offsetY = grab.y - origin.y\n\n  const picture = Gtk.Picture.newForPaintable(Gtk.WidgetPaintable.new(widget))\n  picture.setCanTarget(false)\n  picture.setCanFocus(false)\n  picture.setHalign(Gtk.Align.START)\n  picture.setValign(Gtk.Align.START)\n  picture.setMarginStart(Math.round(origin.x))\n  picture.setMarginTop(Math.round(origin.y))\n\n  entry.overlay.addOverlay(picture)\n  // Neither should ever be true for a floating ghost, but both default open\n  // on a plain overlay child — set explicitly rather than trusted, since\n  // either one being true would let the ghost resize the window it is\n  // supposed to float over (measure) or vanish at its own edge (clip) the\n  // moment it demonstrates the fix this exists for.\n  entry.overlay.setMeasureOverlay(picture, false)\n  entry.overlay.setClipOverlay(picture, false)\n\n  const previousOpacity = widget.getOpacity()\n  widget.setOpacity(GHOST_OPACITY)\n\n  const handle: DragLayerHandle = {\n    move: (x, y) => {\n      picture.setMarginStart(Math.round(x - offsetX))\n      picture.setMarginTop(Math.round(y - offsetY))\n    },\n    show: (x, y) => {\n      picture.setVisible(true)\n      handle.move(x, y)\n    },\n    hide: () => picture.setVisible(false),\n    end: () => {\n      entry.overlay.removeOverlay(picture)\n      widget.setOpacity(previousOpacity)\n      if (entry.active === handle) {\n        entry.active = null\n      }\n    },\n  }\n  entry.active = handle\n  return handle\n}\n"]}

package/dist/gtkx/bridge/index.d.ts

@@ -1,27 +1 @@
-import * as Adw from "@gtkx/gi/adw";
-import * as Gdk from "@gtkx/gi/gdk";
-import * as Gio from "@gtkx/gi/gio";
-import * as GLib from "@gtkx/gi/glib";
-import * as GObject from "@gtkx/gi/gobject";
-import * as Graphene from "@gtkx/gi/graphene";
-import * as Gsk from "@gtkx/gi/gsk";
-import * as Gtk from "@gtkx/gi/gtk";
-import * as Pango from "@gtkx/gi/pango";
-export { Adw, Gdk, Gio, GLib, GObject, Graphene, Gsk, Gtk, Pango };
-export { GtkApplication, GtkGestureClick } from "@gtkx/jsx/gtk";
-export { GMenu, GSimpleAction } from "@gtkx/jsx/gio";
-export { AdwBreakpoint, AdwShortcutsItem, AdwShortcutsSection, AdwToggle, } from "@gtkx/jsx/adw";
-export { GtkAdjustment, GtkDragSource, GtkDropControllerMotion, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "@gtkx/jsx/gtk";
-export * from "./widgets.generated";
-export { createPortal, createRoot, quit, rootElement, useApplication, useBindSetting, useParentWindow, useProperty, useSetting, type Root, type RootElement, } from "@gtkx/react";
-export type { SettingsSchema, SettingsSchemaKeys, SettingValue, } from "@gtkx/react/internal";
-export { useSignal } from "./use-signal";
-export { css, cx, injectGlobal } from "@gtkx/css";
-export { createWidgetCss, type WidgetCss } from "./widget-css";
-export { createTextProbe, measureWidget, toNumber } from "./measure";
-export { computePointIn, computePointInWindow, type Point } from "./geometry";
-export { createSlotPortal } from "./slot-portal";
-export { cacheChildOrder, getViewBoxComponent, invalidateZOrder, setBoxOnly, setBoxPassthrough, setHitSlop, setPaintOnlyLeaf, setPointerTarget, setZIndex, type HitSlop, } from "./view-box";
-export { getSvgNodeComponent, getSvgNodeDescriptor, queueSvgRedraw, resolveSvgColor, resolveSvgPaint, setSvgNodeDescriptor, type SvgDefsDescriptor, type SvgGradientUnits, type SvgGroupDescriptor, type SvgLinearGradientDescriptor, type SvgNodeDescriptor, type SvgPaintSpec, type SvgRadialGradientDescriptor, type SvgShapeDescriptor, type SvgStopDescriptor, type SvgSvgDescriptor, } from "./svg-node";
-export { allocateChild, attachRnLayout, detachRnLayout, queueAllocate, queueResize, type RnLayoutHooks, type RnLayoutOrientation, } from "./layout-manager";
-export { colorScheme, styleManager } from "./theme";
+export * from "./core";