{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"expandable-mobile-nav","title":"Expandable Mobile Nav","author":"CoDesign-Spa27","description":"A bottom-anchored navigation shell with expandable labels and composable per-item panels.","dependencies":["motion"],"files":[{"path":"components/ui-components/expandable-mobile-nav.tsx","content":"\"use client\";\n\nimport { AnimatePresence, motion, useReducedMotion } from \"motion/react\";\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\nexport interface ExpandableMobileNavItem {\n  id: string;\n  label: React.ReactNode;\n  ariaLabel?: string;\n  icon: React.ElementType;\n  panelContent?: React.ReactNode;\n  disabled?: boolean;\n  className?: string;\n  onSelect?: () => void;\n  type?: \"item\";\n}\n\nexport interface ExpandableMobileNavSeparator {\n  id: string;\n  type: \"separator\";\n}\n\nexport type ExpandableMobileNavEntry = ExpandableMobileNavItem | ExpandableMobileNavSeparator;\n\nexport interface ExpandableMobileNavPanel {\n  triggerId: string;\n  navItems?: readonly ExpandableMobileNavEntry[];\n  content?: React.ReactNode;\n  className?: string;\n  navClassName?: string;\n}\n\nexport interface ExpandableMobileNavClassNames {\n  shell?: string;\n  item?: string;\n  activeItem?: string;\n  label?: string;\n  panel?: string;\n  panelNav?: string;\n  panelItem?: string;\n  activePanelItem?: string;\n  separator?: string;\n}\n\nexport interface ExpandableMobileNavLayout {\n  iconSize?: number;\n  panelIconSize?: number;\n  gap?: number;\n  collapsedPadding?: number;\n  expandedPadding?: number;\n  labelGap?: number;\n}\n\nexport interface ExpandableMobileNavProps\n  extends Omit<React.ComponentPropsWithoutRef<\"nav\">, \"onChange\" | \"defaultValue\"> {\n  navItems: readonly ExpandableMobileNavEntry[];\n  expandedPanel?: ExpandableMobileNavPanel;\n  nestedExpandedPanel?: ExpandableMobileNavPanel;\n  hideExpandedPanel?: boolean;\n  hideNestedPanel?: boolean;\n  value?: string | null;\n  defaultValue?: string | null;\n  onValueChange?: (value: string | null) => void;\n  onItemSelect?: (item: ExpandableMobileNavItem) => void;\n  classNames?: ExpandableMobileNavClassNames;\n  layout?: ExpandableMobileNavLayout;\n  closeOnOutsideClick?: boolean;\n}\n\nconst SHELL_PADDING = 4;\nconst BUTTON_VERTICAL_PADDING = 8;\nconst SEPARATOR_WIDTH = 9;\n\nfunction isNavItem(entry: ExpandableMobileNavEntry): entry is ExpandableMobileNavItem {\n  return entry.type !== \"separator\";\n}\n\nfunction getItemAriaLabel(item: ExpandableMobileNavItem) {\n  return item.ariaLabel ?? (typeof item.label === \"string\" ? item.label : undefined);\n}\n\nfunction AnimatedPanel({\n  children,\n  className,\n  id,\n}: {\n  children: React.ReactNode;\n  className?: string;\n  id: string;\n}) {\n  const shouldReduceMotion = useReducedMotion();\n\n  return (\n    <motion.div\n      id={id}\n      initial={{\n        height: 0,\n        opacity: 0,\n        filter: shouldReduceMotion ? \"blur(0px)\" : \"blur(8px)\",\n      }}\n      animate={{ height: \"auto\", opacity: 1, filter: \"blur(0px)\" }}\n      exit={{\n        height: 0,\n        opacity: 0,\n        filter: shouldReduceMotion ? \"blur(0px)\" : \"blur(8px)\",\n      }}\n      transition={\n        shouldReduceMotion\n          ? { duration: 0.15 }\n          : {\n              height: { type: \"spring\", duration: 0.3, bounce: 0.2 },\n              opacity: { duration: 0.15 },\n              filter: {\n                duration: 0.15,\n                ease: [0.23, 1, 0.32, 1],\n              },\n            }\n      }\n      className={cn(\"overflow-hidden\", className)}\n    >\n      {children}\n    </motion.div>\n  );\n}\n\nfunction PanelNavItems({\n  navItems,\n  value,\n  onValueChange,\n  expandedTriggerId,\n  expandedPanelId,\n  iconSize,\n  classNames,\n  navClassName,\n}: {\n  navItems: readonly ExpandableMobileNavEntry[];\n  value: string | null;\n  onValueChange: (item: ExpandableMobileNavItem) => void;\n  expandedTriggerId?: string;\n  expandedPanelId?: string;\n  iconSize: number;\n  classNames?: ExpandableMobileNavClassNames;\n  navClassName?: string;\n}) {\n  if (!navItems.length) return null;\n\n  return (\n    <div className={cn(\"grid grid-cols-2 gap-1 p-2 text-sm\", classNames?.panelNav, navClassName)}>\n      {navItems.map((entry) => {\n        if (!isNavItem(entry)) {\n          return (\n            <hr\n              key={entry.id}\n              className={cn(\"col-span-full h-px border-0 bg-border\", classNames?.separator)}\n            />\n          );\n        }\n\n        const Icon = entry.icon;\n        const isActive = value === entry.id;\n        const controlsExpandedPanel = entry.id === expandedTriggerId;\n\n        return (\n          <button\n            key={entry.id}\n            type=\"button\"\n            disabled={entry.disabled}\n            onClick={() => onValueChange(entry)}\n            aria-label={getItemAriaLabel(entry)}\n            aria-expanded={controlsExpandedPanel ? isActive : undefined}\n            aria-controls={controlsExpandedPanel && isActive ? expandedPanelId : undefined}\n            data-state={isActive ? \"open\" : \"closed\"}\n            className={cn(\n              \"flex items-center gap-2 rounded-lg px-3 py-2 text-left text-muted-foreground transition-colors hover:bg-muted hover:text-foreground disabled:pointer-events-none disabled:opacity-50\",\n              isActive && \"bg-muted text-foreground\",\n              classNames?.panelItem,\n              isActive && classNames?.activePanelItem,\n              entry.className,\n            )}\n          >\n            <Icon aria-hidden=\"true\" size={iconSize} />\n            <span>{entry.label}</span>\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\nfunction StructuredExpandedPanel({\n  expandedPanel,\n  nestedExpandedPanel,\n  hideNestedPanel,\n  expandedPanelId,\n  nestedExpandedPanelId,\n  panelIconSize,\n  classNames,\n  onItemSelect,\n}: {\n  expandedPanel: ExpandableMobileNavPanel;\n  nestedExpandedPanel?: ExpandableMobileNavPanel;\n  hideNestedPanel: boolean;\n  expandedPanelId: string;\n  nestedExpandedPanelId: string;\n  panelIconSize: number;\n  classNames?: ExpandableMobileNavClassNames;\n  onItemSelect?: (item: ExpandableMobileNavItem) => void;\n}) {\n  const [expandedValue, setExpandedValue] = React.useState<string | null>(null);\n  const [nestedValue, setNestedValue] = React.useState<string | null>(null);\n  const nestedPanelOpen =\n    !hideNestedPanel &&\n    Boolean(nestedExpandedPanel) &&\n    expandedValue === nestedExpandedPanel?.triggerId;\n\n  const handleExpandedItemSelect = (item: ExpandableMobileNavItem) => {\n    const nextValue = expandedValue === item.id ? null : item.id;\n    setExpandedValue(nextValue);\n    if (nextValue !== nestedExpandedPanel?.triggerId) setNestedValue(null);\n    item.onSelect?.();\n    onItemSelect?.(item);\n  };\n\n  const handleNestedItemSelect = (item: ExpandableMobileNavItem) => {\n    setNestedValue((currentValue) => (currentValue === item.id ? null : item.id));\n    item.onSelect?.();\n    onItemSelect?.(item);\n  };\n\n  return (\n    <AnimatedPanel\n      id={expandedPanelId}\n      className={cn(\"w-0 min-w-full\", classNames?.panel, expandedPanel.className)}\n    >\n      {expandedPanel.content}\n\n      <AnimatePresence initial={false}>\n        {nestedPanelOpen && nestedExpandedPanel ? (\n          <AnimatedPanel\n            key={nestedExpandedPanel.triggerId}\n            id={nestedExpandedPanelId}\n            className={nestedExpandedPanel.className}\n          >\n            {nestedExpandedPanel.content}\n            <PanelNavItems\n              navItems={nestedExpandedPanel.navItems ?? []}\n              value={nestedValue}\n              onValueChange={handleNestedItemSelect}\n              iconSize={panelIconSize}\n              classNames={classNames}\n              navClassName={nestedExpandedPanel.navClassName}\n            />\n          </AnimatedPanel>\n        ) : null}\n      </AnimatePresence>\n\n      <PanelNavItems\n        navItems={expandedPanel.navItems ?? []}\n        value={expandedValue}\n        onValueChange={handleExpandedItemSelect}\n        expandedTriggerId={hideNestedPanel ? undefined : nestedExpandedPanel?.triggerId}\n        expandedPanelId={nestedExpandedPanelId}\n        iconSize={panelIconSize}\n        classNames={classNames}\n        navClassName={expandedPanel.navClassName}\n      />\n    </AnimatedPanel>\n  );\n}\n\nexport function ExpandableMobileNav({\n  navItems,\n  expandedPanel,\n  nestedExpandedPanel,\n  hideExpandedPanel = false,\n  hideNestedPanel = false,\n  value,\n  defaultValue = null,\n  onValueChange,\n  onItemSelect,\n  classNames,\n  layout,\n  closeOnOutsideClick = true,\n  className,\n  style,\n  \"aria-label\": ariaLabel = \"Mobile navigation\",\n  ...props\n}: ExpandableMobileNavProps) {\n  const [internalValue, setInternalValue] = React.useState<string | null>(defaultValue);\n  const containerRef = React.useRef<HTMLElement>(null);\n  const expandedPanelId = React.useId();\n  const nestedExpandedPanelId = React.useId();\n  const isControlled = value !== undefined;\n  const activeValue = isControlled ? value : internalValue;\n  const iconSize = layout?.iconSize ?? 20;\n  const panelIconSize = layout?.panelIconSize ?? 18;\n  const gap = layout?.gap ?? 8;\n  const collapsedPadding = layout?.collapsedPadding ?? 8;\n  const expandedPadding = layout?.expandedPadding ?? 16;\n  const labelGap = layout?.labelGap ?? 8;\n\n  const setActiveValue = React.useCallback(\n    (nextValue: string | null) => {\n      if (!isControlled) setInternalValue(nextValue);\n      onValueChange?.(nextValue);\n    },\n    [isControlled, onValueChange],\n  );\n\n  const activeItem = React.useMemo(\n    () =>\n      navItems.find(\n        (entry): entry is ExpandableMobileNavItem => isNavItem(entry) && entry.id === activeValue,\n      ) ?? null,\n    [activeValue, navItems],\n  );\n\n  const collapsedToolbarWidth = React.useMemo(() => {\n    const itemsWidth = navItems.reduce((width, entry) => {\n      if (!isNavItem(entry)) return width + SEPARATOR_WIDTH;\n      return width + iconSize + collapsedPadding * 2;\n    }, 0);\n    const gapsWidth = Math.max(0, navItems.length - 1) * gap;\n\n    return SHELL_PADDING * 2 + itemsWidth + gapsWidth;\n  }, [collapsedPadding, gap, iconSize, navItems]);\n\n  const toolbarHeight = SHELL_PADDING * 2 + iconSize + BUTTON_VERTICAL_PADDING * 2;\n  const structuredPanelOpen =\n    !hideExpandedPanel && Boolean(expandedPanel) && activeValue === expandedPanel?.triggerId;\n  const customPanelOpen =\n    !hideExpandedPanel && !structuredPanelOpen && Boolean(activeItem?.panelContent);\n\n  React.useEffect(() => {\n    if (!closeOnOutsideClick) return;\n\n    const handleMouseDown = (event: MouseEvent) => {\n      if (!containerRef.current?.contains(event.target as Node)) setActiveValue(null);\n    };\n\n    document.addEventListener(\"mousedown\", handleMouseDown);\n    return () => document.removeEventListener(\"mousedown\", handleMouseDown);\n  }, [closeOnOutsideClick, setActiveValue]);\n\n  const handleItemClick = (item: ExpandableMobileNavItem) => {\n    if (item.disabled) return;\n\n    setActiveValue(activeValue === item.id ? null : item.id);\n    item.onSelect?.();\n    onItemSelect?.(item);\n  };\n\n  const buttonVariants = {\n    initial: {\n      gap: 0,\n      paddingLeft: collapsedPadding,\n      paddingRight: collapsedPadding,\n    },\n    animate: (isActive: boolean) => ({\n      gap: isActive ? labelGap : 0,\n      paddingLeft: isActive ? expandedPadding : collapsedPadding,\n      paddingRight: isActive ? expandedPadding : collapsedPadding,\n    }),\n  };\n\n  const labelVariants = {\n    initial: { width: 0, opacity: 0, transform: \"translateY(-10px)\" },\n    animate: { width: \"auto\", opacity: 1, transform: \"translateY(0px)\" },\n    exit: { width: 0, opacity: 0, transform: \"translateY(-10px)\" },\n  };\n\n  return (\n    <nav\n      ref={containerRef}\n      aria-label={ariaLabel}\n      className={cn(\"relative\", className)}\n      style={{ width: collapsedToolbarWidth, height: toolbarHeight, ...style }}\n      {...props}\n    >\n      <motion.div\n        className={cn(\n          \"absolute bottom-0 left-1/2 flex w-max -translate-x-1/2 flex-col overflow-hidden rounded-xl bg-background p-1 shadow-[0px_2px_3px_-1px_rgba(0,0,0,0.1),0px_1px_0px_0px_rgba(25,28,33,0.02),0px_0px_0px_1px_rgba(25,28,33,0.08)] dark:shadow-[0px_2px_3px_-1px_rgba(255,255,255,0.02),0px_1px_0px_0px_rgba(255,255,255,0.02),0px_0px_0px_1px_rgba(255,255,255,0.08)]\",\n          classNames?.shell,\n        )}\n        onKeyDown={(event) => {\n          if (event.key === \"Escape\") setActiveValue(null);\n        }}\n      >\n        <AnimatePresence initial={false} mode=\"wait\">\n          {structuredPanelOpen && expandedPanel ? (\n            <StructuredExpandedPanel\n              key={expandedPanel.triggerId}\n              expandedPanel={expandedPanel}\n              nestedExpandedPanel={nestedExpandedPanel}\n              hideNestedPanel={hideNestedPanel}\n              expandedPanelId={expandedPanelId}\n              nestedExpandedPanelId={nestedExpandedPanelId}\n              panelIconSize={panelIconSize}\n              classNames={classNames}\n              onItemSelect={onItemSelect}\n            />\n          ) : customPanelOpen && activeItem?.panelContent ? (\n            <AnimatedPanel\n              key={activeItem.id}\n              id={expandedPanelId}\n              className={cn(\"w-0 min-w-full\", classNames?.panel)}\n            >\n              {activeItem.panelContent}\n            </AnimatedPanel>\n          ) : null}\n        </AnimatePresence>\n\n        <div className=\"flex\" style={{ gap }}>\n          {navItems.map((entry) => {\n            if (!isNavItem(entry)) {\n              return (\n                <hr\n                  key={entry.id}\n                  className={cn(\"mx-1 w-px self-stretch border-0 bg-border\", classNames?.separator)}\n                />\n              );\n            }\n\n            const Icon = entry.icon;\n            const isActive = activeValue === entry.id;\n            const controlsPanel =\n              !hideExpandedPanel &&\n              (entry.id === expandedPanel?.triggerId || Boolean(entry.panelContent));\n\n            return (\n              <motion.button\n                key={entry.id}\n                type=\"button\"\n                variants={buttonVariants}\n                initial={false}\n                animate=\"animate\"\n                custom={isActive}\n                disabled={entry.disabled}\n                onClick={() => handleItemClick(entry)}\n                aria-label={getItemAriaLabel(entry)}\n                aria-expanded={controlsPanel ? isActive : undefined}\n                aria-controls={controlsPanel && isActive ? expandedPanelId : undefined}\n                data-state={isActive ? \"open\" : \"closed\"}\n                transition={{\n                  delay: 0.1,\n                  duration: 0.3,\n                  ease: [0.08, 0.82, 0.17, 1],\n                }}\n                className={cn(\n                  \"relative flex items-center whitespace-nowrap rounded-xl py-2 text-sm font-medium transition-colors duration-300 disabled:pointer-events-none disabled:opacity-50\",\n                  isActive\n                    ? cn(\"bg-muted text-primary\", classNames?.activeItem)\n                    : \"text-muted-foreground hover:bg-muted hover:text-foreground\",\n                  classNames?.item,\n                  entry.className,\n                )}\n              >\n                <Icon aria-hidden=\"true\" size={iconSize} />\n                <AnimatePresence initial={false}>\n                  {isActive ? (\n                    <motion.span\n                      key=\"label\"\n                      variants={labelVariants}\n                      initial={{ ...labelVariants.initial, filter: \"blur(8px)\" }}\n                      animate={{ ...labelVariants.animate, filter: \"blur(0px)\" }}\n                      exit={{ ...labelVariants.exit, filter: \"blur(8px)\" }}\n                      transition={{\n                        delay: 0.1,\n                        duration: 0.3,\n                        ease: [0.08, 0.82, 0.17, 1],\n                      }}\n                      className={cn(\"overflow-hidden\", classNames?.label)}\n                    >\n                      <span className=\"block pl-2\">{entry.label}</span>\n                    </motion.span>\n                  ) : null}\n                </AnimatePresence>\n              </motion.button>\n            );\n          })}\n        </div>\n      </motion.div>\n    </nav>\n  );\n}\n","type":"registry:ui"}],"categories":["navigation","mobile"],"type":"registry:ui"}