@mks2508/mks-ui 0.1.4 → 0.2.0

package/dist/react/ui/Tabs/index.js

@@ -0,0 +1,308 @@
+'use client';
+
+import { cn } from "../../lib/utils.js";
+import { Highlight, HighlightItem } from "../../primitives/Highlight/index.js";
+import { AutoHeight } from "../../primitives/AutoHeight/index.js";
+import { getStrictContext } from "../../lib/get-strict-context.js";
+import { useControlledState } from "../../hooks/State/UseControlledState.js";
+import { tabsStyles } from "./Tabs.styles.js";
+import * as React from "../../../react";
+import { AnimatePresence, motion } from "motion/react";
+import { jsx } from "react/jsx-runtime";
+import { Tabs } from "@base-ui/react/tabs";
+
+//#region src/react/ui/Tabs/index.tsx
+/**
+* Tabs component -- animated tab navigation built on base-ui Tabs
+* with motion transitions, highlight tracking, auto-height panels,
+* and the v0.2.0 slot system.
+*
+* Provides sub-components for the tab list, individual tabs, panels,
+* animated highlight indicators, and a panels container with two modes:
+* auto-height (ResizeObserver) and layout (Motion layout animation).
+*
+* @module @mks2508/mks-ui/react/ui/Tabs
+*
+* @example
+* ```tsx
+* <Tabs defaultValue="general" slots={{ list: 'flex gap-1 border-b' }}>
+*   <TabsList>
+*     <TabsHighlight className="rounded-md bg-white/10">
+*       <TabsHighlightItem value="general">
+*         <TabsTab value="general">General</TabsTab>
+*       </TabsHighlightItem>
+*       <TabsHighlightItem value="advanced">
+*         <TabsTab value="advanced">Advanced</TabsTab>
+*       </TabsHighlightItem>
+*     </TabsHighlight>
+*   </TabsList>
+*   <TabsPanels>
+*     <TabsPanel value="general">General content</TabsPanel>
+*     <TabsPanel value="advanced">Advanced content</TabsPanel>
+*   </TabsPanels>
+* </Tabs>
+* ```
+*/
+const [TabsProvider, useTabs] = getStrictContext("TabsContext");
+/**
+* Root Tabs component -- provides active tab value context and
+* controlled/uncontrolled state management.
+*
+* @param value - Controlled active tab value
+* @param defaultValue - Uncontrolled initial active tab value
+* @param onValueChange - Callback when active tab changes
+* @param slots - Partial class overrides per slot
+* @param config - Tabs behavior / animation configuration
+*
+* @example
+* ```tsx
+* <Tabs defaultValue="general" slots={{ root: 'w-full' }}>
+*   <TabsList>...</TabsList>
+*   <TabsPanels>...</TabsPanels>
+* </Tabs>
+* ```
+*/
+function Tabs$1({ slots, config, className, ...props }) {
+	const [value, setValue] = useControlledState({
+		value: props.value,
+		defaultValue: props.defaultValue,
+		onChange: props.onValueChange
+	});
+	return /* @__PURE__ */ jsx(TabsProvider, {
+		value: {
+			value,
+			setValue
+		},
+		children: /* @__PURE__ */ jsx(Tabs.Root, {
+			"data-slot": "tabs",
+			className: cn(tabsStyles.root, slots?.root, className),
+			...props,
+			onValueChange: setValue
+		})
+	});
+}
+/**
+* TabsHighlight -- animated background indicator that follows the active tab.
+* Wraps the Highlight primitive with tab-specific defaults (spring transition,
+* no click activation since tabs manage their own active state).
+*
+* @param transition - Motion transition config (default: spring 200/25)
+* @param slots - Partial class overrides per slot
+* @param className - Additional class names
+*
+* @example
+* ```tsx
+* <TabsHighlight className="rounded-md bg-white/10">
+*   <TabsHighlightItem value="tab1">
+*     <TabsTab value="tab1">Tab 1</TabsTab>
+*   </TabsHighlightItem>
+* </TabsHighlight>
+* ```
+*/
+function TabsHighlight({ transition = {
+	type: "spring",
+	stiffness: 200,
+	damping: 25
+}, slots, className, ...props }) {
+	const { value } = useTabs();
+	return /* @__PURE__ */ jsx(Highlight, {
+		"data-slot": "tabs-highlight",
+		controlledItems: true,
+		value,
+		transition,
+		click: false,
+		className: cn(tabsStyles.highlight, slots?.highlight, className),
+		...props
+	});
+}
+/**
+* TabsList -- the container holding tab trigger buttons.
+* Renders a base-ui Tabs.List with the `list` slot classes.
+*
+* @param slots - Partial class overrides per slot
+* @param className - Additional class names
+*
+* @example
+* ```tsx
+* <TabsList className="flex gap-1 border-b border-white/10 pb-1">
+*   <TabsTab value="general">General</TabsTab>
+*   <TabsTab value="advanced">Advanced</TabsTab>
+* </TabsList>
+* ```
+*/
+function TabsList({ slots, className, ...props }) {
+	return /* @__PURE__ */ jsx(Tabs.List, {
+		"data-slot": "tabs-list",
+		className: cn(tabsStyles.list, slots?.list, className),
+		...props
+	});
+}
+/**
+* TabsHighlightItem -- wraps a TabsTab for highlight position tracking.
+* Must be placed inside a TabsHighlight context. The `value` prop should
+* match the corresponding TabsTab value.
+*
+* @param value - Tab value this highlight item corresponds to
+* @param slots - Partial class overrides per slot
+*
+* @example
+* ```tsx
+* <TabsHighlightItem value="general">
+*   <TabsTab value="general">General</TabsTab>
+* </TabsHighlightItem>
+* ```
+*/
+function TabsHighlightItem({ slots, ...props }) {
+	return /* @__PURE__ */ jsx(HighlightItem, {
+		"data-slot": "tabs-highlight-item",
+		...props
+	});
+}
+/**
+* TabsTab -- a single tab trigger button that activates its panel.
+* Renders a base-ui Tabs.Tab with the `tab` slot classes.
+*
+* @param value - The value this tab represents
+* @param slots - Partial class overrides per slot
+* @param className - Additional class names
+*
+* @example
+* ```tsx
+* <TabsTab value="general" className="px-3 py-1.5 text-sm font-medium">
+*   General
+* </TabsTab>
+* ```
+*/
+function TabsTab({ slots, className, ...props }) {
+	return /* @__PURE__ */ jsx(Tabs.Tab, {
+		"data-slot": "tabs-tab",
+		className: cn(tabsStyles.tab, slots?.tab, className),
+		...props
+	});
+}
+/**
+* TabsPanel -- an animated content panel associated with a tab.
+* Uses Motion for blur + opacity enter/exit transitions wrapped in
+* AnimatePresence for smooth unmount animations.
+*
+* @param value - The tab value this panel corresponds to
+* @param keepMounted - Keep the panel in DOM when inactive
+* @param transition - Motion transition config (default: 0.5s easeInOut)
+* @param slots - Partial class overrides per slot
+* @param className - Additional class names
+*
+* @example
+* ```tsx
+* <TabsPanel value="general" className="p-4">
+*   <h2>General Settings</h2>
+*   <p>Configure your preferences here.</p>
+* </TabsPanel>
+* ```
+*/
+function TabsPanel({ value, keepMounted, transition = {
+	duration: .5,
+	ease: "easeInOut"
+}, slots, className, ...props }) {
+	return /* @__PURE__ */ jsx(AnimatePresence, {
+		mode: "wait",
+		children: /* @__PURE__ */ jsx(Tabs.Panel, {
+			render: /* @__PURE__ */ jsx(motion.div, {
+				"data-slot": "tabs-panel",
+				layout: true,
+				layoutDependency: value,
+				initial: {
+					opacity: 0,
+					filter: "blur(4px)"
+				},
+				animate: {
+					opacity: 1,
+					filter: "blur(0px)"
+				},
+				exit: {
+					opacity: 0,
+					filter: "blur(4px)"
+				},
+				transition,
+				className: cn(tabsStyles.panel, slots?.panel, className),
+				...props
+			}),
+			keepMounted,
+			value
+		})
+	});
+}
+/** Default spring transition for the panels container. */
+const defaultPanelsTransition = {
+	type: "spring",
+	stiffness: 200,
+	damping: 30
+};
+/**
+* Type guard to distinguish auto-height mode from layout mode.
+*
+* @param props - TabsPanels props union
+* @returns True if auto-height mode (default)
+*/
+function isAutoMode(props) {
+	return !props.mode || props.mode === "auto-height";
+}
+/**
+* TabsPanels -- container for tab panels with animated height transitions.
+* Supports two modes:
+*
+* - **auto-height** (default): Uses ResizeObserver to animate container
+*   height when panels have different content sizes.
+* - **layout**: Uses Motion layout animation for size transitions,
+*   with overflow hidden.
+*
+* @param mode - Animation mode: 'auto-height' (default) or 'layout'
+* @param transition - Motion transition config
+* @param slots - Partial class overrides per slot
+* @param className - Additional class names
+*
+* @example
+* ```tsx
+* // Auto-height mode (default)
+* <TabsPanels>
+*   <TabsPanel value="short">Short content</TabsPanel>
+*   <TabsPanel value="long">Much longer content with many paragraphs...</TabsPanel>
+* </TabsPanels>
+*
+* // Layout mode
+* <TabsPanels mode="layout" className="rounded-lg">
+*   <TabsPanel value="a">Content A</TabsPanel>
+*   <TabsPanel value="b">Content B</TabsPanel>
+* </TabsPanels>
+* ```
+*/
+function TabsPanels(props) {
+	const { value } = useTabs();
+	if (isAutoMode(props)) {
+		const { children, transition = defaultPanelsTransition, slots, className, mode: _mode, ...autoProps } = props;
+		return /* @__PURE__ */ jsx(AutoHeight, {
+			"data-slot": "tabs-panels",
+			deps: [value],
+			transition,
+			className: cn(tabsStyles.panels, slots?.panels, className),
+			...autoProps,
+			children: /* @__PURE__ */ jsx(React.Fragment, { children }, value)
+		});
+	}
+	const { children, style, transition = defaultPanelsTransition, slots, className, mode: _mode, ...layoutProps } = props;
+	return /* @__PURE__ */ jsx(motion.div, {
+		"data-slot": "tabs-panels",
+		layout: "size",
+		layoutDependency: value,
+		transition: { layout: transition },
+		style: {
+			overflow: "hidden",
+			...style
+		},
+		className: cn(tabsStyles.panels, slots?.panels, className),
+		...layoutProps,
+		children: /* @__PURE__ */ jsx(React.Fragment, { children }, value)
+	});
+}
+
+//#endregion
+export { Tabs$1 as Tabs, TabsHighlight, TabsHighlightItem, TabsList, TabsPanel, TabsPanels, TabsTab };

