react-native-gtkx 0.2.0-alpha.1 → 0.2.0-alpha.2

package/dist/components/use-layout-child.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-layout-child.js","sourceRoot":"","sources":["../../src/components/use-layout-child.ts"],"names":[],"mappings":"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","sourcesContent":["import { useLayoutEffect, useRef, useState, type RefObject } from \"react\"\nimport type { LayoutNode } from \"../layout/index\"\nimport { splitStyle, StyleSheet } from \"../style/index\"\nimport { defaultCssRegistry } from \"../style/registry.gtkx\"\nimport type {\n  LayoutStyle,\n  MeasureFn,\n  Rect,\n  StyleProp,\n  TransformPart,\n  VisualStyle,\n} from \"../contracts\"\nimport {\n  allocateChild,\n  attachRnLayout,\n  detachRnLayout,\n  measureWidget,\n  queueAllocate,\n  queueResize,\n  type Gtk,\n} from \"../gtkx/bridge/index\"\nimport {\n  perfAddTime,\n  perfBurst,\n  perfCount,\n  perfEnabled,\n  perfNow,\n} from \"../perf\"\nimport { useHostNode, type HostNode } from \"./host-node\"\nimport {\n  deferDuringAllocate,\n  getStoredOffset,\n  getStoredRect,\n  setStoredRect,\n  setStoredTransform,\n} from \"./rect-store\"\n\nexport type LayoutEvent = {\n  nativeEvent: {\n    layout: { x: number; y: number; width: number; height: number }\n  }\n}\n\n// Perf: sizeAllocate recurses synchronously into child containers, so a\n// naive per-pass timer double-counts nested passes. Track depth and time\n// only the outermost (top-level) allocate — that is the real wall time GTK\n// spends in OUR layout code for the frame.\nlet perfAllocDepth = 0\n\nexport type LayoutChildOptions = {\n  style: StyleProp | undefined\n  onLayout: ((event: LayoutEvent) => void) | undefined\n  measure?: MeasureFn\n  // Leaves with intrinsic GTK sizes (Entry, Switch, Spinner) measure their\n  // own widget so Yoga reserves exactly what the theme will draw.\n  measureFromWidget?: boolean\n  extraLayout?: LayoutStyle\n}\n\nexport type LayoutChild = {\n  host: HostNode\n  node: LayoutNode\n  flat: ReturnType<typeof StyleSheet.flatten>\n  visual: VisualStyle\n  cssClass: string | null\n}\n\n// Shared plumbing for every leaf/container component: owns one LayoutNode,\n// keeps it in the parent's shadow tree for the component lifetime, applies\n// the layout half of the style and commits Yoga rects into the rect store,\n// where the parent container's RnGtkxLayout allocate() picks them up.\nexport const useLayoutChild = (\n  widgetRef: RefObject<Gtk.Widget | null>,\n  options: LayoutChildOptions,\n): LayoutChild => {\n  const host = useHostNode()\n\n  // useState's lazy initializer is guaranteed once-per-instance even under\n  // the React Compiler — a lazy ref here got its creation memoized ACROSS\n  // component instances, sharing one Yoga node and double-freeing it.\n  const [node] = useState<LayoutNode>(() => host.engine.createNode())\n\n  const flat = StyleSheet.flatten(options.style)\n  const { layout, visual } = splitStyle(flat)\n  const effectiveLayout = options.extraLayout\n    ? { ...layout, ...options.extraLayout }\n    : layout\n\n  // Re-apply layout style only when it actually changed (keyed effect) —\n  // setStyle dirties the whole tree.\n  const layoutKey = JSON.stringify(effectiveLayout)\n  useLayoutEffect(() => {\n    node.setStyle(JSON.parse(layoutKey) as LayoutStyle)\n  }, [node, layoutKey])\n\n  const cssClass = defaultCssRegistry.getClassName(visual)\n\n  // RN transforms are visual only: the widget keeps the box Yoga gave it, so\n  // a transform never touches the shadow tree — it only asks the parent\n  // container to run its allocate hook again. Keyed on the serialized array\n  // so a re-render with the same transform costs nothing.\n  // (Animated.View owns its own transform and strips it from the static\n  // style before it gets here, so the two writers never race.)\n  const transformKey = JSON.stringify(visual.transform ?? null)\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    setStoredTransform(widget, JSON.parse(transformKey) as TransformPart[])\n    const parentWidget = host.widgetRef.current\n    if (parentWidget) {\n      queueAllocate(parentWidget)\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [transformKey])\n\n  useLayoutEffect(() => {\n    const parent = host.node\n    // The reconciler has already attached our widget in JSX order, so its\n    // sibling position is the correct Yoga index — this keeps the shadow tree\n    // ordered even for mid-list mounts (conditional children, list inserts).\n    const widget = widgetRef.current\n    const parentWidget = host.widgetRef.current\n    let index = parent.children.length\n    if (widget && parentWidget) {\n      let position = 0\n      let sibling = parentWidget.getFirstChild()\n      while (sibling !== null && sibling !== widget) {\n        position += 1\n        sibling = sibling.getNextSibling()\n      }\n      if (sibling === widget) {\n        index = Math.min(position, parent.children.length)\n      }\n    }\n    parent.insertChild(node, index)\n    node.setCommit((rect: Rect) => {\n      const widget = widgetRef.current\n      const parentWidget = host.widgetRef.current\n      if (!widget || !parentWidget) {\n        return\n      }\n      const previous = getStoredRect(widget)\n      // A commit does not imply a change. The engine filters unchanged nodes\n      // out of the walk, EXCEPT nodes carrying a measure function — every\n      // Text leaf, every intrinsic widget — which it must still visit. Those\n      // then arrive here with the rect they already have, and queueing an\n      // allocation for them makes GTK re-allocate and re-snapshot the whole\n      // container for nothing.\n      //\n      // The cost of that is not academic: it scales with children × painted\n      // area. Measured on a 500-row list, maximized, windowSize 11 — 801\n      // live nodes — the frame average was 40.4 ms against 15.7 ms windowed,\n      // while neither 777 nodes in a small window nor 205 nodes maximized\n      // cost anything. Only the product hurts, and this is where we inflate\n      // the first factor.\n      if (\n        previous &&\n        previous.x === rect.x &&\n        previous.y === rect.y &&\n        previous.width === rect.width &&\n        previous.height === rect.height\n      ) {\n        return\n      }\n      setStoredRect(widget, rect)\n      const sizeChanged =\n        !previous ||\n        previous.width !== rect.width ||\n        previous.height !== rect.height\n      const queue = (): void => {\n        if (sizeChanged) {\n          // A size change invalidates this widget's cached measure (nested\n          // managers, ScrolledWindow ranges) and re-allocates the ancestors.\n          queueResize(widget)\n        } else {\n          // Pure move: the parent just needs another allocation pass. GTK\n          // dedupes queued allocates, so per-child calls batch into one.\n          queueAllocate(parentWidget)\n        }\n      }\n      if (!deferDuringAllocate(widget, queue)) {\n        queue()\n      }\n    })\n    return () => {\n      node.setCommit(null)\n      parent.removeChild(node)\n      node.free()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [])\n\n  const onLayout = options.onLayout\n  useLayoutEffect(() => {\n    node.setOnLayout(\n      onLayout\n        ? (rect: Rect) => {\n            onLayout({ nativeEvent: { layout: rect } })\n          }\n        : null,\n    )\n  }, [node, onLayout])\n\n  // The explicit return type keeps the inner params contextually typed: with a\n  // bare lazy initializer TS may match the outer arrow against MeasureFn\n  // itself (useState accepts S | () => S) and drop the context.\n  const [widgetMeasure] = useState<MeasureFn>(\n    (): MeasureFn => (width, widthMode) => {\n      const widget = widgetRef.current\n      if (!widget) {\n        return { width: 0, height: 0 }\n      }\n      const { minimum, natural } = measureWidget(widget, \"horizontal\")\n      // Floor at the widget's own minimum width, not at 1 — see the same\n      // clamp in text.tsx's measure for why: gtk_widget_measure() enforces\n      // this floor internally regardless of what we request (warning while\n      // it does), so anything below `minimum` was never actually honored.\n      const used =\n        widthMode === \"undefined\"\n          ? natural\n          : Math.min(natural, Math.max(minimum, Math.floor(width)))\n      return {\n        width: used,\n        height: measureWidget(widget, \"vertical\", used).natural,\n      }\n    },\n  )\n  const measure =\n    options.measure ?? (options.measureFromWidget ? widgetMeasure : undefined)\n  useLayoutEffect(() => {\n    if (!measure) {\n      return\n    }\n    node.setMeasureFn(measure)\n    // Widgets measured before their window is mapped report zero (no realized\n    // theme context yet, unlike offscreen probes) and Yoga caches it —\n    // invalidate once the widget actually maps.\n    const widget = widgetRef.current\n    const remeasure = (): void => {\n      node.markDirty()\n    }\n    if (options.measureFromWidget && widget) {\n      widget.on(\"map\", remeasure)\n    }\n    return () => {\n      if (options.measureFromWidget && widget) {\n        widget.off(\"map\", remeasure)\n      }\n      // Cleared by free() on unmount; explicit unset only when measure is\n      // removed while mounted.\n      node.setMeasureFn(null)\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [node, measure])\n\n  return { host, node, flat, visual, cssClass }\n}\n\nexport type RnContainerOptions = {\n  // Overrides the default engine-rect measure (the window root reports 0 so\n  // the window can shrink freely below the current content size; the\n  // intrinsic root measures its content through Yoga, honoring forSize for\n  // height-for-width).\n  measure?: (orientation: \"horizontal\" | \"vertical\", forSize: number) => number\n  // Runs before children are placed — the window root syncs the engine\n  // viewport to the actual allocation here.\n  beforeAllocate?: (width: number, height: number) => void\n}\n\n// Containers (Root, View, Animated.View, ScrollView content) drive their GTK\n// side with an RnGtkxLayout: measure() reports the engine rect of `node`\n// (minimum == natural — GTK minimums of children never leak upward), and\n// allocate() places every child widget at exactly its stored engine rect\n// plus the Animated offset.\nexport const useRnContainer = (\n  widgetRef: RefObject<Gtk.Widget | null>,\n  node: LayoutNode,\n  options?: RnContainerOptions,\n): void => {\n  const optionsRef = useRef<RnContainerOptions | undefined>(options)\n  optionsRef.current = options\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    attachRnLayout(widget, {\n      measure: (orientation, forSize) => {\n        const custom = optionsRef.current?.measure\n        if (custom) {\n          return custom(orientation, forSize)\n        }\n        const rect = node.getRect()\n        return Math.round(\n          (orientation === \"horizontal\" ? rect?.width : rect?.height) ?? 0,\n        )\n      },\n      allocate: (width, height) => {\n        const start = perfEnabled ? perfNow() : 0\n        perfAllocDepth += 1\n        optionsRef.current?.beforeAllocate?.(width, height)\n        let child = widget.getFirstChild()\n        let children = 0\n        while (child) {\n          const rect = getStoredRect(child)\n          if (rect) {\n            const offset = getStoredOffset(child)\n            allocateChild(\n              child,\n              rect.x + offset.dx,\n              rect.y + offset.dy,\n              rect.width,\n              rect.height,\n              offset.matrix,\n            )\n            children += 1\n          }\n          child = child.getNextSibling()\n        }\n        perfAllocDepth -= 1\n        if (perfEnabled) {\n          perfCount(\"gtk.allocPass\")\n          perfCount(\"gtk.allocChild\", children)\n          if (perfAllocDepth === 0) {\n            const elapsed = perfNow() - start\n            perfAddTime(\"gtk.allocTop\", elapsed)\n            perfBurst(\"gtk.allocMsPerFrame\", elapsed)\n          }\n        }\n      },\n    })\n    return () => {\n      detachRnLayout(widget)\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [])\n}\n"]}
+{"version":3,"file":"use-layout-child.js","sourceRoot":"","sources":["../../src/components/use-layout-child.ts"],"names":[],"mappings":"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","sourcesContent":["import { useLayoutEffect, useRef, useState, type RefObject } from \"react\"\nimport type { LayoutNode } from \"../layout/index\"\nimport { splitStyle, StyleSheet } from \"../style/index\"\nimport { defaultCssRegistry } from \"../style/registry.gtkx\"\nimport type {\n  LayoutStyle,\n  MeasureFn,\n  Rect,\n  StyleProp,\n  TransformPart,\n  VisualStyle,\n} from \"../contracts\"\nimport {\n  allocateChild,\n  attachRnLayout,\n  detachRnLayout,\n  measureWidget,\n  queueAllocate,\n  queueResize,\n  type Gtk,\n} from \"../gtkx/bridge/index\"\nimport {\n  perfAddTime,\n  perfBurst,\n  perfCount,\n  perfEnabled,\n  perfNow,\n} from \"../perf\"\nimport { useHostNode, type HostNode } from \"./host-node\"\nimport {\n  deferDuringAllocate,\n  getStoredOffset,\n  getStoredRect,\n  setStoredRect,\n  setStoredTransform,\n} from \"./rect-store\"\n\nexport type LayoutEvent = {\n  nativeEvent: {\n    layout: { x: number; y: number; width: number; height: number }\n  }\n}\n\n// Perf: sizeAllocate recurses synchronously into child containers, so a\n// naive per-pass timer double-counts nested passes. Track depth and time\n// only the outermost (top-level) allocate — that is the real wall time GTK\n// spends in OUR layout code for the frame.\nlet perfAllocDepth = 0\n\nexport type LayoutChildOptions = {\n  style: StyleProp | undefined\n  onLayout: ((event: LayoutEvent) => void) | undefined\n  measure?: MeasureFn\n  // Leaves with intrinsic GTK sizes (Entry, Switch, Spinner) measure their\n  // own widget so Yoga reserves exactly what the theme will draw.\n  measureFromWidget?: boolean\n  extraLayout?: LayoutStyle\n}\n\nexport type LayoutChild = {\n  host: HostNode\n  node: LayoutNode\n  flat: ReturnType<typeof StyleSheet.flatten>\n  visual: VisualStyle\n  cssClass: string | null\n}\n\n// Shared plumbing for every leaf/container component: owns one LayoutNode,\n// keeps it in the parent's shadow tree for the component lifetime, applies\n// the layout half of the style and commits Yoga rects into the rect store,\n// where the parent container's RnGtkxLayout allocate() picks them up.\nexport const useLayoutChild = (\n  widgetRef: RefObject<Gtk.Widget | null>,\n  options: LayoutChildOptions,\n): LayoutChild => {\n  const host = useHostNode()\n\n  // useState's lazy initializer is guaranteed once-per-instance even under\n  // the React Compiler — a lazy ref here got its creation memoized ACROSS\n  // component instances, sharing one Yoga node and double-freeing it.\n  const [node] = useState<LayoutNode>(() => host.engine.createNode())\n\n  const flat = StyleSheet.flatten(options.style)\n  const { layout, visual } = splitStyle(flat)\n  const effectiveLayout = options.extraLayout\n    ? { ...layout, ...options.extraLayout }\n    : layout\n\n  // Re-apply layout style only when it actually changed (keyed effect) —\n  // setStyle dirties the whole tree.\n  const layoutKey = JSON.stringify(effectiveLayout)\n  useLayoutEffect(() => {\n    node.setStyle(JSON.parse(layoutKey) as LayoutStyle)\n  }, [node, layoutKey])\n\n  const cssClass = defaultCssRegistry.getClassName(visual)\n\n  // RN transforms are visual only: the widget keeps the box Yoga gave it, so\n  // a transform never touches the shadow tree — it only asks the parent\n  // container to run its allocate hook again. Keyed on the serialized array\n  // so a re-render with the same transform costs nothing.\n  // (Animated.View owns its own transform and strips it from the static\n  // style before it gets here, so the two writers never race.)\n  const transformKey = JSON.stringify(visual.transform ?? null)\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    setStoredTransform(widget, JSON.parse(transformKey) as TransformPart[])\n    const parentWidget = host.widgetRef.current\n    if (parentWidget) {\n      queueAllocate(parentWidget)\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [transformKey])\n\n  useLayoutEffect(() => {\n    const parent = host.node\n    // The reconciler has already attached our widget in JSX order, so its\n    // sibling position is the correct Yoga index — this keeps the shadow tree\n    // ordered even for mid-list mounts (conditional children, list inserts).\n    const widget = widgetRef.current\n    const parentWidget = host.widgetRef.current\n    let index = parent.children.length\n    if (widget && parentWidget) {\n      let position = 0\n      let sibling = parentWidget.getFirstChild()\n      while (sibling !== null && sibling !== widget) {\n        position += 1\n        sibling = sibling.getNextSibling()\n      }\n      if (sibling === widget) {\n        index = Math.min(position, parent.children.length)\n      }\n    }\n    parent.insertChild(node, index)\n    node.setCommit((rect: Rect) => {\n      const widget = widgetRef.current\n      const parentWidget = host.widgetRef.current\n      if (!widget || !parentWidget) {\n        return\n      }\n      const previous = getStoredRect(widget)\n      // A commit does not imply a change. The engine may hand us the rect a\n      // widget already has — nodes carrying a measure function are visited\n      // even when Yoga did not move them — and queueing an allocation for\n      // those makes GTK re-allocate and re-snapshot the container for nothing.\n      //\n      // `rect.skip` counts how often this guard actually fires and\n      // `rect.change` how often it does not, because a guard nobody can see\n      // firing is a guard nobody can attribute a measurement to: this one was\n      // once credited with a large maximized-window win that a later, properly\n      // geometry-controlled run could not reproduce (docs/research/\n      // scroll-performance.md, round six). Keep it — it is correct and free —\n      // but read the counter before crediting it with anything.\n      const unchanged =\n        previous !== undefined &&\n        previous.x === rect.x &&\n        previous.y === rect.y &&\n        previous.width === rect.width &&\n        previous.height === rect.height\n      if (perfEnabled) {\n        perfCount(unchanged ? \"rect.skip\" : \"rect.change\")\n      }\n      if (unchanged) {\n        return\n      }\n      setStoredRect(widget, rect)\n      const sizeChanged =\n        !previous ||\n        previous.width !== rect.width ||\n        previous.height !== rect.height\n      const queue = (): void => {\n        if (sizeChanged) {\n          // A size change invalidates this widget's cached measure (nested\n          // managers, ScrolledWindow ranges) and re-allocates the ancestors.\n          queueResize(widget)\n        } else {\n          // Pure move: the parent just needs another allocation pass. GTK\n          // dedupes queued allocates, so per-child calls batch into one.\n          queueAllocate(parentWidget)\n        }\n      }\n      if (!deferDuringAllocate(widget, queue)) {\n        queue()\n      }\n    })\n    return () => {\n      node.setCommit(null)\n      parent.removeChild(node)\n      node.free()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [])\n\n  const onLayout = options.onLayout\n  useLayoutEffect(() => {\n    node.setOnLayout(\n      onLayout\n        ? (rect: Rect) => {\n            onLayout({ nativeEvent: { layout: rect } })\n          }\n        : null,\n    )\n  }, [node, onLayout])\n\n  // The explicit return type keeps the inner params contextually typed: with a\n  // bare lazy initializer TS may match the outer arrow against MeasureFn\n  // itself (useState accepts S | () => S) and drop the context.\n  const [widgetMeasure] = useState<MeasureFn>(\n    (): MeasureFn => (width, widthMode) => {\n      const widget = widgetRef.current\n      if (!widget) {\n        return { width: 0, height: 0 }\n      }\n      const { minimum, natural } = measureWidget(widget, \"horizontal\")\n      // Floor at the widget's own minimum width, not at 1 — see the same\n      // clamp in text.tsx's measure for why: gtk_widget_measure() enforces\n      // this floor internally regardless of what we request (warning while\n      // it does), so anything below `minimum` was never actually honored.\n      const used =\n        widthMode === \"undefined\"\n          ? natural\n          : Math.min(natural, Math.max(minimum, Math.floor(width)))\n      return {\n        width: used,\n        height: measureWidget(widget, \"vertical\", used).natural,\n      }\n    },\n  )\n  const measure =\n    options.measure ?? (options.measureFromWidget ? widgetMeasure : undefined)\n  useLayoutEffect(() => {\n    if (!measure) {\n      return\n    }\n    node.setMeasureFn(measure)\n    // Widgets measured before their window is mapped report zero (no realized\n    // theme context yet, unlike offscreen probes) and Yoga caches it —\n    // invalidate once the widget actually maps.\n    const widget = widgetRef.current\n    const remeasure = (): void => {\n      node.markDirty()\n    }\n    if (options.measureFromWidget && widget) {\n      widget.on(\"map\", remeasure)\n    }\n    return () => {\n      if (options.measureFromWidget && widget) {\n        widget.off(\"map\", remeasure)\n      }\n      // Cleared by free() on unmount; explicit unset only when measure is\n      // removed while mounted.\n      node.setMeasureFn(null)\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [node, measure])\n\n  return { host, node, flat, visual, cssClass }\n}\n\nexport type RnContainerOptions = {\n  // Overrides the default engine-rect measure (the window root reports 0 so\n  // the window can shrink freely below the current content size; the\n  // intrinsic root measures its content through Yoga, honoring forSize for\n  // height-for-width).\n  measure?: (orientation: \"horizontal\" | \"vertical\", forSize: number) => number\n  // Runs before children are placed — the window root syncs the engine\n  // viewport to the actual allocation here.\n  beforeAllocate?: (width: number, height: number) => void\n}\n\n// Containers (Root, View, Animated.View, ScrollView content) drive their GTK\n// side with an RnGtkxLayout: measure() reports the engine rect of `node`\n// (minimum == natural — GTK minimums of children never leak upward), and\n// allocate() places every child widget at exactly its stored engine rect\n// plus the Animated offset.\nexport const useRnContainer = (\n  widgetRef: RefObject<Gtk.Widget | null>,\n  node: LayoutNode,\n  options?: RnContainerOptions,\n): void => {\n  const optionsRef = useRef<RnContainerOptions | undefined>(options)\n  optionsRef.current = options\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    attachRnLayout(widget, {\n      measure: (orientation, forSize) => {\n        const custom = optionsRef.current?.measure\n        if (custom) {\n          return custom(orientation, forSize)\n        }\n        const rect = node.getRect()\n        return Math.round(\n          (orientation === \"horizontal\" ? rect?.width : rect?.height) ?? 0,\n        )\n      },\n      allocate: (width, height) => {\n        const start = perfEnabled ? perfNow() : 0\n        perfAllocDepth += 1\n        optionsRef.current?.beforeAllocate?.(width, height)\n        let child = widget.getFirstChild()\n        let children = 0\n        while (child) {\n          const rect = getStoredRect(child)\n          if (rect) {\n            const offset = getStoredOffset(child)\n            allocateChild(\n              child,\n              rect.x + offset.dx,\n              rect.y + offset.dy,\n              rect.width,\n              rect.height,\n              offset.matrix,\n            )\n            children += 1\n          }\n          child = child.getNextSibling()\n        }\n        perfAllocDepth -= 1\n        if (perfEnabled) {\n          perfCount(\"gtk.allocPass\")\n          perfCount(\"gtk.allocChild\", children)\n          if (perfAllocDepth === 0) {\n            const elapsed = perfNow() - start\n            perfAddTime(\"gtk.allocTop\", elapsed)\n            perfBurst(\"gtk.allocMsPerFrame\", elapsed)\n          }\n        }\n      },\n    })\n    return () => {\n      detachRnLayout(widget)\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [])\n}\n"]}

