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

package/dist/components/app-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-registry.js","sourceRoot":"","sources":["../../src/components/app-registry.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useLayoutEffect, type ComponentType } from \"react\"\nimport {\n  AdwApplicationWindow,\n  createRoot,\n  Gtk,\n  GtkApplication,\n  GtkApplicationWindow,\n  quit,\n} from \"../gtkx/bridge/index\"\nimport { Root } from \"./root\"\n\ntype ComponentProvider = () => ComponentType<Record<string, unknown>>\n\nconst registry = new Map<string, ComponentProvider>()\n\n// The chrome the running app was started with — read by the navigation\n// dev-mode hint (a HeaderBar page under \"system\" chrome renders a doubled\n// titlebar). null until runApplication ran (test harnesses never set it).\nlet activeChrome: \"system\" | \"content\" | null = null\nexport const getActiveChrome = (): \"system\" | \"content\" | null => activeChrome\n\nexport type RunApplicationParams = {\n  initialProps?: Record<string, unknown>\n  title?: string\n  width?: number\n  height?: number\n  // Window chrome. \"system\" (default): a GtkApplicationWindow with its own\n  // titlebar. \"content\": an AdwApplicationWindow with NO window titlebar —\n  // the app's content provides HeaderBars (navigation apps: the page\n  // HeaderBar becomes the titlebar, with the window controls in it).\n  chrome?: \"system\" | \"content\"\n}\n\n// RN parity: system \"reduce animations\" hints never auto-stop RN animations\n// (ActivityIndicator keeps spinning; honoring reduce-motion is an explicit\n// opt-in via AccessibilityInfo). Our Animated runs on GLib timers and already\n// ignores the hint, so GTK-internal animations (GtkSpinner, switch slides)\n// must behave the same — otherwise e.g. GNOME under software rendering\n// reports enable-animations=false through the settings portal and spinners\n// freeze while Animated keeps moving.\nlet animationsForced = false\nconst forceEnableAnimations = (): void => {\n  if (animationsForced) {\n    return\n  }\n  const settings = Gtk.Settings.getDefault()\n  if (!settings) {\n    return\n  }\n  animationsForced = true\n  // Application-set GtkSettings values outrank the desktop backend, so a\n  // later portal update cannot flip this back.\n  settings.gtkEnableAnimations = true\n}\n\n// chrome \"content\": the app component IS the window content (a navigation\n// container whose pages host their own NestedRoots) — no window-level Yoga\n// root in between: the layout root would not allocate foreign GTK children.\nconst ContentChrome = ({\n  App,\n  initialProps,\n}: {\n  App: ComponentType<Record<string, unknown>>\n  initialProps: Record<string, unknown>\n}) => {\n  useLayoutEffect(() => {\n    forceEnableAnimations()\n  }, [])\n  return <App {...initialProps} />\n}\n\nconst WindowContent = ({\n  App,\n  initialProps,\n  initialWidth,\n  initialHeight,\n}: {\n  App: ComponentType<Record<string, unknown>>\n  initialProps: Record<string, unknown>\n  initialWidth: number\n  initialHeight: number\n}) => {\n  // Settings need an initialized display, and writing them mid-render is\n  // unsafe — apply after the window mounts.\n  useLayoutEffect(() => {\n    forceEnableAnimations()\n  }, [])\n\n  // The Root is the window's direct child: RnGtkxLayout reports a zero\n  // minimum (the window shrinks freely — no ratchet) and adopts the actual\n  // content-area allocation as the layout viewport. No scrollable wrapper\n  // means a window can never scroll its own root — RN semantics, scrolling\n  // stays opt-in via <ScrollView>.\n  return (\n    <Root\n      width={initialWidth}\n      height={initialHeight}\n      followAllocation\n    >\n      <App {...initialProps} />\n    </Root>\n  )\n}\n\nexport const AppRegistry = {\n  registerComponent(appKey: string, provider: ComponentProvider): string {\n    registry.set(appKey, provider)\n    return appKey\n  },\n\n  getAppKeys(): string[] {\n    return [...registry.keys()]\n  },\n\n  runApplication(appKey: string, params: RunApplicationParams = {}): void {\n    const provider = registry.get(appKey)\n    if (!provider) {\n      throw new Error(\n        `AppRegistry: no component registered for \"${appKey}\". ` +\n          `Registered: ${[...registry.keys()].join(\", \") || \"(none)\"}`,\n      )\n    }\n    const App = provider()\n    const width = params.width ?? 800\n    const height = params.height ?? 600\n\n    const contentChrome = params.chrome === \"content\"\n    activeChrome = contentChrome ? \"content\" : \"system\"\n    const Window = contentChrome ? AdwApplicationWindow : GtkApplicationWindow\n    const AppWindow = () => (\n      <Window\n        title={params.title ?? appKey}\n        defaultWidth={width}\n        defaultHeight={height}\n        onCloseRequest={quit}\n      >\n        {contentChrome ? (\n          <ContentChrome\n            App={App}\n            initialProps={params.initialProps ?? {}}\n          />\n        ) : (\n          <WindowContent\n            App={App}\n            initialProps={params.initialProps ?? {}}\n            initialWidth={width}\n            initialHeight={height}\n          />\n        )}\n      </Window>\n    )\n\n    createRoot().render(\n      <GtkApplication>\n        <AppWindow />\n      </GtkApplication>,\n    )\n  },\n}\n"]}
+{"version":3,"file":"app-registry.js","sourceRoot":"","sources":["../../src/components/app-registry.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useLayoutEffect, type ComponentType, type ReactNode } from \"react\"\nimport {\n  AdwApplicationWindow,\n  createRoot,\n  Gtk,\n  GtkApplication,\n  GtkApplicationWindow,\n  quit,\n} from \"../gtkx/bridge/index\"\nimport { Root } from \"./root\"\n\ntype ComponentProvider = () => ComponentType<Record<string, unknown>>\n\nconst registry = new Map<string, ComponentProvider>()\n\n// The chrome the running app was started with — read by the navigation\n// dev-mode hint (a HeaderBar page under \"system\" chrome renders a doubled\n// titlebar). null until runApplication ran (test harnesses never set it).\nlet activeChrome: \"system\" | \"content\" | null = null\nexport const getActiveChrome = (): \"system\" | \"content\" | null => activeChrome\n\n// One accelerator binding on the GApplication — the shape GtkApplication's\n// own `actionAccels` prop takes, restated locally so this file needs\n// nothing from @gtkx/react/internal (the \"internal\" subpath is where the\n// real type lives, but nothing else in this package reaches for it).\nexport type ActionAccel = {\n  detailedActionName: string\n  accels: string[]\n}\n\nexport type RunApplicationParams = {\n  initialProps?: Record<string, unknown>\n  title?: string\n  width?: number\n  height?: number\n  // Window chrome. \"system\" (default): a GtkApplicationWindow with its own\n  // titlebar. \"content\": an AdwApplicationWindow with NO window titlebar —\n  // the app's content provides HeaderBars (navigation apps: the page\n  // HeaderBar becomes the titlebar, with the window controls in it).\n  chrome?: \"system\" | \"content\"\n  /**\n   * GSimpleAction elements registered on the GApplication itself\n   * (\"app.<name>\" — reachable from anywhere, including a Gio.Notification's\n   * action buttons, which can only ever target an app-level action).\n   *\n   * @deprecated Render `<ApplicationActions>` (react-native-gtkx/gtk) inside\n   * the app instead. Options render as SIBLINGS of the app tree, so no\n   * context of the app's can reach them and the set is fixed for the\n   * process's lifetime. Still supported; see docs/api.md.\n   */\n  applicationActions?: ReactNode\n  // Keyboard accelerators bound to actions, at the application level —\n  // GtkApplication's own actionAccels prop, unchanged. NOT deprecated with\n  // the three ReactNode options below: this is a flat name→keys table with\n  // no children and nothing to read from context, and it is deliberately\n  // process-wide (an accelerator for an action that is not currently\n  // registered simply does nothing). A shortcut that should come and go\n  // with a screen is a GtkShortcutController in <WindowControllers>.\n  actionAccels?: ActionAccel[]\n  /**\n   * GSimpleAction elements registered on the window (\"win.<name>\" — what a\n   * HeaderBar button's actionName or a GMenu item usually targets).\n   *\n   * @deprecated Render `<WindowActions>` (react-native-gtkx/gtk) inside the\n   * app instead — it can read the app's context and registers/unregisters\n   * with the component that declares it. Still supported; see docs/api.md.\n   */\n  windowActions?: ReactNode\n  /**\n   * Event controllers attached to the window itself — a\n   * GtkShortcutController scoped to the whole window is the common case.\n   *\n   * @deprecated Render `<WindowControllers>` (react-native-gtkx/gtk) inside\n   * the app instead, for the same reasons as `windowActions`. Still\n   * supported; see docs/api.md.\n   */\n  windowControllers?: ReactNode\n  // AdwBreakpoint elements, evaluated against the window's own allocated\n  // size. Only meaningful under chrome: \"content\" (AdwApplicationWindow) —\n  // GtkApplicationWindow has no such concept, so this is ignored (with a\n  // dev warning) under the default \"system\" chrome.\n  breakpoints?: ReactNode\n}\n\n// RN parity: system \"reduce animations\" hints never auto-stop RN animations\n// (ActivityIndicator keeps spinning; honoring reduce-motion is an explicit\n// opt-in via AccessibilityInfo). Our Animated runs on GLib timers and already\n// ignores the hint, so GTK-internal animations (GtkSpinner, switch slides)\n// must behave the same — otherwise e.g. GNOME under software rendering\n// reports enable-animations=false through the settings portal and spinners\n// freeze while Animated keeps moving.\nlet animationsForced = false\nconst forceEnableAnimations = (): void => {\n  if (animationsForced) {\n    return\n  }\n  const settings = Gtk.Settings.getDefault()\n  if (!settings) {\n    return\n  }\n  animationsForced = true\n  // Application-set GtkSettings values outrank the desktop backend, so a\n  // later portal update cannot flip this back.\n  settings.gtkEnableAnimations = true\n}\n\n// chrome \"content\": the app component IS the window content (a navigation\n// container whose pages host their own NestedRoots) — no window-level Yoga\n// root in between: the layout root would not allocate foreign GTK children.\nconst ContentChrome = ({\n  App,\n  initialProps,\n}: {\n  App: ComponentType<Record<string, unknown>>\n  initialProps: Record<string, unknown>\n}) => {\n  useLayoutEffect(() => {\n    forceEnableAnimations()\n  }, [])\n  return <App {...initialProps} />\n}\n\nconst WindowContent = ({\n  App,\n  initialProps,\n  initialWidth,\n  initialHeight,\n}: {\n  App: ComponentType<Record<string, unknown>>\n  initialProps: Record<string, unknown>\n  initialWidth: number\n  initialHeight: number\n}) => {\n  // Settings need an initialized display, and writing them mid-render is\n  // unsafe — apply after the window mounts.\n  useLayoutEffect(() => {\n    forceEnableAnimations()\n  }, [])\n\n  // The Root is the window's direct child: RnGtkxLayout reports a zero\n  // minimum (the window shrinks freely — no ratchet) and adopts the actual\n  // content-area allocation as the layout viewport. No scrollable wrapper\n  // means a window can never scroll its own root — RN semantics, scrolling\n  // stays opt-in via <ScrollView>.\n  return (\n    <Root\n      width={initialWidth}\n      height={initialHeight}\n      followAllocation\n    >\n      <App {...initialProps} />\n    </Root>\n  )\n}\n\nexport const AppRegistry = {\n  registerComponent(appKey: string, provider: ComponentProvider): string {\n    registry.set(appKey, provider)\n    return appKey\n  },\n\n  getAppKeys(): string[] {\n    return [...registry.keys()]\n  },\n\n  runApplication(appKey: string, params: RunApplicationParams = {}): void {\n    const provider = registry.get(appKey)\n    if (!provider) {\n      throw new Error(\n        `AppRegistry: no component registered for \"${appKey}\". ` +\n          `Registered: ${[...registry.keys()].join(\", \") || \"(none)\"}`,\n      )\n    }\n    const App = provider()\n    const width = params.width ?? 800\n    const height = params.height ?? 600\n\n    const contentChrome = params.chrome === \"content\"\n    activeChrome = contentChrome ? \"content\" : \"system\"\n\n    if (\n      process.env.NODE_ENV !== \"production\" &&\n      params.breakpoints &&\n      !contentChrome\n    ) {\n      console.warn(\n        '[react-native-gtkx] breakpoints was passed to runApplication without chrome: \"content\" — GtkApplicationWindow (the \"system\" chrome default) has no breakpoints concept, so it is ignored.',\n      )\n    }\n\n    const content = contentChrome ? (\n      <ContentChrome\n        App={App}\n        initialProps={params.initialProps ?? {}}\n      />\n    ) : (\n      <WindowContent\n        App={App}\n        initialProps={params.initialProps ?? {}}\n        initialWidth={width}\n        initialHeight={height}\n      />\n    )\n\n    const AppWindow = () =>\n      contentChrome ? (\n        <AdwApplicationWindow\n          title={params.title ?? appKey}\n          defaultWidth={width}\n          defaultHeight={height}\n          onCloseRequest={quit}\n          actions={params.windowActions}\n          controllers={params.windowControllers}\n          breakpoints={params.breakpoints}\n        >\n          {content}\n        </AdwApplicationWindow>\n      ) : (\n        <GtkApplicationWindow\n          title={params.title ?? appKey}\n          defaultWidth={width}\n          defaultHeight={height}\n          onCloseRequest={quit}\n          actions={params.windowActions}\n          controllers={params.windowControllers}\n        >\n          {content}\n        </GtkApplicationWindow>\n      )\n\n    createRoot().render(\n      <GtkApplication\n        actions={params.applicationActions}\n        actionAccels={params.actionAccels}\n      >\n        <AppWindow />\n      </GtkApplication>,\n    )\n  },\n}\n"]}

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/index.d.ts