package/dist/react/ui/Textarea/Textarea.styles.d.ts

@@ -0,0 +1,6 @@
+import type { StyleSlots } from '../../../core/types';
+type TextareaSlot = 'root';
+declare const textareaStyles: StyleSlots<TextareaSlot>;
+export { textareaStyles };
+export type { TextareaSlot };
+//# sourceMappingURL=Textarea.styles.d.ts.map

package/dist/react/ui/Textarea/Textarea.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Textarea.styles.d.ts","sourceRoot":"","sources":["../../../../src/react/ui/Textarea/Textarea.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,YAAY,GAAG,MAAM,CAAC;AAE3B,QAAA,MAAM,cAAc,EAAE,UAAU,CAAC,YAAY,CAE5C,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/react/ui/Textarea/Textarea.styles.js

@@ -0,0 +1,5 @@
+//#region src/react/ui/Textarea/Textarea.styles.ts
+const textareaStyles = { root: "border-input dark:bg-input/30 focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:aria-invalid:border-destructive/50 disabled:bg-input/50 dark:disabled:bg-input/80 rounded-lg border bg-transparent px-2.5 py-2 text-base transition-colors focus-visible:ring-3 aria-invalid:ring-3 md:text-sm placeholder:text-muted-foreground flex field-sizing-content min-h-16 w-full outline-none disabled:cursor-not-allowed disabled:opacity-50" };
+
+//#endregion
+export { textareaStyles };

