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

package/dist/components/host-node.d.ts

@@ -7,4 +7,11 @@ export type HostNode = {
     widgetRef: RefObject<Gtk.Box | null>;
 };
 export declare const HostNodeContext: React.Context<HostNode | null>;
+export type SlotLocation = {
+    /** The widget this content was handed to, e.g. "AdwBottomSheet". */
+    widget: string;
+    /** The slot property, e.g. "sheet" — or null for an ordinary child. */
+    slot: string | null;
+};
+export declare const SlotContext: React.Context<SlotLocation | null>;
 export declare const useHostNode: () => HostNode;

package/dist/components/host-node.js

@@ -1,9 +1,34 @@
 import { createContext, useContext } from "react";
 export const HostNodeContext = createContext(null);
+export const SlotContext = createContext(null);
+const slotError = ({ widget, slot }) => {
+    // The two shapes differ only in how you write the wrapper, so the message
+    // shows the caller their own syntax rather than a generic one.
+    const where = slot
+        ? `${widget}'s \`${slot}\` slot`
+        : `${widget}, as its child`;
+    const wrap = (root) => slot
+        ? `  ${slot}={<${root}>…</${root}>}`
+        : `  <${widget}>…</${widget}> → <${widget}><${root}>…</${root}></${widget}>`;
+    return (`react-native-gtkx: React Native content was put in ${where} without a layout root.\n` +
+        `A GTK widget hands out a rectangle, and React Native needs a root to lay out inside it. Wrap the content:\n` +
+        `${wrap("SlotContent")} — fill the area (a page body, a pane, a content area)\n` +
+        `${wrap("IntrinsicContent")} — size the area to the content (a bar, a header slot, a row)\n` +
+        // The subpath is named without quoting it as a specifier: the metro-preset
+        // test scans src for bare imports with a regex, and an import-shaped
+        // sentence in a string literal reads to it exactly like a real one.
+        `Both are exported by react-native-gtkx/common. GTK widgets need neither — they are what a widget takes natively.`);
+};
 export const useHostNode = () => {
     const host = useContext(HostNodeContext);
+    // One extra context read per layout child. Deliberate: it is what turns the
+    // single most confusing failure on this platform — content silently laid
+    // out against the wrong rectangle — into a sentence naming where it landed.
+    const slot = useContext(SlotContext);
     if (host === null) {
-        throw new Error("react-native-gtkx components must be rendered inside AppRegistry.runApplication() or a <Root>");
+        throw new Error(slot
+            ? slotError(slot)
+            : "react-native-gtkx components must be rendered inside AppRegistry.runApplication() or a <Root>");
     }
     return host;
 };

package/dist/components/host-node.js.map

@@ -1 +1 @@
-{"version":3,"file":"host-node.js","sourceRoot":"","sources":["../../src/components/host-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AAajE,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAkB,IAAI,CAAC,CAAA;AAEnE,MAAM,CAAC,MAAM,WAAW,GAAG,GAAa,EAAE;IACxC,MAAM,IAAI,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;IACxC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA","sourcesContent":["import { createContext, useContext, type RefObject } from \"react\"\nimport type { LayoutEngine, LayoutNode } from \"../layout/index\"\nimport type { Gtk } from \"../gtkx/bridge/index\"\n\n// One per mounted container (Root or View): children register their layout\n// nodes here and commit rects into the store read by the parent's\n// RnGtkxLayout allocate().\nexport type HostNode = {\n  engine: LayoutEngine\n  node: LayoutNode\n  widgetRef: RefObject<Gtk.Box | null>\n}\n\nexport const HostNodeContext = createContext<HostNode | null>(null)\n\nexport const useHostNode = (): HostNode => {\n  const host = useContext(HostNodeContext)\n  if (host === null) {\n    throw new Error(\n      \"react-native-gtkx components must be rendered inside AppRegistry.runApplication() or a <Root>\",\n    )\n  }\n  return host\n}\n"]}
+{"version":3,"file":"host-node.js","sourceRoot":"","sources":["../../src/components/host-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AAajE,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAkB,IAAI,CAAC,CAAA;AAenE,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAA;AAEnE,MAAM,SAAS,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAgB,EAAU,EAAE;IAC3D,0EAA0E;IAC1E,+DAA+D;IAC/D,MAAM,KAAK,GAAG,IAAI;QAChB,CAAC,CAAC,GAAG,MAAM,QAAQ,IAAI,SAAS;QAChC,CAAC,CAAC,GAAG,MAAM,gBAAgB,CAAA;IAC7B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE,CACpC,IAAI;QACF,CAAC,CAAC,KAAK,IAAI,MAAM,IAAI,OAAO,IAAI,IAAI;QACpC,CAAC,CAAC,MAAM,MAAM,OAAO,MAAM,QAAQ,MAAM,KAAK,IAAI,OAAO,IAAI,MAAM,MAAM,GAAG,CAAA;IAChF,OAAO,CACL,sDAAsD,KAAK,2BAA2B;QACtF,6GAA6G;QAC7G,GAAG,IAAI,CAAC,aAAa,CAAC,0DAA0D;QAChF,GAAG,IAAI,CAAC,kBAAkB,CAAC,iEAAiE;QAC5F,2EAA2E;QAC3E,qEAAqE;QACrE,oEAAoE;QACpE,kHAAkH,CACnH,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,GAAa,EAAE;IACxC,MAAM,IAAI,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;IACxC,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACpC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,IAAI;YACF,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;YACjB,CAAC,CAAC,+FAA+F,CACpG,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA","sourcesContent":["import { createContext, useContext, type RefObject } from \"react\"\nimport type { LayoutEngine, LayoutNode } from \"../layout/index\"\nimport type { Gtk } from \"../gtkx/bridge/index\"\n\n// One per mounted container (Root or View): children register their layout\n// nodes here and commit rects into the store read by the parent's\n// RnGtkxLayout allocate().\nexport type HostNode = {\n  engine: LayoutEngine\n  node: LayoutNode\n  widgetRef: RefObject<Gtk.Box | null>\n}\n\nexport const HostNodeContext = createContext<HostNode | null>(null)\n\n// Which widget content area the current subtree was handed to, when it was\n// handed to one. Set by wrapReactNative for every element-valued prop it\n// forwards AND for the widget's children (see ../common/widget), and read\n// ONLY to build the error below — the boundary clears the layout root, so\n// React Native content that lands inside a widget without bringing its own\n// root has to be told where it is, and what to wrap it in.\nexport type SlotLocation = {\n  /** The widget this content was handed to, e.g. \"AdwBottomSheet\". */\n  widget: string\n  /** The slot property, e.g. \"sheet\" — or null for an ordinary child. */\n  slot: string | null\n}\n\nexport const SlotContext = createContext<SlotLocation | null>(null)\n\nconst slotError = ({ widget, slot }: SlotLocation): string => {\n  // The two shapes differ only in how you write the wrapper, so the message\n  // shows the caller their own syntax rather than a generic one.\n  const where = slot\n    ? `${widget}'s \\`${slot}\\` slot`\n    : `${widget}, as its child`\n  const wrap = (root: string): string =>\n    slot\n      ? `  ${slot}={<${root}>…</${root}>}`\n      : `  <${widget}>…</${widget}> → <${widget}><${root}>…</${root}></${widget}>`\n  return (\n    `react-native-gtkx: React Native content was put in ${where} without a layout root.\\n` +\n    `A GTK widget hands out a rectangle, and React Native needs a root to lay out inside it. Wrap the content:\\n` +\n    `${wrap(\"SlotContent\")} — fill the area (a page body, a pane, a content area)\\n` +\n    `${wrap(\"IntrinsicContent\")} — size the area to the content (a bar, a header slot, a row)\\n` +\n    // The subpath is named without quoting it as a specifier: the metro-preset\n    // test scans src for bare imports with a regex, and an import-shaped\n    // sentence in a string literal reads to it exactly like a real one.\n    `Both are exported by react-native-gtkx/common. GTK widgets need neither — they are what a widget takes natively.`\n  )\n}\n\nexport const useHostNode = (): HostNode => {\n  const host = useContext(HostNodeContext)\n  // One extra context read per layout child. Deliberate: it is what turns the\n  // single most confusing failure on this platform — content silently laid\n  // out against the wrong rectangle — into a sentence naming where it landed.\n  const slot = useContext(SlotContext)\n  if (host === null) {\n    throw new Error(\n      slot\n        ? slotError(slot)\n        : \"react-native-gtkx components must be rendered inside AppRegistry.runApplication() or a <Root>\",\n    )\n  }\n  return host\n}\n"]}

package/dist/components/image.d.ts

@@ -1,8 +1,12 @@
+import { type Ref } from "react";
 import type { StyleProp } from "../contracts";
+import { type MeasureHandle } from "./measure";
 import { type LayoutEvent } from "./use-layout-child";
 export type ImageSource = {
     uri: string;
 } | string;
+/** RN's imperative geometry methods, on an `Image` ref. */
+export type ImageHandle = MeasureHandle;
 export type ImageProps = {
     source: ImageSource;
     style?: StyleProp;
@@ -15,5 +19,6 @@ export type ImageProps = {
         };
     }) => void;
     testID?: string;
+    ref?: Ref<ImageHandle>;
 };
