@acronis-platform/ui-react 0.56.0 → 0.56.1

package/dist/components/ui/sidebar-primary/sidebar-primary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-primary.js","sources":["../../../../src/components/ui/sidebar-primary/sidebar-primary.tsx"],"sourcesContent":["import * as React from 'react';\nimport { mergeProps } from '@base-ui/react/merge-props';\nimport { useRender } from '@base-ui/react/use-render';\nimport { SquareArrowUpRightIcon } from '@acronis-platform/icons-react/stroke-mono';\nimport { cva, type VariantProps } from 'class-variance-authority';\n\nimport { cn } from '@/lib/utils';\nimport { useDocDir } from '@/lib/use-doc-dir';\n\nimport { ScrollArea } from '../scroll-area';\nimport { Tooltip, TooltipContent, TooltipTrigger } from '../tooltip';\n\n// Composable SidebarPrimary primitives mirroring the Figma \"SidebarPrimary\"\n// component set (node 2092:4359, variant expanded|collapsed). Every color and\n// metric is wired to a next-gen `--ui-sidebar-primary-*` token from\n// @acronis-platform/tokens-pd — no hex, no invented tokens.\n//\n// expanded/collapsed is a width-reflow state, not a panel show/hide, so it is\n// modelled as a controlled/uncontrolled `expanded` prop (default true) that sets\n// `data-state=\"expanded|collapsed\"` on the root. Every metric token has a\n// distinct `collapsed-*` / `expanded-*` name, switched via `data-[state=…]`\n// attribute selectors — Base UI Collapsible would fight this (it hides a panel;\n// the rail never hides). Layout state is shared to descendants through a small\n// context so menu items know whether to show or `sr-only` their label/extras.\n//\n// R2 (menu-item border-radius): the token tier ships no radius token. Verified\n// against the Figma node — the menu-item COMPONENT and its container frame both\n// report cornerRadius=None (the only radius in the node is the COMPONENT_SET's\n// own variant-container chrome). Rows are therefore SQUARE; no `rounded-*` is\n// applied. The focus ring uses the shared `--ui-focus-brand` (no sidebar focus\n// token exists — R1), matching Button/Breadcrumb.\n\ninterface SidebarPrimaryContextValue {\n  expanded: boolean;\n  /** Flip the rail width — drives the controlled/uncontrolled `expanded` state. */\n  toggleExpanded: () => void;\n}\n\nconst SidebarPrimaryContext =\n  React.createContext<SidebarPrimaryContextValue | null>(null);\n\nfunction useSidebarPrimaryContext(): SidebarPrimaryContextValue {\n  // Default to expanded so parts render standalone (e.g. in isolation tests /\n  // stories) without a wrapping root; the toggle is a no-op outside a root.\n  return (\n    React.useContext(SidebarPrimaryContext) ?? {\n      expanded: true,\n      toggleExpanded: () => {},\n    }\n  );\n}\n\n/**\n * Controlled + uncontrolled boolean state (the Base UI idiom). When `controlled`\n * is provided it wins and the setter only emits the change callback; otherwise\n * the setter updates internal state. `onChange` is ALWAYS invoked with the next\n * value so a consumer can react in either mode.\n */\nfunction useControllableBoolean(\n  controlled: boolean | undefined,\n  defaultValue: boolean,\n  onChange?: (next: boolean) => void\n): [boolean, (next: boolean) => void] {\n  const [uncontrolled, setUncontrolled] = React.useState(defaultValue);\n  const isControlled = controlled !== undefined;\n  const value = isControlled ? controlled : uncontrolled;\n  const setValue = React.useCallback(\n    (next: boolean) => {\n      if (!isControlled) setUncontrolled(next);\n      onChange?.(next);\n    },\n    [isControlled, onChange]\n  );\n  return [value, setValue];\n}\n\n/**\n * Tracks whether `ref`'s element is clipping its own content (`scrollWidth >\n * clientWidth`) — used to gate a tooltip so it only opens when a truncated\n * label is actually cut off. Re-measures via `ResizeObserver` (covers the\n * rail's expand/collapse width transition); `enabled` skips measurement\n * entirely (e.g. while collapsed, where the label is `sr-only`).\n */\nfunction useIsOverflowing<T extends Element>(\n  ref: React.RefObject<T | null>,\n  { enabled }: { enabled: boolean }\n): boolean {\n  const [isOverflowing, setIsOverflowing] = React.useState(false);\n\n  React.useEffect(() => {\n    const element = ref.current;\n    if (!enabled || !element) {\n      setIsOverflowing(false);\n      return;\n    }\n    const measure = () =>\n      setIsOverflowing(element.scrollWidth > element.clientWidth);\n    measure();\n    const observer = new ResizeObserver(measure);\n    observer.observe(element);\n    return () => observer.disconnect();\n  }, [ref, enabled]);\n\n  return isOverflowing;\n}\n\nexport interface SidebarPrimaryProps\n  extends React.ComponentPropsWithoutRef<'nav'> {\n  /** Controlled expanded (rail width) state. */\n  expanded?: boolean;\n  /** Uncontrolled initial expanded state. Defaults to `true` (full width). */\n  defaultExpanded?: boolean;\n  /** Fires when the expanded state changes (e.g. a consumer toggle). */\n  onExpandedChange?: (expanded: boolean) => void;\n  /**\n   * Replace the rendered `<nav>` with another element or component\n   * (Base UI composition). Accepts a React element or a render function.\n   */\n  render?: useRender.RenderProp;\n}\n\nconst SidebarPrimary = React.forwardRef<HTMLElement, SidebarPrimaryProps>(\n  (\n    {\n      className,\n      expanded: expandedProp,\n      defaultExpanded = true,\n      onExpandedChange,\n      'aria-label': ariaLabel = 'Primary',\n      render,\n      children,\n      ...props\n    },\n    ref\n  ) => {\n    const [expanded, setExpanded] = useControllableBoolean(\n      expandedProp,\n      defaultExpanded,\n      onExpandedChange\n    );\n\n    // Collapse is driven by the consumer through the layout context — the\n    // `SidebarPrimaryCollapseTrigger` (the Figma \"Collapse menu\" footer item)\n    // calls `toggleExpanded`, which updates uncontrolled state and always emits\n    // `onExpandedChange`. Controlled consumers ignore the internal state and\n    // react to the callback.\n    const context = React.useMemo<SidebarPrimaryContextValue>(\n      () => ({ expanded, toggleExpanded: () => setExpanded(!expanded) }),\n      [expanded, setExpanded]\n    );\n\n    const element = useRender({\n      render,\n      ref,\n      defaultTagName: 'nav',\n      props: mergeProps<'nav'>(\n        {\n          'aria-label': ariaLabel,\n          // `data-state` drives every collapsed/expanded token switch via\n          // attribute selectors; typed loosely because React's nav attribute\n          // map doesn't include arbitrary data-* keys as literals.\n          ...({ 'data-state': expanded ? 'expanded' : 'collapsed' } as Record<\n            string,\n            string\n          >),\n          className: cn(\n            'group/sidebar flex h-full flex-col bg-[var(--ui-sidebar-primary-global-container-color)] w-[var(--ui-sidebar-primary-collapsed-container-width)] data-[state=expanded]:w-[var(--ui-sidebar-primary-expanded-container-width)] transition-[width]',\n            className\n          ),\n          children,\n        },\n        props\n      ),\n    });\n\n    return (\n      <SidebarPrimaryContext.Provider value={context}>\n        {element}\n      </SidebarPrimaryContext.Provider>\n    );\n  }\n);\nSidebarPrimary.displayName = 'SidebarPrimary';\n\nexport interface SidebarPrimaryHeaderProps\n  extends React.ComponentPropsWithoutRef<'div'> {\n  /**\n   * Logo content shown while the rail is expanded (e.g. a full lockup).\n   * Pairs with `collapsedLogo` to swap distinct graphics per rail state\n   * instead of resizing one. When neither `logo` nor `collapsedLogo` is\n   * given, `children` renders in both states (the original single-slot\n   * behavior).\n   */\n  logo?: React.ReactNode;\n  /**\n   * Logo content shown while the rail is collapsed (e.g. a monogram mark).\n   * Falls back to `logo` when omitted.\n   */\n  collapsedLogo?: React.ReactNode;\n}\n\nconst SidebarPrimaryHeader = React.forwardRef<\n  HTMLDivElement,\n  SidebarPrimaryHeaderProps\n>(({ className, logo, collapsedLogo, children, ...props }, ref) => {\n  // Hosts a consumer-provided logo (R7 — no Logo part is built). Padding and the\n  // logo height switch on expanded/collapsed; `[&_*]:h-…` sizes whatever the\n  // consumer slots in. The logo color token tints any `currentColor` mark.\n  const { expanded } = useSidebarPrimaryContext();\n  const hasTwinLogos = logo != null || collapsedLogo != null;\n  const content = hasTwinLogos\n    ? expanded\n      ? (logo ?? collapsedLogo)\n      : (collapsedLogo ?? logo)\n    : children;\n\n  return (\n    <div\n      ref={ref}\n      className={cn(\n        'flex items-center shrink-0 text-[var(--ui-sidebar-primary-global-logo-color)] transition-[padding]',\n        'px-[var(--ui-sidebar-primary-collapsed-container-header-padding-x)] py-[var(--ui-sidebar-primary-collapsed-container-header-padding-y)]',\n        // `logo`/`collapsedLogo` are two separate elements swapped by a JS\n        // conditional (not one element whose size CSS-transitions) — the new\n        // one mounts at its final height instantly, while `padding-y` is\n        // still mid-transition. Since the two states' (padding*2 + logo\n        // height) sums only match at the transition's start/end, that instant\n        // pop makes the row briefly overshoot/undershoot its resting height\n        // and \"jump\". Pinning the row to the larger of the two sums makes the\n        // outer box's height constant across the whole transition regardless\n        // of that mismatch — padding/logo-height still animate cosmetically\n        // inside it.\n        'h-[max(calc(var(--ui-sidebar-primary-collapsed-container-header-padding-y)*2+var(--ui-sidebar-primary-collapsed-logo-height)),calc(var(--ui-sidebar-primary-expanded-container-header-padding-y)*2+var(--ui-sidebar-primary-expanded-logo-height)))]',\n        // Animate the logo's own height alongside the header's padding transition\n        // (both keyed off the same `data-state` flip) — without it the logo swaps\n        // size instantly while the rail width is still animating, reading as a jump.\n        '[&_:where(img,svg)]:h-[var(--ui-sidebar-primary-collapsed-logo-height)] [&_:where(img,svg)]:w-auto [&_:where(img,svg)]:transition-[height]',\n        'group-data-[state=expanded]/sidebar:px-[var(--ui-sidebar-primary-expanded-container-header-padding-x)] group-data-[state=expanded]/sidebar:py-[var(--ui-sidebar-primary-expanded-container-header-padding-y)]',\n        'group-data-[state=expanded]/sidebar:[&_:where(img,svg)]:h-[var(--ui-sidebar-primary-expanded-logo-height)]',\n        className\n      )}\n      {...props}\n    >\n      {content}\n    </div>\n  );\n});\nSidebarPrimaryHeader.displayName = 'SidebarPrimaryHeader';\n\nconst SidebarPrimaryContent = React.forwardRef<\n  HTMLDivElement,\n  React.ComponentPropsWithoutRef<'div'>\n>(({ className, children, ...props }, ref) => (\n  // The section list scrolls inside a ScrollArea: its overlay scrollbar floats\n  // over the content and reserves no gutter, so the full-bleed selected row is\n  // never cropped — on every OS, unlike a native `overflow` scrollbar.\n  //\n  // Base UI's Scroll Area Content sets `min-width: fit-content` inline (it\n  // needs the content's true intrinsic width to detect horizontal overflow),\n  // which forces every row wider than the rail — overriding `min-w-0` +\n  // `truncate` on a long label, since intrinsic-width calculations ignore\n  // `text-overflow`. We only ever scroll vertically here, so cancel it: the\n  // `!` (important) is required to beat the inline style's specificity.\n  <ScrollArea\n    ref={ref}\n    className={cn(\n      'min-h-0 flex-1 [&_[data-slot=scroll-area-content]]:min-w-0!',\n      className\n    )}\n    {...props}\n  >\n    <div className=\"flex flex-col gap-[var(--ui-sidebar-primary-global-section-list-gap)]\">\n      {children}\n    </div>\n  </ScrollArea>\n));\nSidebarPrimaryContent.displayName = 'SidebarPrimaryContent';\n\nconst SidebarPrimaryFooter = React.forwardRef<\n  HTMLDivElement,\n  React.ComponentPropsWithoutRef<'div'>\n>(({ className, ...props }, ref) => (\n    <div\n    ref={ref}\n    className={cn(\n      'flex flex-col shrink-0 gap-[var(--ui-sidebar-primary-global-footer-list-gap)]',\n      'border-t border-[var(--ui-sidebar-primary-global-container-footer-border-color)] [border-top-width:var(--ui-sidebar-primary-global-container-footer-border-width)]',\n      className\n    )}\n    {...props}\n  />\n));\nSidebarPrimaryFooter.displayName = 'SidebarPrimaryFooter';\n\nconst SidebarPrimarySection = React.forwardRef<\n  HTMLDivElement,\n  React.ComponentPropsWithoutRef<'div'>\n>(({ className, ...props }, ref) => (\n  // position (`:not(:first-child)`) instead of a prop.\n  <div\n    ref={ref}\n    className={cn(\n      'flex flex-col pb-[var(--ui-sidebar-primary-section-container-padding-y)]',\n      '[&:not(:first-child)]:border-t [&:not(:first-child)]:border-[var(--ui-sidebar-primary-section-container-border-color)] [&:not(:first-child)]:[border-top-width:var(--ui-sidebar-primary-section-container-border-width)] [&:not(:first-child)]:pt-[var(--ui-sidebar-primary-section-container-padding-y)]',\n      className\n    )}\n    {...props}\n  />\n));\nSidebarPrimarySection.displayName = 'SidebarPrimarySection';\n\nconst SidebarPrimaryMenu = React.forwardRef<\n  HTMLUListElement,\n  React.ComponentPropsWithoutRef<'ul'>\n>(({ className, ...props }, ref) => (\n  <ul\n    ref={ref}\n    className={cn(\n      'flex flex-col gap-[var(--ui-sidebar-primary-section-menu-item-list-gap)]',\n      className\n    )}\n    {...props}\n  />\n));\nSidebarPrimaryMenu.displayName = 'SidebarPrimaryMenu';\n\n// Primary recolors the container, the icon AND the label per variant\n// (selected|unselected) × interaction state (idle/hover/active). Every state is\n// wired to its own token even where acronis's value is unchanged, because these\n// are runtime `var()` references — a brand override is only honored if the\n// matching state token is referenced. (This is why Primary cannot share a cva\n// with Secondary, which recolors only the container — DESIGN §6.2.)\nconst sidebarPrimaryMenuItemVariants = cva(\n  'group/menu-item flex w-full items-center gap-[var(--ui-sidebar-primary-menu-item-global-container-gap)] h-[var(--ui-sidebar-primary-menu-item-global-container-height)] px-[var(--ui-sidebar-primary-menu-item-global-container-padding-x)] py-[var(--ui-sidebar-primary-menu-item-global-container-padding-y)] no-underline cursor-pointer ui-sidebar-primary-menu-item-global-label-text-style transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ui-focus-brand)] focus-visible:ring-inset [&_svg]:shrink-0 [&_svg]:size-[var(--ui-sidebar-primary-menu-item-global-icon-size)]',\n  {\n    variants: {\n      variant: {\n        unselected:\n          'bg-[var(--ui-sidebar-primary-menu-item-unselected-container-color-idle)] text-[var(--ui-sidebar-primary-menu-item-unselected-label-color-idle)] [&_svg]:text-[var(--ui-sidebar-primary-menu-item-unselected-icon-color-idle)] hover:bg-[var(--ui-sidebar-primary-menu-item-unselected-container-color-hover)] hover:text-[var(--ui-sidebar-primary-menu-item-unselected-label-color-hover)] hover:[&_svg]:text-[var(--ui-sidebar-primary-menu-item-unselected-icon-color-hover)] active:bg-[var(--ui-sidebar-primary-menu-item-unselected-container-color-active)] active:text-[var(--ui-sidebar-primary-menu-item-unselected-label-color-active)] active:[&_svg]:text-[var(--ui-sidebar-primary-menu-item-unselected-icon-color-active)]',\n        selected:\n          'bg-[var(--ui-sidebar-primary-menu-item-selected-container-color-idle)] text-[var(--ui-sidebar-primary-menu-item-selected-label-color-idle)] [&_svg]:text-[var(--ui-sidebar-primary-menu-item-selected-icon-color-idle)] hover:bg-[var(--ui-sidebar-primary-menu-item-selected-container-color-hover)] hover:text-[var(--ui-sidebar-primary-menu-item-selected-label-color-hover)] hover:[&_svg]:text-[var(--ui-sidebar-primary-menu-item-selected-icon-color-hover)] active:bg-[var(--ui-sidebar-primary-menu-item-selected-container-color-active)] active:text-[var(--ui-sidebar-primary-menu-item-selected-label-color-active)] active:[&_svg]:text-[var(--ui-sidebar-primary-menu-item-selected-icon-color-active)]',\n      },\n    },\n    defaultVariants: {\n      variant: 'unselected',\n    },\n  }\n);\n\ninterface SidebarPrimaryMenuItemBaseProps\n  extends Omit<React.ComponentPropsWithoutRef<'a'>, 'children'>,\n    Omit<VariantProps<typeof sidebarPrimaryMenuItemVariants>, 'variant'> {\n  /** Marks the current route: sets the `selected` variant + `aria-current=\"page\"`. */\n  selected?: boolean;\n  children?: React.ReactNode;\n  /**\n   * Trailing affordance — a `SidebarPrimaryMenuItemExtras` element. Rendered as\n   * a flex sibling of the label (its own `gap` from `_global/container/gap`),\n   * not nested inside the label's truncating span — nesting it there collapses\n   * the row gap and lets `truncate` clip the affordance. Hidden in collapsed/rail\n   * mode regardless of node type — the parent wraps it, so this holds even for\n   * a raw node rather than `SidebarPrimaryMenuItemExtras`.\n   */\n  extras?: React.ReactNode;\n  /**\n   * Replace the rendered `<a>` with another element or component (e.g. a router\n   * `Link` or a `<button>`) via Base UI composition.\n   */\n  render?: useRender.RenderProp;\n}\n\n// A nav rail row is icon-only when collapsed, so `icon` is required by default\n// (UX: every row must stay legible in rail mode). `noIcon` is the explicit,\n// rare escape hatch for a consumer that truly has no icon for a row.\nexport type SidebarPrimaryMenuItemProps = SidebarPrimaryMenuItemBaseProps &\n  (\n    | {\n        /** Leading 16px icon (from `@acronis-platform/icons-react`). */\n        icon: Exclude<React.ReactNode, undefined>;\n        noIcon?: never;\n      }\n    | { icon?: undefined; /** Explicit opt-out for the rare row with no icon. */ noIcon: true }\n  );\n\nconst SidebarPrimaryMenuItem = React.forwardRef<\n  HTMLAnchorElement,\n  SidebarPrimaryMenuItemProps\n>(\n  (\n    {\n      className,\n      selected = false,\n      icon,\n      noIcon,\n      render,\n      children,\n      extras,\n      ...props\n    },\n    ref\n  ) => {\n    const { expanded } = useSidebarPrimaryContext();\n    const dir = useDocDir();\n    const rowRef = React.useRef<HTMLAnchorElement>(null);\n    const labelRef = React.useRef<HTMLSpanElement>(null);\n    const isOverflowing = useIsOverflowing(labelRef, { enabled: expanded });\n\n    const inner = useRender({\n      render,\n      ref: [ref, rowRef],\n      defaultTagName: 'a',\n      props: mergeProps<'a'>(\n        {\n          className: cn(\n            sidebarPrimaryMenuItemVariants({\n              variant: selected ? 'selected' : 'unselected',\n            }),\n            className\n          ),\n          'aria-current': selected ? 'page' : undefined,\n          onKeyDown: (e: React.KeyboardEvent<HTMLAnchorElement>) => {\n            if (e.key === ' ') {\n              e.preventDefault();\n              e.currentTarget.click();\n            }\n          },\n          children: (\n            <>\n              {icon != null && (\n                <span className=\"flex shrink-0 items-center self-start mt-[var(--ui-sidebar-primary-menu-item-global-icon-margin-t)]\">\n                  {icon}\n                </span>\n              )}\n              {/* Keep the label in the DOM in collapsed/rail mode as `sr-only` so\n                  the icon-only row keeps an accessible name (a11y §7) — never\n                  `display:none` the text. Extras are visually dropped when\n                  collapsed but stay queryable for the same reason. The tooltip\n                  trigger is the label span itself, not the row — it must not\n                  open when hovering the icon or extras, and only ever opens\n                  when the label is actually clipped. It's anchored to the row\n                  (not the label span) so it lines up with the sidebar's right\n                  edge regardless of how much the label shrinks for extras. */}\n              <Tooltip disabled={!isOverflowing}>\n                <TooltipTrigger\n                  render={\n                    <span\n                      ref={labelRef}\n                      className={cn(\n                        'min-w-0 flex-1 truncate text-start',\n                        !expanded && 'sr-only'\n                      )}\n                    />\n                  }\n                >\n                  {children}\n                </TooltipTrigger>\n                <TooltipContent\n                  anchor={rowRef}\n                  side={dir === 'rtl' ? 'left' : 'right'}\n                >\n                  {children}\n                </TooltipContent>\n              </Tooltip>\n              {extras != null && (\n                <span className={cn(!expanded && 'hidden')}>{extras}</span>\n              )}\n            </>\n          ),\n        },\n        props\n      ),\n    });\n\n    return (\n      <li className=\"contents\">\n        {/* In collapsed/rail mode the label above is `sr-only` (zero-size), so\n            it never receives the hover that would open its tooltip — wrap the\n            whole row so the icon itself is hoverable and always shows the\n            item's label as a tooltip while collapsed. */}\n        <Tooltip disabled={expanded}>\n          <TooltipTrigger render={inner} />\n          <TooltipContent side={dir === 'rtl' ? 'left' : 'right'}>\n            {children}\n          </TooltipContent>\n        </Tooltip>\n      </li>\n    );\n  }\n);\nSidebarPrimaryMenuItem.displayName = 'SidebarPrimaryMenuItem';\n\nexport interface SidebarPrimaryMenuItemExtrasProps\n  extends React.ComponentPropsWithoutRef<'span'> {\n  /** Which trailing affordance to render. */\n  variant: 'tag' | 'externalLink' | 'shortcut' | 'tag-externalLink';\n  /** Shortcut text (e.g. \"⌘H\") for the `shortcut` variant. */\n  shortcut?: string;\n  /**\n   * Tag content for the `tag` / `tag-externalLink` variants. Figma constrains\n   * this slot's `Tag` instance to `size=\"sm\"` (no other size is offered on\n   * MenuItemExtras) — always pass a `<Tag variant=\"info\" size=\"sm\">`, never the\n   * default size.\n   */\n  tag?: React.ReactNode;\n}\n\nconst SidebarPrimaryMenuItemExtras = React.forwardRef<\n  HTMLSpanElement,\n  SidebarPrimaryMenuItemExtrasProps\n>(({ className, variant, shortcut, tag, children, ...props }, ref) => {\n  const { expanded } = useSidebarPrimaryContext();\n  const showTag = variant === 'tag' || variant === 'tag-externalLink';\n  const showExternal =\n    variant === 'externalLink' || variant === 'tag-externalLink';\n  const showShortcut = variant === 'shortcut';\n\n  return (\n    <span\n      ref={ref}\n      // The extras cluster is rail-mode noise — drop it when collapsed.\n      className={cn(\n        'inline-flex items-center gap-[var(--ui-sidebar-primary-menu-item-extras-global-container-gap)]',\n        !expanded && 'hidden',\n        className\n      )}\n      {...props}\n    >\n      {showTag && (tag ?? children)}\n      {showShortcut && (\n        <span className=\"ui-sidebar-primary-menu-item-extras-global-shortcut-text-style text-[var(--ui-sidebar-primary-menu-item-extras-global-shortcut-color)]\">\n          {shortcut ?? children}\n        </span>\n      )}\n      {showExternal && (\n        <SquareArrowUpRightIcon\n          size={16}\n          className=\"text-[var(--ui-sidebar-primary-menu-item-extras-global-external-icon-color)] size-[var(--ui-sidebar-primary-menu-item-extras-global-external-icon-size)]\"\n        />\n      )}\n    </span>\n  );\n});\nSidebarPrimaryMenuItemExtras.displayName = 'SidebarPrimaryMenuItemExtras';\n\nexport interface SidebarPrimaryCollapseTriggerProps\n  extends Omit<React.ComponentPropsWithoutRef<'button'>, 'children'> {\n  /** Leading 16px icon (e.g. a panel-left glyph). Rotates 180° between expanded/collapsed. */\n  icon?: React.ReactNode;\n  children?: React.ReactNode;\n  /**\n   * Trailing affordance — a `SidebarPrimaryMenuItemExtras` element (Figma\n   * shows a `⌘H` shortcut here). Rendered as a flex sibling of the label, same\n   * as `SidebarPrimaryMenuItem`'s `extras` prop.\n   */\n  extras?: React.ReactNode;\n  /** Tooltip text shown when the rail is collapsed. Defaults to `'Expand'`. */\n  expandTooltip?: React.ReactNode;\n}\n\n// The footer \"Collapse menu\" affordance (Figma). A menu-item-styled `<button>`\n// that flips the rail width via the layout context — this is the live wiring\n// for the controllable `expanded` state (B1). In collapsed mode it keeps its\n// label as `sr-only` like every other row, and (same as\n// `SidebarSecondaryCollapseTrigger`) wraps the whole button in a tooltip\n// showing `expandTooltip` — the `sr-only` label can't receive the hover that\n// would open its own tooltip.\nconst SidebarPrimaryCollapseTrigger = React.forwardRef<\n  HTMLButtonElement,\n  SidebarPrimaryCollapseTriggerProps\n>(\n  (\n    { className, icon, children, extras, expandTooltip = 'Expand', onClick, ...props },\n    ref\n  ) => {\n    const { expanded, toggleExpanded } = useSidebarPrimaryContext();\n    const dir = useDocDir();\n    const buttonRef = React.useRef<HTMLButtonElement>(null);\n    const labelRef = React.useRef<HTMLSpanElement>(null);\n    const isOverflowing = useIsOverflowing(labelRef, { enabled: expanded });\n\n    const button = (\n      <button\n        ref={(node) => {\n          buttonRef.current = node;\n          if (typeof ref === 'function') ref(node);\n          else if (ref) ref.current = node;\n        }}\n        type=\"button\"\n        aria-expanded={expanded}\n        className={cn(\n          sidebarPrimaryMenuItemVariants({ variant: 'unselected' }),\n          'text-start',\n          className\n        )}\n        onClick={(event) => {\n          onClick?.(event);\n          if (!event.defaultPrevented) toggleExpanded();\n        }}\n        {...props}\n      >\n        {icon != null && (\n          <span\n            className={cn(\n              'flex shrink-0 items-center self-start mt-[var(--ui-sidebar-primary-menu-item-global-icon-margin-t)] transition-transform',\n              expanded ? 'rtl:rotate-180' : 'ltr:rotate-180'\n            )}\n          >\n            {icon}\n          </span>\n        )}\n        <Tooltip disabled={!isOverflowing}>\n          <TooltipTrigger\n            render={\n              <span\n                ref={labelRef}\n                className={cn(\n                  'min-w-0 flex-1 truncate',\n                  !expanded && 'sr-only'\n                )}\n              />\n            }\n          >\n            {children}\n          </TooltipTrigger>\n          <TooltipContent\n            anchor={buttonRef}\n            side={dir === 'rtl' ? 'left' : 'right'}\n          >\n            {children}\n          </TooltipContent>\n        </Tooltip>\n        {extras != null && (\n          <span className={cn(!expanded && 'hidden')}>{extras}</span>\n        )}\n      </button>\n    );\n\n    return (\n      <li className=\"contents\">\n        <Tooltip disabled={expanded}>\n          <TooltipTrigger render={button} />\n          <TooltipContent side={dir === 'rtl' ? 'left' : 'right'}>\n            {expandTooltip}\n          </TooltipContent>\n        </Tooltip>\n      </li>\n    );\n  }\n);\nSidebarPrimaryCollapseTrigger.displayName = 'SidebarPrimaryCollapseTrigger';\n\nexport {\n  SidebarPrimary,\n  SidebarPrimaryHeader,\n  SidebarPrimaryContent,\n  SidebarPrimaryFooter,\n  SidebarPrimarySection,\n  SidebarPrimaryMenu,\n  SidebarPrimaryMenuItem,\n  SidebarPrimaryMenuItemExtras,\n  SidebarPrimaryCollapseTrigger,\n  useIsOverflowing,\n  sidebarPrimaryMenuItemVariants,\n};\n"],"names":["SidebarPrimaryContext","React","useSidebarPrimaryContext","useControllableBoolean","controlled","defaultValue","onChange","uncontrolled","setUncontrolled","isControlled","value","setValue","next","useIsOverflowing","ref","enabled","isOverflowing","setIsOverflowing","element","measure","observer","SidebarPrimary","className","expandedProp","defaultExpanded","onExpandedChange","ariaLabel","render","children","props","expanded","setExpanded","context","useRender","mergeProps","cn","SidebarPrimaryHeader","logo","collapsedLogo","content","jsx","SidebarPrimaryContent","ScrollArea","SidebarPrimaryFooter","SidebarPrimarySection","SidebarPrimaryMenu","sidebarPrimaryMenuItemVariants","cva","SidebarPrimaryMenuItem","selected","icon","noIcon","extras","dir","useDocDir","rowRef","labelRef","inner","e","jsxs","Fragment","Tooltip","TooltipTrigger","TooltipContent","SidebarPrimaryMenuItemExtras","variant","shortcut","tag","showTag","showExternal","showShortcut","SquareArrowUpRightIcon","SidebarPrimaryCollapseTrigger","expandTooltip","onClick","toggleExpanded","buttonRef","button","node","event"],"mappings":"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"}