package/dist/react/ui/Textarea/Textarea.types.d.ts

@@ -0,0 +1,8 @@
+import type { SlotOverrides } from '../../../core/types';
+import type { TextareaSlot } from './Textarea.styles';
+/** Props for the Textarea component. */
+interface ITextareaProps extends React.ComponentProps<'textarea'> {
+    slots?: SlotOverrides<TextareaSlot>;
+}
+export type { ITextareaProps };
+//# sourceMappingURL=Textarea.types.d.ts.map

package/dist/react/ui/Textarea/Textarea.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Textarea.types.d.ts","sourceRoot":"","sources":["../../../../src/react/ui/Textarea/Textarea.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wCAAwC;AACxC,UAAU,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC;IAC/D,KAAK,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CACrC;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/react/ui/Textarea/index.d.ts

@@ -0,0 +1,14 @@
+import type { ITextareaProps } from './Textarea.types';
+/**
+ * Textarea — styled multi-line text input.
+ *
+ * @example
+ * ```tsx
+ * <Textarea placeholder="Enter description..." />
+ * ```
+ */
+declare function Textarea({ className, slots, ...props }: ITextareaProps): import("react/jsx-runtime").JSX.Element;
+export { Textarea };
+export type { ITextareaProps } from './Textarea.types';
+export type { TextareaSlot } from './Textarea.styles';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/ui/Textarea/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/ui/Textarea/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;GAOG;AACH,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,2CAQ/D;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/react/ui/Textarea/index.js