-export declare const Image: ({ source, style, resizeMode, onLayout, onLoad, onError, testID, }: ImageProps) => React.JSX.Element;
+export declare const Image: ({ source, style, resizeMode, onLayout, onLoad, onError, testID, ref, }: ImageProps) => React.JSX.Element;

package/dist/components/image.js

@@ -1,8 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { existsSync } from "node:fs";
-import { useEffect, useRef } from "react";
-import { Gdk, Gtk, GtkPicture } from "../gtkx/bridge/index";
+import { useEffect, useImperativeHandle, useLayoutEffect, useRef, } from "react";
+import { Gdk, Gtk, GtkPicture, setPaintOnlyLeaf } from "../gtkx/bridge/index";
 import { isRemoteUri, loadRemoteImage } from "./image-loader";
+import { createMeasureHandle } from "./measure";
 import { useLayoutChild } from "./use-layout-child";
 const CONTENT_FIT = {
     cover: Gtk.ContentFit.COVER,
@@ -20,9 +21,19 @@ const toPath = (source) => {
 // formats — e.g. ICO favicons), so onError is honest instead of showing
 // an empty picture. Sizing comes from the style (width/height or flex) —
 // like RN, which also cannot infer remote image sizes synchronously.
-export const Image = ({ source, style, resizeMode = "cover", onLayout, onLoad, onError, testID, }) => {
+export const Image = ({ source, style, resizeMode = "cover", onLayout, onLoad, onError, testID, ref, }) => {
     const widgetRef = useRef(null);
-    useLayoutChild(widgetRef, { style, onLayout });
+    const { node } = useLayoutChild(widgetRef, { style, onLayout });
+    useImperativeHandle(ref, () => createMeasureHandle(widgetRef, node), [node]);
+    // Paint-only for picking, exactly as `Text`'s label is: `Image` has no press
+    // prop, so a targetable GtkPicture only ever shadowed its own container —
+    // see the zIndex block in gtkx/bridge/view-box.ts.
+    useLayoutEffect(() => {
+        const picture = widgetRef.current;
+        if (picture) {
+            setPaintOnlyLeaf(picture);
+        }
+    }, []);
     const path = toPath(source);
     useEffect(() => {
         const widget = widgetRef.current;

package/dist/components/image.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/components/image.tsx"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\"\nimport { useEffect, useRef } from \"react\"\nimport type { StyleProp } from \"../contracts\"\nimport { Gdk, Gtk, GtkPicture } from \"../gtkx/bridge/index\"\nimport { isRemoteUri, loadRemoteImage } from \"./image-loader\"\nimport { useLayoutChild, type LayoutEvent } from \"./use-layout-child\"\n\nexport type ImageSource = { uri: string } | string\n\nexport type ImageProps = {\n  source: ImageSource\n  style?: StyleProp\n  resizeMode?: \"cover\" | \"contain\" | \"stretch\" | \"center\"\n  onLayout?: (event: LayoutEvent) => void\n  onLoad?: () => void\n  onError?: (error: { nativeEvent: { error: string } }) => void\n  testID?: string\n}\n\nconst CONTENT_FIT = {\n  cover: Gtk.ContentFit.COVER,\n  contain: Gtk.ContentFit.CONTAIN,\n  stretch: Gtk.ContentFit.FILL,\n  center: Gtk.ContentFit.SCALE_DOWN,\n} as const\n\nconst toPath = (source: ImageSource): string => {\n  const uri = typeof source === \"string\" ? source : source.uri\n  return uri.startsWith(\"file://\") ? uri.slice(\"file://\".length) : uri\n}\n\n// Local files load synchronously; http(s) URIs download through the\n// on-disk cache (image-loader.ts) and set the picture when ready. The\n// texture is decoded explicitly (Gdk.Texture throws on unsupported\n// formats — e.g. ICO favicons), so onError is honest instead of showing\n// an empty picture. Sizing comes from the style (width/height or flex) —\n// like RN, which also cannot infer remote image sizes synchronously.\nexport const Image = ({\n  source,\n  style,\n  resizeMode = \"cover\",\n  onLayout,\n  onLoad,\n  onError,\n  testID,\n}: ImageProps) => {\n  const widgetRef = useRef<Gtk.Picture | null>(null)\n  useLayoutChild(widgetRef, { style, onLayout })\n\n  const path = toPath(source)\n\n  useEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    const show = (file: string): void => {\n      const target = widgetRef.current\n      if (!target) {\n        return\n      }\n      try {\n        // Decode explicitly: setFilename fails silently on formats the\n        // texture loader does not support, newFromFilename throws.\n        target.setPaintable(Gdk.Texture.newFromFilename(file))\n        onLoad?.()\n      } catch (error) {\n        onError?.({ nativeEvent: { error: String(error) } })\n      }\n    }\n    if (isRemoteUri(path)) {\n      let cancelled = false\n      loadRemoteImage(path).then(\n        (file) => {\n          // Unmount (or a source change) during the download must not touch\n          // the widget or fire stale callbacks.\n          if (!cancelled) {\n            show(file)\n          }\n        },\n        (error: unknown) => {\n          if (!cancelled) {\n            onError?.({ nativeEvent: { error: String(error) } })\n          }\n        },\n      )\n      return () => {\n        cancelled = true\n      }\n    }\n    if (!existsSync(path)) {\n      onError?.({ nativeEvent: { error: `Image not found: ${path}` } })\n      return\n    }\n    show(path)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [path])\n\n  return (\n    <GtkPicture\n      ref={widgetRef}\n      name={testID}\n      contentFit={CONTENT_FIT[resizeMode]}\n    />\n  )\n}\n"]}
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/components/image.tsx"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\"\nimport {\n  useEffect,\n  useImperativeHandle,\n  useLayoutEffect,\n  useRef,\n  type Ref,\n} from \"react\"\nimport type { StyleProp } from \"../contracts\"\nimport { Gdk, Gtk, GtkPicture, setPaintOnlyLeaf } from \"../gtkx/bridge/index\"\nimport { isRemoteUri, loadRemoteImage } from \"./image-loader\"\nimport { createMeasureHandle, type MeasureHandle } from \"./measure\"\nimport { useLayoutChild, type LayoutEvent } from \"./use-layout-child\"\n\nexport type ImageSource = { uri: string } | string\n\n/** RN's imperative geometry methods, on an `Image` ref. */\nexport type ImageHandle = MeasureHandle\n\nexport type ImageProps = {\n  source: ImageSource\n  style?: StyleProp\n  resizeMode?: \"cover\" | \"contain\" | \"stretch\" | \"center\"\n  onLayout?: (event: LayoutEvent) => void\n  onLoad?: () => void\n  onError?: (error: { nativeEvent: { error: string } }) => void\n  testID?: string\n  // The same handle every other host component exposes — RN parity, and the\n  // seam `Animated.Image` reads its widget back through.\n  ref?: Ref<ImageHandle>\n}\n\nconst CONTENT_FIT = {\n  cover: Gtk.ContentFit.COVER,\n  contain: Gtk.ContentFit.CONTAIN,\n  stretch: Gtk.ContentFit.FILL,\n  center: Gtk.ContentFit.SCALE_DOWN,\n} as const\n\nconst toPath = (source: ImageSource): string => {\n  const uri = typeof source === \"string\" ? source : source.uri\n  return uri.startsWith(\"file://\") ? uri.slice(\"file://\".length) : uri\n}\n\n// Local files load synchronously; http(s) URIs download through the\n// on-disk cache (image-loader.ts) and set the picture when ready. The\n// texture is decoded explicitly (Gdk.Texture throws on unsupported\n// formats — e.g. ICO favicons), so onError is honest instead of showing\n// an empty picture. Sizing comes from the style (width/height or flex) —\n// like RN, which also cannot infer remote image sizes synchronously.\nexport const Image = ({\n  source,\n  style,\n  resizeMode = \"cover\",\n  onLayout,\n  onLoad,\n  onError,\n  testID,\n  ref,\n}: ImageProps) => {\n  const widgetRef = useRef<Gtk.Picture | null>(null)\n  const { node } = useLayoutChild(widgetRef, { style, onLayout })\n\n  useImperativeHandle(ref, () => createMeasureHandle(widgetRef, node), [node])\n\n  // Paint-only for picking, exactly as `Text`'s label is: `Image` has no press\n  // prop, so a targetable GtkPicture only ever shadowed its own container —\n  // see the zIndex block in gtkx/bridge/view-box.ts.\n  useLayoutEffect(() => {\n    const picture = widgetRef.current\n    if (picture) {\n      setPaintOnlyLeaf(picture)\n    }\n  }, [])\n\n  const path = toPath(source)\n\n  useEffect(() => {\n    const widget = widgetRef.current\n    if (!widget) {\n      return\n    }\n    const show = (file: string): void => {\n      const target = widgetRef.current\n      if (!target) {\n        return\n      }\n      try {\n        // Decode explicitly: setFilename fails silently on formats the\n        // texture loader does not support, newFromFilename throws.\n        target.setPaintable(Gdk.Texture.newFromFilename(file))\n        onLoad?.()\n      } catch (error) {\n        onError?.({ nativeEvent: { error: String(error) } })\n      }\n    }\n    if (isRemoteUri(path)) {\n      let cancelled = false\n      loadRemoteImage(path).then(\n        (file) => {\n          // Unmount (or a source change) during the download must not touch\n          // the widget or fire stale callbacks.\n          if (!cancelled) {\n            show(file)\n          }\n        },\n        (error: unknown) => {\n          if (!cancelled) {\n            onError?.({ nativeEvent: { error: String(error) } })\n          }\n        },\n      )\n      return () => {\n        cancelled = true\n      }\n    }\n    if (!existsSync(path)) {\n      onError?.({ nativeEvent: { error: `Image not found: ${path}` } })\n      return\n    }\n    show(path)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [path])\n\n  return (\n    <GtkPicture\n      ref={widgetRef}\n      name={testID}\n      contentFit={CONTENT_FIT[resizeMode]}\n    />\n  )\n}\n"]}

package/dist/components/index.d.ts

@@ -1,14 +1,20 @@
 export { ActivityIndicator, type ActivityIndicatorProps, } from "./activity-indicator";
-export { Animated, Easing, type AnimatedViewProps, type AnimatedViewStyle, } from "./animated";
+export { Animated, createAnimatedComponent, Easing, type AnimatedComponent, type AnimatedComponentExtraProps, type AnimatedPropsProp, type AnimatedStyleProp, type AnimatedViewProps, type AnimatedViewStyle, } from "./animated";
 export { AppRegistry, type RunApplicationParams } from "./app-registry";
+export { findNodeHandle } from "./find-node-handle";
 export { FlatList, SectionList, type FlatListProps, type ListRenderItemInfo, type SectionListData, type SectionListProps, type ViewabilityConfig, type ViewToken, } from "./flat-list";
-export { Image, type ImageProps, type ImageSource } from "./image";
+export { Image, type ImageHandle, type ImageProps, type ImageSource, } from "./image";
 export { Modal, type ModalProps } from "./modal";
-export { Pressable, TouchableOpacity, type PressableProps, type PressableStateCallbackType, type PressEvent, type TouchableOpacityProps, } from "./pressable";
+export { Pressable, TouchableHighlight, TouchableOpacity, TouchableWithoutFeedback, type NativeTouch, type PressableProps, type PressableStateCallbackType, type PressEvent, type TouchableHighlightProps, type TouchableOpacityProps, type TouchableWithoutFeedbackProps, } from "./pressable";
 export { IntrinsicRoot, NestedRoot, Root, type IntrinsicRootProps, type NestedRootProps, type RootProps, } from "./root";
 export { ScrollView, type ScrollEvent, type ScrollViewHandle, type ScrollViewProps, } from "./scroll-view";
 export { Switch, type SwitchProps } from "./switch";
-export { Text, type TextProps } from "./text";
+export { Text, type TextHandle, type TextProps } from "./text";
 export { TextInput, type TextInputProps } from "./text-input";
-export { SafeAreaView, StatusBar, View, type ViewProps } from "./view";
+export { SafeAreaView, StatusBar, View, type ViewHandle, type ViewProps, } from "./view";
+export type { MeasureHandle, MeasureInWindowOnSuccessCallback, MeasureLayoutOnSuccessCallback, MeasureOnSuccessCallback, NodeHandle, } from "./measure";
+export { VirtualizedList, type ItemLayout, type VirtualizedListHandle, type VirtualizedListProps, } from "./virtualized-list";
 export { type LayoutEvent } from "./use-layout-child";
+export { default as PanResponder } from "../vendor/react-native/pan-responder";
+export type { PanResponderCallbacks, PanResponderGestureState, PanResponderInstance, } from "../vendor/react-native/pan-responder";
+export type { GestureResponderEvent, ResponderProps, TouchHistory, TouchRecord, } from "../responder/types";

package/dist/components/index.js

@@ -1,14 +1,17 @@
 export { ActivityIndicator, } from "./activity-indicator";
-export { Animated, Easing, } from "./animated";
+export { Animated, createAnimatedComponent, Easing, } from "./animated";
 export { AppRegistry } from "./app-registry";
+export { findNodeHandle } from "./find-node-handle";
 export { FlatList, SectionList, } from "./flat-list";
-export { Image } from "./image";
+export { Image, } from "./image";
 export { Modal } from "./modal";
-export { Pressable, TouchableOpacity, } from "./pressable";
+export { Pressable, TouchableHighlight, TouchableOpacity, TouchableWithoutFeedback, } from "./pressable";
 export { IntrinsicRoot, NestedRoot, Root, } from "./root";
 export { ScrollView, } from "./scroll-view";
 export { Switch } from "./switch";
 export { Text } from "./text";
 export { TextInput } from "./text-input";
-export { SafeAreaView, StatusBar, View } from "./view";
+export { SafeAreaView, StatusBar, View, } from "./view";
+export { VirtualizedList, } from "./virtualized-list";
+export { default as PanResponder } from "../vendor/react-native/pan-responder";
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,QAAQ,EACR,MAAM,GAGP,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAA6B,MAAM,gBAAgB,CAAA;AACvE,OAAO,EACL,QAAQ,EACR,WAAW,GAOZ,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,KAAK,EAAqC,MAAM,SAAS,CAAA;AAClE,OAAO,EAAE,KAAK,EAAmB,MAAM,SAAS,CAAA;AAChD,OAAO,EACL,SAAS,EACT,gBAAgB,GAKjB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,aAAa,EACb,UAAU,EACV,IAAI,GAIL,MAAM,QAAQ,CAAA;AACf,OAAO,EACL,UAAU,GAIX,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,IAAI,EAAkB,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAuB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAkB,MAAM,QAAQ,CAAA","sourcesContent":["export {\n  ActivityIndicator,\n  type ActivityIndicatorProps,\n} from \"./activity-indicator\"\nexport {\n  Animated,\n  Easing,\n  type AnimatedViewProps,\n  type AnimatedViewStyle,\n} from \"./animated\"\nexport { AppRegistry, type RunApplicationParams } from \"./app-registry\"\nexport {\n  FlatList,\n  SectionList,\n  type FlatListProps,\n  type ListRenderItemInfo,\n  type SectionListData,\n  type SectionListProps,\n  type ViewabilityConfig,\n  type ViewToken,\n} from \"./flat-list\"\nexport { Image, type ImageProps, type ImageSource } from \"./image\"\nexport { Modal, type ModalProps } from \"./modal\"\nexport {\n  Pressable,\n  TouchableOpacity,\n  type PressableProps,\n  type PressableStateCallbackType,\n  type PressEvent,\n  type TouchableOpacityProps,\n} from \"./pressable\"\nexport {\n  IntrinsicRoot,\n  NestedRoot,\n  Root,\n  type IntrinsicRootProps,\n  type NestedRootProps,\n  type RootProps,\n} from \"./root\"\nexport {\n  ScrollView,\n  type ScrollEvent,\n  type ScrollViewHandle,\n  type ScrollViewProps,\n} from \"./scroll-view\"\nexport { Switch, type SwitchProps } from \"./switch\"\nexport { Text, type TextProps } from \"./text\"\nexport { TextInput, type TextInputProps } from \"./text-input\"\nexport { SafeAreaView, StatusBar, View, type ViewProps } from \"./view\"\nexport { type LayoutEvent } from \"./use-layout-child\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,MAAM,GAOP,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAA6B,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EACL,QAAQ,EACR,WAAW,GAOZ,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,GAIN,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,KAAK,EAAmB,MAAM,SAAS,CAAA;AAChD,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,GAQzB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,aAAa,EACb,UAAU,EACV,IAAI,GAIL,MAAM,QAAQ,CAAA;AACf,OAAO,EACL,UAAU,GAIX,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,IAAI,EAAmC,MAAM,QAAQ,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAuB,MAAM,cAAc,CAAA;AAC7D,OAAO,EACL,YAAY,EACZ,SAAS,EACT,IAAI,GAGL,MAAM,QAAQ,CAAA;AAQf,OAAO,EACL,eAAe,GAIhB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,sCAAsC,CAAA","sourcesContent":["export {\n  ActivityIndicator,\n  type ActivityIndicatorProps,\n} from \"./activity-indicator\"\nexport {\n  Animated,\n  createAnimatedComponent,\n  Easing,\n  type AnimatedComponent,\n  type AnimatedComponentExtraProps,\n  type AnimatedPropsProp,\n  type AnimatedStyleProp,\n  type AnimatedViewProps,\n  type AnimatedViewStyle,\n} from \"./animated\"\nexport { AppRegistry, type RunApplicationParams } from \"./app-registry\"\nexport { findNodeHandle } from \"./find-node-handle\"\nexport {\n  FlatList,\n  SectionList,\n  type FlatListProps,\n  type ListRenderItemInfo,\n  type SectionListData,\n  type SectionListProps,\n  type ViewabilityConfig,\n  type ViewToken,\n} from \"./flat-list\"\nexport {\n  Image,\n  type ImageHandle,\n  type ImageProps,\n  type ImageSource,\n} from \"./image\"\nexport { Modal, type ModalProps } from \"./modal\"\nexport {\n  Pressable,\n  TouchableHighlight,\n  TouchableOpacity,\n  TouchableWithoutFeedback,\n  type NativeTouch,\n  type PressableProps,\n  type PressableStateCallbackType,\n  type PressEvent,\n  type TouchableHighlightProps,\n  type TouchableOpacityProps,\n  type TouchableWithoutFeedbackProps,\n} from \"./pressable\"\nexport {\n  IntrinsicRoot,\n  NestedRoot,\n  Root,\n  type IntrinsicRootProps,\n  type NestedRootProps,\n  type RootProps,\n} from \"./root\"\nexport {\n  ScrollView,\n  type ScrollEvent,\n  type ScrollViewHandle,\n  type ScrollViewProps,\n} from \"./scroll-view\"\nexport { Switch, type SwitchProps } from \"./switch\"\nexport { Text, type TextHandle, type TextProps } from \"./text\"\nexport { TextInput, type TextInputProps } from \"./text-input\"\nexport {\n  SafeAreaView,\n  StatusBar,\n  View,\n  type ViewHandle,\n  type ViewProps,\n} from \"./view\"\nexport type {\n  MeasureHandle,\n  MeasureInWindowOnSuccessCallback,\n  MeasureLayoutOnSuccessCallback,\n  MeasureOnSuccessCallback,\n  NodeHandle,\n} from \"./measure\"\nexport {\n  VirtualizedList,\n  type ItemLayout,\n  type VirtualizedListHandle,\n  type VirtualizedListProps,\n} from \"./virtualized-list\"\nexport { type LayoutEvent } from \"./use-layout-child\"\nexport { default as PanResponder } from \"../vendor/react-native/pan-responder\"\nexport type {\n  PanResponderCallbacks,\n  PanResponderGestureState,\n  PanResponderInstance,\n} from \"../vendor/react-native/pan-responder\"\nexport type {\n  GestureResponderEvent,\n  ResponderProps,\n  TouchHistory,\n  TouchRecord,\n} from \"../responder/types\"\n"]}

package/dist/components/measure.d.ts

@@ -0,0 +1,63 @@
+import type { RefObject } from "react";
+import type { LayoutNodeApi } from "../contracts";
+import { type Gtk } from "../gtkx/bridge/index";
+export type MeasureOnSuccessCallback = (x: number, y: number, width: number, height: number, pageX: number, pageY: number) => void;
+export type MeasureInWindowOnSuccessCallback = (x: number, y: number, width: number, height: number) => void;
+export type MeasureLayoutOnSuccessCallback = (left: number, top: number, width: number, height: number) => void;
+/**
+ * RN's opaque reference to a mounted host view — what `findNodeHandle`
+ * returns and what `measureLayout` accepts as its first argument. A number,
+ * as it is on every RN platform: the value crosses no boundary here, but the
+ * libraries that ask for one compare it, store it in a map and hand it back,
+ * and an object would only be a different type wearing the same name.
+ */
+export type NodeHandle = number;
+/** The measurement half of a component ref, matching RN's method set. */
+export type MeasureHandle = {
+    measure(callback: MeasureOnSuccessCallback): void;
+    measureInWindow(callback: MeasureInWindowOnSuccessCallback): void;
+    measureLayout(relativeTo: MeasureHandle | NodeHandle, onSuccess: MeasureLayoutOnSuccessCallback, onFail?: () => void): void;
+};
+/**
+ * @internal Registers `handle` as standing for `widgetRef`'s widget.
+ *
+ * `createMeasureHandle` does this for the handles it builds; components that
+ * COMPOSE one into a larger handle (ScrollView adds `scrollTo`/`scrollToEnd`)
+ * create a new object, which is a new identity and therefore needs its own
+ * entry — otherwise `measureLayout(scrollViewRef, …)` silently fails.
+ */
+export declare const registerHandleWidget: (handle: object, widgetRef: RefObject<Gtk.Widget | null>) => void;
+/**
+ * @internal The `Gtk.Widget` behind a component handle, or null when the
+ * value is not a handle at all (a component that forwards no ref, or one
+ * whose ref is something else entirely).
+ *
+ * Deliberately not exported from the package: a portable API does not hand
+ * out widgets. This is how `createAnimatedComponent` reaches the widget it
+ * has to write opacity and transforms to.
+ */
+export declare const widgetForHandle: (handle: unknown) => Gtk.Widget | null;
+/**
+ * @internal Registers `handle` as standing for whatever widget `other`
+ * stands for.
+ *
+ * For a COMPOSITE that renders a host component and wants to be reachable as
+ * that host: a windowed list owns no widget of its own, but the ScrollView it
+ * renders is the thing another view measures against and the thing
+ * `findNodeHandle` should answer with. RN resolves a `FlatList`'s node handle
+ * through to its inner scroll view for the same reason.
+ *
+ * It deliberately does NOT give the composite `measure()`/`measureInWindow()`
+ * — see the note on `VirtualizedListHandle`. Being measurable AGAINST is a
+ * weaker claim than reporting your own geometry.
+ */
+export declare const registerHandleAlias: (handle: object, other: () => unknown) => void;
+/**
+ * @internal The tag standing for the widget behind `handle`, minted on first
+ * ask. Null when the value is not a component handle, or when its widget is
+ * not mounted — RN returns null in both cases too.
+ */
+export declare const nodeHandleFor: (handle: unknown) => NodeHandle | null;
+/** @internal The widget a tag was minted for, or null once it is gone. */
+export declare const widgetForNodeHandle: (tag: NodeHandle) => Gtk.Widget | null;
+export declare const createMeasureHandle: (widgetRef: RefObject<Gtk.Widget | null>, node: LayoutNodeApi) => MeasureHandle;

package/dist/components/measure.js

@@ -0,0 +1,150 @@
+import { computePointIn, computePointInWindow, } from "../gtkx/bridge/index";
+// measureLayout needs the OTHER view's widget, and the public handle type
+// deliberately does not carry one — a portable API should not hand out a
+// Gtk.Widget. The lookup lives here instead, keyed by the handle identity.
+//
+// It is also the seam every animated component reaches through: driving
+// `opacity` and `transform` imperatively needs the widget behind a ref, and
+// this map already holds exactly that association for every component that
+// exposes a handle. Widening it beats adding a second, parallel registry.
+const widgetOf = new WeakMap();
+/**
+ * @internal Registers `handle` as standing for `widgetRef`'s widget.
+ *
+ * `createMeasureHandle` does this for the handles it builds; components that
+ * COMPOSE one into a larger handle (ScrollView adds `scrollTo`/`scrollToEnd`)
+ * create a new object, which is a new identity and therefore needs its own
+ * entry — otherwise `measureLayout(scrollViewRef, …)` silently fails.
+ */
+export const registerHandleWidget = (handle, widgetRef) => {
+    widgetOf.set(handle, () => widgetRef.current);
+};
+/**
+ * @internal The `Gtk.Widget` behind a component handle, or null when the
+ * value is not a handle at all (a component that forwards no ref, or one
+ * whose ref is something else entirely).
+ *
+ * Deliberately not exported from the package: a portable API does not hand
+ * out widgets. This is how `createAnimatedComponent` reaches the widget it
+ * has to write opacity and transforms to.
+ */
+export const widgetForHandle = (handle) => {
+    if (handle === null || typeof handle !== "object") {
+        return null;
+    }
+    return widgetOf.get(handle)?.() ?? null;
+};
+// --- node handles --------------------------------------------------------
+//
+// RN's `findNodeHandle` hands out an integer that stands for a mounted host
+// VIEW. On a bridge platform the integer is the native view tag and the
+// number is the only thing that can cross; here nothing has to cross, so the
+// number is minted on demand and means exactly one thing — "the widget it
+// was minted for".
+//
+// Keyed by the WIDGET rather than by the handle object, which is what makes
+// it behave like RN's: two refs onto the same view report the same tag, and
+// the tag survives a re-render that rebuilt the handle object. It is also why
+// this is not a second registry — `widgetOf` above is still the only thing
+// that knows what a handle stands for, and a tag is minted from its answer.
+//
+// A widget that is gone leaves a tag that resolves to null, which is what a
+// stale RN tag does too.
+const tagOfWidget = new WeakMap();
+const widgetOfTag = new Map();
+let nextTag = 1;
+/**
+ * @internal Registers `handle` as standing for whatever widget `other`
+ * stands for.
+ *
+ * For a COMPOSITE that renders a host component and wants to be reachable as
+ * that host: a windowed list owns no widget of its own, but the ScrollView it
+ * renders is the thing another view measures against and the thing
+ * `findNodeHandle` should answer with. RN resolves a `FlatList`'s node handle
+ * through to its inner scroll view for the same reason.
+ *
+ * It deliberately does NOT give the composite `measure()`/`measureInWindow()`
+ * — see the note on `VirtualizedListHandle`. Being measurable AGAINST is a
+ * weaker claim than reporting your own geometry.
+ */
+export const registerHandleAlias = (handle, other) => {
+    widgetOf.set(handle, () => widgetForHandle(other()));
+};
+/**
+ * @internal The tag standing for the widget behind `handle`, minted on first
+ * ask. Null when the value is not a component handle, or when its widget is
+ * not mounted — RN returns null in both cases too.
+ */
+export const nodeHandleFor = (handle) => {
+    const widget = widgetForHandle(handle);
+    if (widget === null) {
+        return null;
+    }
+    const existing = tagOfWidget.get(widget);
+    if (existing !== undefined) {
+        return existing;
+    }
+    const tag = nextTag;
+    nextTag += 1;
+    tagOfWidget.set(widget, tag);
+    widgetOfTag.set(tag, new WeakRef(widget));
+    return tag;
+};
+/** @internal The widget a tag was minted for, or null once it is gone. */
+export const widgetForNodeHandle = (tag) => {
+    const widget = widgetOfTag.get(tag)?.deref() ?? null;
+    if (widget === null) {
+        widgetOfTag.delete(tag);
+    }
+    return widget;
+};
+/** The widget behind either spelling of "that other view" that RN accepts. */
+const widgetForTarget = (target) => typeof target === "number"
+    ? widgetForNodeHandle(target)
+    : widgetForHandle(target);
+export const createMeasureHandle = (widgetRef, node) => {
+    const handle = {
+        measure(callback) {
+            const widget = widgetRef.current;
+            const rect = node.getRect();
+            if (!widget || !rect) {
+                return;
+            }
+            const page = computePointInWindow(widget, 0, 0);
+            if (!page) {
+                return;
+            }
+            callback(rect.x, rect.y, rect.width, rect.height, page.x, page.y);
+        },
+        measureInWindow(callback) {
+            const widget = widgetRef.current;
+            const rect = node.getRect();
+            if (!widget || !rect) {
+                return;
+            }
+            const page = computePointInWindow(widget, 0, 0);
+            if (!page) {
+                return;
+            }
+            callback(page.x, page.y, rect.width, rect.height);
+        },
+        measureLayout(relativeTo, onSuccess, onFail) {
+            const widget = widgetRef.current;
+            const other = widgetForTarget(relativeTo);
+            const rect = node.getRect();
+            if (!widget || !other || !rect) {
+                onFail?.();
+                return;
+            }
+            const origin = computePointIn(widget, other, 0, 0);
+            if (!origin) {
+                onFail?.();
+                return;
+            }
+            onSuccess(origin.x, origin.y, rect.width, rect.height);
+        },
+    };
+    registerHandleWidget(handle, widgetRef);
+    return handle;
+};
+//# sourceMappingURL=measure.js.map

package/dist/components/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../src/components/measure.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,cAAc,EACd,oBAAoB,GAErB,MAAM,sBAAsB,CAAA;AA6C7B,0EAA0E;AAC1E,yEAAyE;AACzE,2EAA2E;AAC3E,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAmC,CAAA;AAE/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,SAAuC,EACjC,EAAE;IACR,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;AAC/C,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAe,EAAqB,EAAE;IACpE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,IAAI,CAAA;AACzC,CAAC,CAAA;AAED,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,mBAAmB;AACnB,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,yBAAyB;AACzB,MAAM,WAAW,GAAG,IAAI,OAAO,EAA0B,CAAA;AACzD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmC,CAAA;AAC9D,IAAI,OAAO,GAAG,CAAC,CAAA;AAEf;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAc,EACd,KAAoB,EACd,EAAE;IACR,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAe,EAAqB,EAAE;IAClE,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACtC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAA;IACnB,OAAO,IAAI,CAAC,CAAA;IACZ,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IACzC,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAe,EAAqB,EAAE;IACxE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,IAAI,CAAA;IACpD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,8EAA8E;AAC9E,MAAM,eAAe,GAAG,CACtB,MAAkC,EACf,EAAE,CACrB,OAAO,MAAM,KAAK,QAAQ;IACxB,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC;IAC7B,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;AAE7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,SAAuC,EACvC,IAAmB,EACJ,EAAE;IACjB,MAAM,MAAM,GAAkB;QAC5B,OAAO,CAAC,QAAQ;YACd,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAA;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAC3B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACrB,OAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAM;YACR,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;QACnE,CAAC;QAED,eAAe,CAAC,QAAQ;YACtB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAA;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAC3B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACrB,OAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAM;YACR,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACnD,CAAC;QAED,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM;YACzC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAA;YAChC,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAC3B,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,EAAE,EAAE,CAAA;gBACV,OAAM;YACR,CAAC;YACD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YAClD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,EAAE,EAAE,CAAA;gBACV,OAAM;YACR,CAAC;YACD,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACxD,CAAC;KACF,CAAA;IAED,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACvC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["// RN's imperative geometry API (measure / measureInWindow / measureLayout),\n// shared by every component that exposes a ref.\n//\n// The size and the parent-relative position come from the Yoga rect the\n// component's layout node already holds — that is the layout truth, and it\n// is what RN reports (a rotated view still measures its own box, not its\n// axis-aligned bounding box). Only the translation into another coordinate\n// space goes through GTK, where compute_point walks the transform chain and\n// therefore already accounts for scroll offsets.\n//\n// RN's contract on failure is to not call back rather than to invent a\n// number: a view whose layout has not been committed yet (before the first\n// onLayout) or that is not in a window has nothing true to report.\nimport type { RefObject } from \"react\"\nimport type { LayoutNodeApi } from \"../contracts\"\nimport {\n  computePointIn,\n  computePointInWindow,\n  type Gtk,\n} from \"../gtkx/bridge/index\"\n\nexport type MeasureOnSuccessCallback = (\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n  pageX: number,\n  pageY: number,\n) => void\n\nexport type MeasureInWindowOnSuccessCallback = (\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n) => void\n\nexport type MeasureLayoutOnSuccessCallback = (\n  left: number,\n  top: number,\n  width: number,\n  height: number,\n) => void\n\n/**\n * RN's opaque reference to a mounted host view — what `findNodeHandle`\n * returns and what `measureLayout` accepts as its first argument. A number,\n * as it is on every RN platform: the value crosses no boundary here, but the\n * libraries that ask for one compare it, store it in a map and hand it back,\n * and an object would only be a different type wearing the same name.\n */\nexport type NodeHandle = number\n\n/** The measurement half of a component ref, matching RN's method set. */\nexport type MeasureHandle = {\n  measure(callback: MeasureOnSuccessCallback): void\n  measureInWindow(callback: MeasureInWindowOnSuccessCallback): void\n  measureLayout(\n    relativeTo: MeasureHandle | NodeHandle,\n    onSuccess: MeasureLayoutOnSuccessCallback,\n    onFail?: () => void,\n  ): void\n}\n\n// measureLayout needs the OTHER view's widget, and the public handle type\n// deliberately does not carry one — a portable API should not hand out a\n// Gtk.Widget. The lookup lives here instead, keyed by the handle identity.\n//\n// It is also the seam every animated component reaches through: driving\n// `opacity` and `transform` imperatively needs the widget behind a ref, and\n// this map already holds exactly that association for every component that\n// exposes a handle. Widening it beats adding a second, parallel registry.\nconst widgetOf = new WeakMap<object, () => Gtk.Widget | null>()\n\n/**\n * @internal Registers `handle` as standing for `widgetRef`'s widget.\n *\n * `createMeasureHandle` does this for the handles it builds; components that\n * COMPOSE one into a larger handle (ScrollView adds `scrollTo`/`scrollToEnd`)\n * create a new object, which is a new identity and therefore needs its own\n * entry — otherwise `measureLayout(scrollViewRef, …)` silently fails.\n */\nexport const registerHandleWidget = (\n  handle: object,\n  widgetRef: RefObject<Gtk.Widget | null>,\n): void => {\n  widgetOf.set(handle, () => widgetRef.current)\n}\n\n/**\n * @internal The `Gtk.Widget` behind a component handle, or null when the\n * value is not a handle at all (a component that forwards no ref, or one\n * whose ref is something else entirely).\n *\n * Deliberately not exported from the package: a portable API does not hand\n * out widgets. This is how `createAnimatedComponent` reaches the widget it\n * has to write opacity and transforms to.\n */\nexport const widgetForHandle = (handle: unknown): Gtk.Widget | null => {\n  if (handle === null || typeof handle !== \"object\") {\n    return null\n  }\n  return widgetOf.get(handle)?.() ?? null\n}\n\n// --- node handles --------------------------------------------------------\n//\n// RN's `findNodeHandle` hands out an integer that stands for a mounted host\n// VIEW. On a bridge platform the integer is the native view tag and the\n// number is the only thing that can cross; here nothing has to cross, so the\n// number is minted on demand and means exactly one thing — \"the widget it\n// was minted for\".\n//\n// Keyed by the WIDGET rather than by the handle object, which is what makes\n// it behave like RN's: two refs onto the same view report the same tag, and\n// the tag survives a re-render that rebuilt the handle object. It is also why\n// this is not a second registry — `widgetOf` above is still the only thing\n// that knows what a handle stands for, and a tag is minted from its answer.\n//\n// A widget that is gone leaves a tag that resolves to null, which is what a\n// stale RN tag does too.\nconst tagOfWidget = new WeakMap<Gtk.Widget, NodeHandle>()\nconst widgetOfTag = new Map<NodeHandle, WeakRef<Gtk.Widget>>()\nlet nextTag = 1\n\n/**\n * @internal Registers `handle` as standing for whatever widget `other`\n * stands for.\n *\n * For a COMPOSITE that renders a host component and wants to be reachable as\n * that host: a windowed list owns no widget of its own, but the ScrollView it\n * renders is the thing another view measures against and the thing\n * `findNodeHandle` should answer with. RN resolves a `FlatList`'s node handle\n * through to its inner scroll view for the same reason.\n *\n * It deliberately does NOT give the composite `measure()`/`measureInWindow()`\n * — see the note on `VirtualizedListHandle`. Being measurable AGAINST is a\n * weaker claim than reporting your own geometry.\n */\nexport const registerHandleAlias = (\n  handle: object,\n  other: () => unknown,\n): void => {\n  widgetOf.set(handle, () => widgetForHandle(other()))\n}\n\n/**\n * @internal The tag standing for the widget behind `handle`, minted on first\n * ask. Null when the value is not a component handle, or when its widget is\n * not mounted — RN returns null in both cases too.\n */\nexport const nodeHandleFor = (handle: unknown): NodeHandle | null => {\n  const widget = widgetForHandle(handle)\n  if (widget === null) {\n    return null\n  }\n  const existing = tagOfWidget.get(widget)\n  if (existing !== undefined) {\n    return existing\n  }\n  const tag = nextTag\n  nextTag += 1\n  tagOfWidget.set(widget, tag)\n  widgetOfTag.set(tag, new WeakRef(widget))\n  return tag\n}\n\n/** @internal The widget a tag was minted for, or null once it is gone. */\nexport const widgetForNodeHandle = (tag: NodeHandle): Gtk.Widget | null => {\n  const widget = widgetOfTag.get(tag)?.deref() ?? null\n  if (widget === null) {\n    widgetOfTag.delete(tag)\n  }\n  return widget\n}\n\n/** The widget behind either spelling of \"that other view\" that RN accepts. */\nconst widgetForTarget = (\n  target: MeasureHandle | NodeHandle,\n): Gtk.Widget | null =>\n  typeof target === \"number\"\n    ? widgetForNodeHandle(target)\n    : widgetForHandle(target)\n\nexport const createMeasureHandle = (\n  widgetRef: RefObject<Gtk.Widget | null>,\n  node: LayoutNodeApi,\n): MeasureHandle => {\n  const handle: MeasureHandle = {\n    measure(callback) {\n      const widget = widgetRef.current\n      const rect = node.getRect()\n      if (!widget || !rect) {\n        return\n      }\n      const page = computePointInWindow(widget, 0, 0)\n      if (!page) {\n        return\n      }\n      callback(rect.x, rect.y, rect.width, rect.height, page.x, page.y)\n    },\n\n    measureInWindow(callback) {\n      const widget = widgetRef.current\n      const rect = node.getRect()\n      if (!widget || !rect) {\n        return\n      }\n      const page = computePointInWindow(widget, 0, 0)\n      if (!page) {\n        return\n      }\n      callback(page.x, page.y, rect.width, rect.height)\n    },\n\n    measureLayout(relativeTo, onSuccess, onFail) {\n      const widget = widgetRef.current\n      const other = widgetForTarget(relativeTo)\n      const rect = node.getRect()\n      if (!widget || !other || !rect) {\n        onFail?.()\n        return\n      }\n      const origin = computePointIn(widget, other, 0, 0)\n      if (!origin) {\n        onFail?.()\n        return\n      }\n      onSuccess(origin.x, origin.y, rect.width, rect.height)\n    },\n  }\n\n  registerHandleWidget(handle, widgetRef)\n  return handle\n}\n"]}

