@nice2dev/ui-core 1.0.10

package/dist/core/themeVariants.d.ts

@@ -0,0 +1,204 @@
+/**
+ * @file themeVariants.ts
+ * @description Extended theme variants - radius, shadows, fills, gradients, effects
+ *
+ * Allows fine-grained customization of theme appearance
+ *
+ * @version 1.0.0
+ * @since 2026-03
+ * @license MIT
+ */
+import type { NiceTheme } from './theme';
+/**
+ * Border radius variants
+ */
+export type RadiusVariant = 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
+/**
+ * Shadow variants
+ */
+export type ShadowVariant = 'none' | 'subtle' | 'md' | 'lg' | 'xl' | 'inner' | 'colored' | 'glow';
+/**
+ * Fill style variants
+ */
+export type FillVariant = 'solid' | 'gradient-linear' | 'gradient-radial' | 'gradient-conic' | 'glass' | 'frosted' | 'pattern' | 'texture' | 'mesh';
+/**
+ * Button style variants
+ */
+export type ButtonStyleVariant = 'flat' | 'raised' | 'outlined' | 'ghost' | 'soft' | 'gradient' | '3d' | 'neumorphic' | 'pill' | 'link' | 'brutal';
+/**
+ * Input style variants
+ */
+export type InputStyleVariant = 'bordered' | 'filled' | 'underlined' | 'floating' | 'soft' | 'neumorphic' | 'pill' | 'flush';
+/**
+ * Card style variants
+ */
+export type CardStyleVariant = 'flat' | 'elevated' | 'bordered' | 'glass' | 'gradient' | 'neumorphic' | 'outlined' | 'paper';
+/**
+ * Badge / tag style variants
+ */
+export type BadgeStyleVariant = 'solid' | 'soft' | 'outlined' | 'dot' | 'pill' | 'gradient';
+/**
+ * Tab style variants
+ */
+export type TabStyleVariant = 'underline' | 'pills' | 'enclosed' | 'soft' | 'lifted' | 'bordered';
+/**
+ * Toggle / switch style variants
+ */
+export type ToggleStyleVariant = 'default' | 'ios' | 'flat' | 'pill' | 'square';
+/**
+ * Tooltip style variants
+ */
+export type TooltipStyleVariant = 'dark' | 'light' | 'primary' | 'glass' | 'bordered';
+/**
+ * Modal / dialog style variants
+ */
+export type ModalStyleVariant = 'default' | 'centered' | 'fullscreen' | 'sheet' | 'glass' | 'drawer';
+/**
+ * Table style variants
+ */
+export type TableStyleVariant = 'default' | 'striped' | 'bordered' | 'compact' | 'hoverable' | 'minimal';
+/**
+ * Menu / dropdown style variants
+ */
+export type MenuStyleVariant = 'default' | 'compact' | 'glass' | 'bordered' | 'floating';
+/**
+ * Animation intensity
+ */
+export type AnimationIntensity = 'none' | 'subtle' | 'normal' | 'playful' | 'dramatic';
+/**
+ * Density variants
+ */
+export type DensityVariant = 'compact' | 'normal' | 'comfortable' | 'spacious';
+/**
+ * Border radius values for each variant
+ */
+export declare const RADIUS_VALUES: Record<RadiusVariant, Record<string, string>>;
+/**
+ * Shadow values for each variant
+ */
+export declare const SHADOW_VALUES: Record<ShadowVariant, string>;
+/**
+ * Shadow intensity multipliers for dark mode
+ */
+export declare const SHADOW_DARK_MODE_VALUES: Record<ShadowVariant, string>;
+/**
+ * Density spacing values
+ */
+export declare const DENSITY_VALUES: Record<DensityVariant, Record<string, string>>;
+/**
+ * Animation timing presets
+ */
+export declare const ANIMATION_VALUES: Record<AnimationIntensity, Record<string, string>>;
+/**
+ * Generate fill CSS for a variant
+ */
+export declare function generateFillStyles(variant: FillVariant, primaryColor: string, secondaryColor?: string): Record<string, string>;
+/**
+ * Generate button styles for a variant
+ */
+export declare function generateButtonStyles(variant: ButtonStyleVariant, color: string): Record<string, string>;
+/**
+ * Generate input styles for a variant
+ */
+export declare function generateInputStyles(variant: InputStyleVariant): Record<string, string>;
+/**
+ * Generate card styles for a variant
+ */
+export declare function generateCardStyles(variant: CardStyleVariant): Record<string, string>;
+/** Generate badge styles */
+export declare function generateBadgeStyles(variant: BadgeStyleVariant, color: string): Record<string, string>;
+/** Generate tab styles */
+export declare function generateTabStyles(variant: TabStyleVariant, activeColor: string): Record<string, string>;
+/** Generate toggle / switch styles */
+export declare function generateToggleStyles(variant: ToggleStyleVariant): Record<string, string>;
+/** Generate tooltip styles */
+export declare function generateTooltipStyles(variant: TooltipStyleVariant): Record<string, string>;
+/** Generate table styles */
+export declare function generateTableStyles(variant: TableStyleVariant): Record<string, string>;
+/**
+ * Theme variant configuration
+ */
+export interface ThemeVariantConfig {
+    /** Border radius variant */
+    radius: RadiusVariant;
+    /** Shadow variant */
+    shadow: ShadowVariant;
+    /** Fill style */
+    fill: FillVariant;
+    /** Button style */
+    buttonStyle: ButtonStyleVariant;
+    /** Input style */
+    inputStyle: InputStyleVariant;
+    /** Card style */
+    cardStyle: CardStyleVariant;
+    /** Badge style */
+    badgeStyle?: BadgeStyleVariant;
+    /** Tab style */
+    tabStyle?: TabStyleVariant;
+    /** Toggle style */
+    toggleStyle?: ToggleStyleVariant;
+    /** Tooltip style */
+    tooltipStyle?: TooltipStyleVariant;
+    /** Modal style */
+    modalStyle?: ModalStyleVariant;
+    /** Table style */
+    tableStyle?: TableStyleVariant;
+    /** Menu style */
+    menuStyle?: MenuStyleVariant;
+    /** Animation intensity */
+    animation: AnimationIntensity;
+    /** Density */
+    density: DensityVariant;
+    /** Custom background image/pattern */
+    backgroundImage?: string;
+    /** Gradient overlay for backgrounds */
+    backgroundOverlay?: string;
+}
+/**
+ * Default variant configuration
+ */
+export declare const DEFAULT_VARIANT_CONFIG: ThemeVariantConfig;
+/**
+ * Preset variant configurations
+ */
+export declare const VARIANT_PRESETS: Record<string, ThemeVariantConfig>;
+/**
+ * Generate CSS variables from variant config.
+ *
+ * @param config   Resolved variant configuration.
+ * @param selector CSS selector the declarations are emitted under.
+ *                 Defaults to `:root` (global). Pass e.g.
+ *                 `'[data-ntd-provider="pr0"]'` to scope the variables
+ *                 to one provider instance.
+ */
+export declare function generateVariantCSS(config: ThemeVariantConfig, selector?: string): string;
+/**
+ * Apply variant config to DOM.
+ *
+ * When `scopeId` is omitted, declarations are written under `:root` to a
+ * single global `<style id="ntd-variant-styles">` (previous behaviour).
+ *
+ * When `scopeId` is provided, declarations are scoped to
+ * `[data-ntd-provider="<scopeId>"]` and written to a dedicated
+ * `<style id="ntd-variant-styles-<scopeId>">`. The attribute is also
+ * set on `element` so descendants match the scope. This lets two
+ * NiceThemeProviders coexist with different `displayStyle`s without
+ * fighting over one global style element.
+ */
+export declare function applyVariantConfig(config: ThemeVariantConfig, element?: HTMLElement, scopeId?: string): void;
+/**
+ * Remove a scoped variant config previously applied via
+ * `applyVariantConfig(config, element, scopeId)`.
+ *
+ * Safe to call on unmount; if the style element is absent this is a
+ * no-op. Does not remove the shared global `ntd-variant-styles` element.
+ */
+export declare function removeVariantConfig(scopeId: string, element?: HTMLElement): void;
+/**
+ * Create theme with variants applied
+ * Returns a modified theme with variant-specific CSS custom properties
+ */
+export declare function applyVariantsToTheme(theme: NiceTheme, config: Partial<ThemeVariantConfig>): NiceTheme & {
+    variantConfig: ThemeVariantConfig;
+};
+//# sourceMappingURL=themeVariants.d.ts.map