@@ -0,0 +1,24 @@
+import { cn } from "../../lib/utils.js";
+import { textareaStyles } from "./Textarea.styles.js";
+import "../../../react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/react/ui/Textarea/index.tsx
+/**
+* Textarea — styled multi-line text input.
+*
+* @example
+* ```tsx
+* <Textarea placeholder="Enter description..." />
+* ```
+*/
+function Textarea({ className, slots, ...props }) {
+	return /* @__PURE__ */ jsx("textarea", {
+		"data-slot": "textarea",
+		className: cn(textareaStyles.root, slots?.root, className),
+		...props
+	});
+}
+
+//#endregion
+export { Textarea };

package/dist/react/ui/Tooltip/Tooltip.styles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Style definitions for the Tooltip component.
+ *
+ * Provides StyleSlots for each visual region. Uses only CSS variable
+ * utilities; never hard-coded color values.
+ *
+ * @module @mks2508/mks-ui/react/ui/Tooltip/Tooltip.styles
+ */
+import type { StyleSlots } from '../../../core/types';
+import type { TooltipSlot } from './Tooltip.types';
+/**
+ * Default Tailwind classes for each Tooltip visual region.
+ * Consumers override via the `slots` prop; the merge order is:
+ * `base -> slots -> className`.
+ *
+ * @example
+ * ```typescript
+ * import { tooltipStyles } from './Tooltip.styles';
+ * // tooltipStyles.popup => 'z-50 overflow-hidden rounded-md ...'
+ * ```
+ */
+export declare const tooltipStyles: StyleSlots<TooltipSlot>;
+//# sourceMappingURL=Tooltip.styles.d.ts.map

package/dist/react/ui/Tooltip/Tooltip.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.styles.d.ts","sourceRoot":"","sources":["../../../../src/react/ui/Tooltip/Tooltip.styles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,WAAW,CAmBjD,CAAC"}

package/dist/react/ui/Tooltip/Tooltip.styles.js

@@ -0,0 +1,26 @@
+//#region src/react/ui/Tooltip/Tooltip.styles.ts
+/**
+* Default Tailwind classes for each Tooltip visual region.
+* Consumers override via the `slots` prop; the merge order is:
+* `base -> slots -> className`.
+*
+* @example
+* ```typescript
+* import { tooltipStyles } from './Tooltip.styles';
+* // tooltipStyles.popup => 'z-50 overflow-hidden rounded-md ...'
+* ```
+*/
+const tooltipStyles = {
+	root: "",
+	popup: [
+		"z-50 overflow-hidden rounded-md",
+		"border border-border bg-popover px-3 py-1.5",
+		"text-sm text-popover-foreground shadow-md"
+	].join(" "),
+	trigger: "",
+	positioner: "",
+	arrow: "fill-popover"
+};
+
+//#endregion
+export { tooltipStyles };