package/dist/components/modal.d.ts

@@ -9,4 +9,4 @@ export type ModalProps = {
     height?: number;
     children?: ReactNode;
 };
-export declare const Modal: ({ visible, onRequestClose, title, width, height, children, }: ModalProps) => ReactNode;
+export declare const Modal: ({ visible, onRequestClose, title, width, height, children, }: ModalProps) => React.ReactPortal | null;

package/dist/components/press-event.d.ts

@@ -0,0 +1,28 @@
+import type { Gtk } from "../gtkx/bridge/index";
+/** One touch point, in RN's shape. */
+export type NativeTouch = {
+    identifier: number;
+    target: number | null;
+    locationX: number;
+    locationY: number;
+    pageX: number;
+    pageY: number;
+    timestamp: number;
+    force: number;
+};
+export type PressEvent = {
+    nativeEvent: NativeTouch & {
+        touches: readonly NativeTouch[];
+        changedTouches: readonly NativeTouch[];
+    };
+};
+export declare const touchTimestamp: () => number;
+/** A stable numeric id for a widget, standing in for RN's node handle. */
+export declare const targetIdOf: (widget: object | null) => number | null;
+/**
+ * Builds a touch from coordinates in the target widget's own space — which
+ * is what every GTK gesture reports.
+ */
+export declare const createTouch: (widget: Gtk.Widget | null, locationX: number, locationY: number, identifier?: number) => NativeTouch;
+/** Wraps a single touch as a complete RN press event. */
+export declare const createPressEvent: (touch: NativeTouch) => PressEvent;

