{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "floating-action-button",
  "title": "Floating Action Button",
  "description": "A positioned primary action that can expand into an extended label and open a FAB menu.",
  "dependencies": [
    "react-native-reanimated",
    "react-native-safe-area-context"
  ],
  "registryDependencies": [
    "@tetra-ui/button",
    "@tetra-ui/icons",
    "@tetra-ui/scrim",
    "@tetra-ui/slots"
  ],
  "files": [
    {
      "path": "ui/floating-action-button.tsx",
      "content": "import { cva } from \"class-variance-authority\";\nimport {\n  Children,\n  cloneElement,\n  createContext,\n  isValidElement,\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport {\n  BackHandler,\n  type GestureResponderEvent,\n  type LayoutChangeEvent,\n  Pressable,\n  type PressableStateCallbackType,\n  Text,\n  useWindowDimensions,\n  View,\n  type ViewStyle,\n} from \"react-native\";\nimport Animated, {\n  Easing,\n  Extrapolation,\n  interpolate,\n  type SharedValue,\n  useAnimatedStyle,\n  useSharedValue,\n  withTiming,\n} from \"react-native-reanimated\";\nimport { useSafeAreaInsets } from \"react-native-safe-area-context\";\nimport { createSlots } from \"@/lib/slots\";\nimport { cn } from \"@/lib/utils\";\nimport {\n  Button,\n  ButtonIcon,\n  type ButtonProps,\n  ButtonText,\n  buttonIconVariants,\n} from \"@/components/ui/button\";\nimport { XIcon } from \"@/components/ui/icons\";\nimport { Scrim, ScrimHost, ScrimTarget } from \"@/components/ui/scrim\";\n\n// Constants\nconst ANIMATION_DURATION = 250;\nconst ANIMATION_EASING = Easing.out(Easing.cubic);\nconst EDGE_PADDING = 16;\nconst MENU_GAP = 12;\nconst MENU_ITEM_STAGGER = 0.12;\nconst MENU_ITEM_TRAVEL = 16;\nconst AUTO_BREAKPOINT = 768;\nconst TIMING = {\n  duration: ANIMATION_DURATION,\n  easing: ANIMATION_EASING,\n} as const;\n\nconst fabSlots = createSlots<\"fab\">({\n  errorMessage: \"Fab must be used within a FabHost\",\n});\n\n// Types\nexport type FabEdge = \"bottom-end\" | \"bottom-start\" | \"bottom-center\";\nexport type FabAppearance = \"fab\" | \"extended\" | \"auto\";\nexport type FabOffset = number | { x?: number; y?: number };\n\ntype FabSize = \"sm\" | \"default\" | \"lg\";\ntype FabVariant = \"default\" | \"secondary\";\ntype FabVisual = \"fab\" | \"extended\";\n\ntype FabContextValue = {\n  open: boolean;\n  onOpenChange: (open: boolean) => void;\n  setMenu: (menu: React.ReactNode | null) => void;\n  size: FabSize;\n  variant: FabVariant;\n  visual: FabVisual;\n  visibilityProgress: SharedValue<number>;\n};\n\ntype FabLayer = {\n  open: boolean;\n  edge: FabEdge;\n  bottom: number;\n  start?: number;\n  end?: number;\n  fabHeight: number;\n  menu: React.ReactNode;\n  onDismiss: () => void;\n  visibilityProgress: SharedValue<number>;\n  fabContext: FabContextValue;\n};\n\ntype FabHostContextValue = {\n  setLayer: (layer: FabLayer | null) => void;\n};\n\nexport type FabHostProps = React.ComponentProps<typeof View>;\n\nexport type FabProps = Omit<ButtonProps, \"size\" | \"variant\"> & {\n  size?: FabSize;\n  variant?: FabVariant;\n  appearance?: FabAppearance;\n  edge?: FabEdge;\n  offset?: FabOffset;\n  bottomInset?: number;\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  positioned?: boolean;\n};\n\nexport type FabMenuProps = {\n  children: React.ReactNode;\n};\n\nexport type FabMenuItemVariant = \"default\" | \"destructive\";\n\nexport type FabMenuItemProps = React.ComponentProps<typeof Pressable> & {\n  closeOnPress?: boolean;\n  variant?: FabMenuItemVariant;\n  children: React.ReactNode;\n};\n\ntype ButtonChildProps = {\n  children: React.ReactNode;\n  className?: string;\n};\n\n// Context\nconst FabContext = createContext<FabContextValue | null>(null);\nconst FabHostContext = createContext<FabHostContextValue | null>(null);\nconst FabMenuItemContext = createContext<FabMenuItemVariant | null>(null);\n\nconst useFab = () => {\n  const context = useContext(FabContext);\n  if (!context) {\n    throw new Error(\"Fab components must be used within a Fab\");\n  }\n  return context;\n};\n\nconst useOptionalFabHost = () => {\n  return useContext(FabHostContext);\n};\n\nconst useFabMenuItem = () => {\n  const context = useContext(FabMenuItemContext);\n  if (!context) {\n    throw new Error(\"FabMenuItem parts must be used within a FabMenuItem\");\n  }\n  return context;\n};\n\n// Helpers\nconst normalizeOffset = (offset?: FabOffset) => {\n  if (typeof offset === \"number\") {\n    return { x: offset, y: offset };\n  }\n\n  return { x: offset?.x ?? 0, y: offset?.y ?? 0 };\n};\n\nconst getFabPositionStyle = ({\n  edge,\n  bottom,\n  horizontal,\n}: {\n  edge: FabEdge;\n  bottom: number;\n  horizontal: number;\n}): ViewStyle => {\n  if (edge === \"bottom-start\") {\n    return {\n      bottom,\n      position: \"absolute\",\n      start: horizontal,\n      zIndex: 50,\n    };\n  }\n\n  if (edge === \"bottom-center\") {\n    return {\n      alignSelf: \"center\",\n      bottom,\n      position: \"absolute\",\n      zIndex: 50,\n    };\n  }\n\n  return {\n    bottom,\n    end: horizontal,\n    position: \"absolute\",\n    zIndex: 50,\n  };\n};\n\nconst getMenuPositionStyle = ({\n  edge,\n  bottom,\n  fabHeight,\n  start,\n  end,\n}: {\n  edge: FabEdge;\n  bottom: number;\n  fabHeight: number;\n  start?: number;\n  end?: number;\n}): ViewStyle => {\n  const style: ViewStyle = {\n    bottom: bottom + fabHeight + MENU_GAP,\n    flexDirection: \"column-reverse\",\n    gap: 8,\n    position: \"absolute\",\n    zIndex: 50,\n  };\n\n  if (edge === \"bottom-center\") {\n    return { ...style, alignItems: \"center\", alignSelf: \"center\" };\n  }\n\n  if (edge === \"bottom-start\") {\n    return { ...style, alignItems: \"flex-start\", start };\n  }\n\n  return { ...style, alignItems: \"flex-end\", end };\n};\n\nconst resolveVisual = ({\n  appearance,\n  width,\n}: {\n  appearance: FabAppearance;\n  width: number;\n}): FabVisual => {\n  if (appearance === \"extended\") {\n    return \"extended\";\n  }\n\n  if (appearance === \"auto\" && width >= AUTO_BREAKPOINT) {\n    return \"extended\";\n  }\n\n  return \"fab\";\n};\n\nconst getButtonSize = (\n  size: FabSize,\n  visual: FabVisual\n): NonNullable<ButtonProps[\"size\"]> => {\n  if (visual === \"extended\") {\n    return size;\n  }\n\n  if (size === \"sm\") {\n    return \"icon-sm\";\n  }\n\n  return \"icon-lg\";\n};\n\n// Components\nexport const FabHost = ({ className, children, ...props }: FabHostProps) => {\n  const [layer, setLayer] = useState<FabLayer | null>(null);\n  const ctx = useMemo(() => ({ setLayer }), []);\n\n  return (\n    <FabHostContext.Provider value={ctx}>\n      <fabSlots.Provider>\n        <ScrimHost className={className} {...props}>\n          <ScrimTarget>{children}</ScrimTarget>\n          <Scrim\n            onPress={layer?.onDismiss}\n            open={layer?.open ?? false}\n            visibilityProgress={layer?.visibilityProgress}\n          />\n          <fabSlots.Outlet name=\"fab\" />\n          <FabMenuLayer layer={layer} />\n        </ScrimHost>\n      </fabSlots.Provider>\n    </FabHostContext.Provider>\n  );\n};\n\nconst FabMenuItemFrame = ({\n  index,\n  visibilityProgress,\n  children,\n}: {\n  index: number;\n  visibilityProgress: SharedValue<number>;\n  children: React.ReactNode;\n}) => {\n  const animatedStyle = useAnimatedStyle(() => {\n    const start = index * MENU_ITEM_STAGGER;\n    const end = Math.min(1, start + 0.55);\n    const itemProgress = interpolate(\n      visibilityProgress.value,\n      [start, end],\n      [0, 1],\n      Extrapolation.CLAMP\n    );\n\n    return {\n      opacity: itemProgress,\n      transform: [\n        {\n          translateY: interpolate(itemProgress, [0, 1], [MENU_ITEM_TRAVEL, 0]),\n        },\n      ],\n    };\n  });\n\n  return <Animated.View style={animatedStyle}>{children}</Animated.View>;\n};\n\nconst FabMenuLayer = ({ layer }: { layer: FabLayer | null }) => {\n  const [mounted, setMounted] = useState(false);\n  const open = layer?.open ?? false;\n\n  useEffect(() => {\n    if (open) {\n      setMounted(true);\n      return;\n    }\n\n    const timeout = setTimeout(() => {\n      setMounted(false);\n    }, ANIMATION_DURATION);\n\n    return () => {\n      clearTimeout(timeout);\n    };\n  }, [open]);\n\n  if (!(layer && mounted)) {\n    return null;\n  }\n\n  const items = Children.toArray(layer.menu);\n\n  return (\n    <FabContext.Provider value={layer.fabContext}>\n      <View\n        pointerEvents={open ? \"box-none\" : \"none\"}\n        style={getMenuPositionStyle({\n          bottom: layer.bottom,\n          edge: layer.edge,\n          end: layer.end,\n          fabHeight: layer.fabHeight,\n          start: layer.start,\n        })}\n      >\n        {items.map((item, index) => {\n          if (!isValidElement(item)) {\n            return item;\n          }\n\n          return (\n            <FabMenuItemFrame\n              index={index}\n              key={item.key}\n              visibilityProgress={layer.visibilityProgress}\n            >\n              {item}\n            </FabMenuItemFrame>\n          );\n        })}\n      </View>\n    </FabContext.Provider>\n  );\n};\n\nexport const Fab = ({\n  className,\n  size = \"default\",\n  variant = \"default\",\n  appearance = \"fab\",\n  edge = \"bottom-end\",\n  offset,\n  bottomInset = 0,\n  open: openProp,\n  defaultOpen = false,\n  onOpenChange: onOpenChangeProp,\n  positioned = true,\n  children,\n  onPress: onPressProp,\n  onLayout: onLayoutProp,\n  accessibilityLabel,\n  busy,\n  disabled,\n  style,\n  ...props\n}: FabProps) => {\n  const host = useOptionalFabHost();\n  const insets = useSafeAreaInsets();\n  const { width } = useWindowDimensions();\n  const [menu, setMenu] = useState<React.ReactNode | null>(null);\n  const [internalOpen, setInternalOpen] = useState(defaultOpen);\n  const [fabHeight, setFabHeight] = useState(56);\n  const visibilityProgress = useSharedValue((openProp ?? defaultOpen) ? 1 : 0);\n\n  const isControlled = openProp !== undefined;\n  const open = isControlled ? openProp : internalOpen;\n  const hasMenu = menu !== null;\n  const isPositioned = Boolean(host) && positioned;\n  const extra = normalizeOffset(offset);\n  const bottom = insets.bottom + EDGE_PADDING + bottomInset + extra.y;\n  const horizontal =\n    (edge === \"bottom-start\" ? insets.left : insets.right) +\n    EDGE_PADDING +\n    extra.x;\n\n  const onOpenChange = useCallback(\n    (nextOpen: boolean) => {\n      if (!isControlled) {\n        setInternalOpen(nextOpen);\n      }\n      onOpenChangeProp?.(nextOpen);\n    },\n    [isControlled, onOpenChangeProp]\n  );\n\n  const visual = resolveVisual({\n    appearance,\n    width,\n  });\n\n  const buttonSize = getButtonSize(size, visual);\n\n  const fabContext = useMemo(\n    () => ({\n      onOpenChange,\n      open,\n      setMenu,\n      size,\n      variant,\n      visibilityProgress,\n      visual,\n    }),\n    [onOpenChange, open, size, variant, visibilityProgress, visual]\n  );\n\n  useEffect(() => {\n    visibilityProgress.value = withTiming(open ? 1 : 0, TIMING);\n  }, [open, visibilityProgress]);\n\n  useEffect(() => {\n    if (!(open && hasMenu)) {\n      return;\n    }\n\n    const subscription = BackHandler.addEventListener(\n      \"hardwareBackPress\",\n      () => {\n        onOpenChange(false);\n        return true;\n      }\n    );\n\n    return () => {\n      subscription.remove();\n    };\n  }, [hasMenu, onOpenChange, open]);\n\n  useLayoutEffect(() => {\n    if (!host) {\n      return;\n    }\n\n    if (!(positioned && menu !== null)) {\n      host.setLayer(null);\n      return;\n    }\n\n    host.setLayer({\n      bottom,\n      edge,\n      end: edge === \"bottom-end\" ? horizontal : undefined,\n      fabContext,\n      fabHeight,\n      menu,\n      onDismiss: () => {\n        onOpenChange(false);\n      },\n      open,\n      start: edge === \"bottom-start\" ? horizontal : undefined,\n      visibilityProgress,\n    });\n  }, [\n    bottom,\n    edge,\n    fabContext,\n    fabHeight,\n    horizontal,\n    host,\n    menu,\n    onOpenChange,\n    open,\n    positioned,\n    visibilityProgress,\n  ]);\n\n  useEffect(() => {\n    return () => {\n      host?.setLayer(null);\n    };\n  }, [host]);\n\n  const handlePress = (event: GestureResponderEvent) => {\n    onPressProp?.(event);\n\n    if (hasMenu && !(disabled || busy)) {\n      onOpenChange(!open);\n    }\n  };\n\n  const handleLayout = (event: LayoutChangeEvent) => {\n    setFabHeight(event.nativeEvent.layout.height);\n    onLayoutProp?.(event);\n  };\n\n  const positionStyle = isPositioned\n    ? getFabPositionStyle({ bottom, edge, horizontal })\n    : undefined;\n\n  const composedStyle =\n    typeof style === \"function\"\n      ? (state: PressableStateCallbackType) => [positionStyle, style(state)]\n      : [positionStyle, style];\n\n  const node = (\n    <FabContext.Provider value={fabContext}>\n      <Button\n        accessibilityLabel={open ? \"Close\" : accessibilityLabel}\n        accessibilityState={hasMenu ? { expanded: open } : undefined}\n        busy={busy}\n        className={cn(fabVariants({ appearance: visual, size }), className)}\n        collapsable={false}\n        disabled={disabled}\n        onLayout={handleLayout}\n        onPress={handlePress}\n        size={buttonSize}\n        style={composedStyle}\n        variant={variant}\n        {...props}\n      >\n        {children}\n      </Button>\n    </FabContext.Provider>\n  );\n\n  if (isPositioned) {\n    return <fabSlots.Fill name=\"fab\">{node}</fabSlots.Fill>;\n  }\n\n  return node;\n};\n\nFab.displayName = \"Fab\";\n\nexport const FabText = (props: ButtonChildProps) => {\n  const { visual } = useFab();\n\n  if (visual !== \"extended\") {\n    return null;\n  }\n\n  return <ButtonText {...props} />;\n};\n\nexport const FabIcon = ({ children, className }: ButtonChildProps) => {\n  const { variant, visual, visibilityProgress, size } = useFab();\n  const buttonSize = getButtonSize(size, visual);\n\n  const restingStyle = useAnimatedStyle(() => ({\n    opacity: interpolate(\n      visibilityProgress.value,\n      [0, 0.5],\n      [1, 0],\n      Extrapolation.CLAMP\n    ),\n    transform: [\n      {\n        rotate: `${interpolate(visibilityProgress.value, [0, 1], [0, 90], Extrapolation.CLAMP)}deg`,\n      },\n    ],\n  }));\n\n  const closeStyle = useAnimatedStyle(() => ({\n    opacity: interpolate(\n      visibilityProgress.value,\n      [0.5, 1],\n      [0, 1],\n      Extrapolation.CLAMP\n    ),\n    transform: [\n      {\n        rotate: `${interpolate(visibilityProgress.value, [0, 1], [-90, 0], Extrapolation.CLAMP)}deg`,\n      },\n    ],\n  }));\n\n  return (\n    <View>\n      <Animated.View style={restingStyle}>\n        <ButtonIcon className={className}>{children}</ButtonIcon>\n      </Animated.View>\n      <Animated.View\n        className=\"absolute inset-0 items-center justify-center\"\n        style={closeStyle}\n      >\n        <XIcon className={buttonIconVariants({ size: buttonSize, variant })} />\n      </Animated.View>\n    </View>\n  );\n};\n\nexport const FabMenu = ({ children }: FabMenuProps) => {\n  const { setMenu } = useFab();\n\n  useLayoutEffect(() => {\n    setMenu(children);\n    return () => {\n      setMenu(null);\n    };\n  }, [children, setMenu]);\n\n  return null;\n};\n\nexport const FabMenuItem = ({\n  className,\n  closeOnPress = true,\n  onPress,\n  variant = \"default\",\n  disabled,\n  children,\n  accessibilityRole = \"button\",\n  ...props\n}: FabMenuItemProps) => {\n  const { onOpenChange } = useFab();\n\n  return (\n    <FabMenuItemContext.Provider value={variant}>\n      <Pressable\n        accessibilityRole={accessibilityRole}\n        className={cn(fabMenuItemVariants({ variant }), className)}\n        disabled={disabled}\n        {...props}\n        onPress={(event) => {\n          onPress?.(event);\n          if (closeOnPress) {\n            onOpenChange(false);\n          }\n        }}\n      >\n        {children}\n      </Pressable>\n    </FabMenuItemContext.Provider>\n  );\n};\n\nexport const FabMenuItemLabel = ({\n  className,\n  ...props\n}: React.ComponentProps<typeof Text>) => {\n  const variant = useFabMenuItem();\n\n  return (\n    <Text\n      className={cn(fabMenuItemLabelVariants({ variant }), className)}\n      {...props}\n    />\n  );\n};\n\nexport const FabMenuItemIcon = ({ children, className }: ButtonChildProps) => {\n  const variant = useFabMenuItem();\n  const child = Children.only(children);\n\n  if (!child) {\n    if (__DEV__) {\n      throw new Error(\n        \"FabMenuItemIcon expects a single React element as children\"\n      );\n    }\n    return null;\n  }\n\n  return cloneElement(child as React.ReactElement<ButtonChildProps>, {\n    className: cn(\n      fabMenuItemIconVariants({ variant }),\n      className,\n      (child as React.ReactElement<ButtonChildProps>).props.className\n    ),\n  });\n};\n\n// Styles\nconst fabVariants = cva(\"w-fit rounded-2xl shadow-lg\", {\n  compoundVariants: [\n    {\n      appearance: \"fab\",\n      class: \"size-10\",\n      size: \"sm\",\n    },\n    {\n      appearance: \"extended\",\n      class: \"h-10 px-4\",\n      size: \"sm\",\n    },\n    {\n      appearance: \"extended\",\n      class: \"h-14 px-5\",\n      size: \"default\",\n    },\n    {\n      appearance: \"fab\",\n      class: \"size-14\",\n      size: \"default\",\n    },\n    {\n      appearance: \"extended\",\n      class: \"h-16 px-6\",\n      size: \"lg\",\n    },\n    {\n      appearance: \"fab\",\n      class: \"size-16\",\n      size: \"lg\",\n    },\n  ],\n  defaultVariants: {\n    appearance: \"fab\",\n    size: \"default\",\n  },\n  variants: {\n    appearance: {\n      extended: \"\",\n      fab: \"\",\n    },\n    size: {\n      default: \"\",\n      lg: \"\",\n      sm: \"\",\n    },\n  },\n});\n\nconst fabMenuItemVariants = cva(\n  \"w-fit flex-row items-center gap-2 rounded-xl px-4 py-3 shadow-md disabled:opacity-50\",\n  {\n    defaultVariants: {\n      variant: \"default\",\n    },\n    variants: {\n      variant: {\n        default: \"bg-card active:bg-muted\",\n        destructive: \"bg-destructive active:opacity-90\",\n      },\n    },\n  }\n);\n\nconst fabMenuItemLabelVariants = cva(\"text-base font-medium\", {\n  defaultVariants: {\n    variant: \"default\",\n  },\n  variants: {\n    variant: {\n      default: \"text-card-foreground\",\n      destructive: \"text-white\",\n    },\n  },\n});\n\nconst fabMenuItemIconVariants = cva(\"size-5\", {\n  defaultVariants: {\n    variant: \"default\",\n  },\n  variants: {\n    variant: {\n      default: \"text-card-foreground\",\n      destructive: \"text-white\",\n    },\n  },\n});\n",
      "type": "registry:ui",
      "target": "@ui/floating-action-button.tsx"
    }
  ],
  "type": "registry:ui"
}
