entangle-ui 0.2.0 → 0.4.0

package/dist/types/components/primitives/Text/Text.d.ts

@@ -0,0 +1,444 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+
+/**
+ * HTML element types that Text component can render as
+ */
+type TextElement = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span' | 'div' | 'label' | 'strong' | 'em' | 'small';
+/**
+ * Semantic text variants optimized for editor interfaces
+ */
+type TextVariant = 'display' | 'heading' | 'subheading' | 'body' | 'caption' | 'code' | 'inherit';
+/**
+ * Text size using theme typography tokens
+ */
+type TextSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * Text weight using theme typography tokens
+ */
+type TextWeight = 'normal' | 'medium' | 'semibold';
+/**
+ * Text color using theme color tokens
+ */
+type TextColor = 'primary' | 'secondary' | 'muted' | 'disabled' | 'accent' | 'success' | 'warning' | 'error';
+/**
+ * Text alignment options
+ */
+type TextAlign = 'left' | 'center' | 'right' | 'justify';
+/**
+ * Line height using theme typography tokens
+ */
+type TextLineHeight = 'tight' | 'normal' | 'relaxed';
+/**
+ * Base props for Text component
+ */
+interface TextBaseProps extends Omit<React.HTMLAttributes<HTMLElement>, 'css' | 'color'> {
+    /**
+     * Text content
+     */
+    children: React.ReactNode;
+    /**
+     * HTML element to render as
+     * @default "span"
+     */
+    as?: TextElement;
+    /**
+     * Semantic variant with predefined styling
+     * - `display`: Large text for main titles (xl size, semibold weight)
+     * - `heading`: Section headings (lg size, medium weight)
+     * - `subheading`: Subsection headings (md size, medium weight)
+     * - `body`: Standard body text (sm size, normal weight)
+     * - `caption`: Small descriptive text (xs size, normal weight)
+     * - `code`: Monospace text for code (sm size, mono font)
+     * - `inherit`: Inherit typography from parent
+     * @default "body"
+     */
+    variant?: TextVariant;
+    /**
+     * Text size using theme typography tokens
+     * Overrides variant size if specified
+     */
+    size?: TextSize;
+    /**
+     * Text weight using theme typography tokens
+     * Overrides variant weight if specified
+     */
+    weight?: TextWeight;
+    /**
+     * Text color using theme color tokens
+     * @default "primary"
+     */
+    color?: TextColor;
+    /**
+     * Line height using theme typography tokens
+     * Overrides variant line height if specified
+     */
+    lineHeight?: TextLineHeight;
+    /**
+     * Text alignment
+     */
+    align?: TextAlign;
+    /**
+     * Whether to truncate text with ellipsis on overflow
+     * @default false
+     */
+    truncate?: boolean;
+    /**
+     * Maximum number of lines before truncating (requires truncate=true)
+     * Single line truncation if not specified
+     */
+    maxLines?: number;
+    /**
+     * Whether text should not wrap to next line
+     * @default false
+     */
+    nowrap?: boolean;
+    /**
+     * Whether to use monospace font family
+     * Automatically true for 'code' variant
+     * @default false
+     */
+    mono?: boolean;
+    /**
+     * Additional CSS class name
+     */
+    className?: string;
+    /**
+     * Test identifier for automated testing
+     */
+    testId?: string;
+    ref?: React.Ref<HTMLElement>;
+}
+/**
+ * Props for the Text component with prettified type for better IntelliSense
+ */
+type TextProps = Prettify<TextBaseProps>;
+/**
+ * A versatile text component for consistent typography in editor interfaces.
+ *
+ * Provides semantic variants, flexible sizing, and comprehensive text styling
+ * options optimized for professional editor UIs. Uses theme typography tokens
+ * for consistent spacing and sizing across the application.
+ *
+ * @example
+ * ```tsx
+ * // Semantic variants
+ * <Text variant="display">Main Title</Text>
+ * <Text variant="heading">Section Heading</Text>
+ * <Text variant="body">Regular paragraph text</Text>
+ * <Text variant="caption">Small helper text</Text>
+ * <Text variant="code">console.log('hello')</Text>
+ *
+ * // Custom sizing and colors
+ * <Text size="lg" weight="semibold" color="accent">
+ *   Custom styled text
+ * </Text>
+ *
+ * // With truncation
+ * <Text truncate maxLines={2}>
+ *   Long text that will be truncated after two lines...
+ * </Text>
+ *
+ * // Different HTML elements
+ * <Text as="h1" variant="display">Page Title</Text>
+ * <Text as="p" variant="body">Paragraph content</Text>
+ * <Text as="label" variant="caption">Form label</Text>
+ * ```
+ */
+declare const Text: React.NamedExoticComponent<{
+    children: React.ReactNode;
+    as?: TextElement | undefined;
+    variant?: TextVariant | undefined;
+    size?: TextSize | undefined;
+    weight?: TextWeight | undefined;
+    color?: TextColor | undefined;
+    lineHeight?: TextLineHeight | undefined;
+    align?: TextAlign | undefined;
+    truncate?: boolean | undefined;
+    maxLines?: number | undefined;
+    nowrap?: boolean | undefined;
+    mono?: boolean | undefined;
+    className?: string | undefined;
+    testId?: string | undefined;
+    ref?: React.Ref<HTMLElement> | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
+    id?: string | undefined | undefined;
+    style?: React.CSSProperties | undefined;
+    defaultChecked?: boolean | undefined | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined | undefined;
+    suppressHydrationWarning?: boolean | undefined | undefined;
+    accessKey?: string | undefined | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+    autoFocus?: boolean | undefined | undefined;
+    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined | undefined;
+    dir?: string | undefined | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+    hidden?: boolean | undefined | undefined;
+    lang?: string | undefined | undefined;
+    nonce?: string | undefined | undefined;
+    slot?: string | undefined | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    tabIndex?: number | undefined | undefined;
+    title?: string | undefined | undefined;
+    translate?: "yes" | "no" | undefined | undefined;
+    radioGroup?: string | undefined | undefined;
+    role?: React.AriaRole | undefined;
+    about?: string | undefined | undefined;
+    content?: string | undefined | undefined;
+    datatype?: string | undefined | undefined;
+    inlist?: any;
+    prefix?: string | undefined | undefined;
+    property?: string | undefined | undefined;
+    rel?: string | undefined | undefined;
+    resource?: string | undefined | undefined;
+    rev?: string | undefined | undefined;
+    typeof?: string | undefined | undefined;
+    vocab?: string | undefined | undefined;
+    autoCorrect?: string | undefined | undefined;
+    autoSave?: string | undefined | undefined;
+    itemProp?: string | undefined | undefined;
+    itemScope?: boolean | undefined | undefined;
+    itemType?: string | undefined | undefined;
+    itemID?: string | undefined | undefined;
+    itemRef?: string | undefined | undefined;
+    results?: number | undefined | undefined;
+    security?: string | undefined | undefined;
+    unselectable?: "on" | "off" | undefined | undefined;
+    popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
+    popoverTarget?: string | undefined | undefined;
+    inert?: boolean | undefined | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+    is?: string | undefined | undefined;
+    exportparts?: string | undefined | undefined;
+    part?: string | undefined | undefined;
+    "aria-activedescendant"?: string | undefined | undefined;
+    "aria-atomic"?: (boolean | "true" | "false") | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
+    "aria-braillelabel"?: string | undefined | undefined;
+    "aria-brailleroledescription"?: string | undefined | undefined;
+    "aria-busy"?: (boolean | "true" | "false") | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-colcount"?: number | undefined | undefined;
+    "aria-colindex"?: number | undefined | undefined;
+    "aria-colindextext"?: string | undefined | undefined;
+    "aria-colspan"?: number | undefined | undefined;
+    "aria-controls"?: string | undefined | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+    "aria-describedby"?: string | undefined | undefined;
+    "aria-description"?: string | undefined | undefined;
+    "aria-details"?: string | undefined | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+    "aria-errormessage"?: string | undefined | undefined;
+    "aria-expanded"?: (boolean | "true" | "false") | undefined;
+    "aria-flowto"?: string | undefined | undefined;
+    "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
+    "aria-hidden"?: (boolean | "true" | "false") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+    "aria-keyshortcuts"?: string | undefined | undefined;
+    "aria-label"?: string | undefined | undefined;
+    "aria-labelledby"?: string | undefined | undefined;
+    "aria-level"?: number | undefined | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+    "aria-modal"?: (boolean | "true" | "false") | undefined;
+    "aria-multiline"?: (boolean | "true" | "false") | undefined;
+    "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+    "aria-owns"?: string | undefined | undefined;
+    "aria-placeholder"?: string | undefined | undefined;
+    "aria-posinset"?: number | undefined | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-readonly"?: (boolean | "true" | "false") | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
+    "aria-required"?: (boolean | "true" | "false") | undefined;
+    "aria-roledescription"?: string | undefined | undefined;
+    "aria-rowcount"?: number | undefined | undefined;
+    "aria-rowindex"?: number | undefined | undefined;
+    "aria-rowindextext"?: string | undefined | undefined;
+    "aria-rowspan"?: number | undefined | undefined;
+    "aria-selected"?: (boolean | "true" | "false") | undefined;
+    "aria-setsize"?: number | undefined | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+    "aria-valuemax"?: number | undefined | undefined;
+    "aria-valuemin"?: number | undefined | undefined;
+    "aria-valuenow"?: number | undefined | undefined;
+    "aria-valuetext"?: string | undefined | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined | undefined;
+    onCopy?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onCopyCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onCut?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onCutCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onPaste?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onPasteCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onCompositionEnd?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionEndCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionStart?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionStartCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionUpdate?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onFocus?: React.FocusEventHandler<HTMLElement> | undefined;
+    onFocusCapture?: React.FocusEventHandler<HTMLElement> | undefined;
+    onBlur?: React.FocusEventHandler<HTMLElement> | undefined;
+    onBlurCapture?: React.FocusEventHandler<HTMLElement> | undefined;
+    onChange?: React.ChangeEventHandler<HTMLElement, Element> | undefined;
+    onChangeCapture?: React.ChangeEventHandler<HTMLElement, Element> | undefined;
+    onBeforeInput?: React.InputEventHandler<HTMLElement> | undefined;
+    onBeforeInputCapture?: React.InputEventHandler<HTMLElement> | undefined;
+    onInput?: React.InputEventHandler<HTMLElement> | undefined;
+    onInputCapture?: React.InputEventHandler<HTMLElement> | undefined;
+    onReset?: React.ReactEventHandler<HTMLElement> | undefined;
+    onResetCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSubmit?: React.SubmitEventHandler<HTMLElement> | undefined;
+    onSubmitCapture?: React.SubmitEventHandler<HTMLElement> | undefined;
+    onInvalid?: React.ReactEventHandler<HTMLElement> | undefined;
+    onInvalidCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoad?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onError?: React.ReactEventHandler<HTMLElement> | undefined;
+    onErrorCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onKeyDown?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyDownCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyPress?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyPressCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyUp?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyUpCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onAbort?: React.ReactEventHandler<HTMLElement> | undefined;
+    onAbortCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlay?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayThrough?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayThroughCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onDurationChange?: React.ReactEventHandler<HTMLElement> | undefined;
+    onDurationChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEmptied?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEmptiedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEncrypted?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEncryptedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEnded?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEndedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedData?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedDataCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedMetadata?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedMetadataCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadStart?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadStartCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPause?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPauseCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlay?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlayCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlaying?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlayingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onProgress?: React.ReactEventHandler<HTMLElement> | undefined;
+    onProgressCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onRateChange?: React.ReactEventHandler<HTMLElement> | undefined;
+    onRateChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeeked?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeekedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeeking?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeekingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onStalled?: React.ReactEventHandler<HTMLElement> | undefined;
+    onStalledCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSuspend?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSuspendCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onTimeUpdate?: React.ReactEventHandler<HTMLElement> | undefined;
+    onTimeUpdateCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onVolumeChange?: React.ReactEventHandler<HTMLElement> | undefined;
+    onVolumeChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onWaiting?: React.ReactEventHandler<HTMLElement> | undefined;
+    onWaitingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onAuxClick?: React.MouseEventHandler<HTMLElement> | undefined;
+    onAuxClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onClick?: React.MouseEventHandler<HTMLElement> | undefined;
+    onClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onContextMenu?: React.MouseEventHandler<HTMLElement> | undefined;
+    onContextMenuCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onDoubleClick?: React.MouseEventHandler<HTMLElement> | undefined;
+    onDoubleClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onDrag?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEnd?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEndCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEnter?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEnterCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragExit?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragExitCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragLeave?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragLeaveCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragOver?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragOverCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragStart?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragStartCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDrop?: React.DragEventHandler<HTMLElement> | undefined;
+    onDropCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onMouseDown?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseDownCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseEnter?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseLeave?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseMove?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseMoveCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOut?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOutCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOver?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOverCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseUp?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseUpCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onSelect?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSelectCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onTouchCancel?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchCancelCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchEnd?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchEndCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchMove?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchMoveCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchStart?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchStartCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onPointerDown?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerDownCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerMove?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerMoveCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerUp?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerUpCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerCancel?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerCancelCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerEnter?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerLeave?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOver?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOverCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOut?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOutCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onGotPointerCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onLostPointerCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onScroll?: React.UIEventHandler<HTMLElement> | undefined;
+    onScrollCapture?: React.UIEventHandler<HTMLElement> | undefined;
+    onScrollEnd?: React.UIEventHandler<HTMLElement> | undefined;
+    onScrollEndCapture?: React.UIEventHandler<HTMLElement> | undefined;
+    onWheel?: React.WheelEventHandler<HTMLElement> | undefined;
+    onWheelCapture?: React.WheelEventHandler<HTMLElement> | undefined;
+    onAnimationStart?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationStartCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationEnd?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationEndCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationIteration?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationIterationCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onToggle?: React.ToggleEventHandler<HTMLElement> | undefined;
+    onBeforeToggle?: React.ToggleEventHandler<HTMLElement> | undefined;
+    onTransitionCancel?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionCancelCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionEnd?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionEndCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionRun?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionRunCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionStart?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionStartCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+}>;
+
+export { Text };
+export type { TextAlign, TextBaseProps, TextColor, TextElement, TextLineHeight, TextProps, TextSize, TextVariant, TextWeight };