package/dist/components/view.d.ts

@@ -1,13 +1,18 @@
-import { type ReactNode } from "react";
+import { type ReactNode, type Ref } from "react";
 import type { PointerEventsValue, StyleProp } from "../contracts";
+import type { ResponderProps } from "../responder/types";
+import { type MeasureHandle } from "./measure";
 import { type LayoutEvent } from "./use-layout-child";
-export type ViewProps = {
+/** RN's imperative geometry methods, on a `View` ref. */
+export type ViewHandle = MeasureHandle;
+export type ViewProps = ResponderProps & {
     style?: StyleProp;
     pointerEvents?: PointerEventsValue;
     onLayout?: (event: LayoutEvent) => void;
     children?: ReactNode;
     testID?: string;
+    ref?: Ref<ViewHandle>;
 };
-export declare const View: ({ style, pointerEvents, onLayout, children, testID, }: ViewProps) => React.JSX.Element;
-export declare const SafeAreaView: ({ style, pointerEvents, onLayout, children, testID, }: ViewProps) => React.JSX.Element;
+export declare const View: ({ style, pointerEvents, onLayout, children, testID, ref, ...responderProps }: ViewProps) => React.JSX.Element;
+export declare const SafeAreaView: ({ style, pointerEvents, onLayout, children, testID, ref, ...responderProps }: ViewProps) => React.JSX.Element;
 export declare const StatusBar: () => null;

package/dist/components/view.js

@@ -1,8 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useLayoutEffect, useRef } from "react";
+import { useImperativeHandle, useLayoutEffect, useRef, } from "react";
 import { StyleSheet } from "../style/index";
 import { getViewBoxComponent, setBoxPassthrough, } from "../gtkx/bridge/index";
