{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "popover",
  "type": "registry:ui",
  "title": "Popover",
  "description": "Popover is a non-modal floating panel for supplementary or lightly interactive content anchored to a trigger.",
  "author": "Skrewww",
  "dependencies": [
    "@phosphor-icons/react"
  ],
  "registryDependencies": [
    "@skrewww/foundation"
  ],
  "docs": "Host requirements (assumed already present, not installed by this command): react, react-dom.",
  "files": [
    {
      "path": "components/ui/Popover.tsx",
      "content": "/** @skrewww-component popover */\n\"use client\";\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  cloneElement,\n  isValidElement,\n  type CSSProperties,\n  type ReactNode,\n  type RefObject,\n} from \"react\";\nimport { X } from \"@phosphor-icons/react\";\nimport { cn } from \"@/lib/cn\";\nimport { useControllableState } from \"@/lib/use-controllable\";\nimport { Portal } from \"@/components/ui/internal/Portal\";\nimport { useOverlayScope } from \"@/components/ui/internal/OverlayScopeContext\";\nimport { useOverlayEscape } from \"@/components/ui/internal/useOverlayEscape\";\nimport { useOutsidePointer } from \"@/components/ui/internal/useOutsidePointer\";\nimport {\n  computePopoverPosition,\n  type PopoverAlign,\n  type PopoverPlacement,\n} from \"@/components/ui/internal/popover-position\";\nimport { resolveInitialFocusTarget, restoreFocusSafely } from \"@/components/ui/internal/focus-utils\";\nimport { useFloatingPosition } from \"@/components/ui/internal/useFloatingPosition\";\nimport { mergeRefs } from \"@/components/ui/internal/assign-ref\";\nimport styles from \"@/components/ui/popover.module.css\";\n\nexport type PopoverFocusMode = \"trigger\" | \"content\";\n\ntype PopoverContextValue = {\n  open: boolean;\n  setOpen: (next: boolean) => void;\n  requestClose: (options?: { restoreFocus?: boolean }) => void;\n  triggerRef: React.MutableRefObject<HTMLElement | null>;\n  contentId: string;\n  titleId: string;\n  hasAccessibleName: boolean;\n  registerAccessibleName: (present: boolean) => void;\n  placement: PopoverPlacement;\n  align: PopoverAlign;\n  focusMode: PopoverFocusMode;\n  showArrow: boolean;\n};\n\nconst PopoverContext = createContext<PopoverContextValue | null>(null);\n\nfunction usePopoverContext(component: string): PopoverContextValue {\n  const context = useContext(PopoverContext);\n  if (!context) {\n    throw new Error(`${component} must be used within Popover`);\n  }\n  return context;\n}\n\nexport type PopoverProps = {\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  /** Override the popover content element id (used for aria-controls wiring). */\n  contentId?: string;\n  placement?: PopoverPlacement;\n  align?: PopoverAlign;\n  focusMode?: PopoverFocusMode;\n  showArrow?: boolean;\n  children: ReactNode;\n};\n\nexport function Popover({\n  open,\n  defaultOpen = false,\n  onOpenChange,\n  contentId: contentIdProp,\n  placement = \"bottom\",\n  align = \"center\",\n  focusMode = \"trigger\",\n  showArrow = true,\n  children,\n}: PopoverProps) {\n  const generatedContentId = useId();\n  const contentId = contentIdProp ?? generatedContentId;\n  const titleId = useId();\n  const triggerRef = useRef<HTMLElement | null>(null);\n  const [accessibleNameCount, setAccessibleNameCount] = useState(0);\n  const [isOpen, setIsOpen] = useControllableState({\n    value: open,\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n  });\n\n  const requestClose = useCallback(\n    (options?: { restoreFocus?: boolean }) => {\n      setIsOpen(false);\n      if (options?.restoreFocus) {\n        restoreFocusSafely(triggerRef.current);\n      }\n    },\n    [setIsOpen],\n  );\n\n  const setOpen = useCallback(\n    (next: boolean) => {\n      setIsOpen(next);\n    },\n    [setIsOpen],\n  );\n\n  const registerAccessibleName = useCallback((present: boolean) => {\n    setAccessibleNameCount((count) => Math.max(0, count + (present ? 1 : -1)));\n  }, []);\n\n  const value = useMemo(\n    () => ({\n      open: Boolean(isOpen),\n      setOpen,\n      requestClose,\n      triggerRef,\n      contentId,\n      titleId,\n      hasAccessibleName: accessibleNameCount > 0,\n      registerAccessibleName,\n      placement,\n      align,\n      focusMode,\n      showArrow,\n    }),\n    [\n      accessibleNameCount,\n      align,\n      contentId,\n      focusMode,\n      isOpen,\n      placement,\n      registerAccessibleName,\n      requestClose,\n      setOpen,\n      showArrow,\n      titleId,\n    ],\n  );\n\n  return <PopoverContext.Provider value={value}>{children}</PopoverContext.Provider>;\n}\n\ntype PopoverTriggerProps = {\n  children: React.ReactElement<{\n    onClick?: React.MouseEventHandler<HTMLElement>;\n    onKeyDown?: React.KeyboardEventHandler<HTMLElement>;\n    ref?: React.Ref<HTMLElement>;\n    \"aria-expanded\"?: boolean;\n    \"aria-controls\"?: string;\n  }>;\n};\n\n/** Registers a positioning anchor without toggle behavior — used by Combobox inputs. */\nexport function PopoverAnchor({\n  children,\n}: {\n  children: React.ReactElement<{ ref?: React.Ref<HTMLElement> }>;\n}) {\n  const { triggerRef } = usePopoverContext(\"PopoverAnchor\");\n\n  if (!isValidElement(children)) return children;\n\n  const child = children;\n\n  return cloneElement(child, {\n    ref: mergeRefs(triggerRef, child.props.ref),\n  });\n}\n\nexport function PopoverTrigger({ children }: PopoverTriggerProps) {\n  const { open, setOpen, requestClose, triggerRef, contentId } =\n    usePopoverContext(\"PopoverTrigger\");\n\n  if (!isValidElement(children)) return children;\n\n  const child = children;\n\n  return cloneElement(child, {\n    ref: mergeRefs(triggerRef, child.props.ref),\n    \"aria-expanded\": open,\n    \"aria-controls\":\n      child.props[\"aria-controls\"] ?? (open ? contentId : undefined),\n    onClick: (event: React.MouseEvent<HTMLElement>) => {\n      child.props.onClick?.(event);\n      if (event.defaultPrevented) return;\n      if (open) requestClose({ restoreFocus: true });\n      else setOpen(true);\n    },\n    onKeyDown: (event: React.KeyboardEvent<HTMLElement>) => {\n      child.props.onKeyDown?.(event);\n      if (event.defaultPrevented) return;\n      if (event.key === \"Enter\" || event.key === \" \") {\n        event.preventDefault();\n        if (open) requestClose({ restoreFocus: true });\n        else setOpen(true);\n      }\n    },\n  });\n}\n\nexport type PopoverContentProps = {\n  children: ReactNode;\n  className?: string;\n  style?: CSSProperties;\n  id?: string;\n  \"aria-label\"?: string;\n  initialFocusRef?: RefObject<HTMLElement | null>;\n  /** Pin popover width to the trigger before positioning — used by Select listboxes. */\n  matchTriggerWidth?: boolean;\n};\n\nexport function PopoverContent({\n  children,\n  className,\n  style,\n  id: idProp,\n  \"aria-label\": ariaLabel,\n  initialFocusRef,\n  matchTriggerWidth = false,\n}: PopoverContentProps) {\n  const {\n    open,\n    requestClose,\n    triggerRef,\n    contentId,\n    titleId,\n    hasAccessibleName: hasTitleRegistered,\n    placement,\n    align,\n    focusMode,\n    showArrow,\n  } = usePopoverContext(\"PopoverContent\");\n\n  const overlayScopeId = useOverlayScope();\n  const contentRef = useRef<HTMLDivElement | null>(null);\n  const [contentNode, setContentNode] = useState<HTMLDivElement | null>(null);\n  const [coords, setCoords] = useState({ top: 0, left: 0 });\n  const [resolvedPlacement, setResolvedPlacement] = useState(placement);\n\n  const setContentRef = useCallback((node: HTMLDivElement | null) => {\n    contentRef.current = node;\n    setContentNode(node);\n  }, []);\n\n  const stackZIndex = useOverlayEscape(open, () => requestClose({ restoreFocus: true }), {\n    modal: false,\n  });\n  useOutsidePointer({\n    active: open,\n    onOutsidePointer: () => requestClose({ restoreFocus: false }),\n    getInsideElements: () => [triggerRef.current, contentNode],\n  });\n\n  const applyTriggerWidth = useCallback(() => {\n    if (!matchTriggerWidth || !triggerRef.current || !contentRef.current) return undefined;\n\n    const viewportPadding =\n      parseFloat(\n        getComputedStyle(document.documentElement).getPropertyValue(\n          \"--popover-viewport-padding\",\n        ),\n      ) || 8;\n    const maxWidth = window.innerWidth - viewportPadding * 2;\n    const triggerWidth = Math.min(triggerRef.current.getBoundingClientRect().width, maxWidth);\n    contentRef.current.style.width = `${triggerWidth}px`;\n    contentRef.current.style.minWidth = `${triggerWidth}px`;\n    contentRef.current.style.maxWidth = `${triggerWidth}px`;\n    contentRef.current.style.boxSizing = \"border-box\";\n    return triggerWidth;\n  }, [matchTriggerWidth, triggerRef]);\n\n  const updatePosition = useCallback(() => {\n    if (!open || !triggerRef.current || !contentRef.current) return;\n\n    const triggerRect = triggerRef.current.getBoundingClientRect();\n    const measuredRect = contentRef.current.getBoundingClientRect();\n    const viewportPadding =\n      parseFloat(\n        getComputedStyle(document.documentElement).getPropertyValue(\n          \"--popover-viewport-padding\",\n        ),\n      ) || 8;\n    const maxWidth = window.innerWidth - viewportPadding * 2;\n    const triggerWidth = matchTriggerWidth\n      ? Math.min(triggerRect.width, maxWidth)\n      : measuredRect.width;\n    const popoverRect = new DOMRect(\n      measuredRect.x,\n      measuredRect.y,\n      triggerWidth,\n      measuredRect.height || contentRef.current.offsetHeight,\n    );\n    const offset =\n      parseFloat(\n        getComputedStyle(document.documentElement).getPropertyValue(\"--popover-offset\"),\n      ) || 8;\n\n    const next = computePopoverPosition(\n      triggerRect,\n      popoverRect,\n      placement,\n      align,\n      offset,\n      viewportPadding,\n    );\n    setCoords({ top: next.top, left: next.left });\n    setResolvedPlacement(next.placement);\n  }, [align, matchTriggerWidth, open, placement, triggerRef]);\n\n  useFloatingPosition({\n    enabled: open,\n    triggerRef,\n    floatingElement: contentNode,\n    onUpdate: updatePosition,\n  });\n\n  useLayoutEffect(() => {\n    if (!open || !contentNode) return;\n    applyTriggerWidth();\n    updatePosition();\n  }, [applyTriggerWidth, contentNode, open, updatePosition, children, style]);\n\n  useLayoutEffect(() => {\n    if (!open || !contentNode || focusMode !== \"content\") return;\n\n    const focusInitial = () => {\n      const target = resolveInitialFocusTarget(contentNode, initialFocusRef);\n      target.focus();\n    };\n\n    focusInitial();\n    const timer = window.setTimeout(focusInitial, 0);\n    return () => window.clearTimeout(timer);\n  }, [contentNode, focusMode, initialFocusRef, open]);\n\n  if (!open) return null;\n\n  const hasAccessibleName = Boolean(ariaLabel) || hasTitleRegistered;\n  const role = hasAccessibleName ? \"dialog\" : undefined;\n  const labelledBy = ariaLabel ? undefined : hasTitleRegistered ? titleId : undefined;\n\n  return (\n    <Portal>\n      <div\n        ref={setContentRef}\n        id={idProp ?? contentId}\n        role={role}\n        aria-label={ariaLabel}\n        aria-labelledby={labelledBy}\n        data-skrewww-overlay-scope={overlayScopeId}\n        data-skrewww-popover-interactive={focusMode === \"content\" ? \"true\" : undefined}\n        data-skrewww-popover-fit={matchTriggerWidth ? \"trigger\" : undefined}\n        className={cn(styles.popover, styles[resolvedPlacement], className)}\n        style={{ top: coords.top, left: coords.left, zIndex: stackZIndex, ...style }}\n        tabIndex={focusMode === \"content\" && !hasAccessibleName ? -1 : undefined}\n        onMouseDown={(event) => event.stopPropagation()}\n      >\n        {showArrow ? <span className={styles.arrow} aria-hidden=\"true\" /> : null}\n        {children}\n      </div>\n    </Portal>\n  );\n}\n\nexport type PopoverTitleProps = {\n  children: ReactNode;\n  className?: string;\n  visuallyHidden?: boolean;\n};\n\nexport function PopoverTitle({\n  children,\n  className,\n  visuallyHidden = false,\n}: PopoverTitleProps) {\n  const { titleId, registerAccessibleName } = usePopoverContext(\"PopoverTitle\");\n\n  useEffect(() => {\n    registerAccessibleName(true);\n    return () => registerAccessibleName(false);\n  }, [registerAccessibleName]);\n\n  return (\n    <h3 id={titleId} className={cn(styles.title, visuallyHidden && \"sr-only\", className)}>\n      {children}\n    </h3>\n  );\n}\n\nexport type PopoverDescriptionProps = {\n  children: ReactNode;\n  className?: string;\n};\n\nexport function PopoverDescription({ children, className }: PopoverDescriptionProps) {\n  return <p className={cn(styles.description, className)}>{children}</p>;\n}\n\nexport type PopoverCloseProps = {\n  className?: string;\n  label?: string;\n};\n\nexport function PopoverClose({ className, label = \"Close popover\" }: PopoverCloseProps) {\n  const { requestClose } = usePopoverContext(\"PopoverClose\");\n  return (\n    <button\n      type=\"button\"\n      className={cn(styles.close, className)}\n      aria-label={label}\n      onClick={() => {\n        requestClose({ restoreFocus: true });\n      }}\n    >\n      <X size={14} aria-hidden=\"true\" />\n    </button>\n  );\n}\n\nexport type PopoverBodyProps = {\n  children: ReactNode;\n  className?: string;\n};\n\nexport function PopoverBody({ children, className }: PopoverBodyProps) {\n  return <div className={cn(styles.body, className)}>{children}</div>;\n}\n\n/** Close the nearest Popover from composed overlay content such as Select listboxes. */\nexport function usePopoverRequestClose() {\n  const { requestClose } = usePopoverContext(\"usePopoverRequestClose\");\n  return requestClose;\n}\n\n/** Read open state from the nearest Popover — useful for measuring on open. */\nexport function usePopoverOpen() {\n  return usePopoverContext(\"usePopoverOpen\").open;\n}\n\n/** Open or close the nearest Popover from composed content such as Select triggers. */\nexport function usePopoverSetOpen() {\n  return usePopoverContext(\"usePopoverSetOpen\").setOpen;\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/Popover.tsx"
    },
    {
      "path": "components/ui/popover.module.css",
      "content": ".popover[data-skrewww-popover-fit=\"trigger\"] {\n  width: auto;\n  max-width: none;\n  padding: 0;\n  overflow: hidden;\n  animation: none;\n}\n\n.popover {\n  position: fixed;\n  z-index: var(--popover-z-index);\n  width: max-content;\n  max-width: min(var(--popover-max-width), calc(100vw - (var(--popover-viewport-padding) * 2)));\n  /* Dialog rim: transparent border + card-surface fill + 3-stop highlight. */\n  border: 1px solid transparent;\n  border-radius: var(--popover-radius);\n  background:\n    linear-gradient(var(--component-card-surface), var(--component-card-surface)) padding-box,\n    var(--component-card-border-gradient) border-box;\n  color: var(--popover-text);\n  /* Figma Content 2044:26006: BACKGROUND_BLUR only — no drop shadow. */\n  box-shadow: none;\n  padding: var(--popover-padding);\n  outline: none;\n  /* Flat/Gradient: none. Glass: --component-surface-backdrop-filter → lg 16px. */\n  backdrop-filter: var(--component-surface-backdrop-filter);\n}\n\n.title {\n  margin: 0 0 var(--popover-body-gap);\n  font-size: 0.9375rem;\n  font-weight: 600;\n  line-height: 1.35;\n  color: var(--popover-text);\n}\n\n.description {\n  margin: 0 0 var(--popover-body-gap);\n  font-size: 0.875rem;\n  line-height: 1.5;\n  color: var(--semantic-text-secondary);\n}\n\n.body {\n  font-size: 0.875rem;\n  line-height: 1.5;\n  color: var(--semantic-text-secondary);\n}\n\n.close {\n  position: absolute;\n  top: 0.5rem;\n  right: 0.5rem;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 1.75rem;\n  height: 1.75rem;\n  border: 1px solid var(--popover-border);\n  border-radius: min(var(--shape-radius-control), 9999px);\n  background: transparent;\n  color: var(--popover-text);\n  cursor: pointer;\n}\n\n.close:focus-visible {\n  outline: 2px solid var(--semantic-focus-ring);\n  outline-offset: 2px;\n}\n\n.top .arrow,\n.bottom .arrow,\n.left .arrow,\n.right .arrow {\n  position: absolute;\n  width: var(--popover-arrow-size);\n  height: var(--popover-arrow-size);\n  background: var(--component-card-surface);\n  border: 1px solid var(--component-card-border);\n  /* Panel owns Glass blur. Arrow fill matches the surface; do not blur again. */\n  transform: rotate(45deg);\n}\n\n.bottom .arrow {\n  top: calc(var(--popover-arrow-size) * -0.5);\n  left: 50%;\n  margin-left: calc(var(--popover-arrow-size) * -0.5);\n  /* width:0 keeps --component-card-border on remaining sides; `border-*: none`\n     resets color to currentColor and breaks flipped-placement assertions. */\n  border-bottom-width: 0;\n  border-right-width: 0;\n}\n\n.top .arrow {\n  bottom: calc(var(--popover-arrow-size) * -0.5);\n  left: 50%;\n  margin-left: calc(var(--popover-arrow-size) * -0.5);\n  border-top-width: 0;\n  border-left-width: 0;\n}\n\n.left .arrow {\n  right: calc(var(--popover-arrow-size) * -0.5);\n  top: 50%;\n  margin-top: calc(var(--popover-arrow-size) * -0.5);\n  border-left-width: 0;\n  border-bottom-width: 0;\n}\n\n.right .arrow {\n  left: calc(var(--popover-arrow-size) * -0.5);\n  top: 50%;\n  margin-top: calc(var(--popover-arrow-size) * -0.5);\n  border-right-width: 0;\n  border-top-width: 0;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .popover {\n    animation: none;\n  }\n}\n\n[data-skrewww-shape=\"pill\"] .popover {\n  border-radius: min(var(--popover-radius), 1.25rem);\n}\n\n@keyframes popover-enter {\n  from {\n    opacity: 0;\n    transform: translateY(4px);\n  }\n\n  to {\n    opacity: 1;\n    transform: translateY(0);\n  }\n}\n\n.popover {\n  animation: popover-enter var(--popover-open-duration) var(--popover-motion-easing);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .popover {\n    animation: none;\n  }\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/popover.module.css"
    },
    {
      "path": "lib/cn.ts",
      "content": "export function cn(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(\" \");\n}\n",
      "type": "registry:lib",
      "target": "~/lib/cn.ts"
    },
    {
      "path": "lib/use-controllable.ts",
      "content": "import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport function useControllableState<T>({\n  value,\n  defaultValue,\n  onChange,\n  controlled: controlledProp,\n  valueProvided,\n}: {\n  value?: T;\n  defaultValue?: T;\n  onChange?: (next: T) => void;\n  /** Explicit controlled override — prefer `valueProvided` from the component root. */\n  controlled?: boolean;\n  /** True when the parent passed a `value` prop, including `undefined`. */\n  valueProvided?: boolean;\n}) {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue as T);\n  const isControlled = controlledProp ?? valueProvided ?? value !== undefined;\n  const current = isControlled ? (value as T) : uncontrolled;\n  const wasControlledRef = useRef(isControlled);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") return;\n    if (wasControlledRef.current !== isControlled) {\n      console.warn(\n        \"[Skrewww] A component changed between controlled and uncontrolled modes. Keep `value` or `defaultValue` usage consistent across renders.\",\n      );\n    }\n    wasControlledRef.current = isControlled;\n  }, [isControlled]);\n\n  const setValue = useCallback(\n    (next: T) => {\n      if (!isControlled) setUncontrolled(next);\n      onChange?.(next);\n    },\n    [isControlled, onChange],\n  );\n\n  return [current, setValue] as const;\n}\n",
      "type": "registry:lib",
      "target": "~/lib/use-controllable.ts"
    },
    {
      "path": "components/ui/internal/Portal.tsx",
      "content": "\"use client\";\n\nimport { createPortal } from \"react-dom\";\nimport { useIsClient } from \"@/components/ui/internal/useIsClient\";\n\nexport type PortalProps = {\n  children: React.ReactNode;\n  container?: Element | DocumentFragment | null;\n};\n\nexport function Portal({ children, container }: PortalProps) {\n  const mounted = useIsClient();\n\n  if (!mounted) return null;\n\n  const target =\n    container ?? (typeof document !== \"undefined\" ? document.body : null);\n  if (!target) return null;\n\n  return createPortal(children, target);\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/internal/Portal.tsx"
    },
    {
      "path": "components/ui/internal/useIsClient.ts",
      "content": "import { useSyncExternalStore } from \"react\";\n\nconst subscribe = () => () => {};\n\n/**\n * Client-only gate for portals and browser APIs.\n * Hydration uses the server snapshot (`false`); the client snapshot is `true`.\n */\nexport function useIsClient() {\n  return useSyncExternalStore(subscribe, () => true, () => false);\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/useIsClient.ts"
    },
    {
      "path": "components/ui/internal/OverlayScopeContext.tsx",
      "content": "\"use client\";\n\nimport { createContext, useContext } from \"react\";\n\nconst OverlayScopeContext = createContext<string | undefined>(undefined);\n\nexport function OverlayScopeProvider({\n  scopeId,\n  children,\n}: {\n  scopeId: string;\n  children: React.ReactNode;\n}) {\n  return <OverlayScopeContext.Provider value={scopeId}>{children}</OverlayScopeContext.Provider>;\n}\n\nexport function useOverlayScope(): string | undefined {\n  return useContext(OverlayScopeContext);\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/internal/OverlayScopeContext.tsx"
    },
    {
      "path": "components/ui/internal/useOverlayEscape.ts",
      "content": "import { useLayoutEffect, useState } from \"react\";\nimport { registerOverlay } from \"@/components/ui/internal/overlay-stack\";\nimport { useLatestRef } from \"@/components/ui/internal/useLatestRef\";\n\n/**\n * Base z-index for stacked overlay content (Popover/Dialog/Drawer/Tooltip). Each\n * overlay's actual z-index is this base plus its registration order in the shared\n * overlay stack, so an overlay opened later — e.g. a Popover opened from inside an\n * already-open Dialog — always renders above the ones already on screen, regardless\n * of which component type it is. Without this, a Popover's static z-index token could\n * be lower than a Dialog's/Drawer's, rendering it behind them even though it opened\n * on top of the stack (see docs/architecture nested-overlay notes).\n */\nconst OVERLAY_STACK_BASE_Z_INDEX = 60;\n\nexport function useOverlayEscape(\n  active: boolean,\n  onEscape: () => void,\n  options?: { modal?: boolean },\n): number | undefined {\n  const onEscapeRef = useLatestRef(onEscape);\n  const [zIndex, setZIndex] = useState<number | undefined>(undefined);\n\n  useLayoutEffect(() => {\n    // Skip when inactive: every consumer of this hook (Popover/Dialog/Drawer/Tooltip content)\n    // renders null while its own `open`/`active` state is false, so a stale zIndex from a prior\n    // open never reaches the DOM — it gets overwritten with a fresh order-derived value the next\n    // time this effect registers.\n    if (!active) return;\n    const { order, unregister } = registerOverlay(() => onEscapeRef.current(), {\n      modal: options?.modal,\n    });\n    setZIndex(OVERLAY_STACK_BASE_Z_INDEX + order);\n    return unregister;\n  }, [active, onEscapeRef, options?.modal]);\n\n  return zIndex;\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/useOverlayEscape.ts"
    },
    {
      "path": "components/ui/internal/overlay-stack.ts",
      "content": "type OverlayRegistration = {\n  id: symbol;\n  order: number;\n  onEscape: () => void;\n  modal: boolean;\n};\n\nexport type OverlayHandle = {\n  /** Monotonically increasing registration order — later-registered overlays get higher values. */\n  order: number;\n  unregister: () => void;\n};\n\nlet orderCounter = 0;\nconst overlayStack: OverlayRegistration[] = [];\nlet escapeListenerBound = false;\n\nfunction handleDocumentEscape(event: KeyboardEvent) {\n  if (event.key !== \"Escape\") return;\n  const top = overlayStack[overlayStack.length - 1];\n  if (!top) return;\n  event.preventDefault();\n  event.stopPropagation();\n  top.onEscape();\n}\n\nfunction ensureEscapeListener() {\n  if (escapeListenerBound || typeof document === \"undefined\") return;\n  document.addEventListener(\"keydown\", handleDocumentEscape);\n  escapeListenerBound = true;\n}\n\nexport function registerOverlay(\n  onEscape: () => void,\n  options?: { modal?: boolean },\n): OverlayHandle {\n  ensureEscapeListener();\n\n  const registration: OverlayRegistration = {\n    id: Symbol(\"overlay\"),\n    order: ++orderCounter,\n    onEscape,\n    modal: options?.modal ?? false,\n  };\n\n  overlayStack.push(registration);\n  overlayStack.sort((left, right) => left.order - right.order);\n\n  return {\n    order: registration.order,\n    unregister: () => {\n      const index = overlayStack.findIndex((entry) => entry.id === registration.id);\n      if (index >= 0) overlayStack.splice(index, 1);\n    },\n  };\n}\n\nexport function getTopOverlay(): OverlayRegistration | undefined {\n  return overlayStack[overlayStack.length - 1];\n}\n\nexport function clearOverlayStackForTests() {\n  overlayStack.length = 0;\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/overlay-stack.ts"
    },
    {
      "path": "components/ui/internal/useLatestRef.ts",
      "content": "import { useLayoutEffect, useRef } from \"react\";\n\n/**\n * Keep a ref pointed at the latest value without retriggering an effect that\n * only needs to read it later (event handlers, observers, overlay callbacks).\n * The write happens after commit so it does not read/write refs during render.\n */\nexport function useLatestRef<T>(value: T) {\n  const ref = useRef(value);\n  useLayoutEffect(() => {\n    ref.current = value;\n  }, [value]);\n  return ref;\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/useLatestRef.ts"
    },
    {
      "path": "components/ui/internal/useOutsidePointer.ts",
      "content": "import { useEffect } from \"react\";\nimport { useLatestRef } from \"@/components/ui/internal/useLatestRef\";\n\ntype OutsidePointerOptions = {\n  active: boolean;\n  onOutsidePointer: () => void;\n  getInsideElements: () => Array<HTMLElement | null>;\n};\n\nexport function useOutsidePointer({\n  active,\n  onOutsidePointer,\n  getInsideElements,\n}: OutsidePointerOptions) {\n  const onOutsidePointerRef = useLatestRef(onOutsidePointer);\n  const getInsideElementsRef = useLatestRef(getInsideElements);\n\n  useEffect(() => {\n    if (!active) return;\n\n    function handlePointerDown(event: PointerEvent) {\n      if (event.button !== 0) return;\n      const target = event.target;\n      if (!(target instanceof Node)) return;\n\n      const isInside = getInsideElementsRef\n        .current()\n        .some((element) => element && (element === target || element.contains(target)));\n\n      if (!isInside) {\n        onOutsidePointerRef.current();\n      }\n    }\n\n    document.addEventListener(\"pointerdown\", handlePointerDown, true);\n    return () => document.removeEventListener(\"pointerdown\", handlePointerDown, true);\n  }, [active, getInsideElementsRef, onOutsidePointerRef]);\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/useOutsidePointer.ts"
    },
    {
      "path": "components/ui/internal/popover-position.ts",
      "content": "export type PopoverPlacement = \"top\" | \"right\" | \"bottom\" | \"left\";\nexport type PopoverAlign = \"start\" | \"center\" | \"end\";\n\nexport type PopoverPosition = {\n  top: number;\n  left: number;\n  placement: PopoverPlacement;\n  align: PopoverAlign;\n};\n\nexport function getOppositePlacement(placement: PopoverPlacement): PopoverPlacement {\n  if (placement === \"top\") return \"bottom\";\n  if (placement === \"bottom\") return \"top\";\n  if (placement === \"left\") return \"right\";\n  return \"left\";\n}\n\nfunction computeAlignedCoordinate(\n  triggerStart: number,\n  triggerSize: number,\n  floatingSize: number,\n  align: PopoverAlign,\n): number {\n  if (align === \"start\") return triggerStart;\n  if (align === \"end\") return triggerStart + triggerSize - floatingSize;\n  return triggerStart + triggerSize / 2 - floatingSize / 2;\n}\n\nexport function computePopoverPosition(\n  triggerRect: DOMRect,\n  popoverRect: DOMRect,\n  preferredPlacement: PopoverPlacement,\n  preferredAlign: PopoverAlign,\n  offset: number,\n  viewportPadding: number,\n): PopoverPosition {\n  const placements: PopoverPlacement[] = [\n    preferredPlacement,\n    \"bottom\",\n    \"top\",\n    \"right\",\n    \"left\",\n  ];\n  const aligns: PopoverAlign[] = [preferredAlign, \"center\", \"start\", \"end\"];\n\n  for (const placement of placements) {\n    for (const align of aligns) {\n      let top = 0;\n      let left = 0;\n\n      if (placement === \"top\") {\n        top = triggerRect.top - popoverRect.height - offset;\n        left = computeAlignedCoordinate(\n          triggerRect.left,\n          triggerRect.width,\n          popoverRect.width,\n          align,\n        );\n      } else if (placement === \"bottom\") {\n        top = triggerRect.bottom + offset;\n        left = computeAlignedCoordinate(\n          triggerRect.left,\n          triggerRect.width,\n          popoverRect.width,\n          align,\n        );\n      } else if (placement === \"left\") {\n        left = triggerRect.left - popoverRect.width - offset;\n        top = computeAlignedCoordinate(\n          triggerRect.top,\n          triggerRect.height,\n          popoverRect.height,\n          align,\n        );\n      } else {\n        left = triggerRect.right + offset;\n        top = computeAlignedCoordinate(\n          triggerRect.top,\n          triggerRect.height,\n          popoverRect.height,\n          align,\n        );\n      }\n\n      const fits =\n        top >= viewportPadding &&\n        left >= viewportPadding &&\n        top + popoverRect.height <= window.innerHeight - viewportPadding &&\n        left + popoverRect.width <= window.innerWidth - viewportPadding;\n\n      if (fits) {\n        const clampedLeft = Math.min(\n          Math.max(viewportPadding, left),\n          window.innerWidth - viewportPadding - popoverRect.width,\n        );\n        const clampedTop = Math.min(\n          Math.max(viewportPadding, top),\n          window.innerHeight - viewportPadding - popoverRect.height,\n        );\n\n        return {\n          top: clampedTop,\n          left: clampedLeft,\n          placement,\n          align,\n        };\n      }\n    }\n  }\n\n  return {\n    top: Math.max(\n      viewportPadding,\n      Math.min(\n        triggerRect.bottom + offset,\n        window.innerHeight - viewportPadding - popoverRect.height,\n      ),\n    ),\n    left: Math.min(\n      Math.max(\n        viewportPadding,\n        computeAlignedCoordinate(\n          triggerRect.left,\n          triggerRect.width,\n          popoverRect.width,\n          preferredAlign,\n        ),\n      ),\n      window.innerWidth - viewportPadding - popoverRect.width,\n    ),\n    placement: preferredPlacement,\n    align: preferredAlign,\n  };\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/popover-position.ts"
    },
    {
      "path": "components/ui/internal/focus-utils.ts",
      "content": "const FOCUSABLE_SELECTOR =\n  'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\nexport function getFocusableElements(container: HTMLElement): HTMLElement[] {\n  return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n    (element) =>\n      !element.hasAttribute(\"disabled\") &&\n      element.getAttribute(\"aria-disabled\") !== \"true\" &&\n      element.tabIndex !== -1,\n  );\n}\n\nexport function getFocusableElementsForScope(\n  container: HTMLElement,\n  overlayScopeId?: string,\n): HTMLElement[] {\n  const focusables = getFocusableElements(container);\n\n  if (!overlayScopeId || typeof document === \"undefined\") {\n    return focusables;\n  }\n\n  const scopedNodes = Array.from(\n    document.querySelectorAll<HTMLElement>(\n      `[data-skrewww-overlay-scope=\"${overlayScopeId}\"]`,\n    ),\n  );\n\n  for (const scopedNode of scopedNodes) {\n    focusables.push(...getFocusableElements(scopedNode));\n  }\n\n  return focusables.filter(\n    (element, index, array) => array.indexOf(element) === index,\n  );\n}\n\nexport function resolveInitialFocusTarget(\n  container: HTMLElement,\n  initialFocusRef?: React.RefObject<HTMLElement | null>,\n  overlayScopeId?: string,\n): HTMLElement {\n  const initial = initialFocusRef?.current;\n  if (initial && container.contains(initial)) {\n    return initial;\n  }\n\n  const focusables = getFocusableElementsForScope(container, overlayScopeId);\n  return focusables[0] ?? container;\n}\n\nexport function restoreFocusSafely(\n  primary: HTMLElement | null | undefined,\n  fallback?: HTMLElement | null,\n) {\n  const target = primary && document.contains(primary) ? primary : fallback;\n  target?.focus?.();\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/focus-utils.ts"
    },
    {
      "path": "components/ui/internal/useFloatingPosition.ts",
      "content": "import { useEffect, type RefObject } from \"react\";\nimport { useLatestRef } from \"@/components/ui/internal/useLatestRef\";\n\nfunction getScrollableAncestors(node: HTMLElement): HTMLElement[] {\n  const ancestors: HTMLElement[] = [];\n  let current: HTMLElement | null = node.parentElement;\n\n  while (current) {\n    const style = getComputedStyle(current);\n    if (/(auto|scroll|overlay)/.test(`${style.overflow}${style.overflowY}${style.overflowX}`)) {\n      ancestors.push(current);\n    }\n    current = current.parentElement;\n  }\n\n  return ancestors;\n}\n\ntype UseFloatingPositionOptions = {\n  enabled: boolean;\n  triggerElement?: HTMLElement | null;\n  triggerRef?: RefObject<HTMLElement | null>;\n  floatingElement: HTMLElement | null;\n  onUpdate: () => void;\n};\n\nexport function useFloatingPosition({\n  enabled,\n  triggerElement,\n  triggerRef,\n  floatingElement,\n  onUpdate,\n}: UseFloatingPositionOptions) {\n  const onUpdateRef = useLatestRef(onUpdate);\n\n  useEffect(() => {\n    const trigger = triggerElement ?? triggerRef?.current ?? null;\n    if (!enabled || !trigger) return;\n\n    let frame = 0;\n    const scheduleUpdate = () => {\n      cancelAnimationFrame(frame);\n      frame = requestAnimationFrame(() => onUpdateRef.current());\n    };\n\n    scheduleUpdate();\n\n    const scrollAncestors = getScrollableAncestors(trigger);\n    for (const ancestor of scrollAncestors) {\n      ancestor.addEventListener(\"scroll\", scheduleUpdate, { passive: true });\n    }\n\n    window.addEventListener(\"resize\", scheduleUpdate);\n    window.addEventListener(\"scroll\", scheduleUpdate, true);\n\n    let triggerObserver: ResizeObserver | undefined;\n    let floatingObserver: ResizeObserver | undefined;\n\n    if (typeof ResizeObserver !== \"undefined\") {\n      triggerObserver = new ResizeObserver(scheduleUpdate);\n      triggerObserver.observe(trigger);\n\n      if (floatingElement) {\n        floatingObserver = new ResizeObserver(scheduleUpdate);\n        floatingObserver.observe(floatingElement);\n      }\n    }\n\n    return () => {\n      cancelAnimationFrame(frame);\n      for (const ancestor of scrollAncestors) {\n        ancestor.removeEventListener(\"scroll\", scheduleUpdate);\n      }\n      window.removeEventListener(\"resize\", scheduleUpdate);\n      window.removeEventListener(\"scroll\", scheduleUpdate, true);\n      triggerObserver?.disconnect();\n      floatingObserver?.disconnect();\n    };\n  }, [enabled, floatingElement, onUpdateRef, triggerElement, triggerRef]);\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/useFloatingPosition.ts"
    },
    {
      "path": "components/ui/internal/assign-ref.ts",
      "content": "import type { Ref } from \"react\";\n\n/** Write a value into a React ref prop (callback or object) without touching render. */\nexport function assignRef<T>(ref: Ref<T> | undefined | null, value: T) {\n  if (!ref) return;\n  if (typeof ref === \"function\") {\n    ref(value);\n    return;\n  }\n  ref.current = value;\n}\n\nexport function mergeRefs<T>(\n  ...refs: Array<Ref<T> | undefined | null>\n): (value: T) => void {\n  return (value) => {\n    for (const ref of refs) {\n      assignRef(ref, value);\n    }\n  };\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/assign-ref.ts"
    }
  ]
}