package/dist/core/themeVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeVariants.d.ts","sourceRoot":"","sources":["../../src/core/themeVariants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,OAAO,GACP,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,QAAQ,GACR,UAAU,GACV,OAAO,GACP,MAAM,GACN,UAAU,GACV,IAAI,GACJ,YAAY,GACZ,MAAM,GACN,MAAM,GACN,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,MAAM,GACN,YAAY,GACZ,MAAM,GACN,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,UAAU,GACV,UAAU,GACV,OAAO,GACP,UAAU,GACV,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,UAAU,GACV,YAAY,GACZ,OAAO,GACP,OAAO,GACP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,SAAS,GACT,UAAU,GACV,SAAS,GACT,WAAW,GACX,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;AAM/E;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyDvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CASvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CASjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqCzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyC/E,CAAC;AAMF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4DxB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwGxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmFtF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6EpF;AAMD,4BAA4B;AAC5B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkDxB;AAED,0BAA0B;AAC1B,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8CxB;AAED,sCAAsC;AACtC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxF;AAED,8BAA8B;AAC9B,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6C1F;AAED,4BAA4B;AAC5B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBtF;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,mBAAmB;IACnB,WAAW,EAAE,kBAAkB,CAAC;IAChC,kBAAkB;IAClB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iBAAiB;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kBAAkB;IAClB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,gBAAgB;IAChB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,mBAAmB;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,oBAAoB;IACpB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,kBAAkB;IAClB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB;IAClB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,iBAAiB;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,0BAA0B;IAC1B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,cAAc;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,kBAgBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAo5B9D,CAAC;AAMF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,GAAE,MAAgB,GAAG,MAAM,CAyCjG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,WAAsC,EAC/C,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAkDN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAQhF;AAsBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAClC,SAAS,GAAG;IAAE,aAAa,EAAE,kBAAkB,CAAA;CAAE,CAOnD"}