+import { useResponder } from "../responder/use-responder";
 import { HostNodeContext } from "./host-node";
+import { createMeasureHandle } from "./measure";
 import { useLayoutChild, useRnContainer, } from "./use-layout-child";
 // Every View is a GtkBox subclass (RnGtkxViewBox) driven by RnGtkxLayout:
 // Yoga computes the children's rects, the manager's allocate() applies
@@ -17,13 +19,17 @@ import { useLayoutChild, useRnContainer, } from "./use-layout-child";
 //   can-target=false; restored when the mode changes. Nesting another
 //   pointerEvents INSIDE a box-only view is not supported (the restore
 //   pass cannot know about it).
-export const View = ({ style, pointerEvents, onLayout, children, testID, }) => {
+export const View = ({ style, pointerEvents, onLayout, children, testID, ref, ...responderProps }) => {
     const widgetRef = useRef(null);
     const { host, node, cssClass } = useLayoutChild(widgetRef, {
         style,
         onLayout,
     });
     useRnContainer(widgetRef, node);
+    useImperativeHandle(ref, () => createMeasureHandle(widgetRef, node), [node]);
+    // Spreading PanResponder's panHandlers onto a View is the portable RN
+    // idiom, so every responder prop arrives here as a rest prop.
+    useResponder(widgetRef, responderProps);
     const mode = pointerEvents ?? StyleSheet.flatten(style)?.pointerEvents ?? "auto";
     useLayoutEffect(() => {
         const widget = widgetRef.current;

package/dist/components/view.js.map

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/components/view.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,OAAO,EACL,mBAAmB,EAEnB,iBAAiB,GAElB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,cAAc,EACd,cAAc,GAEf,MAAM,oBAAoB,CAAA;AAW3B,0EAA0E;AAC1E,uEAAuE;AACvE,sEAAsE;AACtE,+CAA+C;AAC/C,0EAA0E;AAC1E,uDAAuD;AACvD,kEAAkE;AAClE,wEAAwE;AACxE,uDAAuD;AACvD,4DAA4D;AAC5D,sEAAsE;AACtE,uEAAuE;AACvE,gCAAgC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EACnB,KAAK,EACL,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,MAAM,GACI,EAAE,EAAE;IACd,MAAM,SAAS,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAA;IAC9C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE;QACzD,KAAK;QACL,QAAQ;KACT,CAAC,CAAA;IACF,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAE/B,MAAM,IAAI,GACR,aAAa,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,aAAa,IAAI,MAAM,CAAA;IAErE,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAA;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAM;QACR,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;QACpC,iBAAiB,CAAC,MAAM,EAAE,IAAI,KAAK,UAAU,CAAC,CAAA;IAChD,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAEV,yEAAyE;IACzE,uDAAuD;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAChC,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAA;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,KAAK,UAAU,CAAA;QACnC,IAAI,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAA;YAClC,OAAO,KAAK,EAAE,CAAC;gBACb,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAA;gBAC5B,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAA;YAChC,CAAC;QACH,CAAC;QACD,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,mBAAmB,EAAmB,CAAA;IACtD,OAAO,CACL,KAAC,OAAO,IACN,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,YAEtC,KAAC,eAAe,CAAC,QAAQ,IACvB,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAE9C,QAAQ,GACgB,GACnB,CACX,CAAA;AACH,CAAC,CAAA;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAA;AAEhC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAS,EAAE,CAAC,IAAI,CAAA","sourcesContent":["import { useLayoutEffect, useRef, type ReactNode } from \"react\"\nimport { StyleSheet } from \"../style/index\"\nimport type { PointerEventsValue, StyleProp } from \"../contracts\"\nimport {\n  getViewBoxComponent,\n  GtkBox,\n  setBoxPassthrough,\n  type Gtk,\n} from \"../gtkx/bridge/index\"\nimport { HostNodeContext } from \"./host-node\"\nimport {\n  useLayoutChild,\n  useRnContainer,\n  type LayoutEvent,\n} from \"./use-layout-child\"\n\nexport type ViewProps = {\n  style?: StyleProp\n  // RN pointerEvents; the prop wins over style.pointerEvents (RN 0.71+).\n  pointerEvents?: PointerEventsValue\n  onLayout?: (event: LayoutEvent) => void\n  children?: ReactNode\n  testID?: string\n}\n\n// Every View is a GtkBox subclass (RnGtkxViewBox) driven by RnGtkxLayout:\n// Yoga computes the children's rects, the manager's allocate() applies\n// them. Visual styles arrive as a GTK CSS class produced by the style\n// system. pointerEvents maps onto GTK picking:\n// - none: can-target=false — GTK skips the widget WITHOUT descending, the\n//   whole subtree is transparent (exact RN semantics);\n// - box-none: the subclass' contains() fails for this widget (see\n//   view-box.ts) — the box is never the pick target while children stay\n//   pickable, and toggling never remounts the subtree;\n// - box-only: direct children (and thus their subtrees) get\n//   can-target=false; restored when the mode changes. Nesting another\n//   pointerEvents INSIDE a box-only view is not supported (the restore\n//   pass cannot know about it).\nexport const View = ({\n  style,\n  pointerEvents,\n  onLayout,\n  children,\n  testID,\n}: ViewProps) => {\n  const widgetRef = useRef<Gtk.Box | null>(null)\n  const { host, node, cssClass } = useLayoutChild(widgetRef, {\n    style,\n    onLayout,\n  })\n  useRnContainer(widgetRef, node)\n\n  const mode: PointerEventsValue =\n    pointerEvents ?? StyleSheet.flatten(style)?.pointerEvents ?? \"auto\"\n\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    widget.setCanTarget(mode !== \"none\")\n    setBoxPassthrough(widget, mode === \"box-none\")\n  }, [mode])\n\n  // box-only walks the current children every commit (the set changes with\n  // renders) and restores once when the mode moves away.\n  const wasBoxOnly = useRef(false)\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    const boxOnly = mode === \"box-only\"\n    if (boxOnly || wasBoxOnly.current) {\n      let child = widget.getFirstChild()\n      while (child) {\n        child.setCanTarget(!boxOnly)\n        child = child.getNextSibling()\n      }\n    }\n    wasBoxOnly.current = boxOnly\n  })\n\n  const ViewBox = getViewBoxComponent() as typeof GtkBox\n  return (\n    <ViewBox\n      ref={widgetRef}\n      name={testID}\n      cssClasses={cssClass ? [cssClass] : []}\n    >\n      <HostNodeContext.Provider\n        value={{ engine: host.engine, node, widgetRef }}\n      >\n        {children}\n      </HostNodeContext.Provider>\n    </ViewBox>\n  )\n}\n\n// RN parity aliases (no notches or status bars on the Linux desktop).\nexport const SafeAreaView = View\n\nexport const StatusBar = (): null => null\n"]}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/components/view.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  useImperativeHandle,\n  useLayoutEffect,\n  useRef,\n  type ReactNode,\n  type Ref,\n} from \"react\"\nimport { StyleSheet } from \"../style/index\"\nimport type { PointerEventsValue, StyleProp } from \"../contracts\"\nimport {\n  getViewBoxComponent,\n  GtkBox,\n  setBoxPassthrough,\n  type Gtk,\n} from \"../gtkx/bridge/index\"\nimport type { ResponderProps } from \"../responder/types\"\nimport { useResponder } from \"../responder/use-responder\"\nimport { HostNodeContext } from \"./host-node\"\nimport { createMeasureHandle, type MeasureHandle } from \"./measure\"\nimport {\n  useLayoutChild,\n  useRnContainer,\n  type LayoutEvent,\n} from \"./use-layout-child\"\n\n/** RN's imperative geometry methods, on a `View` ref. */\nexport type ViewHandle = MeasureHandle\n\nexport type ViewProps = ResponderProps & {\n  style?: StyleProp\n  // RN pointerEvents; the prop wins over style.pointerEvents (RN 0.71+).\n  pointerEvents?: PointerEventsValue\n  onLayout?: (event: LayoutEvent) => void\n  children?: ReactNode\n  testID?: string\n  // React 19 takes `ref` as an ordinary prop, which is what we want here:\n  // forwardRef is booby-trapped on this stack (useEffectEvent never\n  // refreshes inside it — see gtkx/bridge/use-signal.ts).\n  ref?: Ref<ViewHandle>\n}\n\n// Every View is a GtkBox subclass (RnGtkxViewBox) driven by RnGtkxLayout:\n// Yoga computes the children's rects, the manager's allocate() applies\n// them. Visual styles arrive as a GTK CSS class produced by the style\n// system. pointerEvents maps onto GTK picking:\n// - none: can-target=false — GTK skips the widget WITHOUT descending, the\n//   whole subtree is transparent (exact RN semantics);\n// - box-none: the subclass' contains() fails for this widget (see\n//   view-box.ts) — the box is never the pick target while children stay\n//   pickable, and toggling never remounts the subtree;\n// - box-only: direct children (and thus their subtrees) get\n//   can-target=false; restored when the mode changes. Nesting another\n//   pointerEvents INSIDE a box-only view is not supported (the restore\n//   pass cannot know about it).\nexport const View = ({\n  style,\n  pointerEvents,\n  onLayout,\n  children,\n  testID,\n  ref,\n  ...responderProps\n}: ViewProps) => {\n  const widgetRef = useRef<Gtk.Box | null>(null)\n  const { host, node, cssClass } = useLayoutChild(widgetRef, {\n    style,\n    onLayout,\n  })\n  useRnContainer(widgetRef, node)\n\n  useImperativeHandle(ref, () => createMeasureHandle(widgetRef, node), [node])\n\n  // Spreading PanResponder's panHandlers onto a View is the portable RN\n  // idiom, so every responder prop arrives here as a rest prop.\n  useResponder(widgetRef, responderProps)\n\n  const mode: PointerEventsValue =\n    pointerEvents ?? StyleSheet.flatten(style)?.pointerEvents ?? \"auto\"\n\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    widget.setCanTarget(mode !== \"none\")\n    setBoxPassthrough(widget, mode === \"box-none\")\n  }, [mode])\n\n  // box-only walks the current children every commit (the set changes with\n  // renders) and restores once when the mode moves away.\n  const wasBoxOnly = useRef(false)\n  useLayoutEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    const boxOnly = mode === \"box-only\"\n    if (boxOnly || wasBoxOnly.current) {\n      let child = widget.getFirstChild()\n      while (child) {\n        child.setCanTarget(!boxOnly)\n        child = child.getNextSibling()\n      }\n    }\n    wasBoxOnly.current = boxOnly\n  })\n\n  const ViewBox = getViewBoxComponent() as typeof GtkBox\n  return (\n    <ViewBox\n      ref={widgetRef}\n      name={testID}\n      cssClasses={cssClass ? [cssClass] : []}\n    >\n      <HostNodeContext.Provider\n        value={{ engine: host.engine, node, widgetRef }}\n      >\n        {children}\n      </HostNodeContext.Provider>\n    </ViewBox>\n  )\n}\n\n// RN parity aliases (no notches or status bars on the Linux desktop).\nexport const SafeAreaView = View\n\nexport const StatusBar = (): null => null\n"]}

