Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
// SPDX-License-Identifier: AGPL-3.0-only
// Carbon (github.com/crbnos/carbon). Modified or adapted versions of this file,
// including ports, remain AGPLv3; serving them over a network requires releasing their source.
"use client";
import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
import type { ReactElement } from "react";
import {
createContext,
forwardRef,
isValidElement,
useContext,
useEffect,
useId,
useState
} from "react";
import { cn } from "./utils/cn";
import { useViewport } from "./Viewport";
/**
* Base UI Tooltip wrapped to preserve the Radix-compatible API the codebase
* already uses (`Tooltip` / `TooltipTrigger asChild` / `TooltipContent side=…`).
*
* Why Base UI: Radix's Tooltip swallowed the first click on a trigger that was
* also a modal Dialog/Drawer trigger (tooltip open → focus/pointer fight on
* close), so hovering an icon button then clicking it did nothing. Base UI's
* tooltip composes cleanly with other triggers.
*
* Delay: the old Radix wrapper forced `delayDuration = 0` on every tooltip
* (instant). Base UI's Trigger defaults to 600ms, so each Root is wrapped in a
* Provider whose `delay` defaults to 0 to keep the original snappy behavior.
*/
const DEFAULT_DELAY = 50;
type ProviderProps = TooltipPrimitive.Provider.Props & {
/** Radix-compat alias for Base UI's `delay`. */
delayDuration?: number;
};
const TooltipProvider = ({ delayDuration, delay, ...props }: ProviderProps) => (
<TooltipPrimitive.Provider
delay={delay ?? delayDuration ?? DEFAULT_DELAY}
{...props}
/>
);
TooltipProvider.displayName = "TooltipProvider";
type RootProps = TooltipPrimitive.Root.Props & {
/** Radix-compat alias; mapped to the surrounding Provider's `delay`. */
delayDuration?: number;
};
/**
* Phones cannot hover. On compact an uncontrolled tooltip opens on tap
* instead, but only when the tap does not land on a control the trigger wraps,
* so icons, badges and ⓘ reveal their text while buttons and links keep doing
* their job and keep their aria-label. Desktop is unchanged.
*/
const TapToggleContext = createContext<{
id: string;
toggle: () => void;
} | null>(null);
const INTERACTIVE =
'a[href],button,input,select,textarea,[role="button"],[role="link"],[role="menuitem"],[role="checkbox"],[role="switch"],[role="tab"],[role="combobox"]';
const TapToggleRoot = ({
onOpenChange,
...props
}: TooltipPrimitive.Root.Props) => {
const id = useId();
const [open, setOpen] = useState(false);
useEffect(() => {
if (!open) return;
const close = (event: PointerEvent) => {
const target = event.target as Element | null;
if (!target?.closest?.(`[data-tooltip-tap="${id}"]`)) setOpen(false);
};
document.addEventListener("pointerdown", close);
return () => document.removeEventListener("pointerdown", close);
}, [id, open]);
return (
<TapToggleContext.Provider value={{ id, toggle: () => setOpen((o) => !o) }}>
<TooltipPrimitive.Root
{...props}
open={open}
onOpenChange={(next, ...rest) => {
// Only a tap opens it; dismissals (Escape, blur) still close it.
if (!next) setOpen(false);
onOpenChange?.(next, ...rest);
}}
/>
</TapToggleContext.Provider>
);
};
const TooltipRoot = (props: TooltipPrimitive.Root.Props) => {
const { isPhone } = useViewport();
return isPhone && props.open === undefined ? (
<TapToggleRoot {...props} />
) : (
<TooltipPrimitive.Root {...props} />
);
};
// Without its own delay a tooltip joins the surrounding provider, so once one is
// open its neighbours open at once instead of each waiting out the delay again.
const Tooltip = ({ delayDuration, ...props }: RootProps) =>
delayDuration === undefined ? (
<TooltipRoot {...props} />
) : (
<TooltipPrimitive.Provider delay={delayDuration}>
<TooltipRoot {...props} />
</TooltipPrimitive.Provider>
);
Tooltip.displayName = "Tooltip";
type TriggerProps = TooltipPrimitive.Trigger.Props & {
/** Radix-compat: render the single child as the trigger element. */
asChild?: boolean;
};
const TooltipTrigger = forwardRef<HTMLButtonElement, TriggerProps>(
({ asChild, children, ...rest }, ref) => {
const tap = useContext(TapToggleContext);
const props = tap
? {
...rest,
"data-tooltip-tap": tap.id,
onClick: (
event: Parameters<NonNullable<TriggerProps["onClick"]>>[0]
) => {
rest.onClick?.(event);
const hit = (event.target as Element).closest(INTERACTIVE);
// Base UI's own trigger button (no asChild) is not a wrapped control.
const isOwnButton = !asChild && hit === event.currentTarget;
if (hit && !isOwnButton && event.currentTarget.contains(hit))
return;
tap.toggle();
}
}
: rest;
if (asChild && isValidElement(children)) {
return (
<TooltipPrimitive.Trigger
ref={ref}
render={children as ReactElement}
{...props}
/>
);
}
return (
<TooltipPrimitive.Trigger ref={ref} {...props}>
{children}
</TooltipPrimitive.Trigger>
);
}
);
TooltipTrigger.displayName = "TooltipTrigger";
/**
* `anchor` positions the popup against a different element than the trigger.
* Use it when one tooltip serves many small hover targets inside its trigger
* (a strip of bars): the content follows the hovered target, not the strip.
*/
type ContentProps = TooltipPrimitive.Popup.Props &
Pick<
TooltipPrimitive.Positioner.Props,
"side" | "sideOffset" | "align" | "alignOffset" | "anchor"
> & {
/**
* Portal to `document.body` and paint above other overlays. Opt in only for a
* tooltip inside a popover that already sits above the default layer — the
* default `z-50` deliberately stays below modals, drawers and the palette.
*/
elevated?: boolean;
};
/** Anchor arrow pointing at the trigger; render as a child of TooltipContent. */
const TooltipArrow = (props: TooltipPrimitive.Arrow.Props) => (
<TooltipPrimitive.Arrow
{...props}
className={cn(
"flex data-[side=bottom]:top-[-8px] data-[side=left]:right-[-13px] data-[side=left]:rotate-90 data-[side=right]:left-[-13px] data-[side=right]:-rotate-90 data-[side=top]:bottom-[-8px] data-[side=top]:rotate-180",
props.className as string
)}
>
<svg width="20" height="10" viewBox="0 0 20 10" fill="none">
<path
d="M9.66437 2.60207L4.80758 6.97318C4.07308 7.63423 3.11989 8 2.13172 8H0V10H20V8H18.5349C17.5468 8 16.5936 7.63423 15.8591 6.97318L11.0023 2.60207C10.622 2.2598 10.0447 2.25979 9.66437 2.60207Z"
className="fill-popover"
/>
<path
d="M10.3333 3.34539L5.47654 7.71648C4.55842 8.54279 3.36693 9 2.13172 9H0V8H2.13172C3.11989 8 4.07308 7.63423 4.80758 6.97318L9.66437 2.60207C10.0447 2.25979 10.622 2.2598 11.0023 2.60207L15.8591 6.97318C16.5936 7.63423 17.5468 8 18.5349 8H20V9H18.5349C17.2997 9 16.1082 8.54278 15.1901 7.71648L10.3333 3.34539Z"
className="fill-border"
/>
</svg>
</TooltipPrimitive.Arrow>
);
TooltipArrow.displayName = "TooltipArrow";
const TooltipContent = forwardRef<HTMLDivElement, ContentProps>(
(
{
className,
side = "top",
sideOffset = 4,
align = "center",
alignOffset = 0,
anchor,
elevated = false,
...props
},
ref
) => {
// Phones have no hover: a tooltip shows only when tapped open (see
// TapToggleRoot); controlled tooltips stay hidden.
const { isPhone } = useViewport();
const tap = useContext(TapToggleContext);
if (isPhone && !tap) return null;
return (
<TooltipPrimitive.Portal
container={
elevated && typeof document !== "undefined"
? document.body
: undefined
}
>
<TooltipPrimitive.Positioner
side={side}
sideOffset={sideOffset}
align={align}
alignOffset={alignOffset}
anchor={anchor}
className={elevated ? "z-[9999]" : "z-50"}
>
<TooltipPrimitive.Popup
ref={ref}
data-tooltip-tap={tap?.id}
className={cn(
"z-50 w-fit max-w-xs overflow-hidden rounded-md border border-border bg-popover px-3 py-1.5 text-sm text-popover-foreground shadow-md",
"origin-[var(--transform-origin)] transition-[transform,opacity] duration-150",
"data-[starting-style]:scale-95 data-[starting-style]:opacity-0",
"data-[ending-style]:scale-95 data-[ending-style]:opacity-0",
"max-md:max-w-[calc(100vw-32px)] max-md:text-[15px]",
className
)}
{...props}
/>
</TooltipPrimitive.Positioner>
</TooltipPrimitive.Portal>
);
}
);
TooltipContent.displayName = "TooltipContent";
export {
Tooltip,
TooltipArrow,
TooltipContent,
TooltipProvider,
TooltipTrigger
};