@ldkj/web-ui 0.13.0 → 0.14.1

package/components/interact/tooltip/Tooltip.d.ts

@@ -0,0 +1,93 @@
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+import { type SxProps } from "@/styling";
+export type TooltipTone = "dark" | "light" | "primary";
+type WithStyleProps = {
+    className?: string;
+    class?: string;
+    sx?: SxProps;
+};
+export type TooltipTriggerProps = Omit<React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Trigger>, "className" | "style"> & WithStyleProps & {
+    style?: React.CSSProperties;
+    /**
+     * 当 `asChild` 为 true 时，指定用于包裹 children 的元素或组件。
+     *
+     * @default "span"
+     */
+    asChildWrapper?: React.ElementType;
+};
+export type TooltipContentProps = React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content> & WithStyleProps & {
+    /**
+     * 控制 Tooltip 内容的视觉语气。
+     *
+     * @default "dark"
+     */
+    tone?: TooltipTone;
+    /**
+     * 是否显示指向触发元素的箭头。
+     *
+     * @default false
+     */
+    arrow?: boolean;
+};
+export type TooltipArrowProps = React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Arrow> & WithStyleProps & {
+    /**
+     * 箭头颜色语气；通常与 TooltipContent 的 tone 保持一致。
+     *
+     * @default "dark"
+     */
+    tone?: TooltipTone;
+};
+/**
+ * TooltipProvider 用于配置当前 React 子树内 Tooltip 的延迟和跳过延迟行为。
+ */
+declare const TooltipProvider: ({ delayDuration, ...props }: React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Tooltip 是 Radix Tooltip Root 的组件库导出，用于包裹单个提示实例。
+ */
+declare const Tooltip: React.FC<TooltipPrimitive.TooltipProps>;
+/**
+ * TooltipPortal 用于将 TooltipContent 渲染到独立 Portal 容器。
+ */
+declare const TooltipPortal: React.FC<TooltipPrimitive.TooltipPortalProps>;
+/**
+ * TooltipTrigger 用于声明 Tooltip 的触发元素，支持 `asChild` 组合业务组件。
+ */
+declare const TooltipTrigger: React.ForwardRefExoticComponent<Omit<Omit<TooltipPrimitive.TooltipTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref">, "className" | "style"> & WithStyleProps & {
+    style?: React.CSSProperties;
+    /**
+     * 当 `asChild` 为 true 时，指定用于包裹 children 的元素或组件。
+     *
+     * @default "span"
+     */
+    asChildWrapper?: React.ElementType;
+} & React.RefAttributes<HTMLElement>>;
+/**
+ * TooltipArrow 渲染 Tooltip 的箭头，可单独用于自定义 Content 结构。
+ */
+declare const TooltipArrow: React.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipArrowProps & React.RefAttributes<SVGSVGElement>, "ref"> & WithStyleProps & {
+    /**
+     * 箭头颜色语气；通常与 TooltipContent 的 tone 保持一致。
+     *
+     * @default "dark"
+     */
+    tone?: TooltipTone;
+} & React.RefAttributes<SVGSVGElement>>;
+/**
+ * TooltipContent 渲染提示内容，内置基础动画、tone 语气和可选 arrow。
+ */
+declare const TooltipContent: React.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & WithStyleProps & {
+    /**
+     * 控制 Tooltip 内容的视觉语气。
+     *
+     * @default "dark"
+     */
+    tone?: TooltipTone;
+    /**
+     * 是否显示指向触发元素的箭头。
+     *
+     * @default false
+     */
+    arrow?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+export { Tooltip, TooltipProvider, TooltipTrigger, TooltipContent, TooltipPortal, TooltipArrow, };

package/components/interact/tooltip/index.d.ts

@@ -0,0 +1 @@
+export * from "./Tooltip";