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

package/dist/navigation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.tsx"],"names":[],"mappings":"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","sourcesContent":["// react-native-gtkx/navigation — a react-navigation stack navigator backed\n// by Adw.NavigationView. The model mirrors @react-navigation/native-stack\n// on iOS (UINavigationController): react-navigation state is the source of\n// truth, the native view is imperatively synced to it, and NATIVE pops (the\n// Adwaita back button, Escape, the back gesture) are reported back through\n// the \"popped\" signal.\n//\n// Sync protocol (the two directions must not echo each other):\n// - state → view: an effect diffs the synced tag stack against\n//   state.routes and drives pushByTag / popToTag / replaceWithTags. Pages\n//   are declarative children keyed by route.key, so the widgets exist\n//   before the effect runs.\n// - view → state: \"popped\" fires for EVERY popped page, ours and the\n//   user's. The discriminator is the state itself: a tag that is still in\n//   state.routes means the user popped the view (dispatch POP); a tag\n//   already gone from state means the pop was state-driven — ignore.\nimport {\n  createNavigatorFactory,\n  StackActions,\n  StackRouter,\n  useNavigationBuilder,\n  usePreventRemoveContext,\n  type NavigationProp,\n  type ParamListBase,\n  type RouteProp,\n  type StackNavigationState,\n} from \"@react-navigation/native\"\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  type ComponentType,\n  type ReactNode,\n  type RefObject,\n} from \"react\"\nimport { InteractionManager } from \"../apis/interaction-manager\"\nimport { getActiveChrome } from \"../components/app-registry\"\nimport { IntrinsicRoot, NestedRoot } from \"../components/root\"\nimport {\n  AdwHeaderBar,\n  AdwNavigationPage,\n  AdwNavigationView,\n  AdwToolbarView,\n  GtkButton,\n  type Adw,\n} from \"../gtkx/bridge/index\"\nimport { warnIgnoredOptions } from \"./option-warnings\"\nimport type { HeaderButton } from \"./sidebar\"\n\nconst STACK_OPTION_KEYS: ReadonlySet<string> = new Set([\n  \"title\",\n  \"headerShown\",\n  \"headerButtons\",\n  \"headerLeft\",\n  \"headerRight\",\n  \"gestureEnabled\",\n])\n\nexport type StackNavigationOptions = {\n  /** HeaderBar title; defaults to the route name. */\n  title?: string\n  /** Render the Adwaita HeaderBar for this screen (default true). */\n  headerShown?: boolean\n  /** Buttons packed at the end of this screen's HeaderBar (see\n   *  HeaderButton); screens usually set them via navigation.setOptions. */\n  headerButtons?: HeaderButton[]\n  /** RN content packed at the start of the HeaderBar (an intrinsic-size\n   *  layout root: the content's Yoga size IS the slot size). */\n  headerLeft?: () => ReactNode\n  /** RN content packed at the end of the HeaderBar, before headerButtons. */\n  headerRight?: () => ReactNode\n  /** false disables the native back button, Escape and the back gesture\n   *  for this screen (the page's Adwaita can-pop). Programmatic goBack\n   *  still works. Also the mechanism behind usePreventRemove. */\n  gestureEnabled?: boolean\n}\n\ntype StackDescriptor = {\n  options: StackNavigationOptions\n  render: () => ReactNode\n  // react-navigation hands every descriptor its own route.\n  route: { key: string; name: string }\n}\n\ntype StackNavigatorProps = {\n  initialRouteName?: string\n  screenOptions?: StackNavigationOptions\n  children: ReactNode\n}\n\nconst StackNavigator = ({\n  initialRouteName,\n  screenOptions,\n  children,\n}: StackNavigatorProps) => {\n  const { state, descriptors, navigation, NavigationContent } =\n    useNavigationBuilder<\n      StackNavigationState<ParamListBase>,\n      Record<string, unknown>,\n      Record<string, () => void>,\n      StackNavigationOptions,\n      Record<string, unknown>\n    >(StackRouter, {\n      initialRouteName,\n      screenOptions,\n      children,\n    })\n\n  const viewRef = useRef<Adw.NavigationView | null>(null)\n\n  useEffect(() => {\n    for (const route of state.routes) {\n      const descriptor = descriptors[route.key] as StackDescriptor | undefined\n      if (descriptor) {\n        warnIgnoredOptions(\n          \"createStackNavigator\",\n          descriptor.options,\n          STACK_OPTION_KEYS,\n        )\n      }\n    }\n  }, [state, descriptors])\n\n  useEffect(() => {\n    if (\n      process.env.NODE_ENV !== \"production\" &&\n      getActiveChrome() === \"system\"\n    ) {\n      console.warn(\n        '[react-native-gtkx/navigation] the app runs with the default window chrome — pages bring their own HeaderBars, so you will see a doubled titlebar. Pass chrome: \"content\" to AppRegistry.runApplication.',\n      )\n    }\n  }, [])\n  // Mirror of the view's visible stack (route keys), maintained by the sync\n  // effect and by the popped handler — the two never race: GTK signals run\n  // synchronously inside the very push/pop calls the effect makes.\n  const syncedRef = useRef<string[]>([])\n\n  // Pop ANIMATION support: react-navigation drops a popped route from state\n  // immediately, but Adwaita still animates the page out (~200 ms). Pages\n  // therefore render from renderedKeys — live routes plus closing pages —\n  // and a closing page leaves only on its \"hidden\" signal (the end of the\n  // transition). Its content renders from a snapshot cached while live.\n  const [renderedKeys, setRenderedKeys] = useState<string[]>(() =>\n    state.routes.map((route) => route.key),\n  )\n  const liveKeys = state.routes.map((route) => route.key)\n  const missingKeys = liveKeys.filter((key) => !renderedKeys.includes(key))\n  if (missingKeys.length > 0) {\n    // The sanctioned derive-state-during-render pattern: a new route must be\n    // in renderedKeys within the same commit its page is pushed.\n    setRenderedKeys([...renderedKeys, ...missingKeys])\n  }\n  // A state-held stable Map (not a ref): the render path reads it for\n  // closing pages, and the react-hooks/refs rule rightly bans render-time\n  // ref reads.\n  const [snapshots] = useState(\n    () =>\n      new Map<\n        string,\n        { name: string; options: StackNavigationOptions; element: ReactNode }\n      >(),\n  )\n  useEffect(() => {\n    for (const route of state.routes) {\n      const descriptor = descriptors[route.key] as StackDescriptor | undefined\n      if (descriptor) {\n        snapshots.set(route.key, {\n          name: route.name,\n          options: descriptor.options,\n          element: <NestedRoot>{descriptor.render()}</NestedRoot>,\n        })\n      }\n    }\n  })\n\n  const handleHidden = useCallback(\n    (key: string): void => {\n      // \"hidden\" also fires for a live page covered by a push — only pages\n      // gone from state are actually closing.\n      if (navigation.getState().routes.some((route) => route.key === key)) {\n        return\n      }\n      snapshots.delete(key)\n      setRenderedKeys((keys) => keys.filter((rendered) => rendered !== key))\n    },\n    [navigation, snapshots],\n  )\n\n  // \"hidden\" delivery is not guaranteed in every environment (headless\n  // compositors with animations disabled never emit it) — a timer slightly\n  // longer than the Adwaita transition is the fallback; handleHidden is\n  // idempotent, whichever fires first wins.\n  const scheduleRetainedRemoval = useCallback(\n    (key: string): void => {\n      setTimeout(() => handleHidden(key), 400)\n    },\n    [handleHidden],\n  )\n\n  // Bracket every view transition with an InteractionManager handle so\n  // runAfterInteractions-scheduled work (a screen's own data load / heavy\n  // render) waits for the slide to finish instead of stealing its frames.\n  // The handle is opened when the sync effect mutates the view and cleared\n  // one transition-length later; overlapping transitions reference-count.\n  const beginTransition = useCallback((): void => {\n    const handle = InteractionManager.createInteractionHandle()\n    setTimeout(() => InteractionManager.clearInteractionHandle(handle), 400)\n  }, [])\n\n  useEffect(() => {\n    const view = viewRef.current\n    if (!view) {\n      return\n    }\n    const target = state.routes.map((route) => route.key)\n    if (syncedRef.current.length === 0 && target.length > 0) {\n      // First mount: NavigationView shows the first added page by itself.\n      syncedRef.current = target.slice(0, 1)\n    }\n    let common = 0\n    while (\n      common < syncedRef.current.length &&\n      common < target.length &&\n      syncedRef.current[common] === target[common]\n    ) {\n      common += 1\n    }\n    if (common === 0 && syncedRef.current[0] !== target[0]) {\n      // The stack root changed (reset): swap the whole visible stack.\n      const leaving = syncedRef.current.filter((key) => !target.includes(key))\n      syncedRef.current = [...target]\n      beginTransition()\n      view.replaceWithTags(target)\n      for (const key of leaving) {\n        scheduleRetainedRemoval(key)\n      }\n      return\n    }\n    if (syncedRef.current.length > common) {\n      const anchor = target[common - 1]\n      const leaving = syncedRef.current.slice(common)\n      syncedRef.current = syncedRef.current.slice(0, common)\n      if (anchor !== undefined) {\n        beginTransition()\n        view.popToTag(anchor)\n      }\n      for (const key of leaving) {\n        scheduleRetainedRemoval(key)\n      }\n    }\n    for (\n      let index = syncedRef.current.length;\n      index < target.length;\n      index += 1\n    ) {\n      const key = target[index]!\n      syncedRef.current.push(key)\n      beginTransition()\n      view.pushByTag(key)\n    }\n  }, [state, scheduleRetainedRemoval, beginTransition])\n\n  // `navigation` is identity-stable across renders (react-navigation\n  // builder contract) and getState() always reads the live state — the\n  // closure needs no ref indirection.\n  const handlePopped = (page: Adw.NavigationPage | null): void => {\n    const tag = page?.getTag()\n    if (!tag) {\n      return\n    }\n    syncedRef.current = syncedRef.current.filter((key) => key !== tag)\n    const current = navigation.getState()\n    if (current.routes.some((route) => route.key === tag)) {\n      // The view popped on its own (back button / gesture): follow in state.\n      navigation.dispatch(StackActions.pop())\n    }\n    scheduleRetainedRemoval(tag)\n  }\n\n  return (\n    <NavigationContent>\n      <StackView\n        viewRef={viewRef}\n        renderedKeys={renderedKeys}\n        routeKeys={state.routes.map((route) => route.key)}\n        descriptors={descriptors}\n        snapshots={snapshots}\n        onPopped={handlePopped}\n        onHidden={handleHidden}\n      />\n    </NavigationContent>\n  )\n}\n\ntype StackViewProps = {\n  viewRef: RefObject<Adw.NavigationView | null>\n  renderedKeys: string[]\n  routeKeys: string[]\n  descriptors: Record<string, unknown>\n  snapshots: Map<\n    string,\n    { name: string; options: StackNavigationOptions; element: ReactNode }\n  >\n  onPopped: (page: Adw.NavigationPage | null) => void\n  onHidden: (key: string) => void\n}\n\n// The page list lives inside NavigationContent so it can read the\n// prevent-remove context (which useNavigationBuilder only provides to\n// NavigationContent's children). A page whose route is prevented — or whose\n// screen set gestureEnabled: false — reports canPop: false, so Adwaita\n// disables the back button, Escape and the back gesture for it; a\n// programmatic goBack still pops (once the app lifts the prevention, e.g.\n// after its own confirmation dialog). This is why a native pop can never\n// race react-navigation state for these routes.\nconst StackView = ({\n  viewRef,\n  renderedKeys,\n  routeKeys,\n  descriptors,\n  snapshots,\n  onPopped,\n  onHidden,\n}: StackViewProps) => {\n  const { preventedRoutes } = usePreventRemoveContext()\n  return (\n    <AdwNavigationView\n      ref={viewRef}\n      onPopped={(page) => onPopped(page)}\n    >\n      {renderedKeys.map((key) => {\n        const isLive = routeKeys.includes(key)\n        const descriptor = isLive\n          ? (descriptors[key] as StackDescriptor | undefined)\n          : undefined\n        const snapshot = snapshots.get(key)\n        const options = descriptor?.options ?? snapshot?.options ?? {}\n        const headerShown = options.headerShown ?? true\n        const canPop =\n          options.gestureEnabled !== false &&\n          !preventedRoutes[key]?.preventRemove\n        const content = descriptor ? (\n          <NestedRoot>{descriptor.render()}</NestedRoot>\n        ) : (\n          (snapshot?.element ?? null)\n        )\n        return (\n          <AdwNavigationPage\n            key={key}\n            tag={key}\n            // Never the route key — that is an internal identifier, and\n            // it would end up in the window title under content chrome.\n            title={\n              options.title ?? descriptor?.route.name ?? snapshot?.name ?? key\n            }\n            canPop={canPop}\n            onHidden={() => onHidden(key)}\n          >\n            {headerShown ? (\n              <AdwToolbarView\n                topBar={\n                  <AdwHeaderBar\n                    start={\n                      options.headerLeft ? (\n                        <IntrinsicRoot>{options.headerLeft()}</IntrinsicRoot>\n                      ) : undefined\n                    }\n                    end={[\n                      ...(options.headerRight\n                        ? [\n                            <IntrinsicRoot key=\"header-right\">\n                              {options.headerRight()}\n                            </IntrinsicRoot>,\n                          ]\n                        : []),\n                      ...(options.headerButtons?.map((button) => (\n                        <GtkButton\n                          key={button.id}\n                          iconName={button.icon}\n                          tooltipText={button.tooltip}\n                          onClicked={button.onPress}\n                        />\n                      )) ?? []),\n                    ]}\n                  />\n                }\n              >\n                {content}\n              </AdwToolbarView>\n            ) : (\n              content\n            )}\n          </AdwNavigationPage>\n        )\n      })}\n    </AdwNavigationView>\n  )\n}\n\n// ---- typed factory --------------------------------------------------------\n// The upstream createNavigatorFactory returns `any` — mirroring the typed\n// wrapper pattern of native-stack gives Screen configs, options and screen\n// props real types without changing runtime behavior.\n\nexport type StackNavigationHelpers<\n  ParamList extends ParamListBase = ParamListBase,\n  RouteName extends keyof ParamList = keyof ParamList,\n> = NavigationProp<\n  ParamList,\n  RouteName,\n  undefined,\n  StackNavigationState<ParamList>,\n  StackNavigationOptions\n>\n\nexport type StackScreenProps<\n  ParamList extends ParamListBase = ParamListBase,\n  RouteName extends keyof ParamList = keyof ParamList,\n> = {\n  route: RouteProp<ParamList, RouteName>\n  navigation: StackNavigationHelpers<ParamList, RouteName>\n}\n\nexport type StackScreenConfig<\n  ParamList extends ParamListBase,\n  RouteName extends keyof ParamList,\n> = {\n  name: RouteName\n  component: ComponentType<StackScreenProps<ParamList, RouteName>>\n  options?:\n    | StackNavigationOptions\n    | ((\n        props: StackScreenProps<ParamList, RouteName>,\n      ) => StackNavigationOptions)\n  initialParams?: Partial<ParamList[RouteName]>\n}\n\nexport type TypedStackNavigator<ParamList extends ParamListBase> = {\n  Navigator: ComponentType<StackNavigatorProps>\n  Screen: <RouteName extends keyof ParamList>(\n    props: StackScreenConfig<ParamList, RouteName>,\n  ) => null\n}\n\nconst stackFactory = createNavigatorFactory(StackNavigator)\n\nexport const createStackNavigator = <\n  ParamList extends ParamListBase = ParamListBase,\n>(): TypedStackNavigator<ParamList> =>\n  stackFactory() as TypedStackNavigator<ParamList>\n\nexport {\n  createSidebarNavigator,\n  type HeaderButton,\n  type SidebarNavigationOptions,\n  type SidebarScreenConfig,\n  type SidebarScreenProps,\n  type TypedSidebarNavigator,\n} from \"./sidebar\"\n\n// The rest of the react-navigation surface apps need, so a linux app can\n// import everything from one place.\nexport {\n  CommonActions,\n  NavigationContainer,\n  StackActions,\n  useFocusEffect,\n  useIsFocused,\n  useNavigation,\n  useNavigationContainerRef,\n  usePreventRemove,\n  useRoute,\n} from \"@react-navigation/native\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.tsx"],"names":[],"mappings":"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","sourcesContent":["// react-native-gtkx/navigation — a react-navigation stack navigator backed\n// by the Adw.NavigationView primitive from react-native-gtkx/adwaita.\n//\n// This file is an ADAPTER and nothing else. Every widget concern — diffing\n// the tag stack into pushes and pops, holding a popped page alive until its\n// exit animation ends, bracketing transitions — lives in the primitive. What\n// stays here is exactly the react-navigation half:\n//\n// - state → the ordered tags handed to NavigationStack (route keys);\n// - a native pop (back button, Escape, back gesture) → StackActions.pop,\n//   but only when the tag is still in state, otherwise the pop was one WE\n//   caused and echoing it would double-pop;\n// - descriptors → page titles, header content and canPop;\n// - unknown-option warnings.\n//\n// The same split as @react-navigation/native-stack over react-native-screens.\n// If you do not want a router, use the primitive directly.\nimport {\n  createNavigatorFactory,\n  StackActions,\n  StackRouter,\n  useNavigationBuilder,\n  usePreventRemoveContext,\n  type NavigationProp,\n  type NavigatorTypeBagBase,\n  type NavigatorTypeBagFor,\n  type ParamListBase,\n  type RouteProp,\n  type StackNavigationState,\n  type TypedNavigator,\n} from \"@react-navigation/native\"\nimport { useEffect, useRef, type ComponentType, type ReactNode } from \"react\"\nimport { getActiveChrome } from \"../components/app-registry\"\nimport { AdwHeaderBar, AdwToolbarView } from \"../adw\"\nimport {\n  HeaderSlotContent,\n  NavigationStack,\n  NavigationStackPage,\n  SlotContent,\n} from \"../common\"\nimport { GtkButton } from \"../gtkx/bridge/index\"\nimport { warnIgnoredOptions } from \"./option-warnings\"\nimport type { HeaderButton } from \"./sidebar\"\n\nconst STACK_OPTION_KEYS: ReadonlySet<string> = new Set([\n  \"title\",\n  \"headerShown\",\n  \"headerButtons\",\n  \"headerLeft\",\n  \"headerRight\",\n  \"gestureEnabled\",\n  \"animation\",\n])\n\nexport type StackNavigationOptions = {\n  /** AdwHeaderBar title; defaults to the route name. */\n  title?: string\n  /** Render the Adwaitan AdwHeaderBar for this screen (default true). */\n  headerShown?: boolean\n  /** Buttons packed at the end of this screen's AdwHeaderBar (see\n   *  HeaderButton); screens usually set them via navigation.setOptions. */\n  headerButtons?: HeaderButton[]\n  /** RN content packed at the start of the AdwHeaderBar (an intrinsic-size\n   *  layout root: the content's Yoga size IS the slot size). */\n  headerLeft?: () => ReactNode\n  /** RN content packed at the end of the AdwHeaderBar, before headerButtons. */\n  headerRight?: () => ReactNode\n  /** false disables the native back button, Escape and the back gesture\n   *  for this screen (the page's Adwaita can-pop). Programmatic goBack\n   *  still works. Also the mechanism behind usePreventRemove. */\n  gestureEnabled?: boolean\n  /**\n   * `\"none\"` turns transitions off; any other value (including the\n   * `@react-navigation/native-stack` style names like `\"slide_from_bottom\"`\n   * or `\"fade\"`) turns them on. GTK has exactly one transition style, so a\n   * specific requested type cannot be honored — only whether to animate at\n   * all can be. Requesting a specific (non-`\"default\"`) type still animates,\n   * with the standard Adwaita transition, and warns once in development.\n   * Read from whichever screen is currently on top of the visible stack, so\n   * setting it uniformly via `screenOptions` is the reliable way to use it —\n   * see docs/api.md.\n   */\n  animation?: string\n}\n\n// Matches @react-navigation/stack's and @react-navigation/native-stack's\n// own NativeStackNavigationEventMap/StackNavigationEventMap exactly (both\n// verified against their v8 source — this package is not a dependency, so\n// docs cannot be trusted here, see docs/api.md and 007.md). `closing` is\n// false for a route becoming visible (pushed) and true for a route leaving\n// the visible stack (popped); a route whose visibility does not change\n// (e.g. the screen covered by a push) never receives either event — an app\n// that listens for `transitionEnd` gets the identical event name and\n// payload shape it would get on iOS or Android.\nexport type StackNavigationEventMap = {\n  /** Fires when a push/pop/replace transition starts, once per involved\n   *  route (not once per gesture or user tap). */\n  transitionStart: { data: { closing: boolean } }\n  /** Fires when the transition settles, driven by the page's own real\n   *  `shown`/`hidden` AdwNavigationPage signal (see docs/api.md and the\n   *  primitive's beginTransition) — not a timer, except as a fallback for\n   *  the rare cases where neither signal arrives. Native pops (back\n   *  button, Escape, back gesture) do not fire this at all today — see\n   *  docs/api.md. */\n  transitionEnd: { data: { closing: boolean } }\n}\n\ntype StackDescriptor = {\n  options: StackNavigationOptions\n  render: () => ReactNode\n  // react-navigation hands every descriptor its own route.\n  route: { key: string; name: string }\n}\n\ntype StackNavigatorProps = {\n  initialRouteName?: string\n  screenOptions?: StackNavigationOptions\n  children: ReactNode\n}\n\nconst StackNavigator = ({\n  initialRouteName,\n  screenOptions,\n  children,\n}: StackNavigatorProps) => {\n  const { state, descriptors, navigation, NavigationContent } =\n    useNavigationBuilder<\n      StackNavigationState<ParamListBase>,\n      Record<string, unknown>,\n      Record<string, () => void>,\n      StackNavigationOptions,\n      StackNavigationEventMap\n    >(StackRouter, {\n      initialRouteName,\n      screenOptions,\n      children,\n    })\n\n  // React Navigation 8: `state.routes` is no longer just the visible stack —\n  // it is active routes followed by retained routes (closing, kept mounted\n  // for `inactiveBehavior`) and preloaded routes (`navigation.preload()`,\n  // not yet navigated to), all concatenated, with the focused/visible tail\n  // ending at `state.index` (see StackRouter's `getStateWithRoutes`: `routes:\n  // activeRoutes.concat(retainedRoutes, preloadedRoutes)`, `index:\n  // activeRoutes.length - 1`). Handing the whole array to NavigationStack\n  // would push a preloaded screen onto the widget as if it were a real page\n  // the user navigated to. Only the active slice is the visible stack.\n  const visibleRoutes = state.routes.slice(0, state.index + 1)\n  const visibleKeys = visibleRoutes.map((route) => route.key)\n\n  // GTK has exactly one transition style and one animate-transitions switch\n  // for the whole view — there is no per-route knob to hand it. The screen\n  // actually being navigated TO is the natural read of \"the currently\n  // relevant animation option\": for a push, that is the new top of stack;\n  // for a pop, the screen the pop reveals. An app that sets `animation`\n  // uniformly through `screenOptions` (the common case for \"turn animation\n  // off entirely\") gets the same value everywhere, so this only matters\n  // when different screens genuinely disagree.\n  const activeRouteKey = visibleKeys[visibleKeys.length - 1]\n  const activeDescriptor = activeRouteKey\n    ? (descriptors[activeRouteKey] as StackDescriptor | undefined)\n    : undefined\n  const animateTransitions = activeDescriptor?.options.animation !== \"none\"\n\n  useEffect(() => {\n    for (const route of state.routes) {\n      const descriptor = descriptors[route.key] as StackDescriptor | undefined\n      if (descriptor) {\n        warnIgnoredOptions(\n          \"createStackNavigator\",\n          descriptor.options,\n          STACK_OPTION_KEYS,\n        )\n        const { animation } = descriptor.options\n        // \"animation\" itself is in STACK_OPTION_KEYS above (it IS honored,\n        // collapsed to a boolean), so the call above never flags it. A\n        // specific requested type — anything but \"none\" (handled) or\n        // \"default\" (not a specific request) — is a separate, narrower\n        // complaint, forced through the same verdict lookup and the same\n        // once-per-navigator-per-key dedupe with an empty supported set.\n        if (\n          animation !== undefined &&\n          animation !== \"none\" &&\n          animation !== \"default\"\n        ) {\n          warnIgnoredOptions(\"createStackNavigator\", { animation }, new Set())\n        }\n      }\n    }\n  }, [state, descriptors])\n\n  useEffect(() => {\n    if (\n      process.env.NODE_ENV !== \"production\" &&\n      getActiveChrome() === \"system\"\n    ) {\n      console.warn(\n        '[react-native-gtkx/navigation] the app runs with the default window chrome — pages bring their own HeaderBars, so you will see a doubled titlebar. Pass chrome: \"content\" to AppRegistry.runApplication.',\n      )\n    }\n  }, [])\n\n  // `navigation` is identity-stable across renders (react-navigation builder\n  // contract) and getState() always reads the live state — no ref needed.\n  const handlePopped = (tag: string): void => {\n    if (navigation.getState().routes.some((route) => route.key === tag)) {\n      // Still in state, so the WIDGET popped on its own: follow in state.\n      navigation.dispatch(StackActions.pop())\n    }\n    // Otherwise state dropped the route first and the primitive is merely\n    // reporting the animation we asked for. Nothing to do.\n  }\n\n  // transitionStart/transitionEnd: translates NavigationStack's primitive\n  // callbacks into react-navigation's own per-route events, matching\n  // @react-navigation/stack and @react-navigation/native-stack's v8\n  // behavior byte for byte (verified against their source, not docs — see\n  // 007.md): a route that just became visible fires `closing: false`, a\n  // route that just left the visible stack fires `closing: true`, and a\n  // route whose visibility did not change (e.g. covered by a push) gets\n  // neither event.\n  //\n  // The start and end sides deliberately use TWO DIFFERENT primitive\n  // signals, not the same onTransitionStart/onTransitionEnd pair for both:\n  //\n  // - transitionStart (both directions) rides onTransitionStart, a\n  //   view-level \"a transition just began\" signal with no per-route\n  //   identity — the adapter supplies that identity itself by diffing\n  //   visibleKeys against the previous render's visible keys.\n  // - transitionEnd for an OPENING route also rides the view-level\n  //   onTransitionEnd, itself driven by the pushed page's own real \"shown\"\n  //   signal (transitionDuration only as a fallback — see docs/api.md and\n  //   the primitive's beginTransition): the pushed screen stays mounted\n  //   indefinitely once it is the active page, so nothing about that is\n  //   unsafe here either way.\n  // - transitionEnd for a CLOSING route rides onPageClosed instead, fired\n  //   PER TAG when that page's exit actually finishes (a real GTK\n  //   \"hidden\" signal when available, the primitive's own timer as\n  //   fallback). This was not a style choice: routing the closing side\n  //   through the generic view-level timer was tried first and is wrong\n  //   whenever the real close finishes before the fixed transitionDuration\n  //   default (guaranteed in headless test environments with animations\n  //   disabled, and possible on a real desktop too) — the closing screen's\n  //   React component has already unmounted (and unsubscribed its\n  //   listeners) by the time the generic, one-size-fits-all timer gets\n  //   around to firing, so the event never reaches anyone. onPageClosed\n  //   fires synchronously before React commits that unmount, so the\n  //   listener is still there to receive it.\n  //\n  // previousVisibleKeysRef is compared by CONTENT, not a call-count flag:\n  // NavigationStack's sync effect can call beginTransition() (hence\n  // onTransitionStart) more than once for one state update — e.g. popping\n  // back past two routes and pushing two new ones in the same dispatch\n  // calls it three times — and every one of those calls closes over the\n  // SAME visibleKeys for this render. Diffing against the ref and only\n  // then updating it makes every call after the first a no-op (the ref\n  // already equals visibleKeys), without a manual \"already handling a\n  // transition\" flag that would also incorrectly swallow a second,\n  // genuinely separate transition starting before the first one settles.\n  const previousVisibleKeysRef = useRef<string[]>(visibleKeys)\n  const pendingOpeningEndRef = useRef<string[]>([])\n  // Tags this adapter itself put in flight via transitionStart(closing:\n  // true) — NOT every tag onPageClosed ever reports. A native pop (back\n  // button, Escape, back gesture) also eventually drops its tag through\n  // the exact same primitive mechanism, but never called beginTransition()\n  // (see the primitive: a native pop's own handlePopped reconciles\n  // syncedRef directly, so the sync effect finds nothing left to push or\n  // pop once react-navigation's state catches up) — so it never got a\n  // transitionStart either. Without this guard, handlePageClosed would\n  // emit a transitionEnd with no matching transitionStart for every native\n  // pop, which is worse than emitting neither: a listener would see an\n  // end event out of nowhere. Documented as Known limitation #2 in 007.md\n  // — native pops fire neither event today.\n  const pendingClosingRef = useRef<Set<string>>(new Set())\n\n  const emitTransitionEvent = (\n    type: \"transitionStart\" | \"transitionEnd\",\n    keys: readonly string[],\n    closing: boolean,\n  ): void => {\n    for (const key of keys) {\n      navigation.emit({ type, data: { closing }, target: key })\n    }\n  }\n\n  const handleTransitionStart = (): void => {\n    const previous = previousVisibleKeysRef.current\n    if (\n      previous.length === visibleKeys.length &&\n      previous.every((key, index) => key === visibleKeys[index])\n    ) {\n      // A duplicate beginTransition() call for the same commit (see\n      // above) — already diffed by an earlier call this render.\n      return\n    }\n    const opening = visibleKeys.filter((key) => !previous.includes(key))\n    const closing = previous.filter((key) => !visibleKeys.includes(key))\n    previousVisibleKeysRef.current = visibleKeys\n    pendingOpeningEndRef.current.push(...opening)\n    for (const key of closing) {\n      pendingClosingRef.current.add(key)\n    }\n    emitTransitionEvent(\"transitionStart\", opening, false)\n    emitTransitionEvent(\"transitionStart\", closing, true)\n  }\n\n  // Drains whatever opening keys are pending rather than trusting call\n  // count, for the same reason handleTransitionStart diffs by content: a\n  // compound update's several onTransitionEnd calls (one per\n  // beginTransition() above) all land at essentially the same moment, so\n  // the first one emits everything queued and the rest find nothing left\n  // to drain. Closing keys are NOT handled here — see handlePageClosed.\n  const handleTransitionEnd = (): void => {\n    const opening = pendingOpeningEndRef.current\n    if (opening.length === 0) {\n      return\n    }\n    pendingOpeningEndRef.current = []\n    emitTransitionEvent(\"transitionEnd\", opening, false)\n  }\n\n  const handlePageClosed = (tag: string): void => {\n    if (!pendingClosingRef.current.has(tag)) {\n      // Not a tag this adapter put in flight (a native pop, or a stray\n      // call) — no transitionStart was ever emitted for it, so no\n      // transitionEnd either.\n      return\n    }\n    pendingClosingRef.current.delete(tag)\n    navigation.emit({\n      type: \"transitionEnd\",\n      data: { closing: true },\n      target: tag,\n    })\n  }\n\n  return (\n    <NavigationContent>\n      <StackView\n        routeKeys={visibleKeys}\n        descriptors={descriptors}\n        animateTransitions={animateTransitions}\n        onPopped={handlePopped}\n        onTransitionStart={handleTransitionStart}\n        onTransitionEnd={handleTransitionEnd}\n        onPageClosed={handlePageClosed}\n      />\n    </NavigationContent>\n  )\n}\n\ntype StackViewProps = {\n  routeKeys: string[]\n  descriptors: Record<string, unknown>\n  animateTransitions: boolean\n  onPopped: (tag: string) => void\n  onTransitionStart: () => void\n  onTransitionEnd: () => void\n  onPageClosed: (tag: string) => void\n}\n\n// The page list lives inside NavigationContent so it can read the\n// prevent-remove context (which useNavigationBuilder only provides to\n// NavigationContent's children). A page whose route is prevented — or whose\n// screen set gestureEnabled: false — reports canPop: false, so Adwaita\n// disables the back button, Escape and the back gesture for it; a\n// programmatic goBack still pops (once the app lifts the prevention, e.g.\n// after its own confirmation dialog). This is why a native pop can never\n// race react-navigation state for these routes.\nconst StackView = ({\n  routeKeys,\n  descriptors,\n  animateTransitions,\n  onPopped,\n  onTransitionStart,\n  onTransitionEnd,\n  onPageClosed,\n}: StackViewProps) => {\n  const { preventedRoutes } = usePreventRemoveContext()\n  return (\n    <NavigationStack\n      stack={routeKeys}\n      animateTransitions={animateTransitions}\n      onPopped={onPopped}\n      onTransitionStart={onTransitionStart}\n      onTransitionEnd={onTransitionEnd}\n      onPageClosed={onPageClosed}\n    >\n      {routeKeys.map((key) => {\n        const descriptor = descriptors[key] as StackDescriptor | undefined\n        if (!descriptor) {\n          return null\n        }\n        const options = descriptor.options\n        const headerShown = options.headerShown ?? true\n        const canPop =\n          options.gestureEnabled !== false &&\n          !preventedRoutes[key]?.preventRemove\n        const content = <SlotContent>{descriptor.render()}</SlotContent>\n        return (\n          <NavigationStackPage\n            key={key}\n            tag={key}\n            // Never the route key — that is an internal identifier, and it\n            // would end up in the window title under content chrome.\n            title={options.title ?? descriptor.route.name}\n            canPop={canPop}\n          >\n            {headerShown ? (\n              <AdwToolbarView\n                topBar={\n                  <AdwHeaderBar\n                    start={\n                      options.headerLeft ? (\n                        <HeaderSlotContent>\n                          {options.headerLeft()}\n                        </HeaderSlotContent>\n                      ) : undefined\n                    }\n                    end={[\n                      ...(options.headerRight\n                        ? [\n                            <HeaderSlotContent key=\"header-right\">\n                              {options.headerRight()}\n                            </HeaderSlotContent>,\n                          ]\n                        : []),\n                      ...(options.headerButtons?.map((button) => (\n                        <GtkButton\n                          key={button.id}\n                          iconName={button.icon}\n                          tooltipText={button.tooltip}\n                          onClicked={button.onPress}\n                        />\n                      )) ?? []),\n                    ]}\n                  />\n                }\n              >\n                {content}\n              </AdwToolbarView>\n            ) : (\n              content\n            )}\n          </NavigationStackPage>\n        )\n      })}\n    </NavigationStack>\n  )\n}\n\nexport {\n  createSidebarNavigator,\n  type HeaderButton,\n  type SidebarNavigationEventMap,\n  type SidebarNavigationHelpers,\n  type SidebarNavigationOptions,\n  type SidebarScreenConfig,\n  type SidebarScreenProps,\n  type TypedSidebarNavigator,\n} from \"./sidebar\"\n\n// BREAKING CHANGE: this file used to re-export CommonActions,\n// NavigationContainer, StackActions, useFocusEffect, useIsFocused,\n// useNavigation, useNavigationContainerRef, usePreventRemove and useRoute\n// from @react-navigation/native, so an app could import the whole surface\n// from one place. Removed: the set was never complete (apps still had to\n// go to @react-navigation/native directly for anything else — dispatch\n// helpers, linking types, the rest of the hooks), so re-exporting a subset\n// was only a second place to look, not a convenience. Import these names\n// from @react-navigation/native directly; this package exports only what\n// is genuinely its own (createStackNavigator, createSidebarNavigator, and\n// the option/prop types around them).\n\n// ---- typed factory --------------------------------------------------------\n// React Navigation 8 ships a genuinely generic createNavigatorFactory\n// (NavigatorTypeBagBase + createNavigatorFactory<TypeBag>) — the manual\n// `stackFactory() as TypedStackNavigator<ParamList>` cast this file used to\n// need (upstream's factory returned `any`) is gone. The type bag below\n// wires our own state/options/navigator shape into their factory, so\n// Stack.Navigator and Stack.Screen come out correctly typed — including\n// catching a typo'd screen name or a mismatched param type at the JSX call\n// site, which the old cast could not. Runtime is unchanged either way:\n// createNavigatorFactory(Navigator) has always just returned\n// `{ Navigator, Screen, Group }` (Screen/Group are no-op marker\n// components); only the TYPES improved.\n\nexport type StackNavigationHelpers<\n  ParamList extends ParamListBase = ParamListBase,\n  RouteName extends keyof ParamList = keyof ParamList,\n> = NavigationProp<\n  ParamList,\n  RouteName,\n  StackNavigationState<ParamList>,\n  StackNavigationOptions,\n  StackNavigationEventMap\n>\n\nexport type StackScreenProps<\n  ParamList extends ParamListBase = ParamListBase,\n  RouteName extends keyof ParamList = keyof ParamList,\n> = {\n  route: RouteProp<ParamList, RouteName>\n  navigation: StackNavigationHelpers<ParamList, RouteName>\n}\n\nexport type StackScreenConfig<\n  ParamList extends ParamListBase,\n  RouteName extends keyof ParamList,\n> = {\n  name: RouteName\n  component: ComponentType<StackScreenProps<ParamList, RouteName>>\n  options?:\n    | StackNavigationOptions\n    | ((\n        props: StackScreenProps<ParamList, RouteName>,\n      ) => StackNavigationOptions)\n  initialParams?: Partial<ParamList[RouteName]>\n}\n\ninterface StackTypeBag extends NavigatorTypeBagBase {\n  ParamList: ParamListBase\n  State: StackNavigationState<ParamListBase>\n  ScreenOptions: StackNavigationOptions\n  EventMap: StackNavigationEventMap\n  ActionHelpers: Record<string, () => void>\n  Navigator: typeof StackNavigator\n}\n\nconst stackFactory = createNavigatorFactory<StackTypeBag>(StackNavigator)\n\n// The explicit return type is built from TypedNavigator + NavigatorTypeBagFor\n// (both public exports) rather than `ReturnType<typeof stackFactory<ParamList>>`\n// for two reasons found empirically:\n// - `TypedNavigatorFactory` has two overloaded call signatures (dynamic\n//   Navigator/Screen vs. static config). Resolving\n//   `typeof stackFactory<ParamList>` as a bare instantiation expression\n//   (as opposed to an actual call) picks the wrong one — the static-config\n//   overload — even though calling `stackFactory<ParamList>()` for real\n//   resolves correctly.\n// - Declaration emit (`tsc -p tsconfig.build.json`, i.e. `build:dist`)\n//   additionally rejects an inferred-only return type here with\n//   TS2742 (\"cannot be named without a reference to .../utilities\"),\n//   because it transitively touches a type `@react-navigation/core`\n//   does not export from its public entry point. Naming the return type\n//   through the two types this package DOES export sidesteps both.\nexport type TypedStackNavigator<ParamList extends ParamListBase> =\n  TypedNavigator<NavigatorTypeBagFor<StackTypeBag, ParamList>, undefined>\n\nexport const createStackNavigator = <\n  ParamList extends ParamListBase = ParamListBase,\n>(): TypedStackNavigator<ParamList> => stackFactory<ParamList>()\n"]}