package/dist/types/components/primitives/Tooltip/Tooltip.d.ts

@@ -0,0 +1,179 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+import { TooltipPlacement, TooltipCollisionStrategy, TooltipCollisionConfig, TooltipPositioner, TooltipAnimation, BaseTooltipRootProps, BaseTooltipPositionerProps } from './types.js';
+
+interface TooltipBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'css' | 'title'> {
+    /**
+     * The trigger element that will show the tooltip on hover.
+     * Must be a single React element or component.
+     *
+     * @example
+     * <Button>Hover me</Button>
+     * <IconButton><SaveIcon /></IconButton>
+     */
+    children: React.ReactElement;
+    /**
+     * The content to display in the tooltip.
+     * Can be simple text or a complex React node for advanced customization.
+     *
+     * @example
+     * "Save file"
+     * <div><strong>Save</strong><br />Ctrl+S</div>
+     */
+    title: React.ReactNode;
+    /**
+     * Intuitive placement similar to MUI
+     * @default "top"
+     */
+    placement?: TooltipPlacement;
+    /**
+     * Collision handling strategy
+     * @default "smart"
+     */
+    collision?: TooltipCollisionStrategy;
+    /**
+     * Advanced collision configuration for power users
+     * When provided, overrides the collision strategy
+     */
+    collisionConfig?: TooltipCollisionConfig;
+    /**
+     * Advanced positioning configuration
+     */
+    positioner?: TooltipPositioner;
+    /**
+     * Animation configuration
+     */
+    animation?: TooltipAnimation;
+    /**
+     * Delay in milliseconds before showing the tooltip
+     * @default 600
+     */
+    delay?: number;
+    /**
+     * Delay in milliseconds before hiding the tooltip
+     * @default 0
+     */
+    closeDelay?: number;
+    /**
+     * Whether to show the arrow pointing to the trigger
+     * @default true
+     */
+    arrow?: boolean;
+    /**
+     * Whether the tooltip is disabled
+     * When true, tooltip will not appear
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Direct props passed to Base UI Root component
+     * For power users who need full control
+     */
+    rootProps?: Partial<BaseTooltipRootProps>;
+    /**
+     * Direct props passed to Base UI Positioner component
+     * For power users who need full control
+     */
+    positionerProps?: Partial<BaseTooltipPositionerProps>;
+    /**
+     * Test identifier for automated testing
+     */
+    testId?: string;
+    ref?: React.Ref<HTMLDivElement>;
+}
+/**
+ * Props for the Tooltip component with prettified type for better IntelliSense
+ */
+type TooltipProps = Prettify<TooltipBaseProps>;
+/**
+ * A tooltip component that displays contextual information on hover.
+ *
+ * Built on @base-ui/react for robust accessibility and positioning.
+ * Provides an intuitive API similar to MUI with advanced positioning and collision handling.
+ * Supports both simple text and complex React nodes for advanced tooltip content.
+ *
+ * @example
+ * ```tsx
+ * // Simple text tooltip
+ * <Tooltip title="Save your work">
+ *   <Button>Save</Button>
+ * </Tooltip>
+ *
+ * // Intuitive positioning (MUI-style)
+ * <Tooltip placement="bottom-start" title="Menu options">
+ *   <IconButton><MenuIcon /></IconButton>
+ * </Tooltip>
+ *
+ * // Intelligent collision handling (new default)
+ * <Tooltip collision="smart" title="Intelligent positioning">
+ *   <Button>Smart tooltip</Button>
+ * </Tooltip>
+ *
+ * // Advanced collision configuration
+ * <Tooltip
+ *   collisionConfig={{
+ *     side: 'flip',
+ *     align: 'shift',
+ *     fallbackAxisSide: 'start',
+ *     hideWhenDetached: true
+ *   }}
+ *   title="Custom collision handling"
+ * >
+ *   <Button>Advanced collision</Button>
+ * </Tooltip>
+ *
+ * // Advanced positioning
+ * <Tooltip
+ *   positioner={{
+ *     offset: 12,
+ *     padding: 10,
+ *     sticky: true,
+ *     boundary: '#container'
+ *   }}
+ *   title="Advanced positioning"
+ * >
+ *   <Button>Advanced</Button>
+ * </Tooltip>
+ *
+ * // Custom animations
+ * <Tooltip
+ *   animation={{
+ *     animated: true,
+ *     duration: 300,
+ *     easing: 'ease-in-out'
+ *   }}
+ *   title="Custom animation"
+ * >
+ *   <Button>Animated</Button>
+ * </Tooltip>
+ *
+ * // Interactive tooltip
+ * <Tooltip
+ *   hoverable={true}
+ *   closeDelay={300}
+ *   title={
+ *     <div>
+ *       <strong>Interactive Content</strong>
+ *       <br />
+ *       <button>Click me</button>
+ *     </div>
+ *   }
+ * >
+ *   <Button>Hoverable tooltip</Button>
+ * </Tooltip>
+ *
+ * // Full control with raw props
+ * <Tooltip
+ *   arrow={false}
+ *   rootProps={{ trackCursorAxis: 'x' }}
+ *   positionerProps={{ arrowPadding: 20 }}
+ *   title="Full control"
+ * >
+ *   <Button>Power user</Button>
+ * </Tooltip>
+ * ```
+ */
+declare const Tooltip: React.FC<TooltipProps>;
+
+export { Tooltip };
+export type { TooltipProps };