@tribepad/themis 1.0.0

package/dist/elements/Toast/Toast.types.d.ts

@@ -0,0 +1,209 @@
+import { z } from 'zod';
+import type { ReactNode } from 'react';
+/**
+ * Toast Component Type Definitions
+ *
+ * @see toast-prd.md - Product Requirements Document
+ * @see plan.md - Implementation Plan
+ * @see constitution.md Principle IV (Accessibility First - WCAG 2.2 AAA)
+ */
+/**
+ * Reason why a toast was dismissed
+ * - 'timeout': Auto-dismissed after timeout period
+ * - 'user': User clicked close button or swiped to dismiss
+ * - 'programmatic': Closed via toastQueue.close() or toastQueue.closeAll()
+ */
+export declare const DismissReasonSchema: z.ZodEnum<{
+    user: "user";
+    timeout: "timeout";
+    programmatic: "programmatic";
+}>;
+export type DismissReason = z.infer<typeof DismissReasonSchema>;
+/**
+ * Toast visual variants matching the Themis theme system
+ * Each variant maps to specific theme tokens for background/foreground colors
+ *
+ * @see toast-prd.md Variant Token Mapping table
+ */
+export declare const ToastVariantSchema: z.ZodEnum<{
+    default: "default";
+    primary: "primary";
+    accent: "accent";
+    destructive: "destructive";
+}>;
+export type ToastVariant = z.infer<typeof ToastVariantSchema>;
+/**
+ * Toast region positioning options
+ * Toasts appear in a fixed position on the viewport
+ */
+export declare const ToasterPositionSchema: z.ZodEnum<{
+    "top-right": "top-right";
+    "top-left": "top-left";
+    "bottom-right": "bottom-right";
+    "bottom-left": "bottom-left";
+    "top-center": "top-center";
+    "bottom-center": "bottom-center";
+}>;
+export type ToasterPosition = z.infer<typeof ToasterPositionSchema>;
+/**
+ * Options for creating a toast notification
+ *
+ * @example
+ * ```tsx
+ * toast("Message", {
+ *   variant: "primary",
+ *   timeout: 8000,
+ *   onClose: (key, reason) => console.log(`Toast ${key} closed: ${reason}`)
+ * });
+ * ```
+ */
+export declare const ToastOptionsSchema: z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<{
+        default: "default";
+        primary: "primary";
+        accent: "accent";
+        destructive: "destructive";
+    }>>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    onClose: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+}, z.core.$strip>;
+/**
+ * Inferred type from Zod schema
+ * Note: onClose is typed as generic function in Zod, but we override with proper signature below
+ */
+type ToastOptionsBase = z.infer<typeof ToastOptionsSchema>;
+/**
+ * Toast options with properly typed onClose callback
+ */
+export type ToastOptions = Omit<ToastOptionsBase, 'onClose'> & {
+    /**
+     * Callback fired when toast is dismissed
+     * @param key - Unique identifier of the toast
+     * @param reason - Why the toast was dismissed
+     */
+    onClose?: (key: string, reason: DismissReason) => void;
+};
+/**
+ * Props for the ToastProvider component
+ * Wraps the application to provide toast queue context
+ *
+ * @example
+ * ```tsx
+ * <ToastProvider maxVisibleToasts={3}>
+ *   <App />
+ *   <Toaster position="bottom-right" />
+ * </ToastProvider>
+ * ```
+ */
+export declare const ToastProviderPropsSchema: z.ZodObject<{
+    maxVisibleToasts: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ToastProviderProps = z.infer<typeof ToastProviderPropsSchema> & {
+    /** Child components that can trigger toasts */
+    children: ReactNode;
+};
+/**
+ * Props for the Toaster component (toast region container)
+ * Renders the toast region with positioning and accessibility attributes
+ *
+ * @example
+ * ```tsx
+ * <Toaster
+ *   position="bottom-right"
+ *   aria-label="Notifications"
+ *   className="custom-toast-region"
+ * />
+ * ```
+ */
+export declare const ToasterPropsSchema: z.ZodObject<{
+    position: z.ZodDefault<z.ZodEnum<{
+        "top-right": "top-right";
+        "top-left": "top-left";
+        "bottom-right": "bottom-right";
+        "bottom-left": "bottom-left";
+        "top-center": "top-center";
+        "bottom-center": "bottom-center";
+    }>>;
+    'aria-label': z.ZodDefault<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ToasterProps = z.infer<typeof ToasterPropsSchema>;
+/**
+ * Internal toast state stored in the queue
+ * Contains all information needed to render and manage a toast
+ */
+export interface ToastState {
+    /** Unique identifier for the toast */
+    key: string;
+    /** Content to render inside the toast (ReactNode or string) */
+    content: ReactNode;
+    /** Visual variant for styling */
+    variant: ToastVariant;
+    /** Auto-dismiss timeout in milliseconds (0 = persistent) */
+    timeout: number;
+    /** Callback fired when toast is dismissed */
+    onClose?: (key: string, reason: DismissReason) => void;
+}
+/**
+ * Toast content type - fully customizable by developer
+ * Can be a simple string or complex ReactNode with custom layout
+ */
+export type ToastContent = ReactNode;
+/**
+ * Props for the internal ToastItem component
+ */
+export interface ToastItemProps {
+    /** Toast state from the queue */
+    toast: {
+        key: string;
+        content: ToastState;
+        animation: 'entering' | 'queued' | 'exiting';
+        priority: number;
+    };
+    /** Toast queue state for managing dismissal */
+    state: {
+        close: (key: string) => void;
+    };
+}
+/**
+ * Public API for the toast queue
+ * Allows programmatic control of toasts from anywhere in the app
+ */
+export interface ToastQueueAPI {
+    /**
+     * Add a new toast to the queue
+     * @param content - Content to display in the toast
+     * @param options - Toast configuration options
+     * @returns Unique key for the created toast
+     */
+    add: (content: ToastContent, options?: Partial<ToastOptions>) => string;
+    /**
+     * Close a specific toast by key
+     * @param key - Unique identifier of the toast to close
+     */
+    close: (key: string) => void;
+    /**
+     * Close all toasts (visible and queued)
+     */
+    closeAll: () => void;
+    /**
+     * Pause all toast timers
+     * Useful when user is interacting with the toast region
+     */
+    pauseAll: () => void;
+    /**
+     * Resume all paused toast timers
+     */
+    resumeAll: () => void;
+}
+/**
+ * Configuration for the toast() function
+ * Partial version of ToastOptions for convenience
+ */
+export type ToastConfig = Partial<ToastOptions>;
+/**
+ * Return type of the toast() function
+ */
+export type ToastKey = string;
+export {};
+//# sourceMappingURL=Toast.types.d.ts.map

package/dist/elements/Toast/Toast.types.d.ts.map

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

package/dist/elements/Toast/ToastProvider.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ToastProvider Component
+ * Provides toast queue context for the application
+ *
+ * @see toast-prd.md - Product Requirements Document
+ * @see plan.md - Implementation Plan
+ */
+import { type ReactNode } from 'react';
+import { ToastQueue } from 'react-stately';
+import type { ToastState, ToastProviderProps } from './Toast.types';
+/**
+ * Context for the toast queue
+ * Allows child components to access the toast queue state
+ */
+export declare const ToastContext: import("react").Context<ToastQueue<ToastState> | null>;
+/**
+ * Hook to access the toast queue from context
+ * @returns The toast queue instance
+ * @throws Error if used outside ToastProvider
+ */
+export declare function useToastQueue(): ToastQueue<ToastState>;
+/**
+ * ToastProvider - Wraps application to provide toast functionality
+ *
+ * @example
+ * ```tsx
+ * <ToastProvider maxVisibleToasts={3}>
+ *   <App />
+ *   <Toaster position="bottom-right" />
+ * </ToastProvider>
+ * ```
+ */
+export declare function ToastProvider({ children, maxVisibleToasts, }: ToastProviderProps): ReactNode;
+export declare namespace ToastProvider {
+    var displayName: string;
+}
+//# sourceMappingURL=ToastProvider.d.ts.map

package/dist/elements/Toast/ToastProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToastProvider.d.ts","sourceRoot":"","sources":["../../../src/elements/Toast/ToastProvider.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAQpE;;;GAGG;AACH,eAAO,MAAM,YAAY,wDAAqD,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAAC,UAAU,CAAC,CAMtD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,gBAAoB,GACrB,EAAE,kBAAkB,GAAG,SAAS,CAgBhC;yBAnBe,aAAa"}

package/dist/elements/Toast/Toaster.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Toaster - Toast region container
+ * Renders the toast notification area with proper ARIA attributes
+ *
+ * @example
+ * ```tsx
+ * <ToastProvider>
+ *   <App />
+ *   <Toaster position="bottom-right" aria-label="Notifications" />
+ * </ToastProvider>
+ * ```
+ */
+export declare const Toaster: import("react").NamedExoticComponent<{
+    position: "top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center" | "bottom-center";
+    'aria-label': string;
+    className?: string | undefined;
+} & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Toaster.d.ts.map

package/dist/elements/Toast/Toaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toaster.d.ts","sourceRoot":"","sources":["../../../src/elements/Toast/Toaster.tsx"],"names":[],"mappings":"AAkFA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO;;;;kDA6EnB,CAAC"}

package/dist/elements/Toast/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Toast Component - Accessible notification system
+ *
+ * @see toast-prd.md for full documentation
+ * @see plan.md for implementation details
+ *
+ * @example
+ * ```tsx
+ * import { toast, toastQueue, ToastProvider, Toaster } from '@tribepad/themis/elements/Toast';
+ *
+ * // Setup in app root
+ * <ToastProvider>
+ *   <App />
+ *   <Toaster position="bottom-right" />
+ * </ToastProvider>
+ *
+ * // Trigger from anywhere
+ * toast("Message saved!");
+ * toast("Error occurred", { variant: "destructive" });
+ * ```
+ */
+export { toast, toastQueue, toastVariants, toasterVariants } from './Toast';
+export { ToastProvider } from './ToastProvider';
+export { Toaster } from './Toaster';
+export type { ToastOptions, ToastContent, ToasterProps, ToastProviderProps, ToastVariant, ToasterPosition, DismissReason, ToastKey, ToastConfig, ToastQueueAPI, } from './Toast.types';
+export { ToastOptionsSchema, ToasterPropsSchema, ToastProviderPropsSchema, ToastVariantSchema, ToasterPositionSchema, DismissReasonSchema, } from './Toast.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/Toast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/Toast/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG5E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,QAAQ,EACR,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

package/dist/elements/Toast/index.js

@@ -0,0 +1,60 @@
+'use strict';
+
+var chunkR7XUIV25_js = require('../../chunk-R7XUIV25.js');
+require('../../chunk-3YOY2VJ6.js');
+require('../../chunk-Y3GT7ETK.js');
+require('../../chunk-B5Q4UPL6.js');
+require('../../chunk-VIREG536.js');
+
+
+
+Object.defineProperty(exports, "DismissReasonSchema", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.DismissReasonSchema; }
+});
+Object.defineProperty(exports, "ToastOptionsSchema", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.ToastOptionsSchema; }
+});
+Object.defineProperty(exports, "ToastProvider", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.ToastProvider; }
+});
+Object.defineProperty(exports, "ToastProviderPropsSchema", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.ToastProviderPropsSchema; }
+});
+Object.defineProperty(exports, "ToastVariantSchema", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.ToastVariantSchema; }
+});
+Object.defineProperty(exports, "Toaster", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.Toaster; }
+});
+Object.defineProperty(exports, "ToasterPositionSchema", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.ToasterPositionSchema; }
+});
+Object.defineProperty(exports, "ToasterPropsSchema", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.ToasterPropsSchema; }
+});
+Object.defineProperty(exports, "toast", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.toast; }
+});
+Object.defineProperty(exports, "toastQueue", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.toastQueue; }
+});
+Object.defineProperty(exports, "toastVariants", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.toastVariants; }
+});
+Object.defineProperty(exports, "toasterVariants", {
+  enumerable: true,
+  get: function () { return chunkR7XUIV25_js.toasterVariants; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/elements/Toast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/elements/Toast/index.mjs

@@ -0,0 +1,7 @@
+export { DismissReasonSchema, ToastOptionsSchema, ToastProvider, ToastProviderPropsSchema, ToastVariantSchema, Toaster, ToasterPositionSchema, ToasterPropsSchema, toast, toastQueue, toastVariants, toasterVariants } from '../../chunk-WNURH5OO.mjs';
+import '../../chunk-BDXKKMBZ.mjs';
+import '../../chunk-FPKEAJRZ.mjs';
+import '../../chunk-HK46BT5U.mjs';
+import '../../chunk-E2KQFV3O.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/elements/Toast/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/elements/Tooltip/Tooltip.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Tooltip Component - Implementation
+ *
+ * Accessible tooltip component combining React Aria primitives with ShadCN styling.
+ * Follows Themis library patterns with compound component structure.
+ *
+ * @see plan.md (Implementation plan)
+ * @see Tooltip.types.ts (Zod schemas)
+ * @see tooltip-prd.md (Full requirements)
+ */
+import { type ReactElement } from 'react';
+import type { TooltipProps, TooltipTriggerProps, TooltipContentProps, TooltipArrowProps } from './Tooltip.types';
+/**
+ * CVA Variants for TooltipContent
+ *
+ * Placement-based animations and high-contrast inverted colors.
+ *
+ * @see plan.md (CVA Variant Structure)
+ * @see tooltip-prd.md US-2 (Configurable Placement)
+ */
+export declare const tooltipContentVariants: (props?: ({
+    side?: "top" | "bottom" | "left" | "right" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * CVA Variants for TooltipArrow
+ *
+ * Rotation based on placement for correct arrow pointing direction.
+ *
+ * @see tooltip-prd.md US-2 (Arrow Indicator)
+ */
+export declare const tooltipArrowVariants: (props?: ({
+    side?: "top" | "bottom" | "left" | "right" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Tooltip Root Component
+ *
+ * Manages tooltip open/close state, delays, and trigger behavior.
+ * Wraps React Aria's TooltipTrigger with delay configuration.
+ *
+ * @see tooltip-prd.md US-1 (Basic Usage)
+ * @see tooltip-prd.md US-3 (Delay Configuration)
+ * @see tooltip-prd.md US-7 (Controlled State)
+ */
+declare function TooltipRoot({ children, delay, closeDelay, trigger, isOpen, defaultOpen, onOpenChange, isDisabled, }: TooltipProps): ReactElement;
+declare namespace TooltipRoot {
+    var displayName: string;
+}
+/**
+ * TooltipTrigger Component
+ *
+ * Wrapper for the element that triggers the tooltip.
+ * The child element must be focusable (or wrapped with Focusable).
+ *
+ * React Aria's TooltipTrigger automatically applies:
+ * - aria-describedby linking to tooltip
+ * - Hover and focus event handlers
+ *
+ * @see tooltip-prd.md US-5 (Non-Button Triggers)
+ */
+declare function TooltipTriggerComponent({ children, }: TooltipTriggerProps): ReactElement;
+declare namespace TooltipTriggerComponent {
+    var displayName: string;
+}
+/**
+ * TooltipContent Component
+ *
+ * The actual tooltip overlay that appears.
+ * Supports placement, offset, and optional arrow.
+ *
+ * @see tooltip-prd.md US-2 (Placement and Arrow)
+ * @see tooltip-prd.md Technical Implementation Details
+ */
+declare function TooltipContentComponent({ children, side, sideOffset, alignOffset, shouldFlip, showArrow, arrowSize, className, ...restProps }: TooltipContentProps & {
+    'data-testid'?: string;
+}): ReactElement;
+declare namespace TooltipContentComponent {
+    var displayName: string;
+}
+/**
+ * TooltipArrow Component
+ *
+ * Optional arrow component for custom arrow rendering.
+ * Automatically positioned based on tooltip placement.
+ *
+ * Note: This is an alternative to using showArrow prop on TooltipContent.
+ * Use this when you need custom arrow styling or rendering.
+ *
+ * @see tooltip-prd.md US-2 (Arrow Indicator)
+ */
+declare function TooltipArrowComponent({ size, className, 'data-testid': dataTestId, ...restProps }: TooltipArrowProps & {
+    'data-testid'?: string;
+}): ReactElement;
+declare namespace TooltipArrowComponent {
+    var displayName: string;
+}
+/**
+ * Export all components
+ *
+ * Following Themis pattern - export individual components
+ * No Object.assign compound pattern for Tooltip since React Aria
+ * expects specific component hierarchy.
+ */
+export declare const Tooltip: typeof TooltipRoot;
+export declare const TooltipTrigger: typeof TooltipTriggerComponent;
+export declare const TooltipContent: typeof TooltipContentComponent;
+export declare const TooltipArrow: typeof TooltipArrowComponent;
+export {};
+//# sourceMappingURL=Tooltip.d.ts.map

package/dist/elements/Tooltip/Tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/elements/Tooltip/Tooltip.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAS1C,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;8EAoClC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;8EAgBhC,CAAC;AAkBF;;;;;;;;;GASG;AACH,iBAAS,WAAW,CAAC,EACnB,QAAQ,EACR,KAAW,EACX,UAAgB,EAChB,OAAiB,EACjB,MAAM,EACN,WAAmB,EACnB,YAAY,EACZ,UAAkB,GACnB,EAAE,YAAY,GAAG,YAAY,CAkB7B;kBA3BQ,WAAW;;;AA+BpB;;;;;;;;;;;GAWG;AACH,iBAAS,uBAAuB,CAAC,EAC/B,QAAQ,GACT,EAAE,mBAAmB,GAAG,YAAY,CAIpC;kBANQ,uBAAuB;;;AAUhC;;;;;;;;GAQG;AACH,iBAAS,uBAAuB,CAAC,EAC/B,QAAQ,EACR,IAAY,EACZ,UAAc,EACd,WAAe,EACf,UAAiB,EACjB,SAAiB,EACjB,SAAa,EACb,SAAS,EACT,GAAG,SAAS,EACb,EAAE,mBAAmB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAwCjE;kBAlDQ,uBAAuB;;;AAsDhC;;;;;;;;;;GAUG;AACH,iBAAS,qBAAqB,CAAC,EAC7B,IAAQ,EACR,SAAS,EACT,aAAa,EAAE,UAA4B,EAC3C,GAAG,SAAS,EACb,EAAE,iBAAiB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAsB/D;kBA3BQ,qBAAqB;;;AA+B9B;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,oBAAc,CAAC;AACnC,eAAO,MAAM,cAAc,gCAA0B,CAAC;AACtD,eAAO,MAAM,cAAc,gCAA0B,CAAC;AACtD,eAAO,MAAM,YAAY,8BAAwB,CAAC"}

package/dist/elements/Tooltip/Tooltip.types.d.ts

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+import type { ReactNode } from 'react';
+/**
+ * Tooltip placement/side options
+ *
+ * @see tooltip-prd.md US-2 (Configurable Placement)
+ */
+export declare const TooltipSideSchema: z.ZodEnum<{
+    top: "top";
+    bottom: "bottom";
+    left: "left";
+    right: "right";
+}>;
+export type TooltipSide = z.infer<typeof TooltipSideSchema>;
+/**
+ * Tooltip trigger mode options
+ *
+ * @see tooltip-prd.md US-4 (Keyboard-only Mode)
+ */
+export declare const TooltipTriggerModeSchema: z.ZodEnum<{
+    focus: "focus";
+    hover: "hover";
+}>;
+export type TooltipTriggerMode = z.infer<typeof TooltipTriggerModeSchema>;
+/**
+ * Tooltip root component props schema
+ *
+ * Manages tooltip open/close state, delays, and trigger behavior.
+ * Wraps React Aria's TooltipTrigger with delay configuration.
+ *
+ * @see tooltip-prd.md US-1 (Basic Usage)
+ * @see tooltip-prd.md US-3 (Delay Configuration)
+ * @see tooltip-prd.md US-7 (Controlled State)
+ */
+export declare const TooltipPropsSchema: z.ZodObject<{
+    className: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    'aria-label': z.ZodOptional<z.ZodString>;
+    'aria-labelledby': z.ZodOptional<z.ZodString>;
+    'aria-describedby': z.ZodOptional<z.ZodString>;
+    'aria-live': z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        polite: "polite";
+        assertive: "assertive";
+    }>>;
+    'aria-hidden': z.ZodOptional<z.ZodBoolean>;
+    'data-testid': z.ZodOptional<z.ZodString>;
+    delay: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    closeDelay: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    trigger: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        focus: "focus";
+        hover: "hover";
+    }>>>;
+    isOpen: z.ZodOptional<z.ZodBoolean>;
+    defaultOpen: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    onOpenChange: z.ZodOptional<z.ZodCustom<(isOpen: boolean) => void, (isOpen: boolean) => void>>;
+    isDisabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    children: z.ZodCustom<ReactNode, ReactNode>;
+}, z.core.$strip>;
+export type TooltipProps = z.infer<typeof TooltipPropsSchema>;
+/**
+ * TooltipTrigger props schema
+ *
+ * Wrapper for the element that triggers the tooltip.
+ * The child element must be focusable (or wrapped with Focusable).
+ *
+ * @see tooltip-prd.md US-5 (Non-Button Triggers)
+ */
+export declare const TooltipTriggerPropsSchema: z.ZodObject<{
+    className: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    'aria-label': z.ZodOptional<z.ZodString>;
+    'aria-labelledby': z.ZodOptional<z.ZodString>;
+    'aria-describedby': z.ZodOptional<z.ZodString>;
+    'aria-live': z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        polite: "polite";
+        assertive: "assertive";
+    }>>;
+    'aria-hidden': z.ZodOptional<z.ZodBoolean>;
+    'data-testid': z.ZodOptional<z.ZodString>;
+    asChild: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    children: z.ZodCustom<ReactNode, ReactNode>;
+}, z.core.$strip>;
+export type TooltipTriggerProps = z.infer<typeof TooltipTriggerPropsSchema>;
+/**
+ * TooltipContent props schema
+ *
+ * The actual tooltip overlay that appears.
+ * Supports placement, offset, and optional arrow.
+ *
+ * @see tooltip-prd.md US-2 (Placement and Arrow)
+ * @see tooltip-prd.md Technical Implementation Details
+ */
+export declare const TooltipContentPropsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    'aria-label': z.ZodOptional<z.ZodString>;
+    'aria-labelledby': z.ZodOptional<z.ZodString>;
+    'aria-describedby': z.ZodOptional<z.ZodString>;
+    'aria-live': z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        polite: "polite";
+        assertive: "assertive";
+    }>>;
+    'aria-hidden': z.ZodOptional<z.ZodBoolean>;
+    'data-testid': z.ZodOptional<z.ZodString>;
+    side: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        top: "top";
+        bottom: "bottom";
+        left: "left";
+        right: "right";
+    }>>>;
+    sideOffset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    alignOffset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    shouldFlip: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    showArrow: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    arrowSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    className: z.ZodOptional<z.ZodString>;
+    children: z.ZodCustom<ReactNode, ReactNode>;
+}, z.core.$strip>;
+export type TooltipContentProps = z.infer<typeof TooltipContentPropsSchema>;
+/**
+ * TooltipArrow props schema
+ *
+ * Optional arrow component for custom arrow rendering.
+ * Automatically positioned based on tooltip placement.
+ *
+ * @see tooltip-prd.md US-2 (Arrow Indicator)
+ */
+export declare const TooltipArrowPropsSchema: z.ZodObject<{
+    size: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    className: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TooltipArrowProps = z.infer<typeof TooltipArrowPropsSchema>;
+//# sourceMappingURL=Tooltip.types.d.ts.map

package/dist/elements/Tooltip/Tooltip.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.types.d.ts","sourceRoot":"","sources":["../../../src/elements/Tooltip/Tooltip.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;EAA6C,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;EAA6B,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;qDAuCG,OAAO,KAAK,IAAI,WAAhB,OAAO,KAAK,IAAI;;;iBAYhD,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;iBAapC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;iBAWlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/elements/Tooltip/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tooltip Component - Barrel Export
+ *
+ * @see Tooltip.tsx (Implementation)
+ * @see Tooltip.types.ts (Type definitions)
+ * @see tooltip.json (Registry metadata)
+ */
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipArrow, tooltipContentVariants, tooltipArrowVariants, } from './Tooltip';
+export type { TooltipProps, TooltipTriggerProps, TooltipContentProps, TooltipArrowProps, TooltipSide, TooltipTriggerMode, } from './Tooltip.types';
+export { TooltipPropsSchema, TooltipTriggerPropsSchema, TooltipContentPropsSchema, TooltipArrowPropsSchema, TooltipSideSchema, TooltipTriggerModeSchema, } from './Tooltip.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/Tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/Tooltip/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,OAAO,EACP,cAAc,EACd,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}