package/dist/navigation/option-warnings.js

@@ -20,7 +20,9 @@ const VERDICTS = {
     headerLargeTitle: "no large-title idiom on this desktop",
     headerBlurEffect: "no blur idiom on this desktop",
     presentation: 'only "card" exists today; "modal" is planned on Adw.Dialog',
-    animation: 'transitions are Adwaita\'s own; "none" is planned',
+    animation: "GTK has a single transition style — the requested type is ignored " +
+        'and the standard Adwaita transition plays regardless; "none" does ' +
+        "disable it entirely, if that is what you want",
     animationDuration: "transitions are Adwaita's own",
     animationTypeForReplace: "transitions are Adwaita's own",
     gestureDirection: "the platform defines gesture directions",
@@ -32,7 +34,13 @@ const VERDICTS = {
     navigationBarHidden: "no Android navigation bar on desktop",
     orientation: "window orientation is the compositor's business",
     autoHideHomeIndicator: "no home indicator on desktop",
+    // detachInactiveScreens/freezeOnBlur (native-stack v7) collapsed into
+    // inactiveBehavior (v8, 'pause' | 'unmount' | 'none'). All three are
+    // flagged the same way: our stack always keeps pushed pages mounted —
+    // there is no unmount/freeze knob to offer.
+    detachInactiveScreens: "screens below the stack top already stay mounted",
     freezeOnBlur: "screens below the stack top already stay mounted",
+    inactiveBehavior: "screens below the stack top already stay mounted; there is no unmount/freeze knob",
     contentStyle: "style a wrapper View inside the screen instead",
 };
 const warned = new Set();

package/dist/navigation/option-warnings.js.map

@@ -1 +1 @@
-{"version":3,"file":"option-warnings.js","sourceRoot":"","sources":["../../src/navigation/option-warnings.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,yEAAyE;AACzE,2DAA2D;AAC3D,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,8CAA8C;IACtD,WAAW,EACT,gEAAgE;QAChE,aAAa;IACf,WAAW,EAAE,0DAA0D;IACvE,eAAe,EAAE,0DAA0D;IAC3E,gBAAgB,EAAE,0DAA0D;IAC5E,iBAAiB,EAAE,2CAA2C;IAC9D,mBAAmB,EAAE,2CAA2C;IAChE,sBAAsB,EAAE,0BAA0B;IAClD,iBAAiB,EAAE,wCAAwC;IAC3D,eAAe,EAAE,2CAA2C;IAC5D,2BAA2B,EAAE,2CAA2C;IACxE,2BAA2B,EACzB,+DAA+D;IACjE,gBAAgB,EAAE,sCAAsC;IACxD,gBAAgB,EAAE,+BAA+B;IACjD,YAAY,EAAE,4DAA4D;IAC1E,SAAS,EAAE,mDAAmD;IAC9D,iBAAiB,EAAE,+BAA+B;IAClD,uBAAuB,EAAE,+BAA+B;IACxD,gBAAgB,EAAE,yCAAyC;IAC3D,wBAAwB,EAAE,+BAA+B;IACzD,cAAc,EAAE,0BAA0B;IAC1C,eAAe,EAAE,0BAA0B;IAC3C,kBAAkB,EAAE,0BAA0B;IAC9C,kBAAkB,EAAE,sCAAsC;IAC1D,mBAAmB,EAAE,sCAAsC;IAC3D,WAAW,EAAE,iDAAiD;IAC9D,qBAAqB,EAAE,8BAA8B;IACrD,YAAY,EAAE,kDAAkD;IAChE,YAAY,EAAE,gDAAgD;CAC/D,CAAA;AAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;AAEhC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAiB,EACjB,OAAgC,EAChC,SAA8B,EACxB,EAAE;IACR,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAM;IACR,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,SAAQ;QACV,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,SAAS,IAAI,GAAG,EAAE,CAAA;QACpC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,iCAAiC,CAAA;QAClE,OAAO,CAAC,IAAI,CACV,kCAAkC,SAAS,sBAAsB;YAC/D,WAAW,GAAG,OAAO,OAAO,GAAG,CAClC,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAS,EAAE;IACnD,MAAM,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC,CAAA","sourcesContent":["// Dev-mode guidance for silently ignored screen options: react-navigation's\n// factory is untyped upstream, so neither TS nor the runtime would otherwise\n// say a word when a ported app sets `presentation: \"modal\"` and nothing\n// happens. Each unknown key warns ONCE per navigator kind with an honest\n// verdict (see docs/research/navigation-extensibility.md).\nconst VERDICTS: Record<string, string> = {\n  header: \"full header replacement is not supported yet\",\n  headerTitle:\n    \"string titles map to `title`; a component title-widget is not \" +\n    \"exposed yet\",\n  headerStyle: \"Adwaita's theme owns the chrome styling on this platform\",\n  headerTintColor: \"Adwaita's theme owns the chrome styling on this platform\",\n  headerTitleStyle: \"Adwaita's theme owns the chrome styling on this platform\",\n  headerTransparent: \"planned on AdwToolbarView's top-bar-style\",\n  headerShadowVisible: \"planned on AdwToolbarView's top-bar-style\",\n  headerSearchBarOptions: \"planned on Gtk.SearchBar\",\n  headerBackVisible: \"planned on AdwNavigationPage's can-pop\",\n  headerBackTitle: \"the GNOME back button is icon-only by HIG\",\n  headerBackButtonDisplayMode: \"the GNOME back button is icon-only by HIG\",\n  headerBackButtonMenuEnabled:\n    \"the Adwaita back button already shows a history menu natively\",\n  headerLargeTitle: \"no large-title idiom on this desktop\",\n  headerBlurEffect: \"no blur idiom on this desktop\",\n  presentation: 'only \"card\" exists today; \"modal\" is planned on Adw.Dialog',\n  animation: 'transitions are Adwaita\\'s own; \"none\" is planned',\n  animationDuration: \"transitions are Adwaita's own\",\n  animationTypeForReplace: \"transitions are Adwaita's own\",\n  gestureDirection: \"the platform defines gesture directions\",\n  fullScreenGestureEnabled: \"the platform defines gestures\",\n  statusBarStyle: \"no status bar on desktop\",\n  statusBarHidden: \"no status bar on desktop\",\n  statusBarAnimation: \"no status bar on desktop\",\n  navigationBarColor: \"no Android navigation bar on desktop\",\n  navigationBarHidden: \"no Android navigation bar on desktop\",\n  orientation: \"window orientation is the compositor's business\",\n  autoHideHomeIndicator: \"no home indicator on desktop\",\n  freezeOnBlur: \"screens below the stack top already stay mounted\",\n  contentStyle: \"style a wrapper View inside the screen instead\",\n}\n\nconst warned = new Set<string>()\n\nexport const warnIgnoredOptions = (\n  navigator: string,\n  options: Record<string, unknown>,\n  supported: ReadonlySet<string>,\n): void => {\n  if (process.env.NODE_ENV === \"production\") {\n    return\n  }\n  for (const key of Object.keys(options)) {\n    if (supported.has(key)) {\n      continue\n    }\n    const dedupe = `${navigator}:${key}`\n    if (warned.has(dedupe)) {\n      continue\n    }\n    warned.add(dedupe)\n    const verdict = VERDICTS[key] ?? \"not supported by this navigator\"\n    console.warn(\n      `[react-native-gtkx/navigation] ${navigator} ignores the screen ` +\n        `option \"${key}\" — ${verdict}.`,\n    )\n  }\n}\n\n// Test hook: warnings are once-per-process by design.\nexport const resetIgnoredOptionWarnings = (): void => {\n  warned.clear()\n}\n"]}
+{"version":3,"file":"option-warnings.js","sourceRoot":"","sources":["../../src/navigation/option-warnings.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,yEAAyE;AACzE,2DAA2D;AAC3D,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,8CAA8C;IACtD,WAAW,EACT,gEAAgE;QAChE,aAAa;IACf,WAAW,EAAE,0DAA0D;IACvE,eAAe,EAAE,0DAA0D;IAC3E,gBAAgB,EAAE,0DAA0D;IAC5E,iBAAiB,EAAE,2CAA2C;IAC9D,mBAAmB,EAAE,2CAA2C;IAChE,sBAAsB,EAAE,0BAA0B;IAClD,iBAAiB,EAAE,wCAAwC;IAC3D,eAAe,EAAE,2CAA2C;IAC5D,2BAA2B,EAAE,2CAA2C;IACxE,2BAA2B,EACzB,+DAA+D;IACjE,gBAAgB,EAAE,sCAAsC;IACxD,gBAAgB,EAAE,+BAA+B;IACjD,YAAY,EAAE,4DAA4D;IAC1E,SAAS,EACP,oEAAoE;QACpE,oEAAoE;QACpE,+CAA+C;IACjD,iBAAiB,EAAE,+BAA+B;IAClD,uBAAuB,EAAE,+BAA+B;IACxD,gBAAgB,EAAE,yCAAyC;IAC3D,wBAAwB,EAAE,+BAA+B;IACzD,cAAc,EAAE,0BAA0B;IAC1C,eAAe,EAAE,0BAA0B;IAC3C,kBAAkB,EAAE,0BAA0B;IAC9C,kBAAkB,EAAE,sCAAsC;IAC1D,mBAAmB,EAAE,sCAAsC;IAC3D,WAAW,EAAE,iDAAiD;IAC9D,qBAAqB,EAAE,8BAA8B;IACrD,sEAAsE;IACtE,qEAAqE;IACrE,sEAAsE;IACtE,4CAA4C;IAC5C,qBAAqB,EAAE,kDAAkD;IACzE,YAAY,EAAE,kDAAkD;IAChE,gBAAgB,EACd,mFAAmF;IACrF,YAAY,EAAE,gDAAgD;CAC/D,CAAA;AAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;AAEhC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAiB,EACjB,OAAgC,EAChC,SAA8B,EACxB,EAAE;IACR,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAM;IACR,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,SAAQ;QACV,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,SAAS,IAAI,GAAG,EAAE,CAAA;QACpC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,iCAAiC,CAAA;QAClE,OAAO,CAAC,IAAI,CACV,kCAAkC,SAAS,sBAAsB;YAC/D,WAAW,GAAG,OAAO,OAAO,GAAG,CAClC,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAS,EAAE;IACnD,MAAM,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC,CAAA","sourcesContent":["// Dev-mode guidance for silently ignored screen options: react-navigation's\n// factory is untyped upstream, so neither TS nor the runtime would otherwise\n// say a word when a ported app sets `presentation: \"modal\"` and nothing\n// happens. Each unknown key warns ONCE per navigator kind with an honest\n// verdict (see docs/research/navigation-extensibility.md).\nconst VERDICTS: Record<string, string> = {\n  header: \"full header replacement is not supported yet\",\n  headerTitle:\n    \"string titles map to `title`; a component title-widget is not \" +\n    \"exposed yet\",\n  headerStyle: \"Adwaita's theme owns the chrome styling on this platform\",\n  headerTintColor: \"Adwaita's theme owns the chrome styling on this platform\",\n  headerTitleStyle: \"Adwaita's theme owns the chrome styling on this platform\",\n  headerTransparent: \"planned on AdwToolbarView's top-bar-style\",\n  headerShadowVisible: \"planned on AdwToolbarView's top-bar-style\",\n  headerSearchBarOptions: \"planned on Gtk.SearchBar\",\n  headerBackVisible: \"planned on AdwNavigationPage's can-pop\",\n  headerBackTitle: \"the GNOME back button is icon-only by HIG\",\n  headerBackButtonDisplayMode: \"the GNOME back button is icon-only by HIG\",\n  headerBackButtonMenuEnabled:\n    \"the Adwaita back button already shows a history menu natively\",\n  headerLargeTitle: \"no large-title idiom on this desktop\",\n  headerBlurEffect: \"no blur idiom on this desktop\",\n  presentation: 'only \"card\" exists today; \"modal\" is planned on Adw.Dialog',\n  animation:\n    \"GTK has a single transition style — the requested type is ignored \" +\n    'and the standard Adwaita transition plays regardless; \"none\" does ' +\n    \"disable it entirely, if that is what you want\",\n  animationDuration: \"transitions are Adwaita's own\",\n  animationTypeForReplace: \"transitions are Adwaita's own\",\n  gestureDirection: \"the platform defines gesture directions\",\n  fullScreenGestureEnabled: \"the platform defines gestures\",\n  statusBarStyle: \"no status bar on desktop\",\n  statusBarHidden: \"no status bar on desktop\",\n  statusBarAnimation: \"no status bar on desktop\",\n  navigationBarColor: \"no Android navigation bar on desktop\",\n  navigationBarHidden: \"no Android navigation bar on desktop\",\n  orientation: \"window orientation is the compositor's business\",\n  autoHideHomeIndicator: \"no home indicator on desktop\",\n  // detachInactiveScreens/freezeOnBlur (native-stack v7) collapsed into\n  // inactiveBehavior (v8, 'pause' | 'unmount' | 'none'). All three are\n  // flagged the same way: our stack always keeps pushed pages mounted —\n  // there is no unmount/freeze knob to offer.\n  detachInactiveScreens: \"screens below the stack top already stay mounted\",\n  freezeOnBlur: \"screens below the stack top already stay mounted\",\n  inactiveBehavior:\n    \"screens below the stack top already stay mounted; there is no unmount/freeze knob\",\n  contentStyle: \"style a wrapper View inside the screen instead\",\n}\n\nconst warned = new Set<string>()\n\nexport const warnIgnoredOptions = (\n  navigator: string,\n  options: Record<string, unknown>,\n  supported: ReadonlySet<string>,\n): void => {\n  if (process.env.NODE_ENV === \"production\") {\n    return\n  }\n  for (const key of Object.keys(options)) {\n    if (supported.has(key)) {\n      continue\n    }\n    const dedupe = `${navigator}:${key}`\n    if (warned.has(dedupe)) {\n      continue\n    }\n    warned.add(dedupe)\n    const verdict = VERDICTS[key] ?? \"not supported by this navigator\"\n    console.warn(\n      `[react-native-gtkx/navigation] ${navigator} ignores the screen ` +\n        `option \"${key}\" — ${verdict}.`,\n    )\n  }\n}\n\n// Test hook: warnings are once-per-process by design.\nexport const resetIgnoredOptionWarnings = (): void => {\n  warned.clear()\n}\n"]}

package/dist/navigation/sidebar.d.ts

@@ -1,8 +1,73 @@
-import { type NavigationProp, type ParamListBase, type RouteProp, type TabNavigationState } from "@react-navigation/native";
+import { type NavigationProp, type NavigatorTypeBagBase, type NavigatorTypeBagFor, type ParamListBase, type RouteProp, type TabNavigationState, type TypedNavigator } from "@react-navigation/native";
 import { type ComponentType, type ReactNode } from "react";
 export type SidebarNavigationOptions = {
-    /** Sidebar row and content HeaderBar title; defaults to the route name. */
+    /** Sidebar row and content AdwHeaderBar title; defaults to the route name. */
     title?: string;
+    /** Adwaita symbolic icon name for the sidebar row's prefix (e.g.
+     *  "view-list-symbolic"). Ignored when `color` is also set — a row shows
+     *  a colored dot OR an icon, never both (the same rule tasks-app's own
+     *  hand-rolled sidebar followed). */
+    icon?: string;
+    /** A CSS color for a colored dot prefix, replacing `icon` on this row —
+     *  the way a user-created list is told apart from a smart view. */
+    color?: string;
+    /** Badge shown as the row's suffix. Hidden when 0 or undefined — an
+     *  empty view shows no badge, not a "0". */
+    count?: number;
+    /** RN content packed at the start of the CONTENT AdwHeaderBar (an
+     *  intrinsic-size root, same contract as the stack navigator's
+     *  `headerLeft`) — a back button for an in-place "item open" state, a
+     *  "New" action, anything that changes with THIS screen's selection.
+     *  Call `navigation.setOptions({ headerLeft: … })` from the screen to
+     *  change it as its own internal state changes — no stack involved. */
+    headerLeft?: () => ReactNode;
+    /** RN content packed at the end of the content AdwHeaderBar, before
+     *  `headerButtons`. Same contract as `headerLeft`. */
+    headerRight?: () => ReactNode;
+    /** Replaces the content AdwHeaderBar's title widget for this screen —
+     *  a filter toggle group, an editable title plus a star toggle,
+     *  anything a plain string `title` cannot express. Left unset, the
+     *  HeaderBar shows the page's own title automatically (unchanged
+     *  default behavior). */
+    headerTitle?: () => ReactNode;
+    /** How this screen's body is mounted into the content page.
+     *
+     *  - `"react-native"` (default): the body is a React Native tree, so it
+     *    gets a Yoga layout root that fills the pane — `<View style={{ flex: 1 }}>`
+     *    and friends behave exactly as they do anywhere else.
+     *  - `"widget"`: the body IS a GTK widget tree (a `GtkScrolledWindow`
+     *    around a `.boxed-list` `GtkListBox`, say) and is packed into the page
+     *    directly, with no layout root in between. GTK's own sizing —
+     *    `vexpand`, `AdwClamp`, a list's natural height — then works normally.
+     *    Under the default a widget tree collapses instead: every widget
+     *    becomes a single Yoga LEAF measured for its own natural size, so a
+     *    scrolled window reports the ~1px it can shrink to and the pane comes
+     *    up empty. `examples/tasks-nav` is built this way.
+     *
+     *  Mixing is per SCREEN, not per subtree: a `"widget"` screen that wants
+     *  React Native content somewhere inside it wraps that part in
+     *  `SlotContent` (or `IntrinsicContent`) itself. */
+    contentLayout?: "react-native" | "widget";
+    /** Renders this screen's sidebar row yourself, instead of letting
+     *  `title`/`icon`/`color`/`count` compose one.
+     *
+     *  Those four are a convenience, not the ceiling. They compose an
+     *  `AdwActionRow`, which brings Adwaita's own row metrics with it — so
+     *  an app wanting a different shape, a different density, or simply a
+     *  row height of its own had nothing to reach for, and every app paid
+     *  for the richest case whether it used it or not. This is that reach:
+     *  return anything a `GtkListBoxRow` can hold — React Native content,
+     *  GTK widgets, a differently-configured Adwaita row.
+     *
+     *  The navigator still owns row BEHAVIOUR — selection, click →
+     *  `jumpTo`, keeping the list in step with navigation state, the
+     *  collapsed reveal — so a custom row cannot fall out of sync with the
+     *  router. Only what is drawn changes. */
+    sidebarRow?: () => ReactNode;
+    /** Overrides the navigator-level `headerButtons` prop for this screen
+     *  specifically (replaces it entirely when set, same as the stack
+     *  navigator's per-screen option override). */
+    headerButtons?: HeaderButton[];
 };
 export type HeaderButton = {
     id: string;
@@ -10,18 +75,146 @@ export type HeaderButton = {
     tooltip?: string;
     onPress: () => void;
 };
+export type SidebarNavigationEventMap = {
+    /**
+     * The split view's own back affordance (back button, Escape, the back
+     * gesture) hid the content pane while collapsed, returning to the
+     * sidebar — `AdwNavigationSplitView`'s `showContent` going false, the
+     * counterpart to the stack navigator's native pop. Unlike a stack pop,
+     * TabRouter's state does NOT change: nothing was removed, the same route
+     * stays focused, only the pane did. Fired on the currently active route,
+     * so an app that wants to react — e.g. resetting an in-screen "item
+     * open" state that only makes sense while content is visible, the way
+     * `examples/tasks-nav`'s `ContentScreen` does — can listen without
+     * polling the split view itself.
+     *
+     * Never fired when `collapseWidth` is unset (uncollapsed behavior is
+     * unchanged), and never fired for content being REVEALED — that
+     * direction already shows up as an ordinary state change (the newly
+     * focused route re-rendering), so it needs no event of its own. See
+     * docs/research/navigation-extensibility.md for why no event exists for
+     * the forward direction.
+     */
+    sidebarShown: {
+        data: undefined;
+    };
+};
+/** What a custom sidebar needs to be able to navigate — the routing
+ *  surface the composed list uses internally, handed over so a replacement
+ *  is a real sidebar and not a decoration that cannot select anything. */
+export type SidebarContentProps = {
+    /** Every screen, in declaration order, with its resolved options. */
+    routes: {
+        key: string;
+        name: string;
+        options: SidebarNavigationOptions;
+        /** Resolved title: `options.title`, falling back to the route name. */
+        title: string;
+        /** Whether this route is the one currently showing in the content pane. */
+        focused: boolean;
+    }[];
+    /** Index of the focused route in `routes`. */
+    focusedIndex: number;
+    /** Focus a route by name — the same dispatch a sidebar row click makes,
+     *  including revealing the content pane when collapsed. */
+    jumpTo: (name: string) => void;
+};
 type SidebarNavigatorProps = {
     initialRouteName?: string;
     screenOptions?: SidebarNavigationOptions;
-    /** Title of the sidebar pane's HeaderBar. */
+    /** Title of the sidebar pane's AdwHeaderBar. */
     sidebarTitle?: string;
-    /** Buttons packed at the end of the content HeaderBar. */
+    /**
+     * Content packed at the START of the SIDEBAR pane's AdwHeaderBar — the
+     * "new item" action a GNOME sidebar puts next to its title, a search
+     * toggle, anything the pane's chrome needs.
+     *
+     * The content header's `headerLeft`/`headerRight`/`headerTitle` are
+     * screen OPTIONS because that header changes with the focused screen.
+     * The sidebar's does not: one pane, shared by every screen, so its
+     * chrome belongs to the navigator — the same level `sidebarTitle` and
+     * `sidebarContent` already sit at. Hence the `sidebar` prefix on
+     * otherwise identical names.
+     *
+     * Mounted through the same `HeaderSlotContent` root the content header
+     * uses, so a slot of React Native content lays out as a horizontal,
+     * content-hugging cluster flush with natively packed buttons.
+     */
+    sidebarHeaderLeft?: () => ReactNode;
+    /** Content packed at the END of the sidebar AdwHeaderBar — a primary
+     *  menu, say. Same contract as {@link sidebarHeaderLeft}. */
+    sidebarHeaderRight?: () => ReactNode;
+    /**
+     * Replaces the sidebar AdwHeaderBar's title WIDGET — a search entry, a
+     * switcher, anything the plain `sidebarTitle` string cannot express.
+     *
+     * `sidebarTitle` sets the pane's `AdwNavigationPage` title, which the
+     * HeaderBar renders by default; this overrides what is drawn there,
+     * exactly as a screen's `headerTitle` overrides its page `title`. Left
+     * unset, `sidebarTitle` shows as before.
+     */
+    sidebarHeaderTitle?: () => ReactNode;
+    /** Buttons packed at the end of the content AdwHeaderBar. */
     headerButtons?: HeaderButton[];
+    /**
+     * Width (sp) below which the split view collapses to the sidebar or the
+     * content pane alone, driven by a native `Adw.Breakpoint` — NOT a
+     * `useWindowDimensions` check (see docs/platform-layer.md, "Two ways to
+     * react to size"). The property flip happens inside GTK's own allocation
+     * pass, with no React render for the resize itself. Unset by default: no
+     * `AdwBreakpointBin` is mounted at all, so existing consumers
+     * (`examples/gallery`) see no behavior change.
+     */
+    collapseWidth?: number;
+    /**
+     * The narrowest width (px) this navigator's UI supports, applied to the
+     * `AdwBreakpointBin` `collapseWidth` mounts. Ignored when `collapseWidth`
+     * is unset, since no bin exists then.
+     *
+     * Adwaita cannot measure a breakpoint bin: what it contains changes with
+     * the breakpoints, so the bin reports a minimum of ZERO and warns
+     * ("AdwBreakpointBin does not have a minimum size, set the
+     * 'width-request' and 'height-request' properties to specify it"). With
+     * no minimum the window can be dragged narrower than the pane inside it
+     * can render, and Adwaita then over-allocates and CLIPS the pane rather
+     * than adapting it — visible as a task list running off the right edge
+     * and, in the journal, as "AdwNavigationSplitView exceeds
+     * AdwBreakpointBin width: requested 469 px, 360 px available".
+     *
+     * The default is GNOME's own adaptive floor. An app whose content
+     * HeaderBar needs more than that (a segmented control as `headerTitle`
+     * costs ~110px on its own) must say so — measure the pane, don't guess:
+     * the number is the width below which its own chrome stops fitting.
+     */
+    minWidth?: number;
+    /** Height counterpart of {@link minWidth}, same reasoning. */
+    minHeight?: number;
+    /**
+     * Replaces the ENTIRE sidebar pane's body — for a sidebar that needs
+     * sections, a search field, a footer, or anything a flat list of rows
+     * cannot express.
+     *
+     * The rung below this is `sidebarRow` (a screen option), which keeps the
+     * navigator's list and replaces one row; reach for that first. This one
+     * hands over the whole pane, so it also hands over the routing: use the
+     * {@link SidebarContentProps} passed in rather than trying to dispatch
+     * yourself, and selection stays consistent with navigation state.
+     *
+     * The pane's AdwHeaderBar (and `sidebarTitle`) still belong to the
+     * navigator — this is the body under it, not the chrome.
+     *
+     * Mounted as React Native content (a layout root filling the pane). A
+     * sidebar built from GTK widgets wraps its own tree in `WidgetContent`,
+     * the same escape hatch `contentLayout: "widget"` is for a screen body.
+     */
+    sidebarContent?: (props: SidebarContentProps) => ReactNode;
     children: ReactNode;
 };
+declare const SidebarNavigator: ({ initialRouteName, screenOptions, sidebarTitle, sidebarHeaderLeft, sidebarHeaderRight, sidebarHeaderTitle, headerButtons, collapseWidth, minWidth, minHeight, sidebarContent, children, }: SidebarNavigatorProps) => React.JSX.Element;
+export type SidebarNavigationHelpers<ParamList extends ParamListBase = ParamListBase, RouteName extends keyof ParamList = keyof ParamList> = NavigationProp<ParamList, RouteName, TabNavigationState<ParamList>, SidebarNavigationOptions, SidebarNavigationEventMap>;
 export type SidebarScreenProps<ParamList extends ParamListBase = ParamListBase, RouteName extends keyof ParamList = keyof ParamList> = {
     route: RouteProp<ParamList, RouteName>;
-    navigation: NavigationProp<ParamList, RouteName, undefined, TabNavigationState<ParamList>, SidebarNavigationOptions>;
+    navigation: SidebarNavigationHelpers<ParamList, RouteName>;
 };
 export type SidebarScreenConfig<ParamList extends ParamListBase, RouteName extends keyof ParamList> = {
     name: RouteName;
@@ -29,9 +222,14 @@ export type SidebarScreenConfig<ParamList extends ParamListBase, RouteName exten
     options?: SidebarNavigationOptions;
     initialParams?: Partial<ParamList[RouteName]>;
 };
-export type TypedSidebarNavigator<ParamList extends ParamListBase> = {
-    Navigator: ComponentType<SidebarNavigatorProps>;
-    Screen: <RouteName extends keyof ParamList>(props: SidebarScreenConfig<ParamList, RouteName>) => null;
-};
+interface SidebarTypeBag extends NavigatorTypeBagBase {
+    ParamList: ParamListBase;
+    State: TabNavigationState<ParamListBase>;
+    ScreenOptions: SidebarNavigationOptions;
+    EventMap: SidebarNavigationEventMap;
+    ActionHelpers: Record<string, () => void>;
+    Navigator: typeof SidebarNavigator;
+}
+export type TypedSidebarNavigator<ParamList extends ParamListBase> = TypedNavigator<NavigatorTypeBagFor<SidebarTypeBag, ParamList>, undefined>;
 export declare const createSidebarNavigator: <ParamList extends ParamListBase = ParamListBase>() => TypedSidebarNavigator<ParamList>;
 export {};