package/dist/components/press-event.js

@@ -0,0 +1,46 @@
+import { computePointInWindow } from "../gtkx/bridge/index";
+// performance.now() is monotonic and sub-millisecond — see the note above.
+export const touchTimestamp = () => performance.now();
+let nextTargetId = 1;
+const targetIds = new WeakMap();
+/** A stable numeric id for a widget, standing in for RN's node handle. */
+export const targetIdOf = (widget) => {
+    if (!widget) {
+        return null;
+    }
+    const existing = targetIds.get(widget);
+    if (existing !== undefined) {
+        return existing;
+    }
+    const id = nextTargetId;
+    nextTargetId += 1;
+    targetIds.set(widget, id);
+    return id;
+};
+/**
+ * Builds a touch from coordinates in the target widget's own space — which
+ * is what every GTK gesture reports.
+ */
+export const createTouch = (widget, locationX, locationY, identifier = 0) => {
+    const page = widget
+        ? computePointInWindow(widget, locationX, locationY)
+        : null;
+    return {
+        identifier,
+        target: targetIdOf(widget),
+        locationX,
+        locationY,
+        // A widget outside a window has no page space; falling back to the
+        // local point keeps the fields numeric without pretending to a
+        // translation that does not exist.
+        pageX: page?.x ?? locationX,
+        pageY: page?.y ?? locationY,
+        timestamp: touchTimestamp(),
+        force: 0,
+    };
+};
+/** Wraps a single touch as a complete RN press event. */
+export const createPressEvent = (touch) => ({
+    nativeEvent: { ...touch, touches: [touch], changedTouches: [touch] },
+});
+//# sourceMappingURL=press-event.js.map