@@ -4,11 +4,15 @@ export { AppRegistry, type RunApplicationParams } from "./app-registry";
 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 { Modal, type ModalProps } from "./modal";
-export { Pressable, TouchableOpacity, type PressableProps, type PressableStateCallbackType, type PressEvent, type TouchableOpacityProps, } from "./pressable";
+export { Pressable, TouchableOpacity, type NativeTouch, type PressableProps, type PressableStateCallbackType, type PressEvent, type TouchableOpacityProps, } 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 { 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, } from "./measure";
 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

@@ -10,5 +10,6 @@ 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 { 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,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,GAMjB,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,EACL,YAAY,EACZ,SAAS,EACT,IAAI,GAGL,MAAM,QAAQ,CAAA;AAQf,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,sCAAsC,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 NativeTouch,\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 {\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} from \"./measure\"\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,13 @@
+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;
+/** 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, onSuccess: MeasureLayoutOnSuccessCallback, onFail?: () => void): void;
+};
+export declare const createMeasureHandle: (widgetRef: RefObject<Gtk.Widget | null>, node: LayoutNodeApi) => MeasureHandle;

package/dist/components/measure.js

@@ -0,0 +1,51 @@
+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.
+const widgetOf = new WeakMap();
+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 = widgetOf.get(relativeTo)?.() ?? null;
+            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);
+        },
+    };
+    widgetOf.set(handle, () => widgetRef.current);
+    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;AAoC7B,0EAA0E;AAC1E,yEAAyE;AACzE,2EAA2E;AAC3E,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA0C,CAAA;AAEtE,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,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,IAAI,CAAA;YAClD,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,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IAC7C,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/** 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,\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.\nconst widgetOf = new WeakMap<MeasureHandle, () => Gtk.Widget | null>()\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 = widgetOf.get(relativeTo)?.() ?? null\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  widgetOf.set(handle, () => widgetRef.current)\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"]}

package/dist/components/pressable.d.ts

@@ -1,16 +1,12 @@
 import { type ReactNode } from "react";
 import type { StyleProp } from "../contracts";
+import { type PressEvent } from "./press-event";
 import { type LayoutEvent } from "./use-layout-child";
 export type PressableStateCallbackType = {
     pressed: boolean;
     hovered: boolean;
 };
-export type PressEvent = {
-    nativeEvent: {
-        x: number;
-        y: number;
-    };
-};
+export type { NativeTouch, PressEvent } from "./press-event";
 export type PressableProps = {
     style?: StyleProp | ((state: PressableStateCallbackType) => StyleProp);
     children?: ReactNode | ((state: PressableStateCallbackType) => ReactNode);

package/dist/components/pressable.js

@@ -1,21 +1,46 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useLayoutEffect, useRef, useState } from "react";
+import { useLayoutEffect, useReducer, useRef, useState, } from "react";
+import { splitStyle, StyleSheet } from "../style/index";
+import { defaultCssRegistry } from "../style/registry.gtkx";
 import { Gtk, GtkBox } from "../gtkx/bridge/index";
+import { perfAddTime, perfCount, perfEnabled, perfNow } from "../perf";
 import { HostNodeContext } from "./host-node";
+import { createPressEvent, createTouch } from "./press-event";
 import { useLayoutChild, useRnContainer, } from "./use-layout-child";
-const pressEvent = (x, y) => ({
-    nativeEvent: { x, y },
-});
+// Coordinates arrive from GtkGestureClick in the widget's own space, which
+// is exactly RN's locationX/locationY; createTouch translates them into the
+// window for pageX/pageY.
+const pressEvent = (widget, x, y) => createPressEvent(createTouch(widget, x, y));
 // A View with a click gesture and hover tracking. State-dependent style and
 // children follow the RN Pressable function-prop contract.
 export const Pressable = ({ style, children, onPress, onPressIn, onPressOut, onLongPress, onHoverIn, onHoverOut, disabled = false, delayLongPress = 500, onLayout, testID, }) => {
     const widgetRef = useRef(null);
     const [pressed, setPressed] = useState(false);
-    const [hovered, setHovered] = useState(false);
+    // Hover is not React state: a boundary crossing should cost what it costs
+    // a native GtkListBox row to swap a CSS class, not a setState + render +
+    // Yoga + allocate cycle (measured: roughly 500x the latency of a native
+    // row at rest, see docs/research/scroll-performance.md, task 007).
+    // `hoveredRef` is the single source of truth, read directly at render
+    // time — safe here because this component already mutates
+    // `handlersRef.current` in the render body below, so render was never
+    // React-DOM-pure to begin with. `forceRender` is used only for the two
+    // cases that genuinely need a real render: `children` reads `hovered`,
+    // or hovering would itself change layout (not just paint).
+    const hoveredRef = useRef(false);
+    const [, forceRender] = useReducer((n) => n + 1, 0);
     const longPressTimer = useRef(null);
     const longPressFired = useRef(false);
-    const state = { pressed, hovered };
-    // Gestures are attached imperatively even though rc.2 has a declarative
+    // TEMPORARY perf instrumentation (task 007, see
+    // docs/research/scroll-performance.md): timestamp the native enter/leave
+    // signal so hover's real signal-to-applied latency can be reported —
+    // synchronously for the fast path below, after the resulting commit for
+    // the slow one. perf.ts hooks are no-ops unless GTKX_PERF=1.
+    const hoverSignalAt = useRef(null);
+    const state = {
+        pressed,
+        hovered: hoveredRef.current,
+    };
+    // Gestures are attached imperatively even though rc.3 has a declarative
     // `controllers` slot: the controllers are wired exactly once per widget and
     // the handlers read the latest props through a ref, so a re-render never
     // detaches and re-adds a gesture mid-press.
@@ -36,11 +61,54 @@ export const Pressable = ({ style, children, onPress, onPressIn, onPressOut, onL
     });
     const resolvedStyle = typeof style === "function" ? style(state) : style;
     const resolvedChildren = typeof children === "function" ? children(state) : children;
-    const { host, node, cssClass } = useLayoutChild(widgetRef, {
+    const { host, node, cssClass, flat } = useLayoutChild(widgetRef, {
         style: resolvedStyle,
         onLayout,
     });
     useRnContainer(widgetRef, node);
+    // Hover fast path: when `children` does not read state, hovering can
+    // never change what is rendered — only `style` might. Precompute the CSS
+    // class for the OTHER hover value so the native enter/leave handlers
+    // below can swap classes directly on the widget, with no React involved
+    // at all. If hovering would also change LAYOUT (rare — every hover style
+    // in this codebase's own examples is background/border) that swap is
+    // unsafe, since a real reflow is required; fall back to the ordinary
+    // render in that case, exactly as before this change.
+    let hoverOnClass = null;
+    let hoverOffClass = null;
+    let canSwapHoverClass = typeof children !== "function";
+    if (canSwapHoverClass && typeof style === "function") {
+        const otherState = {
+            pressed,
+            hovered: !hoveredRef.current,
+        };
+        const otherFlat = StyleSheet.flatten(style(otherState));
+        const otherSplit = splitStyle(otherFlat);
+        const currentLayout = splitStyle(flat).layout;
+        if (JSON.stringify(currentLayout) !== JSON.stringify(otherSplit.layout)) {
+            // Hovering resizes or repositions this widget — a CSS class alone
+            // cannot do that, it needs Yoga. Fall back to a real render.
+            canSwapHoverClass = false;
+        }
+        else {
+            const otherClass = defaultCssRegistry.getClassName(otherSplit.visual);
+            hoverOnClass = hoveredRef.current ? cssClass : otherClass;
+            hoverOffClass = hoveredRef.current ? otherClass : cssClass;
+        }
+    }
+    // TEMPORARY perf instrumentation (task 007): runs after every commit, so
+    // it always lands right after whatever render the SLOW hover path
+    // triggered. A no-op when no hover signal is pending (the common case:
+    // renders triggered by anything else, or the fast path above, which
+    // measures itself synchronously) or when GTKX_PERF is unset.
+    useLayoutEffect(() => {
+        if (!perfEnabled || hoverSignalAt.current === null) {
+            return;
+        }
+        perfAddTime("pressable.hoverApply", perfNow() - hoverSignalAt.current);
+        perfCount("pressable.hoverFullCycle");
+        hoverSignalAt.current = null;
+    });
     const clearLongPress = () => {
         if (longPressTimer.current !== null) {
             clearTimeout(longPressTimer.current);
@@ -53,12 +121,15 @@ export const Pressable = ({ style, children, onPress, onPressIn, onPressOut, onL
         }
         longPressFired.current = false;
         setPressed(true);
-        onPressIn?.(pressEvent(x, y));
+        const widget = widgetRef.current;
+        onPressIn?.(pressEvent(widget, x, y));
         if (onLongPress) {
             clearLongPress();
             longPressTimer.current = setTimeout(() => {
                 longPressFired.current = true;
-                onLongPress(pressEvent(x, y));
+                // Timestamped when it FIRES, not when the press started — the delay
+                // is the whole point of the event.
+                onLongPress(pressEvent(widgetRef.current, x, y));
             }, delayLongPress);
         }
     };
@@ -68,27 +139,55 @@ export const Pressable = ({ style, children, onPress, onPressIn, onPressOut, onL
         }
         clearLongPress();
         setPressed(false);
-        onPressOut?.(pressEvent(x, y));
+        const widget = widgetRef.current;
+        onPressOut?.(pressEvent(widget, x, y));
         if (!longPressFired.current) {
-            onPress?.(pressEvent(x, y));
+            onPress?.(pressEvent(widget, x, y));
         }
     };
     const handleCancel = () => {
         clearLongPress();
         setPressed(false);
     };
+    // Applies a hover transition: fires the RN callback, then either swaps
+    // the precomputed CSS class directly on the widget (fast path) or forces
+    // the ordinary render (slow path) — see the `canSwapHoverClass` block
+    // above for which one applies this render.
+    const applyHover = (next, fire) => {
+        const t0 = perfEnabled ? perfNow() : 0;
+        hoveredRef.current = next;
+        fire?.();
+        if (!canSwapHoverClass) {
+            if (perfEnabled) {
+                hoverSignalAt.current = t0;
+                perfCount("pressable.hoverEvent");
+            }
+            forceRender();
+            return;
+        }
+        const widget = widgetRef.current;
+        const applyClass = next ? hoverOnClass : hoverOffClass;
+        const removeClass = next ? hoverOffClass : hoverOnClass;
+        if (widget && hoverOnClass !== hoverOffClass) {
+            if (removeClass) {
+                widget.removeCssClass(removeClass);
+            }
+            if (applyClass) {
+                widget.addCssClass(applyClass);
+            }
+        }
+        if (perfEnabled) {
+            perfAddTime("pressable.hoverApply", perfNow() - t0);
+            perfCount("pressable.hoverEvent");
+            perfCount("pressable.hoverFast");
+        }
+    };
     handlersRef.current = {
         handlePressed,
         handleReleased,
         handleCancel,
-        handleEnter: () => {
-            setHovered(true);
-            onHoverIn?.();
-        },
-        handleLeave: () => {
-            setHovered(false);
-            onHoverOut?.();
-        },
+        handleEnter: () => applyHover(true, onHoverIn),
+        handleLeave: () => applyHover(false, onHoverOut),
     };
     useLayoutEffect(() => {
         const widget = widgetRef.current;