expo-router 4.0.0-preview.8 → 4.0.0

package/build/ui/TabTrigger.d.ts

@@ -1,94 +1,89 @@
+import { TabNavigationState } from '@react-navigation/native';
 import { ReactNode, ReactElement, ComponentProps } from 'react';
 import { View, PressableProps } from 'react-native';
 import { ExpoTabsResetValue } from './TabRouter';
+import type { TriggerMap } from './common';
 import type { Href } from '../types';
 type PressablePropsWithoutFunctionChildren = Omit<PressableProps, 'children'> & {
     children?: ReactNode | undefined;
 };
-export type TabTriggerProps<T extends string | object> = PressablePropsWithoutFunctionChildren & {
+export type TabTriggerProps = PressablePropsWithoutFunctionChildren & {
+    /**
+     *  Name of tab. When used within a `TabList` this sets the name of the tab.
+     * Otherwise, this references the name.
+     */
     name: string;
-    href?: Href<T>;
-    /** Forward props to child component. Useful for custom wrappers. */
+    /**
+     * Name of tab. Required when used within a `TabList`.
+     */
+    href?: Href;
+    /**
+     * Forward props to child component. Useful for custom wrappers.
+     */
     asChild?: boolean;
-    /** Reset the route when switching to the tab */
+    /**
+     * Resets the route when switching to a tab.
+     */
     reset?: SwitchToOptions['reset'] | 'onLongPress';
 };
-export type TabTriggerOptions<T extends string | object> = {
+export type TabTriggerOptions = {
     name: string;
-    href: Href<T>;
+    href: Href;
 };
 export type TabTriggerSlotProps = PressablePropsWithoutFunctionChildren & React.RefAttributes<View> & {
     isFocused?: boolean;
     href?: string;
 };
-export declare function TabTrigger<T extends string | object>({ asChild, name, href, reset, ...props }: TabTriggerProps<T>): import("react").JSX.Element;
+/**
+ * Creates a trigger to navigate to a tab. When used as child of `TabList`, its
+ * functionality slightly changes since the `href` prop is required,
+ * and the trigger also defines what routes are present in the `Tabs`.
+ *
+ * When used outside of `TabList`, this component no longer requires an `href`.
+ *
+ * @example
+ * ```tsx
+ * <Tabs>
+ *  <TabSlot />
+ *  <TabList>
+ *   <TabTrigger name="home" href="/" />
+ *  </TabList>
+ * </Tabs>
+ * ```
+ */
+export declare function TabTrigger({ asChild, name, href, reset, ...props }: TabTriggerProps): import("react").JSX.Element;
+/**
+ * @hidden
+ */
 export declare function isTabTrigger(child: ReactElement<any>): child is ReactElement<ComponentProps<typeof TabTrigger>>;
+/**
+ * Options for `switchTab` function.
+ */
 export type SwitchToOptions = {
+    /**
+     * Navigate and reset the history.
+     */
     reset?: ExpoTabsResetValue;
 };
-export declare function useTabTrigger({ name, reset, onPress, onLongPress }: TabTriggerProps<any>): {
-    switchTab: (name: string, options?: SwitchToOptions) => void;
-    getTrigger: (name: string) => {
-        type: "internal";
-        name: string;
-        href: string;
-        routeNode: import("../Route").RouteNode;
-        action: import("@react-navigation/routers").TabActionType | {
-            type: "JUMP_TO";
-            source?: string | undefined;
-            target?: string | undefined;
-            payload: {
-                name: string;
-                reset?: ExpoTabsResetValue | undefined;
-                params?: object | undefined;
-            };
-        };
-        index: number;
-        isFocused: boolean;
-        route: import("@react-navigation/routers").NavigationRoute<import("@react-navigation/routers").ParamListBase, string>;
-        resolvedHref: string;
-    } | {
-        type: "external";
-        name: string;
-        href: string;
-        index: number;
-        isFocused: boolean;
-        route: import("@react-navigation/routers").NavigationRoute<import("@react-navigation/routers").ParamListBase, string>;
-        resolvedHref: string;
-    } | undefined;
-    trigger: {
-        type: "internal";
-        name: string;
-        href: string;
-        routeNode: import("../Route").RouteNode;
-        action: import("@react-navigation/routers").TabActionType | {
-            type: "JUMP_TO";
-            source?: string | undefined;
-            target?: string | undefined;
-            payload: {
-                name: string;
-                reset?: ExpoTabsResetValue | undefined;
-                params?: object | undefined;
-            };
-        };
-        index: number;
-        isFocused: boolean;
-        route: import("@react-navigation/routers").NavigationRoute<import("@react-navigation/routers").ParamListBase, string>;
-        resolvedHref: string;
-    } | {
-        type: "external";
-        name: string;
-        href: string;
-        index: number;
-        isFocused: boolean;
-        route: import("@react-navigation/routers").NavigationRoute<import("@react-navigation/routers").ParamListBase, string>;
-        resolvedHref: string;
-    } | undefined;
-    triggerProps: {
-        isFocused: boolean;
-        onPress: (event: import("react-native").GestureResponderEvent) => void;
-        onLongPress: (event: import("react-native").GestureResponderEvent) => void;
-    };
+export type Trigger = TriggerMap[string] & {
+    isFocused: boolean;
+    resolvedHref: string;
+    route: TabNavigationState<any>['routes'][number];
 };
+export type UseTabTriggerResult = {
+    switchTab: (name: string, options: SwitchToOptions) => void;
+    getTrigger: (name: string) => Trigger | undefined;
+    trigger?: Trigger;
+    triggerProps: TriggerProps;
+};
+export type TriggerProps = {
+    isFocused: boolean;
+    onPress: PressableProps['onPress'];
+    onLongPress: PressableProps['onLongPress'];
+};
+/**
+ * Utility hook creating custom `TabTrigger`.
+ */
+export declare function useTabTrigger(options: TabTriggerProps): UseTabTriggerResult;
 export {};
 //# sourceMappingURL=TabTrigger.d.ts.map

package/build/ui/TabTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TabTrigger.d.ts","sourceRoot":"","sources":["../../src/ui/TabTrigger.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAc,YAAY,EAAE,cAAc,EAAe,MAAM,OAAO,CAAC;AACzF,OAAO,EAAE,IAAI,EAAyB,cAAc,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGrC,KAAK,qCAAqC,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IAC9E,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,qCAAqC,GAAG;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,qCAAqC,GACrE,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAIJ,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EACpD,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,KAAiB,EACjB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,CAAC,CAAC,+BA4BpB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,GACvB,KAAK,IAAI,YAAY,CAAC,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC,CAE1D;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE7D,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,eAAe,CAAC,GAAG,CAAC;sBAyB9E,MAAM,YAAY,eAAe;uBApBjC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkGhB"}
+{"version":3,"file":"TabTrigger.d.ts","sourceRoot":"","sources":["../../src/ui/TabTrigger.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAc,YAAY,EAAE,cAAc,EAAe,MAAM,OAAO,CAAC;AACzF,OAAO,EAAE,IAAI,EAAyB,cAAc,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAK3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGrC,KAAK,qCAAqC,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IAC9E,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,qCAAqC,GAAG;IACpE;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,qCAAqC,GACrE,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAIJ;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAiB,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,+BA4B/F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,GACvB,KAAK,IAAI,YAAY,CAAC,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC,CAE1D;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5D,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,mBAAmB,CAwG3E"}

package/build/ui/TabTrigger.js

@@ -11,6 +11,23 @@ const useLinkToPathProps_1 = require("../link/useLinkToPathProps");
 const matchers_1 = require("../matchers");
 const Navigator_1 = require("../views/Navigator");
 const TabTriggerSlot = react_slot_1.Slot;
+/**
+ * Creates a trigger to navigate to a tab. When used as child of `TabList`, its
+ * functionality slightly changes since the `href` prop is required,
+ * and the trigger also defines what routes are present in the `Tabs`.
+ *
+ * When used outside of `TabList`, this component no longer requires an `href`.
+ *
+ * @example
+ * ```tsx
+ * <Tabs>
+ *  <TabSlot />
+ *  <TabList>
+ *   <TabTrigger name="home" href="/" />
+ *  </TabList>
+ * </Tabs>
+ * ```
+ */
 function TabTrigger({ asChild, name, href, reset = 'onFocus', ...props }) {
     const { trigger, triggerProps } = useTabTrigger({
         name,
@@ -32,12 +49,19 @@ function TabTrigger({ asChild, name, href, reset = 'onFocus', ...props }) {
     }
 }
 exports.TabTrigger = TabTrigger;
+/**
+ * @hidden
+ */
 function isTabTrigger(child) {
     return child.type === TabTrigger;
 }
 exports.isTabTrigger = isTabTrigger;
-function useTabTrigger({ name, reset, onPress, onLongPress }) {
+/**
+ * Utility hook creating custom `TabTrigger`.
+ */
+function useTabTrigger(options) {
     const { state, navigation } = (0, Navigator_1.useNavigatorContext)();
+    const { name, reset, onPress, onLongPress } = options;
     const triggerMap = (0, react_1.useContext)(TabContext_1.TabTriggerMapContext);
     const getTrigger = (0, react_1.useCallback)((name) => {
         const config = triggerMap[name];

package/build/ui/TabTrigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"TabTrigger.js","sourceRoot":"","sources":["../../src/ui/TabTrigger.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Slot } from '@radix-ui/react-slot';\nimport { ReactNode, useContext, ReactElement, ComponentProps, useCallback } from 'react';\nimport { View, StyleSheet, Pressable, PressableProps } from 'react-native';\n\nimport { TabTriggerMapContext } from './TabContext';\nimport { ExpoTabsResetValue } from './TabRouter';\nimport { appendBaseUrl } from '../fork/getPathFromState';\nimport { router } from '../imperative-api';\nimport { shouldHandleMouseEvent } from '../link/useLinkToPathProps';\nimport { stripGroupSegmentsFromPath } from '../matchers';\nimport type { Href } from '../types';\nimport { useNavigatorContext } from '../views/Navigator';\n\ntype PressablePropsWithoutFunctionChildren = Omit<PressableProps, 'children'> & {\n  children?: ReactNode | undefined;\n};\n\nexport type TabTriggerProps<T extends string | object> = PressablePropsWithoutFunctionChildren & {\n  name: string;\n  href?: Href<T>;\n  /** Forward props to child component. Useful for custom wrappers. */\n  asChild?: boolean;\n  /** Reset the route when switching to the tab */\n  reset?: SwitchToOptions['reset'] | 'onLongPress';\n};\n\nexport type TabTriggerOptions<T extends string | object> = {\n  name: string;\n  href: Href<T>;\n};\n\nexport type TabTriggerSlotProps = PressablePropsWithoutFunctionChildren &\n  React.RefAttributes<View> & {\n    isFocused?: boolean;\n    href?: string;\n  };\n\nconst TabTriggerSlot = Slot as React.ForwardRefExoticComponent<TabTriggerSlotProps>;\n\nexport function TabTrigger<T extends string | object>({\n  asChild,\n  name,\n  href,\n  reset = 'onFocus',\n  ...props\n}: TabTriggerProps<T>) {\n  const { trigger, triggerProps } = useTabTrigger({\n    name,\n    reset,\n    ...props,\n  });\n\n  // Pressable doesn't accept the extra props, so only pass them if we are using asChild\n  if (asChild) {\n    return (\n      <TabTriggerSlot\n        style={styles.tabTrigger}\n        {...props}\n        {...triggerProps}\n        href={trigger?.resolvedHref}>\n        {props.children}\n      </TabTriggerSlot>\n    );\n  } else {\n    // These props are not typed, but are allowed by React Native Web\n    const reactNativeWebProps = { href: trigger?.resolvedHref };\n\n    return (\n      <Pressable style={styles.tabTrigger} {...reactNativeWebProps} {...props} {...triggerProps}>\n        {props.children}\n      </Pressable>\n    );\n  }\n}\n\nexport function isTabTrigger(\n  child: ReactElement<any>\n): child is ReactElement<ComponentProps<typeof TabTrigger>> {\n  return child.type === TabTrigger;\n}\n\nexport type SwitchToOptions = { reset?: ExpoTabsResetValue };\n\nexport function useTabTrigger({ name, reset, onPress, onLongPress }: TabTriggerProps<any>) {\n  const { state, navigation } = useNavigatorContext();\n  const triggerMap = useContext(TabTriggerMapContext);\n\n  const getTrigger = useCallback(\n    (name: string) => {\n      const config = triggerMap[name];\n\n      if (!config) {\n        return;\n      }\n\n      return {\n        isFocused: state.index === config.index,\n        route: state.routes[config.index],\n        resolvedHref: stripGroupSegmentsFromPath(appendBaseUrl(config.href)),\n        ...config,\n      };\n    },\n    [triggerMap]\n  );\n\n  const trigger = name !== undefined ? getTrigger(name) : undefined;\n\n  const switchTab = useCallback(\n    (name: string, options?: SwitchToOptions) => {\n      const config = triggerMap[name];\n\n      if (config) {\n        if (config.type === 'external') {\n          return router.navigate(config.href);\n        } else {\n          return navigation?.dispatch({\n            type: 'JUMP_TO',\n            payload: {\n              name,\n              ...options,\n            },\n          });\n        }\n      } else {\n        return navigation?.dispatch({\n          type: 'JUMP_TO',\n          payload: {\n            name,\n          },\n        });\n      }\n    },\n    [navigation, triggerMap]\n  );\n\n  const handleOnPress = useCallback<NonNullable<PressableProps['onPress']>>(\n    (event) => {\n      onPress?.(event);\n      if (!trigger) return;\n      if (event?.isDefaultPrevented()) return;\n\n      navigation?.emit({\n        type: 'tabPress',\n        target: trigger.type === 'internal' ? trigger.route.key : trigger?.href,\n        canPreventDefault: true,\n      });\n\n      if (!shouldHandleMouseEvent(event)) return;\n\n      switchTab(name, { reset: reset !== 'onLongPress' ? reset : undefined });\n    },\n    [onPress, name, reset, trigger]\n  );\n\n  const handleOnLongPress = useCallback<NonNullable<PressableProps['onPress']>>(\n    (event) => {\n      onPress?.(event);\n      if (!trigger) return;\n      if (event?.isDefaultPrevented()) return;\n\n      navigation?.emit({\n        type: 'tabLongPress',\n        target: trigger.type === 'internal' ? trigger.route.key : trigger?.href,\n      });\n\n      if (!shouldHandleMouseEvent(event)) return;\n\n      switchTab(name, {\n        reset: reset === 'onLongPress' ? 'always' : reset,\n      });\n    },\n    [onLongPress, name, reset, trigger]\n  );\n\n  const triggerProps = {\n    isFocused: Boolean(trigger?.isFocused),\n    onPress: handleOnPress,\n    onLongPress: handleOnLongPress,\n  };\n\n  return {\n    switchTab,\n    getTrigger,\n    trigger,\n    triggerProps,\n  };\n}\n\nconst styles = StyleSheet.create({\n  tabTrigger: {\n    flexDirection: 'row',\n    justifyContent: 'space-between',\n  },\n});\n"]}
+{"version":3,"file":"TabTrigger.js","sourceRoot":"","sources":["../../src/ui/TabTrigger.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Slot } from '@radix-ui/react-slot';\nimport { TabNavigationState } from '@react-navigation/native';\nimport { ReactNode, useContext, ReactElement, ComponentProps, useCallback } from 'react';\nimport { View, StyleSheet, Pressable, PressableProps } from 'react-native';\n\nimport { TabTriggerMapContext } from './TabContext';\nimport { ExpoTabsResetValue } from './TabRouter';\nimport type { TriggerMap } from './common';\nimport { appendBaseUrl } from '../fork/getPathFromState';\nimport { router } from '../imperative-api';\nimport { shouldHandleMouseEvent } from '../link/useLinkToPathProps';\nimport { stripGroupSegmentsFromPath } from '../matchers';\nimport type { Href } from '../types';\nimport { useNavigatorContext } from '../views/Navigator';\n\ntype PressablePropsWithoutFunctionChildren = Omit<PressableProps, 'children'> & {\n  children?: ReactNode | undefined;\n};\n\nexport type TabTriggerProps = PressablePropsWithoutFunctionChildren & {\n  /**\n   *  Name of tab. When used within a `TabList` this sets the name of the tab.\n   * Otherwise, this references the name.\n   */\n  name: string;\n  /**\n   * Name of tab. Required when used within a `TabList`.\n   */\n  href?: Href;\n  /**\n   * Forward props to child component. Useful for custom wrappers.\n   */\n  asChild?: boolean;\n  /**\n   * Resets the route when switching to a tab.\n   */\n  reset?: SwitchToOptions['reset'] | 'onLongPress';\n};\n\nexport type TabTriggerOptions = {\n  name: string;\n  href: Href;\n};\n\nexport type TabTriggerSlotProps = PressablePropsWithoutFunctionChildren &\n  React.RefAttributes<View> & {\n    isFocused?: boolean;\n    href?: string;\n  };\n\nconst TabTriggerSlot = Slot as React.ForwardRefExoticComponent<TabTriggerSlotProps>;\n\n/**\n * Creates a trigger to navigate to a tab. When used as child of `TabList`, its\n * functionality slightly changes since the `href` prop is required,\n * and the trigger also defines what routes are present in the `Tabs`.\n *\n * When used outside of `TabList`, this component no longer requires an `href`.\n *\n * @example\n * ```tsx\n * <Tabs>\n *  <TabSlot />\n *  <TabList>\n *   <TabTrigger name=\"home\" href=\"/\" />\n *  </TabList>\n * </Tabs>\n * ```\n */\nexport function TabTrigger({ asChild, name, href, reset = 'onFocus', ...props }: TabTriggerProps) {\n  const { trigger, triggerProps } = useTabTrigger({\n    name,\n    reset,\n    ...props,\n  });\n\n  // Pressable doesn't accept the extra props, so only pass them if we are using asChild\n  if (asChild) {\n    return (\n      <TabTriggerSlot\n        style={styles.tabTrigger}\n        {...props}\n        {...triggerProps}\n        href={trigger?.resolvedHref}>\n        {props.children}\n      </TabTriggerSlot>\n    );\n  } else {\n    // These props are not typed, but are allowed by React Native Web\n    const reactNativeWebProps = { href: trigger?.resolvedHref };\n\n    return (\n      <Pressable style={styles.tabTrigger} {...reactNativeWebProps} {...props} {...triggerProps}>\n        {props.children}\n      </Pressable>\n    );\n  }\n}\n\n/**\n * @hidden\n */\nexport function isTabTrigger(\n  child: ReactElement<any>\n): child is ReactElement<ComponentProps<typeof TabTrigger>> {\n  return child.type === TabTrigger;\n}\n\n/**\n * Options for `switchTab` function.\n */\nexport type SwitchToOptions = {\n  /**\n   * Navigate and reset the history.\n   */\n  reset?: ExpoTabsResetValue;\n};\n\nexport type Trigger = TriggerMap[string] & {\n  isFocused: boolean;\n  resolvedHref: string;\n  route: TabNavigationState<any>['routes'][number];\n};\n\nexport type UseTabTriggerResult = {\n  switchTab: (name: string, options: SwitchToOptions) => void;\n  getTrigger: (name: string) => Trigger | undefined;\n  trigger?: Trigger;\n  triggerProps: TriggerProps;\n};\n\nexport type TriggerProps = {\n  isFocused: boolean;\n  onPress: PressableProps['onPress'];\n  onLongPress: PressableProps['onLongPress'];\n};\n\n/**\n * Utility hook creating custom `TabTrigger`.\n */\nexport function useTabTrigger(options: TabTriggerProps): UseTabTriggerResult {\n  const { state, navigation } = useNavigatorContext();\n  const { name, reset, onPress, onLongPress } = options;\n  const triggerMap = useContext(TabTriggerMapContext);\n\n  const getTrigger = useCallback(\n    (name: string) => {\n      const config = triggerMap[name];\n\n      if (!config) {\n        return;\n      }\n\n      return {\n        isFocused: state.index === config.index,\n        route: state.routes[config.index],\n        resolvedHref: stripGroupSegmentsFromPath(appendBaseUrl(config.href)),\n        ...config,\n      };\n    },\n    [triggerMap]\n  );\n\n  const trigger = name !== undefined ? getTrigger(name) : undefined;\n\n  const switchTab = useCallback(\n    (name: string, options?: SwitchToOptions) => {\n      const config = triggerMap[name];\n\n      if (config) {\n        if (config.type === 'external') {\n          return router.navigate(config.href);\n        } else {\n          return navigation?.dispatch({\n            type: 'JUMP_TO',\n            payload: {\n              name,\n              ...options,\n            },\n          });\n        }\n      } else {\n        return navigation?.dispatch({\n          type: 'JUMP_TO',\n          payload: {\n            name,\n          },\n        });\n      }\n    },\n    [navigation, triggerMap]\n  );\n\n  const handleOnPress = useCallback<NonNullable<PressableProps['onPress']>>(\n    (event) => {\n      onPress?.(event);\n      if (!trigger) return;\n      if (event?.isDefaultPrevented()) return;\n\n      navigation?.emit({\n        type: 'tabPress',\n        target: trigger.type === 'internal' ? trigger.route.key : trigger?.href,\n        canPreventDefault: true,\n      });\n\n      if (!shouldHandleMouseEvent(event)) return;\n\n      switchTab(name, { reset: reset !== 'onLongPress' ? reset : undefined });\n    },\n    [onPress, name, reset, trigger]\n  );\n\n  const handleOnLongPress = useCallback<NonNullable<PressableProps['onPress']>>(\n    (event) => {\n      onPress?.(event);\n      if (!trigger) return;\n      if (event?.isDefaultPrevented()) return;\n\n      navigation?.emit({\n        type: 'tabLongPress',\n        target: trigger.type === 'internal' ? trigger.route.key : trigger?.href,\n      });\n\n      if (!shouldHandleMouseEvent(event)) return;\n\n      switchTab(name, {\n        reset: reset === 'onLongPress' ? 'always' : reset,\n      });\n    },\n    [onLongPress, name, reset, trigger]\n  );\n\n  const triggerProps = {\n    isFocused: Boolean(trigger?.isFocused),\n    onPress: handleOnPress,\n    onLongPress: handleOnLongPress,\n  };\n\n  return {\n    switchTab,\n    getTrigger,\n    trigger,\n    triggerProps,\n  };\n}\n\nconst styles = StyleSheet.create({\n  tabTrigger: {\n    flexDirection: 'row',\n    justifyContent: 'space-between',\n  },\n});\n"]}

package/build/ui/Tabs.d.ts

@@ -1,74 +1,60 @@
-import { ParamListBase, TabActionHelpers, TabNavigationState } from '@react-navigation/native';
+import { DefaultNavigatorOptions, ParamListBase, TabActionHelpers, TabNavigationState, TabRouterOptions } from '@react-navigation/native';
 import { ReactNode } from 'react';
 import { ViewProps } from 'react-native';
-import { ExpoTabsProps, ExpoTabsScreenOptions, TabNavigationEventMap } from './TabContext';
-import { ExpoTabRouterOptions } from './TabRouter';
+import { ExpoTabsScreenOptions, TabNavigationEventMap, TabsContextValue } from './TabContext';
 import { ScreenTrigger } from './common';
 export * from './TabContext';
 export * from './TabList';
 export * from './TabSlot';
 export * from './TabTrigger';
-export type UseTabsOptions = Omit<ExpoTabsProps, 'children'> & Omit<ExpoTabRouterOptions, 'initialRouteName' | 'triggerMap'>;
+/**
+ * Options to provide to the Tab Router.
+ */
+export type UseTabsOptions = Omit<DefaultNavigatorOptions<ParamListBase, any, TabNavigationState<any>, ExpoTabsScreenOptions, TabNavigationEventMap, any>, 'children'> & {
+    backBehavior?: TabRouterOptions['backBehavior'];
+};
 export type TabsProps = ViewProps & {
+    /** Forward props to child component and removes the extra `<View>`. Useful for custom wrappers. */
     asChild?: boolean;
     options?: UseTabsOptions;
 };
-export declare function Tabs({ children, asChild, options, ...props }: TabsProps): import("react").JSX.Element;
+/**
+ * Root component for the headless tabs.
+ *
+ * @see [`useTabsWithChildren`](#usetabswithchildrenoptions) for a hook version of this component.
+ * @example
+ * ```tsx
+ * <Tabs>
+ *  <TabSlot />
+ *  <TabList>
+ *   <TabTrigger name="home" href="/" />
+ *  </TabList>
+ * </Tabs>
+ * ```
+ */
+export declare function Tabs(props: TabsProps): import("react").JSX.Element;
 export type UseTabsWithChildrenOptions = UseTabsOptions & {
     children: ReactNode;
 };
-export type UseTabsWithTriggersOptions<T extends string | object> = UseTabsOptions & {
-    triggers: ScreenTrigger<T>[];
+export type UseTabsWithTriggersOptions = UseTabsOptions & {
+    triggers: ScreenTrigger[];
 };
-export declare function useTabsWithChildren({ children, ...options }: UseTabsWithChildrenOptions): {
+/**
+ * Hook version of `Tabs`. The returned NavigationContent component
+ * should be rendered.
+ *
+ * @see [`Tabs`](#tabs) for the component version of this hook.
+ * @example
+ * ```tsx
+ * export function MyTabs({ children }) {
+ *  const { NavigationContent } = useTabsWithChildren({ children })
+ *
+ *  return <NavigationContent />
+ * }
+ * ```
+ */
+export declare function useTabsWithChildren(options: UseTabsWithChildrenOptions): {
     state: TabNavigationState<any>;
-    descriptors: Record<string, import("@react-navigation/native").Descriptor<ExpoTabsScreenOptions, Omit<{
-        dispatch(action: Readonly<{
-            type: string;
-            payload?: object | undefined;
-            source?: string | undefined;
-            target?: string | undefined;
-        }> | ((state: Readonly<TabNavigationState<any>>) => Readonly<{
-            type: string;
-            payload?: object | undefined;
-            source?: string | undefined;
-            target?: string | undefined;
-        }>)): void;
-        navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigate<RouteName_1 extends string>(options: {
-            name: string;
-            params: object | undefined;
-            path?: string | undefined;
-            merge?: boolean | undefined;
-        }): void;
-        navigateDeprecated<RouteName_2 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName_3 extends string>(options: {
-            name: string;
-            params: object | undefined;
-            merge?: boolean | undefined;
-        }): void;
-        preload<RouteName_4 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        reset(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
-        goBack(): void;
-        isFocused(): boolean;
-        canGoBack(): boolean;
-        getId(): string | undefined;
-        getParent<T = import("@react-navigation/native").NavigationHelpers<ParamListBase, {}> | undefined>(id?: string | undefined): T;
-        getState(): TabNavigationState<any>;
-        setStateForNextRouteNamesChange(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
-    } & import("@react-navigation/native").PrivateValueStore<[ParamListBase, unknown, unknown]>, "getParent"> & {
-        getParent<T_1 = import("@react-navigation/native").NavigationProp<ParamListBase, string, undefined, Readonly<{
-            key: string;
-            index: number;
-            routeNames: string[];
-            history?: unknown[] | undefined;
-            routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
-            type: string;
-            stale: false;
-        }>, {}, {}> | undefined>(id?: string | undefined): T_1;
-        setParams(params: Partial<object | undefined>): void;
-        setOptions(options: Partial<ExpoTabsScreenOptions>): void;
-    } & import("@react-navigation/native").EventConsumer<TabNavigationEventMap & import("@react-navigation/native").EventMapCore<TabNavigationState<any>>> & import("@react-navigation/native").PrivateValueStore<[ParamListBase, string, TabNavigationEventMap]> & TabActionHelpers<ParamListBase>, import("@react-navigation/native").RouteProp<ParamListBase, string>>>;
     navigation: {
         dispatch(action: Readonly<{
             type: string;
@@ -89,20 +75,20 @@ export declare function useTabsWithChildren({ children, ...options }: UseTabsWit
             source?: string | undefined;
             target?: string | undefined;
         }>)): void;
-        navigate<RouteName_5 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigate<RouteName_6 extends string>(options: {
+        navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        navigate<RouteName_1 extends string>(options: {
             name: string;
             params: object | undefined;
             path?: string | undefined;
             merge?: boolean | undefined;
         }): void;
-        navigateDeprecated<RouteName_7 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName_8 extends string>(options: {
+        navigateDeprecated<RouteName_2 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        navigateDeprecated<RouteName_3 extends string>(options: {
             name: string;
             params: object | undefined;
             merge?: boolean | undefined;
         }): void;
-        preload<RouteName_9 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        preload<RouteName_4 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
         reset(state: Readonly<{
             key: string;
             index: number;
@@ -124,7 +110,7 @@ export declare function useTabsWithChildren({ children, ...options }: UseTabsWit
         isFocused(): boolean;
         canGoBack(): boolean;
         getId(): string | undefined;
-        getParent<T_2 = import("@react-navigation/native").NavigationHelpers<ParamListBase, {}> | undefined>(id?: string | undefined): T_2;
+        getParent<T = import("@react-navigation/native").NavigationHelpers<ParamListBase, {}> | undefined>(id?: string | undefined): T;
         getState(): Readonly<{
             key: string;
             index: number;
@@ -152,15 +138,9 @@ export declare function useTabsWithChildren({ children, ...options }: UseTabsWit
             stale: false;
         }>>): void;
     } & import("@react-navigation/native").PrivateValueStore<[ParamListBase, unknown, unknown]> & import("@react-navigation/native").EventEmitter<TabNavigationEventMap> & {
-        setParams<RouteName_10 extends string>(params: Partial<object | undefined>): void;
+        setParams<RouteName_5 extends string>(params: Partial<object | undefined>): void;
     } & TabActionHelpers<ParamListBase>;
-    NavigationContent: import("react").ForwardRefExoticComponent<{
-        children: ReactNode;
-    } & import("react").RefAttributes<unknown>>;
-};
-export declare function useTabsWithTriggers<T extends string | object>({ triggers, ...options }: UseTabsWithTriggersOptions<T>): {
-    state: TabNavigationState<any>;
-    descriptors: Record<string, import("@react-navigation/native").Descriptor<ExpoTabsScreenOptions, Omit<{
+    describe: (route: import("@react-navigation/native").RouteProp<ParamListBase, string>, placeholder: boolean) => import("@react-navigation/native").Descriptor<import("./TabContext").ExpoTabsNavigatorScreenOptions, Omit<{
         dispatch(action: Readonly<{
             type: string;
             payload?: object | undefined;
@@ -172,20 +152,20 @@ export declare function useTabsWithTriggers<T extends string | object>({ trigger
             source?: string | undefined;
             target?: string | undefined;
         }>)): void;
-        navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigate<RouteName_1 extends string>(options: {
+        navigate<RouteName_6 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        navigate<RouteName_7 extends string>(options: {
             name: string;
             params: object | undefined;
             path?: string | undefined;
             merge?: boolean | undefined;
         }): void;
-        navigateDeprecated<RouteName_2 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName_3 extends string>(options: {
+        navigateDeprecated<RouteName_8 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        navigateDeprecated<RouteName_9 extends string>(options: {
             name: string;
             params: object | undefined;
             merge?: boolean | undefined;
         }): void;
-        preload<RouteName_4 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        preload<RouteName_10 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
         reset(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
         goBack(): void;
         isFocused(): boolean;
@@ -205,82 +185,44 @@ export declare function useTabsWithTriggers<T extends string | object>({ trigger
             stale: false;
         }>, {}, {}> | undefined>(id?: string | undefined): T_2;
         setParams(params: Partial<object | undefined>): void;
-        setOptions(options: Partial<ExpoTabsScreenOptions>): void;
-    } & import("@react-navigation/native").EventConsumer<TabNavigationEventMap & import("@react-navigation/native").EventMapCore<TabNavigationState<any>>> & import("@react-navigation/native").PrivateValueStore<[ParamListBase, string, TabNavigationEventMap]> & TabActionHelpers<ParamListBase>, import("@react-navigation/native").RouteProp<ParamListBase, string>>>;
-    navigation: {
+        setOptions(options: Partial<import("./TabContext").ExpoTabsNavigatorScreenOptions>): void;
+    } & import("@react-navigation/native").EventConsumer<TabNavigationEventMap & import("@react-navigation/native").EventMapCore<TabNavigationState<any>>> & import("@react-navigation/native").PrivateValueStore<[ParamListBase, string, TabNavigationEventMap]> & TabActionHelpers<ParamListBase>, import("@react-navigation/native").RouteProp<ParamListBase, string>>;
+    descriptors: Record<string, import("@react-navigation/native").Descriptor<import("./TabContext").ExpoTabsNavigatorScreenOptions, Omit<{
         dispatch(action: Readonly<{
             type: string;
             payload?: object | undefined;
             source?: string | undefined;
             target?: string | undefined;
-        }> | ((state: Readonly<Readonly<{
-            key: string;
-            index: number;
-            routeNames: string[];
-            history?: unknown[] | undefined;
-            routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
-            type: string;
-            stale: false;
-        }>>) => Readonly<{
+        }> | ((state: Readonly<TabNavigationState<any>>) => Readonly<{
             type: string;
             payload?: object | undefined;
             source?: string | undefined;
             target?: string | undefined;
         }>)): void;
-        navigate<RouteName_5 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigate<RouteName_6 extends string>(options: {
+        navigate<RouteName_11 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        navigate<RouteName_12 extends string>(options: {
             name: string;
             params: object | undefined;
             path?: string | undefined;
             merge?: boolean | undefined;
         }): void;
-        navigateDeprecated<RouteName_7 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName_8 extends string>(options: {
+        navigateDeprecated<RouteName_13 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        navigateDeprecated<RouteName_14 extends string>(options: {
             name: string;
             params: object | undefined;
             merge?: boolean | undefined;
         }): void;
-        preload<RouteName_9 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        reset(state: Readonly<{
-            key: string;
-            index: number;
-            routeNames: string[];
-            history?: unknown[] | undefined;
-            routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
-            type: string;
-            stale: false;
-        }> | import("@react-navigation/native").PartialState<Readonly<{
-            key: string;
-            index: number;
-            routeNames: string[];
-            history?: unknown[] | undefined;
-            routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
-            type: string;
-            stale: false;
-        }>>): void;
+        preload<RouteName_15 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        reset(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
         goBack(): void;
         isFocused(): boolean;
         canGoBack(): boolean;
         getId(): string | undefined;
         getParent<T_3 = import("@react-navigation/native").NavigationHelpers<ParamListBase, {}> | undefined>(id?: string | undefined): T_3;
-        getState(): Readonly<{
-            key: string;
-            index: number;
-            routeNames: string[];
-            history?: unknown[] | undefined;
-            routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
-            type: string;
-            stale: false;
-        }>;
-        setStateForNextRouteNamesChange(state: Readonly<{
-            key: string;
-            index: number;
-            routeNames: string[];
-            history?: unknown[] | undefined;
-            routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
-            type: string;
-            stale: false;
-        }> | import("@react-navigation/native").PartialState<Readonly<{
+        getState(): TabNavigationState<any>;
+        setStateForNextRouteNamesChange(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
+    } & import("@react-navigation/native").PrivateValueStore<[ParamListBase, unknown, unknown]>, "getParent"> & {
+        getParent<T_4 = import("@react-navigation/native").NavigationProp<ParamListBase, string, undefined, Readonly<{
             key: string;
             index: number;
             routeNames: string[];
@@ -288,12 +230,27 @@ export declare function useTabsWithTriggers<T extends string | object>({ trigger
             routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
             type: string;
             stale: false;
-        }>>): void;
-    } & import("@react-navigation/native").PrivateValueStore<[ParamListBase, unknown, unknown]> & import("@react-navigation/native").EventEmitter<TabNavigationEventMap> & {
-        setParams<RouteName_10 extends string>(params: Partial<object | undefined>): void;
-    } & TabActionHelpers<ParamListBase>;
-    NavigationContent: import("react").ForwardRefExoticComponent<{
+        }>, {}, {}> | undefined>(id?: string | undefined): T_4;
+        setParams(params: Partial<object | undefined>): void;
+        setOptions(options: Partial<import("./TabContext").ExpoTabsNavigatorScreenOptions>): void;
+    } & import("@react-navigation/native").EventConsumer<TabNavigationEventMap & import("@react-navigation/native").EventMapCore<TabNavigationState<any>>> & import("@react-navigation/native").PrivateValueStore<[ParamListBase, string, TabNavigationEventMap]> & TabActionHelpers<ParamListBase>, import("@react-navigation/native").RouteProp<ParamListBase, string>>>;
+    NavigationContent: ({ children }: {
         children: ReactNode;
-    } & import("react").RefAttributes<unknown>>;
+    }) => import("react/jsx-runtime").JSX.Element;
 };
+/**
+ * Alternative hook version of `Tabs` that uses explicit triggers
+ * instead of `children`.
+ *
+ * @see [`Tabs`](#tabs) for the component version of this hook.
+ * @example
+ * ```tsx
+ * export function MyTabs({ children }) {
+ *   const { NavigationContent } = useTabsWithChildren({ triggers: [] })
+ *
+ *   return <NavigationContent />
+ * }
+ * ```
+ */
+export declare function useTabsWithTriggers(options: UseTabsWithTriggersOptions): TabsContextValue;
 //# sourceMappingURL=Tabs.d.ts.map

package/build/ui/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../src/ui/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAKL,SAAS,EAIV,MAAM,OAAO,CAAC;AACf,OAAO,EAAc,SAAS,EAAQ,MAAM,cAAc,CAAC;AAE3D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAiB,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAoB,aAAa,EAAqB,MAAM,UAAU,CAAC;AAQ9E,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAE7B,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAC1D,IAAI,CAAC,oBAAoB,EAAE,kBAAkB,GAAG,YAAY,CAAC,CAAC;AAEhE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,+BAcvE;AAED,MAAM,MAAM,0BAA0B,GAAG,cAAc,GAAG;IACxD,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,cAAc,GAAG;IACnF,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;CAC9B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEvF;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAC7D,QAAQ,EACR,GAAG,OAAO,EACX,EAAE,0BAA0B,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+D/B"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../src/ui/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAEvB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAKL,SAAS,EAIV,MAAM,OAAO,CAAC;AACf,OAAO,EAAc,SAAS,EAAQ,MAAM,cAAc,CAAC;AAE3D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EAErB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAKtB,OAAO,EAAoB,aAAa,EAAqB,MAAM,UAAU,CAAC;AAQ9E,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,uBAAuB,CACrB,aAAa,EACb,GAAG,EACH,kBAAkB,CAAC,GAAG,CAAC,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,GAAG,CACJ,EACD,UAAU,CACX,GAAG;IACF,YAAY,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAClC,mGAAmG;IACnG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,+BAepC;AAED,MAAM,MAAM,0BAA0B,GAAG,cAAc,GAAG;IACxD,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,cAAc,GAAG;IACxD,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,gBAAgB,CAiEzF"}