package/dist/components/press-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"press-event.js","sourceRoot":"","sources":["../../src/components/press-event.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AA+B3D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAA;AAE7D,IAAI,YAAY,GAAG,CAAC,CAAA;AACpB,MAAM,SAAS,GAAG,IAAI,OAAO,EAAkB,CAAA;AAE/C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAqB,EAAiB,EAAE;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,MAAM,EAAE,GAAG,YAAY,CAAA;IACvB,YAAY,IAAI,CAAC,CAAA;IACjB,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACzB,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,MAAyB,EACzB,SAAiB,EACjB,SAAiB,EACjB,UAAU,GAAG,CAAC,EACD,EAAE;IACf,MAAM,IAAI,GAAG,MAAM;QACjB,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;QACpD,CAAC,CAAC,IAAI,CAAA;IACR,OAAO;QACL,UAAU;QACV,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;QAC1B,SAAS;QACT,SAAS;QACT,mEAAmE;QACnE,+DAA+D;QAC/D,mCAAmC;QACnC,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,SAAS;QAC3B,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,SAAS;QAC3B,SAAS,EAAE,cAAc,EAAE;QAC3B,KAAK,EAAE,CAAC;KACT,CAAA;AACH,CAAC,CAAA;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAkB,EAAc,EAAE,CAAC,CAAC;IACnE,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC,KAAK,CAAC,EAAE;CACrE,CAAC,CAAA","sourcesContent":["// RN's touch payload. One shape, shared by Pressable today and by the touch\n// and responder props when they land — in RN a single native touch stream\n// feeds both, and splitting it here would guarantee the two drift.\n//\n// Two details that look cosmetic and are not:\n//\n// - `timestamp` must be monotonic and finer than a millisecond tick.\n//   PanResponder and TouchHistoryMath compute velocity by differencing it,\n//   so a coarse clock makes consecutive frames compare equal and silently\n//   reports ZERO movement. That is the standing diagnosis for\n//   react-native-windows' New-Architecture PanResponder bug (#14119, open\n//   since 2024-11): Date.now() granularity, not a logic error.\n// - `pageX/pageY` and `locationX/locationY` are different spaces (window vs\n//   target-relative) and code in the wild reads both. Reporting one twice\n//   is the kind of bug that only shows up once something is nested.\nimport type { Gtk } from \"../gtkx/bridge/index\"\nimport { computePointInWindow } from \"../gtkx/bridge/index\"\n\n/** One touch point, in RN's shape. */\nexport type NativeTouch = {\n  // A desktop pointer is a single fabricated touch: RN's own event plugin\n  // has always had a mouse path, and react-native-web documents converting\n  // mouse events into one emulated touch. Real multitouch will hand out the\n  // GdkEventSequence's own identity here.\n  identifier: number\n  // Stable per-widget id; RN's is a React node handle, which we have no\n  // equivalent of. Null before the widget exists.\n  target: number | null\n  // Relative to the target view.\n  locationX: number\n  locationY: number\n  // Relative to the window (\"page\" in RN's vocabulary).\n  pageX: number\n  pageY: number\n  timestamp: number\n  // No pressure-sensitive input plumbed yet; RN reports 0 for devices\n  // without it, which is exactly what a mouse is.\n  force: number\n}\n\nexport type PressEvent = {\n  nativeEvent: NativeTouch & {\n    touches: readonly NativeTouch[]\n    changedTouches: readonly NativeTouch[]\n  }\n}\n\n// performance.now() is monotonic and sub-millisecond — see the note above.\nexport const touchTimestamp = (): number => performance.now()\n\nlet nextTargetId = 1\nconst targetIds = new WeakMap<object, number>()\n\n/** A stable numeric id for a widget, standing in for RN's node handle. */\nexport const targetIdOf = (widget: object | null): number | null => {\n  if (!widget) {\n    return null\n  }\n  const existing = targetIds.get(widget)\n  if (existing !== undefined) {\n    return existing\n  }\n  const id = nextTargetId\n  nextTargetId += 1\n  targetIds.set(widget, id)\n  return id\n}\n\n/**\n * Builds a touch from coordinates in the target widget's own space — which\n * is what every GTK gesture reports.\n */\nexport const createTouch = (\n  widget: Gtk.Widget | null,\n  locationX: number,\n  locationY: number,\n  identifier = 0,\n): NativeTouch => {\n  const page = widget\n    ? computePointInWindow(widget, locationX, locationY)\n    : null\n  return {\n    identifier,\n    target: targetIdOf(widget),\n    locationX,\n    locationY,\n    // A widget outside a window has no page space; falling back to the\n    // local point keeps the fields numeric without pretending to a\n    // translation that does not exist.\n    pageX: page?.x ?? locationX,\n    pageY: page?.y ?? locationY,\n    timestamp: touchTimestamp(),\n    force: 0,\n  }\n}\n\n/** Wraps a single touch as a complete RN press event. */\nexport const createPressEvent = (touch: NativeTouch): PressEvent => ({\n  nativeEvent: { ...touch, touches: [touch], changedTouches: [touch] },\n})\n"]}