@fragments-sdk/ui 0.9.0 → 0.9.2

package/dist/components/Sidebar/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/components/Sidebar/index.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport styles from './Sidebar.module.scss';\nimport { Tooltip } from '../Tooltip';\nimport { Skeleton } from '../Skeleton';\nimport { Collapsible } from '../Collapsible';\nimport { ScrollArea } from '../ScrollArea';\nimport { useFocusTrap } from '../../utils/a11y';\n\n// ============================================\n// Types\n// ============================================\n\n/** Collapse behavior mode */\nexport type SidebarCollapsible = 'icon' | 'offcanvas' | 'none';\n\nexport interface SidebarProviderProps {\n  children: React.ReactNode;\n  /** Icon-only mode (desktop) - controlled */\n  collapsed?: boolean;\n  /** Initial collapsed state (uncontrolled) */\n  defaultCollapsed?: boolean;\n  /** Callback when collapsed state changes */\n  onCollapsedChange?: (collapsed: boolean) => void;\n  /** Mobile drawer state - controlled */\n  open?: boolean;\n  /** Initial open state (uncontrolled) */\n  defaultOpen?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n  /** Width of expanded sidebar */\n  width?: string;\n  /** Width when collapsed */\n  collapsedWidth?: string;\n  /** Sidebar position */\n  position?: 'left' | 'right';\n  /** Collapse behavior: 'icon' (default), 'offcanvas', or 'none' */\n  collapsible?: SidebarCollapsible;\n  /** Enable Cmd/Ctrl+B keyboard shortcut to toggle sidebar */\n  enableKeyboardShortcut?: boolean;\n}\n\nexport interface SidebarProps extends React.HTMLAttributes<HTMLElement> {\n  children: React.ReactNode;\n  /** Icon-only mode (desktop) - controlled */\n  collapsed?: boolean;\n  /** Initial collapsed state (uncontrolled) */\n  defaultCollapsed?: boolean;\n  /** Callback when collapsed state changes */\n  onCollapsedChange?: (collapsed: boolean) => void;\n  /** Mobile drawer state - controlled */\n  open?: boolean;\n  /** Initial open state (uncontrolled) */\n  defaultOpen?: boolean;\n  /** Callback when open state changes */\n  onOpenChange?: (open: boolean) => void;\n  /** Width of expanded sidebar */\n  width?: string;\n  /** Width when collapsed */\n  collapsedWidth?: string;\n  /** Sidebar position */\n  position?: 'left' | 'right';\n  /** Collapse behavior: 'icon' (default), 'offcanvas', or 'none' */\n  collapsible?: SidebarCollapsible;\n}\n\nexport interface SidebarHeaderProps {\n  children: React.ReactNode;\n  /** Content to show when sidebar is collapsed (e.g., just logo icon) */\n  collapsedContent?: React.ReactNode;\n  className?: string;\n}\n\nexport interface SidebarNavProps {\n  children: React.ReactNode;\n  /** Accessible label for navigation */\n  'aria-label'?: string;\n  className?: string;\n}\n\nexport interface SidebarSectionProps {\n  children: React.ReactNode;\n  /** Optional section label */\n  label?: string;\n  /** Action element to display in the section header (e.g., \"Add\" button) */\n  action?: React.ReactNode;\n  /** Enable collapsible behavior */\n  collapsible?: boolean;\n  /** Default expanded state (only applies when collapsible is true) */\n  defaultOpen?: boolean;\n  className?: string;\n}\n\nexport interface SidebarSectionActionProps {\n  children: React.ReactNode;\n  /** Click handler */\n  onClick?: () => void;\n  /** Accessible label */\n  'aria-label'?: string;\n  className?: string;\n}\n\nexport interface SidebarItemProps {\n  children: React.ReactNode;\n  /** Icon element (required for collapsed mode visibility) */\n  icon?: React.ReactNode;\n  /** Whether item is currently active/selected */\n  active?: boolean;\n  /** Disabled state */\n  disabled?: boolean;\n  /** Badge content (e.g., notification count) */\n  badge?: React.ReactNode;\n  /** Renders as anchor if provided */\n  href?: string;\n  /** Click handler (renders as button) */\n  onClick?: () => void;\n  /** Whether this item has a submenu */\n  hasSubmenu?: boolean;\n  /** Whether submenu is expanded (controlled) */\n  expanded?: boolean;\n  /** Initial expanded state (uncontrolled) */\n  defaultExpanded?: boolean;\n  /** Callback when expanded state changes */\n  onExpandedChange?: (expanded: boolean) => void;\n  /**\n   * Render as child element (polymorphic). When true, clones the single child\n   * and merges sidebar item props. Useful for rendering as Next.js Link, etc.\n   */\n  asChild?: boolean;\n  className?: string;\n}\n\nexport interface SidebarSubItemProps {\n  children: React.ReactNode;\n  /** Whether item is currently active/selected */\n  active?: boolean;\n  /** Disabled state */\n  disabled?: boolean;\n  /** Renders as anchor if provided */\n  href?: string;\n  /** Click handler (renders as button) */\n  onClick?: () => void;\n  className?: string;\n}\n\nexport interface SidebarFooterProps {\n  children: React.ReactNode;\n  className?: string;\n}\n\nexport interface SidebarTriggerProps {\n  /** Custom trigger element (uses render prop pattern) */\n  children?: React.ReactNode;\n  /** Accessible label */\n  'aria-label'?: string;\n  className?: string;\n}\n\nexport interface SidebarOverlayProps {\n  className?: string;\n}\n\nexport interface SidebarCollapseToggleProps {\n  /** Accessible label */\n  'aria-label'?: string;\n  className?: string;\n}\n\nexport interface SidebarRailProps {\n  className?: string;\n}\n\nexport interface SidebarMenuSkeletonProps {\n  /** Number of skeleton items to render */\n  count?: number;\n  /** Show icons in skeleton items */\n  showIcon?: boolean;\n  className?: string;\n}\n\n// ============================================\n// Icons\n// ============================================\n\nfunction MenuIcon() {\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width=\"24\"\n      height=\"24\"\n      viewBox=\"0 0 256 256\"\n      fill=\"currentColor\"\n      aria-hidden=\"true\"\n    >\n      <path d=\"M224,128a8,8,0,0,1-8,8H40a8,8,0,0,1,0-16H216A8,8,0,0,1,224,128ZM40,72H216a8,8,0,0,0,0-16H40a8,8,0,0,0,0,16ZM216,184H40a8,8,0,0,0,0,16H216a8,8,0,0,0,0-16Z\" />\n    </svg>\n  );\n}\n\nfunction CloseIcon() {\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width=\"24\"\n      height=\"24\"\n      viewBox=\"0 0 256 256\"\n      fill=\"currentColor\"\n      aria-hidden=\"true\"\n    >\n      <path d=\"M205.66,194.34a8,8,0,0,1-11.32,11.32L128,139.31,61.66,205.66a8,8,0,0,1-11.32-11.32L116.69,128,50.34,61.66A8,8,0,0,1,61.66,50.34L128,116.69l66.34-66.35a8,8,0,0,1,11.32,11.32L139.31,128Z\" />\n    </svg>\n  );\n}\n\nfunction CollapsePanelIcon() {\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width=\"20\"\n      height=\"20\"\n      viewBox=\"0 0 256 256\"\n      fill=\"currentColor\"\n      aria-hidden=\"true\"\n    >\n      <path d=\"M216,40H40A16,16,0,0,0,24,56V200a16,16,0,0,0,16,16H216a16,16,0,0,0,16-16V56A16,16,0,0,0,216,40ZM40,56H80V200H40ZM216,200H96V56H216V200Z\" />\n    </svg>\n  );\n}\n\nfunction ChevronRightIcon() {\n  return (\n    <svg\n      xmlns=\"http://www.w3.org/2000/svg\"\n      width=\"16\"\n      height=\"16\"\n      viewBox=\"0 0 256 256\"\n      fill=\"currentColor\"\n      aria-hidden=\"true\"\n    >\n      <path d=\"M181.66,133.66l-80,80a8,8,0,0,1-11.32-11.32L164.69,128,90.34,53.66a8,8,0,0,1,11.32-11.32l80,80A8,8,0,0,1,181.66,133.66Z\" />\n    </svg>\n  );\n}\n\n// ============================================\n// Context\n// ============================================\n\ninterface SidebarContextValue {\n  collapsed: boolean;\n  setCollapsed: (collapsed: boolean) => void;\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  isMobile: boolean;\n  position: 'left' | 'right';\n  width: string;\n  collapsedWidth: string;\n  collapsible: SidebarCollapsible;\n  hasIcons: boolean;\n  toggleSidebar: () => void;\n  sidebarId: string;\n}\n\nconst SidebarContext = React.createContext<SidebarContextValue | null>(null);\n\n/**\n * Hook to access sidebar state and controls.\n * Returns safe defaults if used outside a SidebarProvider/Sidebar.\n */\nfunction useSidebar() {\n  const context = React.useContext(SidebarContext);\n  if (!context) {\n    // Return safe defaults when used outside provider\n    return {\n      collapsed: false,\n      setCollapsed: () => {},\n      open: false,\n      setOpen: () => {},\n      isMobile: false,\n      position: 'left' as const,\n      width: '240px',\n      collapsedWidth: '56px',\n      collapsible: 'icon' as SidebarCollapsible,\n      hasIcons: true,\n      toggleSidebar: () => {},\n      sidebarId: 'sidebar',\n      state: 'expanded' as 'expanded' | 'collapsed' | 'open' | 'closed',\n    };\n  }\n  return {\n    ...context,\n    state: context.isMobile\n      ? (context.open ? 'open' : 'closed')\n      : (context.collapsed ? 'collapsed' : 'expanded'),\n  };\n}\n\n/**\n * @deprecated Use `useSidebar` instead. This will be removed in a future version.\n */\nfunction useSidebarContext() {\n  const context = React.useContext(SidebarContext);\n  if (!context) {\n    throw new Error('Sidebar compound components must be used within a Sidebar');\n  }\n  return context;\n}\n\n// ============================================\n// Hooks\n// ============================================\n\nfunction useIsMobile() {\n  const [isMobile, setIsMobile] = React.useState(false);\n\n  React.useEffect(() => {\n    const mq = window.matchMedia('(max-width: 767px)');\n    setIsMobile(mq.matches);\n    const handler = (e: MediaQueryListEvent) => setIsMobile(e.matches);\n    mq.addEventListener('change', handler);\n    return () => mq.removeEventListener('change', handler);\n  }, []);\n\n  return isMobile;\n}\n\nfunction useControllableState<T>(\n  controlledValue: T | undefined,\n  defaultValue: T,\n  onChange?: (value: T) => void\n): [T, (value: T) => void] {\n  const [uncontrolledValue, setUncontrolledValue] = React.useState(defaultValue);\n  const isControlled = controlledValue !== undefined;\n  const value = isControlled ? controlledValue : uncontrolledValue;\n\n  const setValue = React.useCallback(\n    (newValue: T) => {\n      if (!isControlled) {\n        setUncontrolledValue(newValue);\n      }\n      onChange?.(newValue);\n    },\n    [isControlled, onChange]\n  );\n\n  return [value, setValue];\n}\n\nfunction hasSidebarItemIcons(children: React.ReactNode): boolean {\n  let found = false;\n\n  const visit = (nodes: React.ReactNode) => {\n    React.Children.forEach(nodes, child => {\n      if (found || !React.isValidElement(child)) return;\n\n      if (child.type === SidebarItem) {\n        const props = child.props as SidebarItemProps;\n        if (props.icon) {\n          found = true;\n          return;\n        }\n      }\n\n      const childProps = child.props as { children?: React.ReactNode };\n      if (childProps?.children) {\n        visit(childProps.children);\n      }\n    });\n  };\n\n  visit(children);\n  return found;\n}\n\n// ============================================\n// Components\n// ============================================\n\n/**\n * SidebarProvider - Wrap your app layout to provide sidebar state to children.\n * This enables external triggers and keyboard shortcuts.\n */\nfunction SidebarProvider({\n  children,\n  collapsed: controlledCollapsed,\n  defaultCollapsed = false,\n  onCollapsedChange,\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  width = '240px',\n  collapsedWidth = '56px',\n  position = 'left',\n  collapsible = 'icon',\n  enableKeyboardShortcut = true,\n}: SidebarProviderProps) {\n  const isMobile = useIsMobile();\n  const sidebarId = React.useId();\n\n  const [collapsed, setCollapsed] = useControllableState(\n    controlledCollapsed,\n    defaultCollapsed,\n    onCollapsedChange\n  );\n\n  const [open, setOpen] = useControllableState(\n    controlledOpen,\n    defaultOpen,\n    onOpenChange\n  );\n\n  const toggleSidebar = React.useCallback(() => {\n    if (collapsible === 'none') return;\n    if (isMobile) {\n      setOpen(!open);\n    } else {\n      setCollapsed(!collapsed);\n    }\n  }, [isMobile, open, collapsed, setOpen, setCollapsed, collapsible]);\n\n  // Handle Cmd/Ctrl+B keyboard shortcut\n  React.useEffect(() => {\n    if (!enableKeyboardShortcut || collapsible === 'none') return;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key === 'b') {\n        e.preventDefault();\n        toggleSidebar();\n      }\n    };\n\n    document.addEventListener('keydown', handleKeyDown);\n    return () => document.removeEventListener('keydown', handleKeyDown);\n  }, [enableKeyboardShortcut, toggleSidebar, collapsible]);\n\n  // Handle escape key for mobile drawer\n  React.useEffect(() => {\n    if (!isMobile || !open) return;\n\n    const handleEscape = (e: KeyboardEvent) => {\n      if (e.key === 'Escape') {\n        setOpen(false);\n      }\n    };\n\n    document.addEventListener('keydown', handleEscape);\n    return () => document.removeEventListener('keydown', handleEscape);\n  }, [isMobile, open, setOpen]);\n\n  // Lock body scroll when mobile drawer is open\n  React.useEffect(() => {\n    if (!isMobile) return;\n\n    if (open) {\n      document.body.style.overflow = 'hidden';\n    } else {\n      document.body.style.overflow = '';\n    }\n\n    return () => {\n      document.body.style.overflow = '';\n    };\n  }, [isMobile, open]);\n\n  const contextValue: SidebarContextValue = {\n    collapsed,\n    setCollapsed,\n    open,\n    setOpen,\n    isMobile,\n    position,\n    width,\n    collapsedWidth,\n    collapsible,\n    hasIcons: true,\n    toggleSidebar,\n    sidebarId,\n  };\n\n  return (\n    <SidebarContext.Provider value={contextValue}>\n      {children}\n    </SidebarContext.Provider>\n  );\n}\n\nfunction SidebarRoot({\n  children,\n  collapsed: controlledCollapsed,\n  defaultCollapsed = false,\n  onCollapsedChange,\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  width = '240px',\n  collapsedWidth = '56px',\n  position = 'left',\n  collapsible = 'icon',\n  className,\n  style: styleProp,\n  'aria-label': ariaLabel,\n  ...htmlProps\n}: SidebarProps) {\n  // Check if we're inside a SidebarProvider\n  const existingContext = React.useContext(SidebarContext);\n  const isMobile = useIsMobile();\n\n  const [internalCollapsed, setInternalCollapsed] = useControllableState(\n    controlledCollapsed,\n    defaultCollapsed,\n    onCollapsedChange\n  );\n\n  const [internalOpen, setInternalOpen] = useControllableState(\n    controlledOpen,\n    defaultOpen,\n    onOpenChange\n  );\n\n  // Use existing context values if inside a provider, otherwise use internal state\n  const collapsed = existingContext ? existingContext.collapsed : internalCollapsed;\n  const setCollapsed = existingContext ? existingContext.setCollapsed : setInternalCollapsed;\n  const open = existingContext ? existingContext.open : internalOpen;\n  const setOpen = existingContext ? existingContext.setOpen : setInternalOpen;\n  const resolvedPosition = existingContext ? existingContext.position : position;\n  const resolvedWidth = existingContext ? existingContext.width : width;\n  const resolvedCollapsedWidth = existingContext ? existingContext.collapsedWidth : collapsedWidth;\n  const resolvedCollapsible = existingContext ? existingContext.collapsible : collapsible;\n  const hasIcons = React.useMemo(() => hasSidebarItemIcons(children), [children]);\n  const shouldCollapseToZero = !isMobile && resolvedCollapsible === 'icon' && collapsed && !hasIcons;\n  const isOffcanvasCollapsed = !isMobile && resolvedCollapsible === 'offcanvas' && collapsed;\n  const effectiveCollapsedWidth = (shouldCollapseToZero || isOffcanvasCollapsed) ? '0px' : resolvedCollapsedWidth;\n  const sidebarId = React.useId();\n  const resolvedSidebarId = existingContext ? existingContext.sidebarId : sidebarId;\n  const sidebarRef = React.useRef<HTMLElement>(null);\n\n  useFocusTrap(sidebarRef, isMobile && open);\n\n  const toggleSidebar = React.useCallback(() => {\n    if (resolvedCollapsible === 'none') return;\n    if (isMobile) {\n      setOpen(!open);\n    } else {\n      setCollapsed(!collapsed);\n    }\n  }, [isMobile, open, collapsed, setOpen, setCollapsed, resolvedCollapsible]);\n\n  // Handle escape key for mobile drawer (only if no provider)\n  React.useEffect(() => {\n    if (existingContext) return; // Provider handles this\n    if (!isMobile || !open) return;\n\n    const handleEscape = (e: KeyboardEvent) => {\n      if (e.key === 'Escape') {\n        setOpen(false);\n      }\n    };\n\n    document.addEventListener('keydown', handleEscape);\n    return () => document.removeEventListener('keydown', handleEscape);\n  }, [existingContext, isMobile, open, setOpen]);\n\n  // Lock body scroll when mobile drawer is open (only if no provider)\n  React.useEffect(() => {\n    if (existingContext) return; // Provider handles this\n    if (!isMobile) return;\n\n    if (open) {\n      document.body.style.overflow = 'hidden';\n    } else {\n      document.body.style.overflow = '';\n    }\n\n    return () => {\n      document.body.style.overflow = '';\n    };\n  }, [existingContext, isMobile, open]);\n\n  const contextValue: SidebarContextValue = {\n    ...(existingContext || {\n      collapsed,\n      setCollapsed,\n      open,\n      setOpen,\n      isMobile,\n      position: resolvedPosition,\n      width: resolvedWidth,\n      collapsedWidth: resolvedCollapsedWidth,\n      collapsible: resolvedCollapsible,\n      hasIcons,\n      toggleSidebar,\n      sidebarId: resolvedSidebarId,\n    }),\n    hasIcons,\n  };\n\n  const isCollapsedForStyle = resolvedCollapsible === 'icon' && collapsed;\n\n  const classes = [\n    styles.root,\n    isMobile && styles.mobile,\n    !isMobile && isCollapsedForStyle && styles.collapsed,\n    !isMobile && isCollapsedForStyle && shouldCollapseToZero && styles.collapsedNoIcons,\n    isOffcanvasCollapsed && styles.offcanvasCollapsed,\n    resolvedPosition === 'right' && styles.positionRight,\n    className,\n  ].filter(Boolean).join(' ');\n\n  const style: React.CSSProperties = {\n    '--sidebar-width': resolvedWidth,\n    '--sidebar-collapsed-width': resolvedCollapsedWidth,\n    '--sidebar-effective-collapsed-width': effectiveCollapsedWidth,\n    ...styleProp,\n  } as React.CSSProperties;\n\n  const content = (\n    <aside\n      ref={sidebarRef}\n      id={resolvedSidebarId}\n      {...htmlProps}\n      className={classes}\n      style={style}\n      role={isMobile ? 'dialog' : undefined}\n      aria-modal={isMobile && open ? true : undefined}\n      aria-hidden={isMobile && !open ? true : undefined}\n      aria-label={isMobile ? (ariaLabel || 'Sidebar navigation') : ariaLabel}\n      data-state={isMobile ? (open ? 'open' : 'closed') : (collapsed ? 'collapsed' : 'expanded')}\n      data-position={resolvedPosition}\n      data-collapsible={resolvedCollapsible}\n      data-icon-collapse={resolvedCollapsible === 'icon' ? (hasIcons ? 'icons' : 'none') : undefined}\n    >\n      {children}\n    </aside>\n  );\n\n  return (\n    <SidebarContext.Provider value={contextValue}>\n      {content}\n    </SidebarContext.Provider>\n  );\n}\n\nfunction SidebarHeader({ children, collapsedContent, className }: SidebarHeaderProps) {\n  const { collapsed, isMobile } = useSidebarContext();\n  const isCollapsed = collapsed && !isMobile;\n  const classes = [styles.header, className].filter(Boolean).join(' ');\n\n  // Show collapsed content when sidebar is collapsed (and we have it), otherwise show children\n  const content = isCollapsed && collapsedContent ? collapsedContent : children;\n\n  return <div className={classes}>{content}</div>;\n}\n\nfunction SidebarNav({ children, 'aria-label': ariaLabel = 'Main navigation', className }: SidebarNavProps) {\n  const classes = [styles.nav, className].filter(Boolean).join(' ');\n  return (\n    <nav className={classes} aria-label={ariaLabel}>\n      <ScrollArea orientation=\"vertical\" showFades className={styles.navScrollArea}>\n        {children}\n      </ScrollArea>\n    </nav>\n  );\n}\n\nfunction SidebarSection({\n  children,\n  label,\n  action,\n  collapsible: isCollapsibleProp = false,\n  defaultOpen = true,\n  className\n}: SidebarSectionProps) {\n  const { collapsed, isMobile } = useSidebarContext();\n\n  const classes = [\n    styles.section,\n    className\n  ].filter(Boolean).join(' ');\n\n  const showLabel = label && (!collapsed || isMobile);\n  const showAction = action && (!collapsed || isMobile);\n  const isCollapsible = isCollapsibleProp && showLabel;\n\n  // Non-collapsible section\n  if (!isCollapsible) {\n    return (\n      <div className={classes} role=\"group\" aria-label={label}>\n        {(showLabel || showAction) && (\n          <div className={styles.sectionHeader}>\n            {showLabel && <div className={styles.sectionLabel}>{label}</div>}\n            {showAction && <div className={styles.sectionActionWrapper}>{action}</div>}\n          </div>\n        )}\n        <ul className={styles.sectionList}>\n          {children}\n        </ul>\n      </div>\n    );\n  }\n\n  // Collapsible section using Collapsible component\n  return (\n    <div className={classes} role=\"group\" aria-label={label}>\n      <Collapsible defaultOpen={defaultOpen} className={styles.sectionCollapsible}>\n        <div className={styles.sectionHeader}>\n          <Collapsible.Trigger\n            className={styles.sectionTrigger}\n            chevronPosition=\"end\"\n          >\n            <span className={styles.sectionLabel}>{label}</span>\n          </Collapsible.Trigger>\n          {showAction && <div className={styles.sectionActionWrapper}>{action}</div>}\n        </div>\n        <Collapsible.Content className={styles.sectionContent}>\n          <ul className={styles.sectionList}>\n            {children}\n          </ul>\n        </Collapsible.Content>\n      </Collapsible>\n    </div>\n  );\n}\n\nfunction SidebarSectionAction({\n  children,\n  onClick,\n  'aria-label': ariaLabel,\n  className,\n}: SidebarSectionActionProps) {\n  const classes = [styles.sectionAction, className].filter(Boolean).join(' ');\n\n  return (\n    <button\n      type=\"button\"\n      className={classes}\n      onClick={onClick}\n      aria-label={ariaLabel}\n    >\n      {children}\n    </button>\n  );\n}\n\nfunction SidebarItem({\n  children,\n  icon,\n  active = false,\n  disabled = false,\n  badge,\n  href,\n  onClick,\n  hasSubmenu = false,\n  expanded: controlledExpanded,\n  defaultExpanded = false,\n  onExpandedChange,\n  asChild = false,\n  className,\n}: SidebarItemProps) {\n  const { collapsed, isMobile } = useSidebarContext();\n  const [expanded, setExpanded] = useControllableState(\n    controlledExpanded,\n    defaultExpanded,\n    onExpandedChange\n  );\n\n  const isCollapsed = collapsed && !isMobile;\n  const showLabel = !isCollapsed;\n\n  const classes = [\n    styles.item,\n    active && styles.itemActive,\n    disabled && styles.itemDisabled,\n    hasSubmenu && styles.itemHasSubmenu,\n    expanded && styles.itemExpanded,\n    className,\n  ].filter(Boolean).join(' ');\n\n  const handleClick = (e: React.MouseEvent) => {\n    if (disabled) {\n      e.preventDefault();\n      return;\n    }\n    if (hasSubmenu) {\n      e.preventDefault();\n      setExpanded(!expanded);\n    }\n    onClick?.();\n  };\n\n  // Extract text content from children for aria-label when collapsed\n  // For asChild, try to extract from the child's children prop\n  let labelText: string | undefined;\n  if (asChild && React.isValidElement(children)) {\n    const childProps = children.props as { children?: React.ReactNode };\n    labelText = typeof childProps.children === 'string' ? childProps.children : undefined;\n  } else {\n    labelText = typeof children === 'string' ? children : undefined;\n  }\n\n  const itemContent = (\n    <>\n      {icon && <span className={styles.itemIcon}>{icon}</span>}\n      {showLabel && <span className={styles.itemLabel}>{asChild && React.isValidElement(children) ? (children.props as { children?: React.ReactNode }).children : children}</span>}\n      {showLabel && badge && <span className={styles.itemBadge}>{badge}</span>}\n      {showLabel && hasSubmenu && (\n        <span className={styles.itemChevron}>\n          <ChevronRightIcon />\n        </span>\n      )}\n    </>\n  );\n\n  const itemProps = {\n    className: classes,\n    onClick: handleClick,\n    'aria-current': active ? 'page' as const : undefined,\n    'aria-disabled': disabled || undefined,\n    'aria-expanded': hasSubmenu ? expanded : undefined,\n    'aria-label': isCollapsed ? labelText : undefined,\n    tabIndex: disabled ? -1 : 0,\n  };\n\n  let itemElement: React.ReactElement;\n\n  if (asChild && React.isValidElement(children)) {\n    // Clone the child element and merge props\n    itemElement = React.cloneElement(children, {\n      ...itemProps,\n      // Merge classNames\n      className: [classes, (children.props as { className?: string }).className].filter(Boolean).join(' '),\n      children: itemContent,\n    } as React.HTMLAttributes<HTMLElement>);\n  } else if (href) {\n    itemElement = (\n      <a {...itemProps} href={href}>\n        {itemContent}\n      </a>\n    );\n  } else {\n    itemElement = (\n      <button {...itemProps} type=\"button\">\n        {itemContent}\n      </button>\n    );\n  }\n\n  // Wrap in tooltip when collapsed\n  const wrappedItem = isCollapsed ? (\n    <Tooltip content={labelText || children} side=\"right\" delay={100}>\n      {itemElement}\n    </Tooltip>\n  ) : (\n    itemElement\n  );\n\n  const wrapperClasses = [\n    styles.itemWrapper,\n    expanded && styles.itemExpanded,\n  ].filter(Boolean).join(' ');\n\n  return <li className={wrapperClasses}>{wrappedItem}</li>;\n}\n\nfunction SidebarSubItem({\n  children,\n  active = false,\n  disabled = false,\n  href,\n  onClick,\n  className,\n}: SidebarSubItemProps) {\n  const { collapsed, isMobile } = useSidebarContext();\n\n  // Don't render sub-items when collapsed (unless mobile)\n  if (collapsed && !isMobile) {\n    return null;\n  }\n\n  const classes = [\n    styles.subItem,\n    active && styles.subItemActive,\n    disabled && styles.subItemDisabled,\n    className,\n  ].filter(Boolean).join(' ');\n\n  const handleClick = (e: React.MouseEvent) => {\n    if (disabled) {\n      e.preventDefault();\n      return;\n    }\n    onClick?.();\n  };\n\n  const itemProps = {\n    className: classes,\n    onClick: handleClick,\n    'aria-current': active ? 'page' as const : undefined,\n    'aria-disabled': disabled,\n    tabIndex: disabled ? -1 : 0,\n  };\n\n  const itemElement = href ? (\n    <a {...itemProps} href={href}>\n      {children}\n    </a>\n  ) : (\n    <button {...itemProps} type=\"button\">\n      {children}\n    </button>\n  );\n\n  return <li className={styles.subItemWrapper}>{itemElement}</li>;\n}\n\nfunction SidebarSubmenu({ children }: { children: React.ReactNode }) {\n  return (\n    <li className={styles.submenuWrapper}>\n      <ul className={styles.submenu}>\n        {children}\n      </ul>\n    </li>\n  );\n}\n\nfunction SidebarFooter({ children, className }: SidebarFooterProps) {\n  const classes = [styles.footer, className].filter(Boolean).join(' ');\n  return <div className={classes}>{children}</div>;\n}\n\nfunction SidebarTrigger({ children, 'aria-label': ariaLabel = 'Toggle navigation', className }: SidebarTriggerProps) {\n  const { open, setOpen, isMobile, sidebarId } = useSidebarContext();\n\n  // Only render trigger on mobile\n  if (!isMobile) {\n    return null;\n  }\n\n  const classes = [styles.trigger, className].filter(Boolean).join(' ');\n\n  return (\n    <button\n      type=\"button\"\n      className={classes}\n      onClick={() => setOpen(!open)}\n      aria-label={ariaLabel}\n      aria-expanded={open}\n      aria-controls={sidebarId}\n    >\n      {children || (open ? <CloseIcon /> : <MenuIcon />)}\n    </button>\n  );\n}\n\nfunction SidebarOverlay({ className }: SidebarOverlayProps) {\n  const { open, setOpen, isMobile } = useSidebarContext();\n\n  // Only render overlay on mobile when open\n  if (!isMobile || !open) {\n    return null;\n  }\n\n  const classes = [styles.overlay, className].filter(Boolean).join(' ');\n\n  return (\n    <div\n      className={classes}\n      onClick={() => setOpen(false)}\n      aria-hidden=\"true\"\n      data-state={open ? 'open' : 'closed'}\n    />\n  );\n}\n\nfunction SidebarCollapseToggle({ 'aria-label': ariaLabel, className }: SidebarCollapseToggleProps) {\n  const { collapsed, setCollapsed, isMobile, collapsible, hasIcons } = useSidebarContext();\n\n  // Don't show on mobile or when collapsing is disabled\n  if (isMobile || collapsible === 'none') {\n    return null;\n  }\n\n  const shouldFloat = collapsed && (\n    (collapsible === 'icon' && !hasIcons) ||\n    collapsible === 'offcanvas'\n  );\n  const classes = [\n    styles.collapseToggle,\n    shouldFloat && styles.collapseToggleFloating,\n    className,\n  ].filter(Boolean).join(' ');\n  const label = ariaLabel || (collapsed ? 'Expand sidebar' : 'Collapse sidebar');\n\n  return (\n    <button\n      type=\"button\"\n      className={classes}\n      onClick={() => setCollapsed(!collapsed)}\n      aria-label={label}\n    >\n      <CollapsePanelIcon />\n    </button>\n  );\n}\n\nfunction SidebarRail({ className }: SidebarRailProps) {\n  const { collapsed, setCollapsed, isMobile, collapsible } = useSidebarContext();\n\n  // Don't show on mobile or when collapsing is disabled\n  if (isMobile || collapsible === 'none') {\n    return null;\n  }\n\n  const classes = [\n    styles.rail,\n    collapsed && styles.railCollapsed,\n    className,\n  ].filter(Boolean).join(' ');\n\n  return (\n    <button\n      type=\"button\"\n      className={classes}\n      onClick={() => setCollapsed(!collapsed)}\n      aria-label={collapsed ? 'Expand sidebar' : 'Collapse sidebar'}\n      title={collapsed ? 'Expand sidebar' : 'Collapse sidebar'}\n    />\n  );\n}\n\nfunction SidebarMenuSkeleton({\n  count = 5,\n  showIcon = true,\n  className,\n}: SidebarMenuSkeletonProps) {\n  const { collapsed, isMobile } = useSidebarContext();\n  const isCollapsed = collapsed && !isMobile;\n\n  const classes = [styles.menuSkeleton, className].filter(Boolean).join(' ');\n  const labelWidths = ['64%', '72%', '68%', '79%', '74%', '66%', '83%', '70%'];\n\n  return (\n    <div className={classes} aria-hidden=\"true\">\n      {Array.from({ length: count }).map((_, i) => (\n        <div key={i} className={styles.skeletonItem}>\n          {showIcon && <Skeleton variant=\"avatar\" size=\"sm\" />}\n          {!isCollapsed && (\n            <Skeleton\n              variant=\"text\"\n              className={styles.skeletonLabel}\n              width={labelWidths[i % labelWidths.length]}\n            />\n          )}\n        </div>\n      ))}\n    </div>\n  );\n}\n\n// ============================================\n// Export compound component\n// ============================================\n\nexport const Sidebar = Object.assign(SidebarRoot, {\n  Header: SidebarHeader,\n  Nav: SidebarNav,\n  Section: SidebarSection,\n  SectionAction: SidebarSectionAction,\n  Item: SidebarItem,\n  SubItem: SidebarSubItem,\n  Submenu: SidebarSubmenu,\n  Footer: SidebarFooter,\n  Trigger: SidebarTrigger,\n  Overlay: SidebarOverlay,\n  CollapseToggle: SidebarCollapseToggle,\n  Rail: SidebarRail,\n  MenuSkeleton: SidebarMenuSkeleton,\n});\n\n// Re-export individual components\nexport {\n  SidebarProvider,\n  SidebarRoot,\n  SidebarHeader,\n  SidebarNav,\n  SidebarSection,\n  SidebarSectionAction,\n  SidebarItem,\n  SidebarSubItem,\n  SidebarSubmenu,\n  SidebarFooter,\n  SidebarTrigger,\n  SidebarOverlay,\n  SidebarCollapseToggle,\n  SidebarRail,\n  SidebarMenuSkeleton,\n};\n\n// Export hooks\nexport { useSidebar };\n\n// Export context hook for backwards compatibility (deprecated)\nexport { useSidebarContext };\n"],"names":["jsx","React","useFocusTrap","styles","ScrollArea","jsxs","Collapsible","Fragment","Tooltip","Skeleton"],"mappings":"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"}

