react-native-gtkx 0.1.0-alpha.4 → 0.2.0-alpha.1

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

@@ -2,17 +2,22 @@ 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, Graphene, Gsk, Gtk, Pango };
-export { AdwApplicationWindow, AdwHeaderBar, AdwNavigationPage, AdwNavigationSplitView, AdwNavigationView, AdwToolbarView, } from "@gtkx/jsx/adw";
-export { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkEntry, GtkGestureClick, GtkLabel, GtkListBox, GtkListBoxRow, GtkPicture, GtkScrolledWindow, GtkSpinner, GtkSwitch, GtkTextView, GtkWindow, } from "@gtkx/jsx/gtk";
-export { createPortal, createRoot, quit, useApplication, useParentWindow, useProperty, type Root, } from "@gtkx/react";
+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, 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, type SettingsSchema, type SettingsSchemaKeys, type SettingValue, } from "@gtkx/react";
 export { useSignal } from "./use-signal";
 export { css, cx, injectGlobal } from "@gtkx/css";
 export { createTextProbe, measureWidget, toNumber } from "./measure";
 export { getViewBoxComponent, setBoxPassthrough } 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";

package/dist/gtkx/bridge/index.js

@@ -10,20 +10,56 @@ 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, Graphene, Gsk, Gtk, Pango };
-export { AdwApplicationWindow, AdwHeaderBar, AdwNavigationPage, AdwNavigationSplitView, AdwNavigationView, AdwToolbarView, } from "@gtkx/jsx/adw";
-export { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkEntry, GtkGestureClick, GtkLabel, GtkListBox, GtkListBoxRow, GtkPicture, GtkScrolledWindow, GtkSpinner, GtkSwitch, GtkTextView, GtkWindow, } from "@gtkx/jsx/gtk";
-export { createPortal, createRoot, quit, useApplication, useParentWindow, useProperty, } from "@gtkx/react";
+export { Adw, 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/Adw.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 or /adw. Every one of these is a
+// real, necessary building block for a real app: actions and menus (Gio),
+// a responsive breakpoint (Adw), a text buffer and an adjustment (the model
+// objects GtkTextView/GtkSpinRow etc. bind to), keyboard shortcuts, and the
+// two drag-and-drop controllers.
+//
+// Adw.Breakpoint specifically: independently verified
+// (`Adw.Breakpoint.prototype instanceof Gtk.Widget === false`, prototype
+// chain bottoms out at plain GObject.Object) — it draws nothing and has no
+// size, it is a declaration (a condition plus a set of property setters)
+// attached to a Window/ApplicationWindow/Dialog/BreakpointBin. Running it
+// through wrapReactNative would give it a Yoga node for a widget that
+// occupies no space: a layout bug, not a convenience. Adw.BreakpointBin (a
+// real widget, the container that scopes breakpoints to a subtree) is
+// wrapped normally in ./widgets.generated instead, and is what
+// createSidebarNavigator's own collapse pairs AdwBreakpoint with (see
+// docs/platform-layer.md, "Two ways to react to size").
+export { GMenu, GSimpleAction } from "@gtkx/jsx/gio";
+export { AdwBreakpoint, AdwShortcutsItem, AdwShortcutsSection, AdwToggle, } from "@gtkx/jsx/adw";
+export { GtkAdjustment, GtkDragSource, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "@gtkx/jsx/gtk";
+// The full widget surface — every GTK/Adwaita class gtkx binds that derives
+// Gtk.Widget, raw. src/gtk/widgets.generated and src/adw/widgets.generated
+// wrap 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 they pull the raw widgets from here rather than
+// from @gtkx/jsx themselves.
+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.2 delivers a stale handler).
 export { useSignal } from "./use-signal";
 export { css, cx, injectGlobal } from "@gtkx/css";
 export { createTextProbe, measureWidget, toNumber } from "./measure";
 export { getViewBoxComponent, setBoxPassthrough } from "./view-box";
+export { getSvgNodeComponent, getSvgNodeDescriptor, queueSvgRedraw, resolveSvgColor, resolveSvgPaint, setSvgNodeDescriptor, } from "./svg-node";
 export { allocateChild, attachRnLayout, detachRnLayout, queueAllocate, queueResize, } from "./layout-manager";
 export { colorScheme, styleManager } from "./theme";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gtkx/bridge/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,gFAAgF;AAChF,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,GAAG,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AACrC,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,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AAEzD,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,MAAM,EACN,SAAS,EACT,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,UAAU,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,GACV,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,cAAc,EACd,eAAe,EACf,WAAW,GAEZ,MAAM,aAAa,CAAA;AAEpB,+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,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,GAGZ,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA","sourcesContent":["// The ONLY module allowed to import @gtkx/* (enforced by eslint no-restricted-imports).\n// gtkx is an RC dependency: when its API moves, this bridge absorbs the change.\n//\n// Caveats baked into this surface (catalogued in docs/gtkx-rc2-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 Adw from \"@gtkx/gi/adw\"\nimport * as Gdk from \"@gtkx/gi/gdk\"\nimport * as Gio from \"@gtkx/gi/gio\"\nimport * as GLib from \"@gtkx/gi/glib\"\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 { Adw, Gdk, Gio, GLib, Graphene, Gsk, Gtk, Pango }\n\nexport {\n  AdwApplicationWindow,\n  AdwHeaderBar,\n  AdwNavigationPage,\n  AdwNavigationSplitView,\n  AdwNavigationView,\n  AdwToolbarView,\n} from \"@gtkx/jsx/adw\"\n\nexport {\n  GtkApplication,\n  GtkApplicationWindow,\n  GtkBox,\n  GtkButton,\n  GtkEntry,\n  GtkGestureClick,\n  GtkLabel,\n  GtkListBox,\n  GtkListBoxRow,\n  GtkPicture,\n  GtkScrolledWindow,\n  GtkSpinner,\n  GtkSwitch,\n  GtkTextView,\n  GtkWindow,\n} from \"@gtkx/jsx/gtk\"\n\nexport {\n  createPortal,\n  createRoot,\n  quit,\n  useApplication,\n  useParentWindow,\n  useProperty,\n  type Root,\n} from \"@gtkx/react\"\n\n// useSignal comes from ./use-signal, not @gtkx/react — see the workaround note\n// there (rc.2 delivers a stale handler).\nexport { useSignal } from \"./use-signal\"\n\nexport { css, cx, injectGlobal } from \"@gtkx/css\"\n\nexport { createTextProbe, measureWidget, toNumber } from \"./measure\"\nexport { getViewBoxComponent, setBoxPassthrough } from \"./view-box\"\nexport {\n  allocateChild,\n  attachRnLayout,\n  detachRnLayout,\n  queueAllocate,\n  queueResize,\n  type RnLayoutHooks,\n  type RnLayoutOrientation,\n} from \"./layout-manager\"\nexport { colorScheme, styleManager } from \"./theme\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gtkx/bridge/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,gFAAgF;AAChF,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,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,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AAElE,uEAAuE;AACvE,2EAA2E;AAC3E,2EAA2E;AAC3E,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/D,4EAA4E;AAC5E,6EAA6E;AAC7E,sEAAsE;AACtE,qEAAqE;AACrE,6EAA6E;AAC7E,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,iCAAiC;AACjC,EAAE;AACF,sDAAsD;AACtD,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,2EAA2E;AAC3E,sEAAsE;AACtE,+DAA+D;AAC/D,sEAAsE;AACtE,wDAAwD;AACxD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,GACV,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,eAAe,CAAA;AAEtB,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,sEAAsE;AACtE,0EAA0E;AAC1E,6BAA6B;AAC7B,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,GAMX,MAAM,aAAa,CAAA;AAEpB,+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,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnE,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;AACzB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA","sourcesContent":["// The ONLY module allowed to import @gtkx/* (enforced by eslint no-restricted-imports).\n// gtkx is an RC dependency: when its API moves, this bridge absorbs the change.\n//\n// Caveats baked into this surface (catalogued in docs/gtkx-rc2-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 Adw from \"@gtkx/gi/adw\"\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 { Adw, 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/Adw.Widget subclasses\n// either, same reason as the pair above — scripts/generate-widget-surface.ts\n// only classifies widgets, so these fall into its \"notAWidget\" bucket\n// (see scripts/widget-surface/classification.json) and are otherwise\n// unreachable through react-native-gtkx/gtk or /adw. Every one of these is a\n// real, necessary building block for a real app: actions and menus (Gio),\n// a responsive breakpoint (Adw), a text buffer and an adjustment (the model\n// objects GtkTextView/GtkSpinRow etc. bind to), keyboard shortcuts, and the\n// two drag-and-drop controllers.\n//\n// Adw.Breakpoint specifically: independently verified\n// (`Adw.Breakpoint.prototype instanceof Gtk.Widget === false`, prototype\n// chain bottoms out at plain GObject.Object) — it draws nothing and has no\n// size, it is a declaration (a condition plus a set of property setters)\n// attached to a Window/ApplicationWindow/Dialog/BreakpointBin. Running it\n// through wrapReactNative would give it a Yoga node for a widget that\n// occupies no space: a layout bug, not a convenience. Adw.BreakpointBin (a\n// real widget, the container that scopes breakpoints to a subtree) is\n// wrapped normally in ./widgets.generated instead, and is what\n// createSidebarNavigator's own collapse pairs AdwBreakpoint with (see\n// docs/platform-layer.md, \"Two ways to react to size\").\nexport { GMenu, GSimpleAction } from \"@gtkx/jsx/gio\"\nexport {\n  AdwBreakpoint,\n  AdwShortcutsItem,\n  AdwShortcutsSection,\n  AdwToggle,\n} from \"@gtkx/jsx/adw\"\nexport {\n  GtkAdjustment,\n  GtkDragSource,\n  GtkDropTarget,\n  GtkShortcut,\n  GtkShortcutController,\n  GtkTextBuffer,\n} from \"@gtkx/jsx/gtk\"\n\n// The full widget surface — every GTK/Adwaita class gtkx binds that derives\n// Gtk.Widget, raw. src/gtk/widgets.generated and src/adw/widgets.generated\n// wrap most of them with wrapReactNative; this file is where @gtkx/jsx is\n// still allowed to be imported directly (see the eslint carve-out for\n// src/gtkx/bridge/**), so they pull the raw widgets from here rather than\n// from @gtkx/jsx themselves.\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  type SettingsSchema,\n  type SettingsSchemaKeys,\n  type SettingValue,\n} from \"@gtkx/react\"\n\n// useSignal comes from ./use-signal, not @gtkx/react — see the workaround note\n// there (rc.2 delivers a stale handler).\nexport { useSignal } from \"./use-signal\"\n\nexport { css, cx, injectGlobal } from \"@gtkx/css\"\n\nexport { createTextProbe, measureWidget, toNumber } from \"./measure\"\nexport { getViewBoxComponent, setBoxPassthrough } 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\"\nexport { colorScheme, styleManager } from \"./theme\"\n"]}

package/dist/gtkx/bridge/layout-manager.d.ts

@@ -1,4 +1,5 @@
 import * as Gtk from "@gtkx/gi/gtk";
+import type { Transform2D } from "../../contracts";
 export type RnLayoutOrientation = "horizontal" | "vertical";
 export type RnLayoutHooks = {
     measure(orientation: RnLayoutOrientation, forSize: number): number;
@@ -6,6 +7,6 @@ export type RnLayoutHooks = {
 };
 export declare const attachRnLayout: (widget: Gtk.Widget, hooks: RnLayoutHooks) => void;
 export declare const detachRnLayout: (widget: Gtk.Widget) => void;
-export declare const allocateChild: (child: Gtk.Widget, x: number, y: number, width: number, height: number) => void;
+export declare const allocateChild: (child: Gtk.Widget, x: number, y: number, width: number, height: number, matrix?: Transform2D | null) => void;
 export declare const queueAllocate: (widget: Gtk.Widget) => void;
 export declare const queueResize: (widget: Gtk.Widget) => void;

package/dist/gtkx/bridge/layout-manager.js

@@ -7,6 +7,7 @@
 // minimum ratchet, overflow children inflating ancestors, and widget minimums
 // pushing rects.
 import * as Gdk from "@gtkx/gi/gdk";
+import * as Gsk from "@gtkx/gi/gsk";
 import * as Gtk from "@gtkx/gi/gtk";
 import { registerClass } from "@gtkx/runtime";
 // The class must exist before any instance is created, but registration needs
@@ -66,15 +67,36 @@ export const detachRnLayout = (widget) => {
     hooksByManager.delete(manager);
     widget.setLayoutManager(null);
 };
-// Places one child at an exact rect. Only meaningful from inside an allocate()
-// hook — GTK forbids size-allocating outside the layout phase.
-export const allocateChild = (child, x, y, width, height) => {
-    child.sizeAllocate(new Gdk.Rectangle({
-        x: Math.round(x),
-        y: Math.round(y),
-        width: Math.max(0, Math.round(width)),
-        height: Math.max(0, Math.round(height)),
-    }), -1);
+// Places one child at an exact rect, optionally under a visual transform.
+// Only meaningful from inside an allocate() hook — GTK forbids
+// size-allocating outside the layout phase.
+//
+// The transform path is gtk_widget_allocate(), which is what
+// gtk_widget_size_allocate() itself calls with a plain translate — the child
+// keeps the width/height Yoga gave it and only its placement matrix changes,
+// which is exactly RN's "transforms are visual only". GTK4 inverts that
+// matrix in gtk_widget_pick(), so input follows the rotated/scaled shape for
+// free (measured: docs/research/transforms.md).
+export const allocateChild = (child, x, y, width, height, matrix = null) => {
+    const left = Math.round(x);
+    const top = Math.round(y);
+    const w = Math.max(0, Math.round(width));
+    const h = Math.max(0, Math.round(height));
+    if (!matrix) {
+        child.sizeAllocate(new Gdk.Rectangle({ x: left, y: top, width: w, height: h }), -1);
+        return;
+    }
+    // RN's transform origin is the centre of the view, so the matrix GTK gets
+    // is T(left + cx, top + cy) · matrix · T(-cx, -cy) — folded into the six
+    // components here rather than chained through GskTransform, which would
+    // cost five FFI hops instead of one.
+    const cx = w / 2;
+    const cy = h / 2;
+    const transform = Gsk.Transform.new().matrix2d(matrix.xx, matrix.yx, matrix.xy, matrix.yy, left + cx - (matrix.xx * cx + matrix.xy * cy) + matrix.dx, top + cy - (matrix.yx * cx + matrix.yy * cy) + matrix.dy);
+    // gtk_widget_allocate consumes the transform (transfer full) and gtkx
+    // hands ownership over with it — never unref it here (that aborts on
+    // GLib's rc-box magic assertion).
+    child.allocate(w, h, -1, transform);
 };
 // Engine flush → new rects for the same container size: schedule allocation
 // only. A measure-affecting change must use queueResize instead.

package/dist/gtkx/bridge/layout-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-manager.js","sourceRoot":"","sources":["../../../src/gtkx/bridge/layout-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// RnGtkxLayout — a GObject subclass of GtkLayoutManager registered entirely\n// from JS (docs/research/layout-manager.md, \"B0\"). The manager obeys ONLY the\n// layout engine: measure() reports the engine-provided size (minimum ==\n// natural, children are never queried) and allocate() delegates to the engine,\n// which places every child at exactly its computed rect via allocateChild().\n// This is what removes the GTK-vs-RN layout conflicts at the root: window\n// minimum ratchet, overflow children inflating ancestors, and widget minimums\n// pushing rects.\nimport * as Gdk from \"@gtkx/gi/gdk\"\nimport * as Gtk from \"@gtkx/gi/gtk\"\nimport { registerClass } from \"@gtkx/runtime\"\n\nexport type RnLayoutOrientation = \"horizontal\" | \"vertical\"\n\nexport type RnLayoutHooks = {\n  // Engine-provided size for the given axis; minimum == natural == this value.\n  measure(orientation: RnLayoutOrientation, forSize: number): number\n  // Called during GTK's allocation phase with the container's final size.\n  // The engine must size-allocate every child (allocateChild) synchronously.\n  allocate(width: number, height: number): void\n}\n\n// The class must exist before any instance is created, but registration needs\n// GObject to be initialized — both hold after the bridge is imported, so the\n// class is registered lazily on first attach (also keeps the module safe to\n// import in environments without a display).\nlet RnGtkxLayoutClass: (new () => Gtk.LayoutManager) | null = null\n\nconst hooksByManager = new WeakMap<Gtk.LayoutManager, RnLayoutHooks>()\n\nconst ensureRegistered = (): new () => Gtk.LayoutManager => {\n  if (RnGtkxLayoutClass) {\n    return RnGtkxLayoutClass\n  }\n\n  class RnGtkxLayout extends Gtk.LayoutManager {\n    override measure(\n      _widget: Gtk.Widget,\n      orientation: Gtk.Orientation,\n      forSize: number,\n    ): [number, number, number, number] {\n      const hooks = hooksByManager.get(this)\n      if (!hooks) {\n        return [0, 0, -1, -1]\n      }\n      const size = hooks.measure(\n        orientation === Gtk.Orientation.HORIZONTAL ? \"horizontal\" : \"vertical\",\n        forSize,\n      )\n      return [size, size, -1, -1]\n    }\n\n    // Trailing vfunc params (baseline; widget) are dropped — JS tolerates the\n    // arity mismatch and the linter rejects unused trailing args.\n    override allocate(\n      _widget: Gtk.Widget,\n      width: number,\n      height: number,\n    ): void {\n      hooksByManager.get(this)?.allocate(width, height)\n    }\n\n    override getRequestMode(): Gtk.SizeRequestMode {\n      return Gtk.SizeRequestMode.CONSTANT_SIZE\n    }\n  }\n\n  // Explicit typeName: bundlers minify class names and registerClass derives\n  // the GType name from klass.name by default (FINDINGS §1).\n  registerClass(RnGtkxLayout, { typeName: \"RnGtkxLayout\" })\n  RnGtkxLayoutClass = RnGtkxLayout\n  return RnGtkxLayout\n}\n\n// Replaces the widget's layout manager with an RnGtkxLayout driven by `hooks`.\n// The container must attach its children in a layout-child-free way (GtkBox\n// append / set_parent) — GtkFixed.put demands a GtkFixedLayoutChild from the\n// current manager and is incompatible (FINDINGS §2).\nexport const attachRnLayout = (\n  widget: Gtk.Widget,\n  hooks: RnLayoutHooks,\n): void => {\n  const Klass = ensureRegistered()\n  if (hooksByManager.has(widget.getLayoutManager() as Gtk.LayoutManager)) {\n    throw new Error(\"attachRnLayout: widget already has an RnGtkxLayout\")\n  }\n  const manager = new Klass()\n  hooksByManager.set(manager, hooks)\n  widget.setLayoutManager(manager)\n}\n\n// Drops the hooks and hands layout back to a fresh manager of the widget's\n// own class default. Safe to call on widgets that were never attached.\nexport const detachRnLayout = (widget: Gtk.Widget): void => {\n  const manager = widget.getLayoutManager() as Gtk.LayoutManager | null\n  if (!manager || !hooksByManager.has(manager)) {\n    return\n  }\n  hooksByManager.delete(manager)\n  widget.setLayoutManager(null as unknown as Gtk.LayoutManager)\n}\n\n// Places one child at an exact rect. Only meaningful from inside an allocate()\n// hook — GTK forbids size-allocating outside the layout phase.\nexport const allocateChild = (\n  child: Gtk.Widget,\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n): void => {\n  child.sizeAllocate(\n    new Gdk.Rectangle({\n      x: Math.round(x),\n      y: Math.round(y),\n      width: Math.max(0, Math.round(width)),\n      height: Math.max(0, Math.round(height)),\n    }),\n    -1,\n  )\n}\n\n// Engine flush → new rects for the same container size: schedule allocation\n// only. A measure-affecting change must use queueResize instead.\nexport const queueAllocate = (widget: Gtk.Widget): void => {\n  widget.queueAllocate()\n}\n\nexport const queueResize = (widget: Gtk.Widget): void => {\n  widget.queueResize()\n}\n"]}
+{"version":3,"file":"layout-manager.js","sourceRoot":"","sources":["../../../src/gtkx/bridge/layout-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// RnGtkxLayout — a GObject subclass of GtkLayoutManager registered entirely\n// from JS (docs/research/layout-manager.md, \"B0\"). The manager obeys ONLY the\n// layout engine: measure() reports the engine-provided size (minimum ==\n// natural, children are never queried) and allocate() delegates to the engine,\n// which places every child at exactly its computed rect via allocateChild().\n// This is what removes the GTK-vs-RN layout conflicts at the root: window\n// minimum ratchet, overflow children inflating ancestors, and widget minimums\n// pushing rects.\nimport * as Gdk from \"@gtkx/gi/gdk\"\nimport * as Gsk from \"@gtkx/gi/gsk\"\nimport * as Gtk from \"@gtkx/gi/gtk\"\nimport { registerClass } from \"@gtkx/runtime\"\nimport type { Transform2D } from \"../../contracts\"\n\nexport type RnLayoutOrientation = \"horizontal\" | \"vertical\"\n\nexport type RnLayoutHooks = {\n  // Engine-provided size for the given axis; minimum == natural == this value.\n  measure(orientation: RnLayoutOrientation, forSize: number): number\n  // Called during GTK's allocation phase with the container's final size.\n  // The engine must size-allocate every child (allocateChild) synchronously.\n  allocate(width: number, height: number): void\n}\n\n// The class must exist before any instance is created, but registration needs\n// GObject to be initialized — both hold after the bridge is imported, so the\n// class is registered lazily on first attach (also keeps the module safe to\n// import in environments without a display).\nlet RnGtkxLayoutClass: (new () => Gtk.LayoutManager) | null = null\n\nconst hooksByManager = new WeakMap<Gtk.LayoutManager, RnLayoutHooks>()\n\nconst ensureRegistered = (): new () => Gtk.LayoutManager => {\n  if (RnGtkxLayoutClass) {\n    return RnGtkxLayoutClass\n  }\n\n  class RnGtkxLayout extends Gtk.LayoutManager {\n    override measure(\n      _widget: Gtk.Widget,\n      orientation: Gtk.Orientation,\n      forSize: number,\n    ): [number, number, number, number] {\n      const hooks = hooksByManager.get(this)\n      if (!hooks) {\n        return [0, 0, -1, -1]\n      }\n      const size = hooks.measure(\n        orientation === Gtk.Orientation.HORIZONTAL ? \"horizontal\" : \"vertical\",\n        forSize,\n      )\n      return [size, size, -1, -1]\n    }\n\n    // Trailing vfunc params (baseline; widget) are dropped — JS tolerates the\n    // arity mismatch and the linter rejects unused trailing args.\n    override allocate(\n      _widget: Gtk.Widget,\n      width: number,\n      height: number,\n    ): void {\n      hooksByManager.get(this)?.allocate(width, height)\n    }\n\n    override getRequestMode(): Gtk.SizeRequestMode {\n      return Gtk.SizeRequestMode.CONSTANT_SIZE\n    }\n  }\n\n  // Explicit typeName: bundlers minify class names and registerClass derives\n  // the GType name from klass.name by default (FINDINGS §1).\n  registerClass(RnGtkxLayout, { typeName: \"RnGtkxLayout\" })\n  RnGtkxLayoutClass = RnGtkxLayout\n  return RnGtkxLayout\n}\n\n// Replaces the widget's layout manager with an RnGtkxLayout driven by `hooks`.\n// The container must attach its children in a layout-child-free way (GtkBox\n// append / set_parent) — GtkFixed.put demands a GtkFixedLayoutChild from the\n// current manager and is incompatible (FINDINGS §2).\nexport const attachRnLayout = (\n  widget: Gtk.Widget,\n  hooks: RnLayoutHooks,\n): void => {\n  const Klass = ensureRegistered()\n  if (hooksByManager.has(widget.getLayoutManager() as Gtk.LayoutManager)) {\n    throw new Error(\"attachRnLayout: widget already has an RnGtkxLayout\")\n  }\n  const manager = new Klass()\n  hooksByManager.set(manager, hooks)\n  widget.setLayoutManager(manager)\n}\n\n// Drops the hooks and hands layout back to a fresh manager of the widget's\n// own class default. Safe to call on widgets that were never attached.\nexport const detachRnLayout = (widget: Gtk.Widget): void => {\n  const manager = widget.getLayoutManager() as Gtk.LayoutManager | null\n  if (!manager || !hooksByManager.has(manager)) {\n    return\n  }\n  hooksByManager.delete(manager)\n  widget.setLayoutManager(null as unknown as Gtk.LayoutManager)\n}\n\n// Places one child at an exact rect, optionally under a visual transform.\n// Only meaningful from inside an allocate() hook — GTK forbids\n// size-allocating outside the layout phase.\n//\n// The transform path is gtk_widget_allocate(), which is what\n// gtk_widget_size_allocate() itself calls with a plain translate — the child\n// keeps the width/height Yoga gave it and only its placement matrix changes,\n// which is exactly RN's \"transforms are visual only\". GTK4 inverts that\n// matrix in gtk_widget_pick(), so input follows the rotated/scaled shape for\n// free (measured: docs/research/transforms.md).\nexport const allocateChild = (\n  child: Gtk.Widget,\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n  matrix: Transform2D | null = null,\n): void => {\n  const left = Math.round(x)\n  const top = Math.round(y)\n  const w = Math.max(0, Math.round(width))\n  const h = Math.max(0, Math.round(height))\n\n  if (!matrix) {\n    child.sizeAllocate(\n      new Gdk.Rectangle({ x: left, y: top, width: w, height: h }),\n      -1,\n    )\n    return\n  }\n\n  // RN's transform origin is the centre of the view, so the matrix GTK gets\n  // is T(left + cx, top + cy) · matrix · T(-cx, -cy) — folded into the six\n  // components here rather than chained through GskTransform, which would\n  // cost five FFI hops instead of one.\n  const cx = w / 2\n  const cy = h / 2\n  const transform = Gsk.Transform.new().matrix2d(\n    matrix.xx,\n    matrix.yx,\n    matrix.xy,\n    matrix.yy,\n    left + cx - (matrix.xx * cx + matrix.xy * cy) + matrix.dx,\n    top + cy - (matrix.yx * cx + matrix.yy * cy) + matrix.dy,\n  )\n  // gtk_widget_allocate consumes the transform (transfer full) and gtkx\n  // hands ownership over with it — never unref it here (that aborts on\n  // GLib's rc-box magic assertion).\n  child.allocate(w, h, -1, transform)\n}\n\n// Engine flush → new rects for the same container size: schedule allocation\n// only. A measure-affecting change must use queueResize instead.\nexport const queueAllocate = (widget: Gtk.Widget): void => {\n  widget.queueAllocate()\n}\n\nexport const queueResize = (widget: Gtk.Widget): void => {\n  widget.queueResize()\n}\n"]}

package/dist/gtkx/bridge/svg-node.d.ts

@@ -0,0 +1,79 @@
+import * as Gdk from "@gtkx/gi/gdk";
+import * as Gsk from "@gtkx/gi/gsk";
+import * as Gtk from "@gtkx/gi/gtk";
+import { createElementComponent } from "@gtkx/react/internal";
+import type { SvgTransformOp } from "../../svg/transform";
+import { type PreserveAspectRatio, type ViewBox } from "../../svg/view-box";
+export type SvgPaintSpec = {
+    kind: "color";
+    rgba: Gdk.RGBA;
+} | {
+    kind: "ref";
+    id: string;
+};
+export type SvgGradientUnits = "objectBoundingBox" | "userSpaceOnUse";
+export type SvgSvgDescriptor = {
+    kind: "svg";
+    viewBox: ViewBox | null;
+    preserveAspectRatio: PreserveAspectRatio;
+};
+export type SvgGroupDescriptor = {
+    kind: "g";
+    transformOps: SvgTransformOp[];
+    opacity: number;
+};
+export type SvgShapeDescriptor = {
+    kind: "shape";
+    path: Gsk.Path | null;
+    fill: SvgPaintSpec | null;
+    fillOpacity: number;
+    fillRule: Gsk.FillRule;
+    stroke: SvgPaintSpec | null;
+    strokeOpacity: number;
+    strokeWidth: number;
+    strokeLinecap: Gsk.LineCap;
+    strokeLinejoin: Gsk.LineJoin;
+    strokeMiterlimit: number;
+    strokeDasharray: number[] | null;
+    strokeDashoffset: number;
+    opacity: number;
+};
+export type SvgDefsDescriptor = {
+    kind: "defs";
+};
+export type SvgLinearGradientDescriptor = {
+    kind: "gradient";
+    type: "linear";
+    id: string;
+    units: SvgGradientUnits;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+};
+export type SvgRadialGradientDescriptor = {
+    kind: "gradient";
+    type: "radial";
+    id: string;
+    units: SvgGradientUnits;
+    cx: number;
+    cy: number;
+    r: number;
+};
+export type SvgStopDescriptor = {
+    kind: "stop";
+    offset: number;
+    color: Gdk.RGBA;
+};
+export type SvgNodeDescriptor = SvgSvgDescriptor | SvgGroupDescriptor | SvgShapeDescriptor | SvgDefsDescriptor | SvgLinearGradientDescriptor | SvgRadialGradientDescriptor | SvgStopDescriptor;
+export declare const setSvgNodeDescriptor: (widget: Gtk.Widget, descriptor: SvgNodeDescriptor) => void;
+export declare const getSvgNodeDescriptor: (widget: Gtk.Widget) => SvgNodeDescriptor | undefined;
+export declare const resolveSvgColor: (spec: string | undefined) => Gdk.RGBA | null;
+export declare const resolveSvgPaint: (spec: string | undefined) => SvgPaintSpec | null;
+type SvgNodeComponent = ReturnType<typeof createElementComponent>;
+export declare const getSvgNodeComponent: () => SvgNodeComponent;
+/** Imperative invalidation channel for SVG: paint-only changes (including
+ * Animated-driven ones) call this instead of queueAllocate/queueResize —
+ * nothing here ever touches Yoga. */
+export declare const queueSvgRedraw: (rootWidget: Gtk.Widget) => void;
+export {};