package/dist/contracts.d.ts

@@ -68,8 +68,18 @@ export type Transform2D = {
     dx: number;
     dy: number;
 };
+export type BoxShadowValue = {
+    offsetX: number | string;
+    offsetY: number | string;
+    color?: string;
+    blurRadius?: number | string;
+    spreadDistance?: number | string;
+    inset?: boolean;
+};
+export type TextDecorationLine = "none" | "underline" | "line-through" | "underline line-through";
 export type VisualStyle = Partial<{
     backgroundColor: string;
+    boxShadow: string | readonly BoxShadowValue[];
     borderBottomColor: string;
     borderBottomLeftRadius: number;
     borderBottomRightRadius: number;
@@ -94,13 +104,19 @@ export type VisualStyle = Partial<{
     letterSpacing: number;
     lineHeight: number;
     opacity: number;
+    outlineColor: string;
+    outlineOffset: number;
+    outlineStyle: "solid" | "dotted" | "dashed";
+    outlineWidth: number;
     textAlign: "auto" | "left" | "right" | "center" | "justify";
+    textDecorationLine: TextDecorationLine;
     transform: TransformPart[];
 }>;
 export type PointerEventsValue = "auto" | "none" | "box-none" | "box-only";
-export type FlatStyle = LayoutStyle & VisualStyle & {
-    pointerEvents?: PointerEventsValue;
-};
+export type BehavioralStyle = Partial<{
+    pointerEvents: PointerEventsValue;
+}>;
+export type FlatStyle = LayoutStyle & VisualStyle & BehavioralStyle;
 export type StyleProp<T = FlatStyle> = T | null | undefined | false | ReadonlyArray<StyleProp<T>>;
 export type SplitStyle = {
     layout: LayoutStyle;

package/dist/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sEAAsE","sourcesContent":["// Shared contracts between the layout engine, the style system, the API\n// modules and the components — the one module every layer may import.\n\n// --- style ------------------------------------------------------------------\n\nexport type DimensionValue = number | `${number}%` | \"auto\"\n\nexport type FlexAlignType =\n  \"flex-start\" | \"flex-end\" | \"center\" | \"stretch\" | \"baseline\"\n\n// Layout-affecting props: classified by the style system, consumed by the\n// layout engine, which maps them onto Yoga node setters.\nexport type LayoutStyle = Partial<{\n  alignContent:\n    | \"flex-start\"\n    | \"flex-end\"\n    | \"center\"\n    | \"stretch\"\n    | \"space-between\"\n    | \"space-around\"\n  alignItems: FlexAlignType\n  alignSelf: \"auto\" | FlexAlignType\n  aspectRatio: number | string\n  bottom: DimensionValue\n  columnGap: number\n  direction: \"inherit\" | \"ltr\" | \"rtl\"\n  display: \"none\" | \"flex\"\n  flex: number\n  flexBasis: DimensionValue\n  flexDirection: \"row\" | \"row-reverse\" | \"column\" | \"column-reverse\"\n  flexGrow: number\n  flexShrink: number\n  flexWrap: \"wrap\" | \"nowrap\" | \"wrap-reverse\"\n  gap: number\n  height: DimensionValue\n  justifyContent:\n    | \"flex-start\"\n    | \"flex-end\"\n    | \"center\"\n    | \"space-between\"\n    | \"space-around\"\n    | \"space-evenly\"\n  left: DimensionValue\n  margin: DimensionValue\n  marginBottom: DimensionValue\n  marginHorizontal: DimensionValue\n  marginLeft: DimensionValue\n  marginRight: DimensionValue\n  marginTop: DimensionValue\n  marginVertical: DimensionValue\n  maxHeight: DimensionValue\n  maxWidth: DimensionValue\n  minHeight: DimensionValue\n  minWidth: DimensionValue\n  overflow: \"visible\" | \"hidden\" | \"scroll\"\n  padding: DimensionValue\n  paddingBottom: DimensionValue\n  paddingHorizontal: DimensionValue\n  paddingLeft: DimensionValue\n  paddingRight: DimensionValue\n  paddingTop: DimensionValue\n  paddingVertical: DimensionValue\n  position: \"absolute\" | \"relative\" | \"static\"\n  right: DimensionValue\n  rowGap: number\n  top: DimensionValue\n  width: DimensionValue\n}>\n\nexport type Angle = `${number}deg` | `${number}rad`\n\nexport type TransformPart =\n  | { translateX: number }\n  | { translateY: number }\n  | { scale: number }\n  | { scaleX: number }\n  | { scaleY: number }\n  | { rotate: Angle }\n  // RN's 2D alias for `rotate` (rotation about the Z axis).\n  | { rotateZ: Angle }\n\n// A 2D affine transform in the component order GSK and cairo use:\n//   x' = xx * x + xy * y + dx\n//   y' = yx * x + yy * y + dy\n// This is exactly the argument order of gsk_transform_matrix2d(), so a\n// composed TransformPart[] reaches GTK in a single FFI call.\nexport type Transform2D = {\n  xx: number\n  yx: number\n  xy: number\n  yy: number\n  dx: number\n  dy: number\n}\n\n// Visual props: classified by the style system, compiled into GTK CSS\n// classes via the bridge `css` helper. Text-specific props apply to <Text>.\nexport type VisualStyle = Partial<{\n  backgroundColor: string\n  borderBottomColor: string\n  borderBottomLeftRadius: number\n  borderBottomRightRadius: number\n  borderBottomWidth: number\n  borderColor: string\n  borderLeftColor: string\n  borderLeftWidth: number\n  borderRadius: number\n  borderRightColor: string\n  borderRightWidth: number\n  borderStyle: \"solid\" | \"dotted\" | \"dashed\"\n  borderTopColor: string\n  borderTopLeftRadius: number\n  borderTopRightRadius: number\n  borderTopWidth: number\n  borderWidth: number\n  color: string\n  fontFamily: string\n  fontSize: number\n  fontStyle: \"normal\" | \"italic\"\n  fontWeight:\n    | \"normal\"\n    | \"bold\"\n    | \"100\"\n    | \"200\"\n    | \"300\"\n    | \"400\"\n    | \"500\"\n    | \"600\"\n    | \"700\"\n    | \"800\"\n    | \"900\"\n  letterSpacing: number\n  lineHeight: number\n  opacity: number\n  // NOT emitted to CSS (no such GTK CSS property): the Text component applies\n  // it via label props using the pure style/text-align helper.\n  textAlign: \"auto\" | \"left\" | \"right\" | \"center\" | \"justify\"\n  // NOT emitted to CSS (GTK4 has no widget `transform` property): composed\n  // into a Transform2D by style/transform.ts and applied as the GskTransform\n  // of the child's allocation by the container's layout manager.\n  transform: TransformPart[]\n}>\n\n// RN pointerEvents (also allowed in styles since RN 0.71); behavioral, so\n// it belongs to neither the layout nor the visual bucket — splitStyle\n// ignores it and View reads it from the flattened style.\nexport type PointerEventsValue = \"auto\" | \"none\" | \"box-none\" | \"box-only\"\n\nexport type FlatStyle = LayoutStyle &\n  VisualStyle & {\n    pointerEvents?: PointerEventsValue\n  }\n\n// Style prop as components accept it: single object, array (with falsy holes).\nexport type StyleProp<T = FlatStyle> =\n  T | null | undefined | false | ReadonlyArray<StyleProp<T>>\n\n// Result of classifying a flattened style (produced by the style system):\nexport type SplitStyle = {\n  layout: LayoutStyle\n  visual: VisualStyle\n}\n\n// --- layout engine ----------------------------------------------------------\n\nexport type Rect = {\n  x: number\n  y: number\n  width: number\n  height: number\n}\n\nexport type MeasureConstraintMode = \"undefined\" | \"exactly\" | \"at-most\"\n\nexport type MeasureSize = { width: number; height: number }\n\n// Measure callback for leaf nodes (text, images): implemented by components\n// using bridge probes; called by the engine during Yoga layout passes.\nexport type MeasureFn = (\n  width: number,\n  widthMode: MeasureConstraintMode,\n  height: number,\n  heightMode: MeasureConstraintMode,\n) => MeasureSize\n\n// Handle the layout engine gives every mounted component.\nexport interface LayoutNodeApi {\n  setStyle(style: LayoutStyle): void\n  setMeasureFn(measure: MeasureFn | null): void\n  markDirty(): void\n  getRect(): Rect | null\n  setOnLayout(callback: ((rect: Rect) => void) | null): void\n}\n\n// --- subscriptions ----------------------------------------------------------\n\nexport type SubscriptionHandle = { remove(): void }\n"]}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sEAAsE","sourcesContent":["// Shared contracts between the layout engine, the style system, the API\n// modules and the components — the one module every layer may import.\n\n// --- style ------------------------------------------------------------------\n\nexport type DimensionValue = number | `${number}%` | \"auto\"\n\nexport type FlexAlignType =\n  \"flex-start\" | \"flex-end\" | \"center\" | \"stretch\" | \"baseline\"\n\n// Layout-affecting props: classified by the style system, consumed by the\n// layout engine, which maps them onto Yoga node setters.\nexport type LayoutStyle = Partial<{\n  alignContent:\n    | \"flex-start\"\n    | \"flex-end\"\n    | \"center\"\n    | \"stretch\"\n    | \"space-between\"\n    | \"space-around\"\n  alignItems: FlexAlignType\n  alignSelf: \"auto\" | FlexAlignType\n  aspectRatio: number | string\n  bottom: DimensionValue\n  columnGap: number\n  direction: \"inherit\" | \"ltr\" | \"rtl\"\n  display: \"none\" | \"flex\"\n  flex: number\n  flexBasis: DimensionValue\n  flexDirection: \"row\" | \"row-reverse\" | \"column\" | \"column-reverse\"\n  flexGrow: number\n  flexShrink: number\n  flexWrap: \"wrap\" | \"nowrap\" | \"wrap-reverse\"\n  gap: number\n  height: DimensionValue\n  justifyContent:\n    | \"flex-start\"\n    | \"flex-end\"\n    | \"center\"\n    | \"space-between\"\n    | \"space-around\"\n    | \"space-evenly\"\n  left: DimensionValue\n  margin: DimensionValue\n  marginBottom: DimensionValue\n  marginHorizontal: DimensionValue\n  marginLeft: DimensionValue\n  marginRight: DimensionValue\n  marginTop: DimensionValue\n  marginVertical: DimensionValue\n  maxHeight: DimensionValue\n  maxWidth: DimensionValue\n  minHeight: DimensionValue\n  minWidth: DimensionValue\n  overflow: \"visible\" | \"hidden\" | \"scroll\"\n  padding: DimensionValue\n  paddingBottom: DimensionValue\n  paddingHorizontal: DimensionValue\n  paddingLeft: DimensionValue\n  paddingRight: DimensionValue\n  paddingTop: DimensionValue\n  paddingVertical: DimensionValue\n  position: \"absolute\" | \"relative\" | \"static\"\n  right: DimensionValue\n  rowGap: number\n  top: DimensionValue\n  width: DimensionValue\n}>\n\nexport type Angle = `${number}deg` | `${number}rad`\n\nexport type TransformPart =\n  | { translateX: number }\n  | { translateY: number }\n  | { scale: number }\n  | { scaleX: number }\n  | { scaleY: number }\n  | { rotate: Angle }\n  // RN's 2D alias for `rotate` (rotation about the Z axis).\n  | { rotateZ: Angle }\n\n// A 2D affine transform in the component order GSK and cairo use:\n//   x' = xx * x + xy * y + dx\n//   y' = yx * x + yy * y + dy\n// This is exactly the argument order of gsk_transform_matrix2d(), so a\n// composed TransformPart[] reaches GTK in a single FFI call.\nexport type Transform2D = {\n  xx: number\n  yx: number\n  xy: number\n  yy: number\n  dx: number\n  dy: number\n}\n\n// Visual props: classified by the style system, compiled into GTK CSS\n// classes via the bridge `css` helper. Text-specific props apply to <Text>.\n// One shadow of a `boxShadow`, field for field react-native's own\n// `BoxShadowValue` (RN 0.76+). Lengths are RN DIPs when numeric; the string\n// form accepts a bare number or `px` and nothing else, which is exactly what\n// RN's processBoxShadow.js accepts.\nexport type BoxShadowValue = {\n  offsetX: number | string\n  offsetY: number | string\n  color?: string\n  blurRadius?: number | string\n  spreadDistance?: number | string\n  inset?: boolean\n}\n\nexport type TextDecorationLine =\n  \"none\" | \"underline\" | \"line-through\" | \"underline line-through\"\n\nexport type VisualStyle = Partial<{\n  backgroundColor: string\n  // RN 0.76+. Both forms RN takes: a CSS `box-shadow` string or the\n  // structured array. Compiled by style/box-shadow.ts rather than forwarded,\n  // so colours go through the same normalizer as every other colour prop.\n  boxShadow: string | readonly BoxShadowValue[]\n  borderBottomColor: string\n  borderBottomLeftRadius: number\n  borderBottomRightRadius: number\n  borderBottomWidth: number\n  borderColor: string\n  borderLeftColor: string\n  borderLeftWidth: number\n  borderRadius: number\n  borderRightColor: string\n  borderRightWidth: number\n  borderStyle: \"solid\" | \"dotted\" | \"dashed\"\n  borderTopColor: string\n  borderTopLeftRadius: number\n  borderTopRightRadius: number\n  borderTopWidth: number\n  borderWidth: number\n  color: string\n  fontFamily: string\n  fontSize: number\n  fontStyle: \"normal\" | \"italic\"\n  fontWeight:\n    | \"normal\"\n    | \"bold\"\n    | \"100\"\n    | \"200\"\n    | \"300\"\n    | \"400\"\n    | \"500\"\n    | \"600\"\n    | \"700\"\n    | \"800\"\n    | \"900\"\n  letterSpacing: number\n  lineHeight: number\n  opacity: number\n  // RN 0.77+. A ring drawn around the border box that takes no layout space\n  // — CSS `outline`, which GTK4 implements natively and Adwaita itself uses\n  // for every focus ring in the theme.\n  outlineColor: string\n  outlineOffset: number\n  outlineStyle: \"solid\" | \"dotted\" | \"dashed\"\n  outlineWidth: number\n  // NOT emitted to CSS (no such GTK CSS property): the Text component applies\n  // it via label props using the pure style/text-align helper.\n  textAlign: \"auto\" | \"left\" | \"right\" | \"center\" | \"justify\"\n  // NOT emitted to CSS either — GTK4 CSS has no widget `text-decoration`.\n  // Pango carries it, so the Text component turns it into the label's\n  // attribute list using the pure style/text-decoration helper.\n  textDecorationLine: TextDecorationLine\n  // NOT emitted to CSS (GTK4 has no widget `transform` property): composed\n  // into a Transform2D by style/transform.ts and applied as the GskTransform\n  // of the child's allocation by the container's layout manager.\n  transform: TransformPart[]\n}>\n\n// RN pointerEvents (also allowed in styles since RN 0.71); behavioral, so\n// it belongs to neither the layout nor the visual bucket — splitStyle\n// consumes it without routing it and View reads it from the flattened style.\nexport type PointerEventsValue = \"auto\" | \"none\" | \"box-none\" | \"box-only\"\n\n// The third bucket, named rather than inlined into FlatStyle below: props\n// that are supported but consumed by the component that owns the behavior,\n// not by either half of the style pipeline. Having a name for it is what\n// lets splitStyle state which keys it deliberately routes nowhere, instead\n// of reporting them as unknown — the drift this type was born from.\nexport type BehavioralStyle = Partial<{\n  pointerEvents: PointerEventsValue\n}>\n\nexport type FlatStyle = LayoutStyle & VisualStyle & BehavioralStyle\n\n// Style prop as components accept it: single object, array (with falsy holes).\nexport type StyleProp<T = FlatStyle> =\n  T | null | undefined | false | ReadonlyArray<StyleProp<T>>\n\n// Result of classifying a flattened style (produced by the style system):\nexport type SplitStyle = {\n  layout: LayoutStyle\n  visual: VisualStyle\n}\n\n// --- layout engine ----------------------------------------------------------\n\nexport type Rect = {\n  x: number\n  y: number\n  width: number\n  height: number\n}\n\nexport type MeasureConstraintMode = \"undefined\" | \"exactly\" | \"at-most\"\n\nexport type MeasureSize = { width: number; height: number }\n\n// Measure callback for leaf nodes (text, images): implemented by components\n// using bridge probes; called by the engine during Yoga layout passes.\nexport type MeasureFn = (\n  width: number,\n  widthMode: MeasureConstraintMode,\n  height: number,\n  heightMode: MeasureConstraintMode,\n) => MeasureSize\n\n// Handle the layout engine gives every mounted component.\nexport interface LayoutNodeApi {\n  setStyle(style: LayoutStyle): void\n  setMeasureFn(measure: MeasureFn | null): void\n  markDirty(): void\n  getRect(): Rect | null\n  setOnLayout(callback: ((rect: Rect) => void) | null): void\n}\n\n// --- subscriptions ----------------------------------------------------------\n\nexport type SubscriptionHandle = { remove(): void }\n"]}

package/dist/gtk/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./widgets.generated";
 export { Gdk, Gio, GLib, GObject, Gtk, Pango } from "../gtkx/bridge/index";
-export { GMenu, GSimpleAction, GtkAdjustment, GtkDragSource, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "../gtkx/bridge/index";
+export { GMenu, GtkAdjustment, GtkDragSource, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "../gtkx/bridge/index";
+export { ApplicationActions, GSimpleAction, WindowActions, WindowControllers, type ApplicationActionsProps, type GSimpleActionProps, type WindowActionsProps, type WindowControllersProps, } from "./window-actions";
 export { useBindSetting, useSetting, type SettingsSchema, type SettingsSchemaKeys, type SettingValue, } from "../gtkx/bridge/index";
 export { css, cx, injectGlobal } from "../gtkx/bridge/index";
 export { quit, useApplication, useParentWindow } from "../gtkx/bridge/index";

package/dist/gtk/index.js

@@ -14,7 +14,14 @@ export { Gdk, Gio, GLib, GObject, Gtk, Pango } from "../gtkx/bridge/index";
 // adjustment (the model objects `GtkTextView`/`GtkSpinRow`-style widgets
 // bind to), keyboard shortcuts, and the two drag-and-drop controllers. See
 // docs/platform-layer.md "Unwrapped by necessity".
-export { GMenu, GSimpleAction, GtkAdjustment, GtkDragSource, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "../gtkx/bridge/index";
+export { GMenu, GtkAdjustment, GtkDragSource, GtkDropTarget, GtkShortcut, GtkShortcutController, GtkTextBuffer, } from "../gtkx/bridge/index";
+// Window and application actions declared inside the app tree instead of
+// around it (the AppRegistry options they replace cannot see app context —
+// see window-actions.tsx). GSimpleAction comes from here rather than
+// straight from the bridge because inside these components it arbitrates
+// duplicate action names; on every other path it is gtkx's element,
+// unchanged.
+export { ApplicationActions, GSimpleAction, WindowActions, WindowControllers, } from "./window-actions";
 // GSettings: reads and writes backed by a compiled `.gschema.xml` schema.
 // `useSetting`/`useBindSetting` come straight from @gtkx/react; loading a
 // `.gschema.xml` file into the `SettingsSchema` object they expect is a

package/dist/gtk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gtk/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8DAA8D;AAC9D,yCAAyC;AACzC,0EAA0E;AAC1E,cAAc,qBAAqB,CAAA;AAEnC,4EAA4E;AAC5E,8EAA8E;AAC9E,mCAAmC;AACnC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE1E,oEAAoE;AACpE,0EAA0E;AAC1E,oEAAoE;AACpE,mEAAmE;AACnE,yEAAyE;AACzE,2EAA2E;AAC3E,mDAAmD;AACnD,OAAO,EACL,KAAK,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,sBAAsB,CAAA;AAE7B,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;AACxE,mDAAmD;AACnD,OAAO,EACL,cAAc,EACd,UAAU,GAIX,MAAM,sBAAsB,CAAA;AAE7B,oEAAoE;AACpE,0EAA0E;AAC1E,sEAAsE;AACtE,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,6DAA6D;AAC7D,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE5D,yEAAyE;AACzE,wEAAwE;AACxE,uEAAuE;AACvE,6DAA6D;AAC7D,yEAAyE;AACzE,mEAAmE;AACnE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA","sourcesContent":["// The full GTK widget surface lives in a generated file: every Gtk.Widget\n// subclass gtkx binds, wrapped so React Native drives it. See\n// scripts/generate-widget-surface.ts and\n// scripts/widget-surface/classification.json for how the list is derived.\nexport * from \"./widgets.generated\"\n\n// The GTK namespaces themselves, exported as values because they carry both\n// the enums you need at runtime — `hscrollbarPolicy={Gtk.PolicyType.NEVER}` —\n// and the types you need for refs.\nexport { Gdk, Gio, GLib, GObject, Gtk, Pango } from \"../gtkx/bridge/index\"\n\n// Auxiliary JSX elements that are not Gtk.Widget subclasses, so the\n// generated widget surface above never sees them — real building blocks a\n// non-trivial app still needs: actions and menus (Gio, used through\n// `Gtk.Application`/`Gtk.ApplicationWindow`), a text buffer and an\n// adjustment (the model objects `GtkTextView`/`GtkSpinRow`-style widgets\n// bind to), keyboard shortcuts, and the two drag-and-drop controllers. See\n// docs/platform-layer.md \"Unwrapped by necessity\".\nexport {\n  GMenu,\n  GSimpleAction,\n  GtkAdjustment,\n  GtkDragSource,\n  GtkDropTarget,\n  GtkShortcut,\n  GtkShortcutController,\n  GtkTextBuffer,\n} from \"../gtkx/bridge/index\"\n\n// GSettings: reads and writes backed by a compiled `.gschema.xml` schema.\n// `useSetting`/`useBindSetting` come straight from @gtkx/react; loading a\n// `.gschema.xml` file into the `SettingsSchema` object they expect is a\n// build-time concern (see docs/platform-layer.md).\nexport {\n  useBindSetting,\n  useSetting,\n  type SettingsSchema,\n  type SettingsSchemaKeys,\n  type SettingValue,\n} from \"../gtkx/bridge/index\"\n\n// @gtkx/css — a real GTK CSS class from a tagged template, the same\n// mechanism the style prop's visual half uses under the hood. Re-exported\n// here rather than left to a direct @gtkx/css dependency for the same\n// reason the namespaces above are: one subpath for the whole gtkx toolkit\n// surface, not just Gtk.Widget subclasses. `GObject` above is exported\n// mainly for `GObject.Value` — constructing a boxed value is required by\n// APIs like `Adw.Breakpoint.addSetter`, which reject a bare JS primitive\n// (see docs/platform-layer.md, \"Two ways to react to size\").\nexport { css, cx, injectGlobal } from \"../gtkx/bridge/index\"\n\n// The window and application AppRegistry itself sits on: useParentWindow\n// reaches the Gtk.Window ancestor (for anything not modeled by a prop —\n// e.g. binding a GSettings key to its own defaultWidth/defaultHeight),\n// useApplication reaches the Adw.Application (e.g. to send a\n// Gio.Notification), quit tears the whole app down programmatically (the\n// same function AppRegistry wires to a window's own close button).\nexport { quit, useApplication, useParentWindow } from \"../gtkx/bridge/index\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gtk/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8DAA8D;AAC9D,yCAAyC;AACzC,0EAA0E;AAC1E,cAAc,qBAAqB,CAAA;AAEnC,4EAA4E;AAC5E,8EAA8E;AAC9E,mCAAmC;AACnC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE1E,oEAAoE;AACpE,0EAA0E;AAC1E,oEAAoE;AACpE,mEAAmE;AACnE,yEAAyE;AACzE,2EAA2E;AAC3E,mDAAmD;AACnD,OAAO,EACL,KAAK,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,sBAAsB,CAAA;AAE7B,yEAAyE;AACzE,2EAA2E;AAC3E,qEAAqE;AACrE,yEAAyE;AACzE,oEAAoE;AACpE,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,iBAAiB,GAKlB,MAAM,kBAAkB,CAAA;AAEzB,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;AACxE,mDAAmD;AACnD,OAAO,EACL,cAAc,EACd,UAAU,GAIX,MAAM,sBAAsB,CAAA;AAE7B,oEAAoE;AACpE,0EAA0E;AAC1E,sEAAsE;AACtE,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,6DAA6D;AAC7D,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE5D,yEAAyE;AACzE,wEAAwE;AACxE,uEAAuE;AACvE,6DAA6D;AAC7D,yEAAyE;AACzE,mEAAmE;AACnE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA","sourcesContent":["// The full GTK widget surface lives in a generated file: every Gtk.Widget\n// subclass gtkx binds, wrapped so React Native drives it. See\n// scripts/generate-widget-surface.ts and\n// scripts/widget-surface/classification.json for how the list is derived.\nexport * from \"./widgets.generated\"\n\n// The GTK namespaces themselves, exported as values because they carry both\n// the enums you need at runtime — `hscrollbarPolicy={Gtk.PolicyType.NEVER}` —\n// and the types you need for refs.\nexport { Gdk, Gio, GLib, GObject, Gtk, Pango } from \"../gtkx/bridge/index\"\n\n// Auxiliary JSX elements that are not Gtk.Widget subclasses, so the\n// generated widget surface above never sees them — real building blocks a\n// non-trivial app still needs: actions and menus (Gio, used through\n// `Gtk.Application`/`Gtk.ApplicationWindow`), a text buffer and an\n// adjustment (the model objects `GtkTextView`/`GtkSpinRow`-style widgets\n// bind to), keyboard shortcuts, and the two drag-and-drop controllers. See\n// docs/platform-layer.md \"Unwrapped by necessity\".\nexport {\n  GMenu,\n  GtkAdjustment,\n  GtkDragSource,\n  GtkDropTarget,\n  GtkShortcut,\n  GtkShortcutController,\n  GtkTextBuffer,\n} from \"../gtkx/bridge/index\"\n\n// Window and application actions declared inside the app tree instead of\n// around it (the AppRegistry options they replace cannot see app context —\n// see window-actions.tsx). GSimpleAction comes from here rather than\n// straight from the bridge because inside these components it arbitrates\n// duplicate action names; on every other path it is gtkx's element,\n// unchanged.\nexport {\n  ApplicationActions,\n  GSimpleAction,\n  WindowActions,\n  WindowControllers,\n  type ApplicationActionsProps,\n  type GSimpleActionProps,\n  type WindowActionsProps,\n  type WindowControllersProps,\n} from \"./window-actions\"\n\n// GSettings: reads and writes backed by a compiled `.gschema.xml` schema.\n// `useSetting`/`useBindSetting` come straight from @gtkx/react; loading a\n// `.gschema.xml` file into the `SettingsSchema` object they expect is a\n// build-time concern (see docs/platform-layer.md).\nexport {\n  useBindSetting,\n  useSetting,\n  type SettingsSchema,\n  type SettingsSchemaKeys,\n  type SettingValue,\n} from \"../gtkx/bridge/index\"\n\n// @gtkx/css — a real GTK CSS class from a tagged template, the same\n// mechanism the style prop's visual half uses under the hood. Re-exported\n// here rather than left to a direct @gtkx/css dependency for the same\n// reason the namespaces above are: one subpath for the whole gtkx toolkit\n// surface, not just Gtk.Widget subclasses. `GObject` above is exported\n// mainly for `GObject.Value` — constructing a boxed value is required by\n// APIs like `Adw.Breakpoint.addSetter`, which reject a bare JS primitive\n// (see docs/platform-layer.md, \"Two ways to react to size\").\nexport { css, cx, injectGlobal } from \"../gtkx/bridge/index\"\n\n// The window and application AppRegistry itself sits on: useParentWindow\n// reaches the Gtk.Window ancestor (for anything not modeled by a prop —\n// e.g. binding a GSettings key to its own defaultWidth/defaultHeight),\n// useApplication reaches the Adw.Application (e.g. to send a\n// Gio.Notification), quit tears the whole app down programmatically (the\n// same function AppRegistry wires to a window's own close button).\nexport { quit, useApplication, useParentWindow } from \"../gtkx/bridge/index\"\n"]}

package/dist/gtk/widgets.generated.d.ts

@@ -14,7 +14,6 @@ export declare const GtkColorDialogButton: React.ComponentType<import("@gtkx/jsx
 export declare const GtkColumnView: React.ComponentType<import("@gtkx/jsx/gtk").GtkColumnViewProps<import("@gtkx/gi/gtk").ColumnView> & import("../common").ReactNativeLayoutProps>;
 export declare const GtkComboBox: React.ComponentType<import("@gtkx/jsx/gtk").GtkComboBoxProps<import("@gtkx/gi/gtk").ComboBox> & import("../common").ReactNativeLayoutProps>;
 export declare const GtkComboBoxText: React.ComponentType<import("@gtkx/jsx/gtk").GtkComboBoxTextProps<import("@gtkx/gi/gtk").ComboBoxText> & import("../common").ReactNativeLayoutProps>;
-export declare const GtkDragIcon: React.ComponentType<import("@gtkx/jsx/gtk").GtkDragIconProps<import("@gtkx/gi/gtk").DragIcon> & import("../common").ReactNativeLayoutProps>;
 export declare const GtkDrawingArea: React.ComponentType<import("@gtkx/jsx/gtk").GtkDrawingAreaProps<import("@gtkx/gi/gtk").DrawingArea> & import("../common").ReactNativeLayoutProps>;
 export declare const GtkDropDown: React.ComponentType<import("@gtkx/jsx/gtk").GtkDropDownProps<import("@gtkx/gi/gtk").DropDown> & import("../common").ReactNativeLayoutProps>;
 export declare const GtkEditableLabel: React.ComponentType<import("@gtkx/jsx/gtk").GtkEditableLabelProps<import("@gtkx/gi/gtk").EditableLabel> & import("../common").ReactNativeLayoutProps>;
@@ -85,19 +84,20 @@ export declare const GtkViewport: React.ComponentType<import("@gtkx/jsx/gtk").Gt
 export declare const GtkVolumeButton: React.ComponentType<import("@gtkx/jsx/gtk").GtkVolumeButtonProps<import("@gtkx/gi/gtk").VolumeButton> & import("../common").ReactNativeLayoutProps>;
 export declare const GtkWindowControls: React.ComponentType<import("@gtkx/jsx/gtk").GtkWindowControlsProps<import("@gtkx/gi/gtk").WindowControls> & import("../common").ReactNativeLayoutProps>;
 export declare const GtkWindowHandle: React.ComponentType<import("@gtkx/jsx/gtk").GtkWindowHandleProps<import("@gtkx/gi/gtk").WindowHandle> & import("../common").ReactNativeLayoutProps>;
-export { GtkAboutDialog, // toplevel (derives Gtk.Window)
-GtkAppChooserDialog, // toplevel (derives Gtk.Window)
-GtkApplicationWindow, // toplevel (derives Gtk.Window)
-GtkAssistant, // toplevel (derives Gtk.Window)
-GtkColorChooserDialog, // toplevel (derives Gtk.Window)
-GtkDialog, // toplevel (derives Gtk.Window)
-GtkFileChooserDialog, // toplevel (derives Gtk.Window)
+export { GtkAboutDialog, // toplevel (implements GtkRoot)
+GtkAppChooserDialog, // toplevel (implements GtkRoot)
+GtkApplicationWindow, // toplevel (implements GtkRoot)
+GtkAssistant, // toplevel (implements GtkRoot)
+GtkColorChooserDialog, // toplevel (implements GtkRoot)
+GtkDialog, // toplevel (implements GtkRoot)
+GtkDragIcon, // toplevel (implements GtkRoot)
+GtkFileChooserDialog, // toplevel (implements GtkRoot)
 GtkFlowBoxChild, // child-only (derives Gtk.FlowBoxChild)
-GtkFontChooserDialog, // toplevel (derives Gtk.Window)
+GtkFontChooserDialog, // toplevel (implements GtkRoot)
 GtkListBoxRow, // child-only (derives Gtk.ListBoxRow)
-GtkMessageDialog, // toplevel (derives Gtk.Window)
-GtkPageSetupUnixDialog, // toplevel (derives Gtk.Window)
-GtkPrintUnixDialog, // toplevel (derives Gtk.Window)
-GtkShortcutsWindow, // toplevel (derives Gtk.Window)
+GtkMessageDialog, // toplevel (implements GtkRoot)
+GtkPageSetupUnixDialog, // toplevel (implements GtkRoot)
+GtkPrintUnixDialog, // toplevel (implements GtkRoot)
+GtkShortcutsWindow, // toplevel (implements GtkRoot)
 GtkWindow, } from "../gtkx/bridge/widgets.generated";
-export declare const GTK_WRAPPED_WIDGET_NAMES: readonly ["GtkActionBar", "GtkAppChooserButton", "GtkAppChooserWidget", "GtkAspectFrame", "GtkBox", "GtkButton", "GtkCalendar", "GtkCellView", "GtkCenterBox", "GtkCheckButton", "GtkColorButton", "GtkColorChooserWidget", "GtkColorDialogButton", "GtkColumnView", "GtkComboBox", "GtkComboBoxText", "GtkDragIcon", "GtkDrawingArea", "GtkDropDown", "GtkEditableLabel", "GtkEmojiChooser", "GtkEntry", "GtkExpander", "GtkFileChooserWidget", "GtkFixed", "GtkFlowBox", "GtkFontButton", "GtkFontChooserWidget", "GtkFontDialogButton", "GtkFrame", "GtkGLArea", "GtkGraphicsOffload", "GtkGrid", "GtkGridView", "GtkHeaderBar", "GtkIconView", "GtkImage", "GtkInfoBar", "GtkInscription", "GtkLabel", "GtkLevelBar", "GtkLinkButton", "GtkListBox", "GtkListView", "GtkLockButton", "GtkMediaControls", "GtkMenuButton", "GtkNotebook", "GtkOverlay", "GtkPaned", "GtkPasswordEntry", "GtkPicture", "GtkPopover", "GtkPopoverBin", "GtkPopoverMenu", "GtkPopoverMenuBar", "GtkProgressBar", "GtkRange", "GtkRevealer", "GtkScale", "GtkScaleButton", "GtkScrollbar", "GtkScrolledWindow", "GtkSearchBar", "GtkSearchEntry", "GtkSeparator", "GtkShortcutLabel", "GtkShortcutsGroup", "GtkShortcutsSection", "GtkShortcutsShortcut", "GtkSpinButton", "GtkSpinner", "GtkStack", "GtkStackSidebar", "GtkStackSwitcher", "GtkStatusbar", "GtkSwitch", "GtkText", "GtkTextView", "GtkToggleButton", "GtkTreeExpander", "GtkTreeView", "GtkVideo", "GtkViewport", "GtkVolumeButton", "GtkWindowControls", "GtkWindowHandle"];
+export declare const GTK_WRAPPED_WIDGET_NAMES: readonly ["GtkActionBar", "GtkAppChooserButton", "GtkAppChooserWidget", "GtkAspectFrame", "GtkBox", "GtkButton", "GtkCalendar", "GtkCellView", "GtkCenterBox", "GtkCheckButton", "GtkColorButton", "GtkColorChooserWidget", "GtkColorDialogButton", "GtkColumnView", "GtkComboBox", "GtkComboBoxText", "GtkDrawingArea", "GtkDropDown", "GtkEditableLabel", "GtkEmojiChooser", "GtkEntry", "GtkExpander", "GtkFileChooserWidget", "GtkFixed", "GtkFlowBox", "GtkFontButton", "GtkFontChooserWidget", "GtkFontDialogButton", "GtkFrame", "GtkGLArea", "GtkGraphicsOffload", "GtkGrid", "GtkGridView", "GtkHeaderBar", "GtkIconView", "GtkImage", "GtkInfoBar", "GtkInscription", "GtkLabel", "GtkLevelBar", "GtkLinkButton", "GtkListBox", "GtkListView", "GtkLockButton", "GtkMediaControls", "GtkMenuButton", "GtkNotebook", "GtkOverlay", "GtkPaned", "GtkPasswordEntry", "GtkPicture", "GtkPopover", "GtkPopoverBin", "GtkPopoverMenu", "GtkPopoverMenuBar", "GtkProgressBar", "GtkRange", "GtkRevealer", "GtkScale", "GtkScaleButton", "GtkScrollbar", "GtkScrolledWindow", "GtkSearchBar", "GtkSearchEntry", "GtkSeparator", "GtkShortcutLabel", "GtkShortcutsGroup", "GtkShortcutsSection", "GtkShortcutsShortcut", "GtkSpinButton", "GtkSpinner", "GtkStack", "GtkStackSidebar", "GtkStackSwitcher", "GtkStatusbar", "GtkSwitch", "GtkText", "GtkTextView", "GtkToggleButton", "GtkTreeExpander", "GtkTreeView", "GtkVideo", "GtkViewport", "GtkVolumeButton", "GtkWindowControls", "GtkWindowHandle"];