package/dist/react/ui/Tooltip/Tooltip.types.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Type definitions for the Tooltip component.
+ *
+ * Provides all prop interfaces, slot types, context types, and configuration
+ * for the animated tooltip system built on Base UI and Motion.
+ *
+ * @module @mks2508/mks-ui/react/ui/Tooltip/Tooltip.types
+ */
+import type * as React from '../../../react';
+import type { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';
+import type { HTMLMotionProps, MotionValue, SpringOptions } from 'motion/react';
+import type { SlotOverrides, IBaseConfig } from '../../../core/types';
+/**
+ * Visual regions available for class-name overrides via the `slots` prop.
+ *
+ * @example
+ * ```tsx
+ * <TooltipPopup slots={{ popup: 'bg-primary text-primary-foreground' }} />
+ * ```
+ */
+export type TooltipSlot = 'root' | 'popup' | 'trigger' | 'positioner' | 'arrow';
+/**
+ * Extended configuration for the Tooltip component.
+ * Inherits base animation settings and adds tooltip-specific cursor-following options.
+ *
+ * @example
+ * ```typescript
+ * const config: ITooltipConfig = {
+ *   followCursor: 'x',
+ *   followCursorSpringOptions: { stiffness: 200, damping: 17 },
+ *   animation: { duration: 0.15 },
+ * };
+ * ```
+ */
+export interface ITooltipConfig extends IBaseConfig {
+    /**
+     * Whether the tooltip follows the cursor position.
+     * - `true` — follows on both axes
+     * - `'x'` — follows only horizontal movement
+     * - `'y'` — follows only vertical movement
+     * - `false` — static positioning (default)
+     *
+     * @defaultValue false
+     */
+    followCursor?: boolean | 'x' | 'y';
+    /**
+     * Spring physics options for the cursor-following animation.
+     * Only used when `followCursor` is enabled.
+     *
+     * @defaultValue `{ stiffness: 200, damping: 17 }`
+     */
+    followCursorSpringOptions?: SpringOptions;
+}
+/**
+ * Internal context type shared between Tooltip sub-components.
+ * Tracks open state, cursor position motion values, and follow-cursor settings.
+ *
+ * @example
+ * ```tsx
+ * const { isOpen, x, y, followCursor } = useTooltip();
+ * ```
+ */
+export type TooltipContextType = {
+    /** Whether the tooltip is currently open. */
+    isOpen: boolean;
+    /** Callback to change the open state. */
+    setIsOpen: ITooltipProps['onOpenChange'];
+    /** Motion value tracking horizontal cursor offset. */
+    x: MotionValue<number>;
+    /** Motion value tracking vertical cursor offset. */
+    y: MotionValue<number>;
+    /** Current follow-cursor mode. */
+    followCursor?: boolean | 'x' | 'y';
+    /** Spring physics options for cursor-following. */
+    followCursorSpringOptions?: SpringOptions;
+};
+/**
+ * Props for the root `Tooltip` component.
+ * Wraps Base UI Tooltip.Root with controlled-state support, context provider,
+ * and cursor-following motion values.
+ *
+ * @example
+ * ```tsx
+ * <Tooltip followCursor="x">
+ *   <TooltipTrigger>Hover me</TooltipTrigger>
+ *   <TooltipPortal>
+ *     <TooltipPositioner>
+ *       <TooltipPopup>Tooltip content</TooltipPopup>
+ *     </TooltipPositioner>
+ *   </TooltipPortal>
+ * </Tooltip>
+ * ```
+ */
+export interface ITooltipProps extends React.ComponentProps<typeof TooltipPrimitive.Root> {
+    /**
+     * Whether the tooltip follows the cursor position.
+     * @defaultValue false
+     */
+    followCursor?: boolean | 'x' | 'y';
+    /**
+     * Spring physics options for the cursor-following animation.
+     * @defaultValue `{ stiffness: 200, damping: 17 }`
+     */
+    followCursorSpringOptions?: SpringOptions;
+    /** Style slot overrides. */
+    slots?: SlotOverrides<TooltipSlot>;
+    /** Component configuration. */
+    config?: ITooltipConfig;
+}
+/**
+ * Props for the `TooltipProvider` component.
+ * Wraps Base UI Tooltip.Provider to set shared defaults for a group of tooltips.
+ *
+ * @example
+ * ```tsx
+ * <TooltipProvider delay={200}>
+ *   <Tooltip>...</Tooltip>
+ *   <Tooltip>...</Tooltip>
+ * </TooltipProvider>
+ * ```
+ */
+export interface ITooltipProviderProps extends React.ComponentProps<typeof TooltipPrimitive.Provider> {
+    /** Style slot overrides. */
+    slots?: SlotOverrides<TooltipSlot>;
+}
+/**
+ * Props for the `TooltipTrigger` component.
+ * Renders the element that shows the tooltip on hover/focus.
+ *
+ * @example
+ * ```tsx
+ * <TooltipTrigger>
+ *   <Button>Hover me</Button>
+ * </TooltipTrigger>
+ * ```
+ */
+export interface ITooltipTriggerProps extends React.ComponentProps<typeof TooltipPrimitive.Trigger> {
+    /** Style slot overrides. */
+    slots?: SlotOverrides<TooltipSlot>;
+}
+/**
+ * Props for the `TooltipPortal` component.
+ * Renders children into a React portal with AnimatePresence for exit animations.
+ * The `keepMounted` prop is handled internally and cannot be overridden.
+ *
+ * @example
+ * ```tsx
+ * <TooltipPortal>
+ *   <TooltipPositioner>
+ *     <TooltipPopup>...</TooltipPopup>
+ *   </TooltipPositioner>
+ * </TooltipPortal>
+ * ```
+ */
+export interface ITooltipPortalProps extends Omit<React.ComponentProps<typeof TooltipPrimitive.Portal>, 'keepMounted'> {
+    /** Style slot overrides. */
+    slots?: SlotOverrides<TooltipSlot>;
+}
+/**
+ * Props for the `TooltipPositioner` component.
+ * Handles automatic positioning relative to the trigger.
+ *
+ * @example
+ * ```tsx
+ * <TooltipPositioner sideOffset={4}>
+ *   <TooltipPopup>Content</TooltipPopup>
+ * </TooltipPositioner>
+ * ```
+ */
+export interface ITooltipPositionerProps extends React.ComponentProps<typeof TooltipPrimitive.Positioner> {
+    /** Style slot overrides. */
+    slots?: SlotOverrides<TooltipSlot>;
+}
+/**
+ * Props for the `TooltipPopup` component.
+ * The main content container with scale entrance animation.
+ * Supports cursor-following via spring-animated motion values.
+ *
+ * @example
+ * ```tsx
+ * <TooltipPopup className="px-3 py-1.5 text-sm">
+ *   Helpful information
+ * </TooltipPopup>
+ * ```
+ */
+export interface ITooltipPopupProps extends Omit<Omit<React.ComponentProps<typeof TooltipPrimitive.Popup>, 'render'>, keyof HTMLMotionProps<'div'>>, HTMLMotionProps<'div'> {
+    /** Style slot overrides. */
+    slots?: SlotOverrides<TooltipSlot>;
+}
+/**
+ * Props for the `TooltipArrow` component.
+ * Renders a directional arrow pointing toward the trigger.
+ *
+ * @example
+ * ```tsx
+ * <TooltipArrow className="fill-primary" />
+ * ```
+ */
+export interface ITooltipArrowProps extends React.ComponentProps<typeof TooltipPrimitive.Arrow> {
+    /** Style slot overrides. */
+    slots?: SlotOverrides<TooltipSlot>;
+}
+//# sourceMappingURL=Tooltip.types.d.ts.map

package/dist/react/ui/Tooltip/Tooltip.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.types.d.ts","sourceRoot":"","sources":["../../../../src/react/ui/Tooltip/Tooltip.types.ts"],"names":[],"mappings":"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"}