package/dist/core/touch.d.ts

@@ -0,0 +1,208 @@
+import React from 'react';
+export interface TouchPoint {
+    x: number;
+    y: number;
+    timestamp: number;
+}
+export interface SwipeGesture {
+    direction: 'left' | 'right' | 'up' | 'down';
+    distance: number;
+    velocity: number;
+    duration: number;
+}
+export interface PinchGesture {
+    scale: number;
+    center: {
+        x: number;
+        y: number;
+    };
+}
+export interface PanGesture {
+    deltaX: number;
+    deltaY: number;
+    velocityX: number;
+    velocityY: number;
+}
+export interface UseSwipeOptions {
+    /** Minimum distance in px to trigger a swipe (default 50) */
+    threshold?: number;
+    /** Maximum time in ms for a valid swipe (default 300) */
+    maxDuration?: number;
+    /** Callback when swipe is detected */
+    onSwipe?: (gesture: SwipeGesture) => void;
+    /** Callback when swiping left */
+    onSwipeLeft?: (gesture: SwipeGesture) => void;
+    /** Callback when swiping right */
+    onSwipeRight?: (gesture: SwipeGesture) => void;
+    /** Callback when swiping up */
+    onSwipeUp?: (gesture: SwipeGesture) => void;
+    /** Callback when swiping down */
+    onSwipeDown?: (gesture: SwipeGesture) => void;
+    /** Whether swipe detection is enabled (default true) */
+    enabled?: boolean;
+}
+export interface UseSwipeResult {
+    ref: React.RefObject<HTMLElement | null>;
+    isSwiping: boolean;
+    swipeDirection: SwipeGesture['direction'] | null;
+}
+/**
+ * Hook for detecting swipe gestures on touch devices.
+ * Returns a ref to attach to the swipeable element.
+ */
+export declare function useSwipe(options?: UseSwipeOptions): UseSwipeResult;
+export interface UsePinchOptions {
+    /** Callback during pinch gesture */
+    onPinch?: (gesture: PinchGesture) => void;
+    /** Callback when pinch starts */
+    onPinchStart?: () => void;
+    /** Callback when pinch ends */
+    onPinchEnd?: (finalScale: number) => void;
+    /** Minimum scale factor (default 0.5) */
+    minScale?: number;
+    /** Maximum scale factor (default 3) */
+    maxScale?: number;
+    /** Whether pinch is enabled (default true) */
+    enabled?: boolean;
+}
+export interface UsePinchResult {
+    ref: React.RefObject<HTMLElement | null>;
+    scale: number;
+    isPinching: boolean;
+}
+/**
+ * Hook for detecting pinch-to-zoom gestures.
+ */
+export declare function usePinch(options?: UsePinchOptions): UsePinchResult;
+export interface UsePanOptions {
+    /** Callback during pan */
+    onPan?: (gesture: PanGesture) => void;
+    /** Callback when pan starts */
+    onPanStart?: () => void;
+    /** Callback when pan ends */
+    onPanEnd?: (gesture: PanGesture) => void;
+    /** Whether pan is enabled (default true) */
+    enabled?: boolean;
+}
+export interface UsePanResult {
+    ref: React.RefObject<HTMLElement | null>;
+    isPanning: boolean;
+    deltaX: number;
+    deltaY: number;
+}
+/**
+ * Hook for detecting pan/drag gestures.
+ */
+export declare function usePan(options?: UsePanOptions): UsePanResult;
+export interface UsePullToRefreshOptions {
+    /** Callback when refresh is triggered */
+    onRefresh: () => Promise<void> | void;
+    /** Pull distance to trigger refresh (default 80) */
+    threshold?: number;
+    /** Maximum pull distance (default 120) */
+    maxPull?: number;
+    /** Whether pull to refresh is enabled (default true) */
+    enabled?: boolean;
+}
+export interface UsePullToRefreshResult {
+    ref: React.RefObject<HTMLElement | null>;
+    isPulling: boolean;
+    isRefreshing: boolean;
+    pullDistance: number;
+    pullProgress: number;
+}
+/**
+ * Hook for implementing pull-to-refresh functionality.
+ */
+export declare function usePullToRefresh(options: UsePullToRefreshOptions): UsePullToRefreshResult;
+export interface SwipeAction {
+    /** Unique key for the action */
+    key: string;
+    /** Icon or text content */
+    content: React.ReactNode;
+    /** Background color */
+    color: string;
+    /** Callback when action is triggered */
+    onAction: () => void;
+}
+export interface NiceSwipeableListItemProps {
+    /** Content of the list item */
+    children: React.ReactNode;
+    /** Actions revealed when swiping left */
+    leftActions?: SwipeAction[];
+    /** Actions revealed when swiping right */
+    rightActions?: SwipeAction[];
+    /** Width of each action button (default 80) */
+    actionWidth?: number;
+    /** Maximum swipe distance as multiplier of action buttons (default 1.5) */
+    maxSwipe?: number;
+    /** Threshold to auto-complete swipe (default 0.5) */
+    threshold?: number;
+    /** Additional className */
+    className?: string;
+    /** Additional styles */
+    style?: React.CSSProperties;
+}
+/**
+ * A list item component with swipe-to-reveal actions (like iOS).
+ */
+export declare const NiceSwipeableListItem: React.FC<NiceSwipeableListItemProps>;
+export interface NicePullToRefreshProps {
+    /** Content to display */
+    children: React.ReactNode;
+    /** Callback when refresh triggered */
+    onRefresh: () => Promise<void>;
+    /** Pull threshold to trigger refresh (default 80) */
+    threshold?: number;
+    /** Custom pulling indicator */
+    pullingContent?: React.ReactNode;
+    /** Custom refreshing indicator */
+    refreshingContent?: React.ReactNode;
+    /** Whether pull to refresh is enabled */
+    enabled?: boolean;
+    /** Additional className */
+    className?: string;
+    /** Additional styles */
+    style?: React.CSSProperties;
+}
+/**
+ * A container component that adds pull-to-refresh functionality.
+ */
+export declare const NicePullToRefresh: React.FC<NicePullToRefreshProps>;
+export type HapticFeedbackType = 'light' | 'medium' | 'heavy' | 'selection' | 'success' | 'warning' | 'error';
+/**
+ * Triggers haptic feedback on supported devices.
+ * Falls back silently if not supported.
+ */
+export declare function triggerHaptic(type?: HapticFeedbackType): void;
+/**
+ * Hook that returns a function to trigger haptic feedback.
+ */
+export declare function useHaptic(): (type?: HapticFeedbackType) => void;
+export interface TouchTargetProps {
+    /** Minimum touch target size in pixels (default 44, WCAG 2.5.8) */
+    minSize?: number;
+    /** Content to wrap */
+    children: React.ReactNode;
+    /** Additional className */
+    className?: string;
+    /** Additional styles */
+    style?: React.CSSProperties;
+    /** onClick handler */
+    onClick?: () => void;
+}
+/**
+ * Wrapper component that ensures minimum touch target size.
+ * Adds invisible padding to small elements to meet WCAG 2.5.8.
+ */
+export declare const NiceTouchTarget: React.FC<TouchTargetProps>;
+export interface UseVirtualKeyboardResult {
+    isKeyboardVisible: boolean;
+    keyboardHeight: number;
+}
+/**
+ * Hook to detect virtual keyboard visibility on mobile devices.
+ * Uses viewport height changes as the primary detection method.
+ */
+export declare function useVirtualKeyboard(): UseVirtualKeyboardResult;
+//# sourceMappingURL=touch.d.ts.map

package/dist/core/touch.d.ts.map

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