package/dist/components/Sidebar/index.d.ts

@@ -0,0 +1,230 @@
+import * as React from 'react';
+/** Collapse behavior mode */
+export type SidebarCollapsible = 'icon' | 'offcanvas' | 'none';
+export interface SidebarProviderProps {
+    children: React.ReactNode;
+    /** Icon-only mode (desktop) - controlled */
+    collapsed?: boolean;
+    /** Initial collapsed state (uncontrolled) */
+    defaultCollapsed?: boolean;
+    /** Callback when collapsed state changes */
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** Mobile drawer state - controlled */
+    open?: boolean;
+    /** Initial open state (uncontrolled) */
+    defaultOpen?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Width of expanded sidebar */
+    width?: string;
+    /** Width when collapsed */
+    collapsedWidth?: string;
+    /** Sidebar position */
+    position?: 'left' | 'right';
+    /** Collapse behavior: 'icon' (default), 'offcanvas', or 'none' */
+    collapsible?: SidebarCollapsible;
+    /** Enable Cmd/Ctrl+B keyboard shortcut to toggle sidebar */
+    enableKeyboardShortcut?: boolean;
+}
+export interface SidebarProps extends React.HTMLAttributes<HTMLElement> {
+    children: React.ReactNode;
+    /** Icon-only mode (desktop) - controlled */
+    collapsed?: boolean;
+    /** Initial collapsed state (uncontrolled) */
+    defaultCollapsed?: boolean;
+    /** Callback when collapsed state changes */
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** Mobile drawer state - controlled */
+    open?: boolean;
+    /** Initial open state (uncontrolled) */
+    defaultOpen?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Width of expanded sidebar */
+    width?: string;
+    /** Width when collapsed */
+    collapsedWidth?: string;
+    /** Sidebar position */
+    position?: 'left' | 'right';
+    /** Collapse behavior: 'icon' (default), 'offcanvas', or 'none' */
+    collapsible?: SidebarCollapsible;
+}
+export interface SidebarHeaderProps {
+    children: React.ReactNode;
+    /** Content to show when sidebar is collapsed (e.g., just logo icon) */
+    collapsedContent?: React.ReactNode;
+    className?: string;
+}
+export interface SidebarNavProps {
+    children: React.ReactNode;
+    /** Accessible label for navigation */
+    'aria-label'?: string;
+    className?: string;
+}
+export interface SidebarSectionProps {
+    children: React.ReactNode;
+    /** Optional section label */
+    label?: string;
+    /** Action element to display in the section header (e.g., "Add" button) */
+    action?: React.ReactNode;
+    /** Enable collapsible behavior */
+    collapsible?: boolean;
+    /** Default expanded state (only applies when collapsible is true) */
+    defaultOpen?: boolean;
+    className?: string;
+}
+export interface SidebarSectionActionProps {
+    children: React.ReactNode;
+    /** Click handler */
+    onClick?: () => void;
+    /** Accessible label */
+    'aria-label'?: string;
+    className?: string;
+}
+export interface SidebarItemProps {
+    children: React.ReactNode;
+    /** Icon element (required for collapsed mode visibility) */
+    icon?: React.ReactNode;
+    /** Whether item is currently active/selected */
+    active?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Badge content (e.g., notification count) */
+    badge?: React.ReactNode;
+    /** Renders as anchor if provided */
+    href?: string;
+    /** Click handler (renders as button) */
+    onClick?: () => void;
+    /** Whether this item has a submenu */
+    hasSubmenu?: boolean;
+    /** Whether submenu is expanded (controlled) */
+    expanded?: boolean;
+    /** Initial expanded state (uncontrolled) */
+    defaultExpanded?: boolean;
+    /** Callback when expanded state changes */
+    onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Render as child element (polymorphic). When true, clones the single child
+     * and merges sidebar item props. Useful for rendering as Next.js Link, etc.
+     */
+    asChild?: boolean;
+    className?: string;
+}
+export interface SidebarSubItemProps {
+    children: React.ReactNode;
+    /** Whether item is currently active/selected */
+    active?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Renders as anchor if provided */
+    href?: string;
+    /** Click handler (renders as button) */
+    onClick?: () => void;
+    className?: string;
+}
+export interface SidebarFooterProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export interface SidebarTriggerProps {
+    /** Custom trigger element (uses render prop pattern) */
+    children?: React.ReactNode;
+    /** Accessible label */
+    'aria-label'?: string;
+    className?: string;
+}
+export interface SidebarOverlayProps {
+    className?: string;
+}
+export interface SidebarCollapseToggleProps {
+    /** Accessible label */
+    'aria-label'?: string;
+    className?: string;
+}
+export interface SidebarRailProps {
+    className?: string;
+}
+export interface SidebarMenuSkeletonProps {
+    /** Number of skeleton items to render */
+    count?: number;
+    /** Show icons in skeleton items */
+    showIcon?: boolean;
+    className?: string;
+}
+interface SidebarContextValue {
+    collapsed: boolean;
+    setCollapsed: (collapsed: boolean) => void;
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    isMobile: boolean;
+    position: 'left' | 'right';
+    width: string;
+    collapsedWidth: string;
+    collapsible: SidebarCollapsible;
+    hasIcons: boolean;
+    toggleSidebar: () => void;
+    sidebarId: string;
+}
+/**
+ * Hook to access sidebar state and controls.
+ * Returns safe defaults if used outside a SidebarProvider/Sidebar.
+ */
+declare function useSidebar(): {
+    state: string;
+    collapsed: boolean;
+    setCollapsed: (collapsed: boolean) => void;
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    isMobile: boolean;
+    position: "left" | "right";
+    width: string;
+    collapsedWidth: string;
+    collapsible: SidebarCollapsible;
+    hasIcons: boolean;
+    toggleSidebar: () => void;
+    sidebarId: string;
+};
+/**
+ * @deprecated Use `useSidebar` instead. This will be removed in a future version.
+ */
+declare function useSidebarContext(): SidebarContextValue;
+/**
+ * SidebarProvider - Wrap your app layout to provide sidebar state to children.
+ * This enables external triggers and keyboard shortcuts.
+ */
+declare function SidebarProvider({ children, collapsed: controlledCollapsed, defaultCollapsed, onCollapsedChange, open: controlledOpen, defaultOpen, onOpenChange, width, collapsedWidth, position, collapsible, enableKeyboardShortcut, }: SidebarProviderProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarRoot({ children, collapsed: controlledCollapsed, defaultCollapsed, onCollapsedChange, open: controlledOpen, defaultOpen, onOpenChange, width, collapsedWidth, position, collapsible, className, style: styleProp, 'aria-label': ariaLabel, ...htmlProps }: SidebarProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarHeader({ children, collapsedContent, className }: SidebarHeaderProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarNav({ children, 'aria-label': ariaLabel, className }: SidebarNavProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarSection({ children, label, action, collapsible: isCollapsibleProp, defaultOpen, className }: SidebarSectionProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarSectionAction({ children, onClick, 'aria-label': ariaLabel, className, }: SidebarSectionActionProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarItem({ children, icon, active, disabled, badge, href, onClick, hasSubmenu, expanded: controlledExpanded, defaultExpanded, onExpandedChange, asChild, className, }: SidebarItemProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarSubItem({ children, active, disabled, href, onClick, className, }: SidebarSubItemProps): import("react/jsx-runtime").JSX.Element | null;
+declare function SidebarSubmenu({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function SidebarFooter({ children, className }: SidebarFooterProps): import("react/jsx-runtime").JSX.Element;
+declare function SidebarTrigger({ children, 'aria-label': ariaLabel, className }: SidebarTriggerProps): import("react/jsx-runtime").JSX.Element | null;
+declare function SidebarOverlay({ className }: SidebarOverlayProps): import("react/jsx-runtime").JSX.Element | null;
+declare function SidebarCollapseToggle({ 'aria-label': ariaLabel, className }: SidebarCollapseToggleProps): import("react/jsx-runtime").JSX.Element | null;
+declare function SidebarRail({ className }: SidebarRailProps): import("react/jsx-runtime").JSX.Element | null;
+declare function SidebarMenuSkeleton({ count, showIcon, className, }: SidebarMenuSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare const Sidebar: typeof SidebarRoot & {
+    Header: typeof SidebarHeader;
+    Nav: typeof SidebarNav;
+    Section: typeof SidebarSection;
+    SectionAction: typeof SidebarSectionAction;
+    Item: typeof SidebarItem;
+    SubItem: typeof SidebarSubItem;
+    Submenu: typeof SidebarSubmenu;
+    Footer: typeof SidebarFooter;
+    Trigger: typeof SidebarTrigger;
+    Overlay: typeof SidebarOverlay;
+    CollapseToggle: typeof SidebarCollapseToggle;
+    Rail: typeof SidebarRail;
+    MenuSkeleton: typeof SidebarMenuSkeleton;
+};
+export { SidebarProvider, SidebarRoot, SidebarHeader, SidebarNav, SidebarSection, SidebarSectionAction, SidebarItem, SidebarSubItem, SidebarSubmenu, SidebarFooter, SidebarTrigger, SidebarOverlay, SidebarCollapseToggle, SidebarRail, SidebarMenuSkeleton, };
+export { useSidebar };
+export { useSidebarContext };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Sidebar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Sidebar/index.tsx"],"names":[],"mappings":"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"}