@mks2508/sidebar-headless 0.2.1 → 0.3.0

package/dist/components/BottomNavBar/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview MobileBottomNav component exports
+ * @description Centralized exports for the MobileBottomNav component system
+ * @module MobileBottomNav
+ */
+export { MobileBottomNav, default } from "./MobileBottomNav";
+export { NavVariant, NavSize, LabelPosition, AnimationType, NavItemState, IconSize, ZIndexLevel, BlurIntensity, type RootProps, type NavListProps, type NavItemProps, type NavContextValue, type SpringConfig, type TweenConfig, type AnimationConfig, type GlassConfig, type BaseNavProps, DEFAULT_ANIMATION_CONFIG, DEFAULT_GLASS_CONFIG, DEFAULT_SPRING_CONFIG, DEFAULT_TWEEN_CONFIG, } from "./types";
+export { rootVariants, navListVariants, navItemVariants, iconVariants, labelVariants, badgeVariants, spacerVariants, type RootVariantProps, type NavListVariantProps, type NavItemVariantProps, type IconVariantProps, type LabelVariantProps, type BadgeVariantProps, type SpacerVariantProps, } from "./MobileBottomNav.styles";
+export { useIOSSafariFix, useIOSFixedReset, detectIOSVersion, type IOSSafariFixConfig, } from "./useIOSSafariFix";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/BottomNavBar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/BottomNavBar/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG5D,OAAO,EAEL,UAAU,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,aAAa,EAEb,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EAEjB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA"}

package/dist/components/BottomNavBar/types.d.ts

@@ -0,0 +1,363 @@
+import type React from "react";
+/**
+ * @fileoverview Type definitions for MobileBottomNav component
+ * @module MobileBottomNav/types
+ * @version 1.0.0
+ */
+import type { ReactNode, HTMLAttributes, ComponentPropsWithoutRef } from "react";
+/**
+ * Visual variant of the navigation bar
+ * @enum {string}
+ * @description Defines the visual style of the bottom navigation
+ */
+export declare enum NavVariant {
+    /** Glassmorphism effect with blur and transparency */
+    GLASS = "glass",
+    /** Solid background without transparency */
+    SOLID = "solid",
+    /** Transparent background - headless mode for custom styling */
+    HEADLESS = "headless"
+}
+/**
+ * Size preset for the navigation bar
+ * @enum {string}
+ * @description Controls the overall size and spacing of navigation elements
+ */
+export declare enum NavSize {
+    /** Compact size - 56px height, smaller touch targets */
+    SMALL = "sm",
+    /** Default size - 72px height, optimal touch targets */
+    MEDIUM = "md",
+    /** Large size - 88px height, larger touch targets */
+    LARGE = "lg"
+}
+/**
+ * Position of the label relative to the icon
+ * @enum {string}
+ * @description Determines how labels are displayed in navigation items
+ */
+export declare enum LabelPosition {
+    /** Label below the icon (default mobile pattern) */
+    BELOW = "below",
+    /** Label beside the icon (horizontal layout) */
+    BESIDE = "beside",
+    /** No label, icon only */
+    HIDDEN = "hidden"
+}
+/**
+ * Animation type for navigation interactions
+ * @enum {string}
+ * @description Defines the animation behavior for navigation items
+ */
+export declare enum AnimationType {
+    /** Spring animation for natural feel */
+    SPRING = "spring",
+    /** Tween animation for precise timing */
+    TWEEN = "tween",
+    /** No animation */
+    NONE = "none"
+}
+/**
+ * State of a navigation item
+ * @enum {string}
+ * @description Represents the current state of a navigation item
+ */
+export declare enum NavItemState {
+    /** Default inactive state */
+    INACTIVE = "inactive",
+    /** Currently selected/active item */
+    ACTIVE = "active",
+    /** Disabled and non-interactive */
+    DISABLED = "disabled"
+}
+/**
+ * Icon size preset
+ * @enum {number}
+ * @description Standard icon sizes in pixels
+ */
+export declare enum IconSize {
+    /** Small icons - 18px */
+    SMALL = 18,
+    /** Medium icons - 24px (default) */
+    MEDIUM = 24,
+    /** Large icons - 28px */
+    LARGE = 28
+}
+/**
+ * Z-index levels for layering
+ * @enum {number}
+ * @description Consistent z-index values for proper stacking
+ */
+export declare enum ZIndexLevel {
+    /** Below default content */
+    BELOW = 40,
+    /** Default navigation level */
+    DEFAULT = 50,
+    /** Above most content */
+    ELEVATED = 60,
+    /** Maximum elevation */
+    MAX = 100
+}
+/**
+ * Blur intensity for glassmorphism
+ * @enum {number}
+ * @description Backdrop blur values in pixels
+ */
+export declare enum BlurIntensity {
+    /** Subtle blur - 8px */
+    LIGHT = 8,
+    /** Standard blur - 20px (default) */
+    MEDIUM = 20,
+    /** Heavy blur - 40px */
+    HEAVY = 40
+}
+/**
+ * Border radius preset for navigation
+ * @enum {string}
+ * @description Defines the border radius style
+ */
+export declare enum NavBorderRadius {
+    /** No border radius */
+    NONE = "none",
+    /** Small radius - 8px */
+    SMALL = "sm",
+    /** Medium radius - 16px (default) */
+    MEDIUM = "md",
+    /** Large radius - 24px */
+    LARGE = "lg",
+    /** Extra large radius - 32px */
+    EXTRA_LARGE = "xl",
+    /** Full rounded (pill shape) */
+    FULL = "full"
+}
+/**
+ * Gap spacing preset for items
+ * @enum {number}
+ * @description Standard gap values in rem units
+ */
+export declare enum NavGap {
+    /** No gap */
+    NONE = 0,
+    /** Extra small - 0.25rem (4px) */
+    EXTRA_SMALL = 0.25,
+    /** Small - 0.5rem (8px) */
+    SMALL = 0.5,
+    /** Medium - 1rem (16px) */
+    MEDIUM = 1,
+    /** Large - 1.5rem (24px) */
+    LARGE = 1.5,
+    /** Extra large - 2rem (32px) */
+    EXTRA_LARGE = 2
+}
+/**
+ * Spring animation configuration
+ * @interface SpringConfig
+ * @description Configuration for spring-based animations
+ */
+export interface SpringConfig {
+    /** Spring stiffness (default: 400) */
+    stiffness: number;
+    /** Damping ratio (default: 30) */
+    damping: number;
+    /** Mass of the animated element (default: 1) */
+    mass: number;
+}
+/**
+ * Tween animation configuration
+ * @interface TweenConfig
+ * @description Configuration for tween-based animations
+ */
+export interface TweenConfig {
+    /** Duration in seconds */
+    duration: number;
+    /** Easing function name */
+    ease: "linear" | "easeIn" | "easeOut" | "easeInOut";
+}
+/**
+ * Animation configuration union type
+ * @interface AnimationConfig
+ * @description Complete animation configuration options
+ */
+export interface AnimationConfig {
+    /** Type of animation to use */
+    type: AnimationType;
+    /** Spring configuration (when type is SPRING) */
+    spring?: SpringConfig;
+    /** Tween configuration (when type is TWEEN) */
+    tween?: TweenConfig;
+    /** Scale factor for press animation */
+    pressScale?: number;
+    /** Scale factor for hover animation */
+    hoverScale?: number;
+}
+/**
+ * Glassmorphism style configuration
+ * @interface GlassConfig
+ * @description Configuration for glassmorphism visual effects
+ */
+export interface GlassConfig {
+    /** Blur intensity in pixels */
+    blur: BlurIntensity | number;
+    /** Saturation percentage (100-200) */
+    saturation: number;
+    /** Background opacity (0-1) */
+    opacity: number;
+    /** Border opacity (0-1) */
+    borderOpacity: number;
+}
+/**
+ * Base props shared by all MobileBottomNav components
+ * @interface BaseNavProps
+ * @description Common properties for navigation components
+ */
+export interface BaseNavProps {
+    /** Additional CSS classes */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Test ID for testing */
+    "data-testid"?: string;
+}
+/**
+ * Motion-specific props for components using Framer Motion
+ * @interface MotionProps
+ * @description Props that are specific to Framer Motion components
+ */
+export interface MotionProps {
+    onDrag?: (event: MouseEvent | TouchEvent | PointerEvent, info: any) => void;
+    onDragStart?: (event: MouseEvent | TouchEvent | PointerEvent, info: any) => void;
+    onDragEnd?: (event: MouseEvent | TouchEvent | PointerEvent, info: any) => void;
+    drag?: boolean | "x" | "y";
+    dragConstraints?: any;
+    dragMomentum?: boolean;
+    dragElastic?: boolean;
+    dragPropagation?: boolean;
+    dragTransition?: any;
+    whileTap?: any;
+    whileHover?: any;
+    animate?: any;
+    initial?: any;
+    exit?: any;
+    transition?: any;
+}
+/**
+ * Root component props
+ * @interface RootProps
+ * @description Properties for the MobileBottomNav.Root component
+ */
+export interface RootProps extends BaseNavProps, Omit<HTMLAttributes<HTMLElement>, "className" | "style" | keyof MotionProps> {
+    /** Child components (NavList, custom content) */
+    children: ReactNode;
+    /** Visual variant of the navigation */
+    variant?: NavVariant;
+    /** Size preset */
+    size?: NavSize;
+    /** Z-index level */
+    zIndex?: ZIndexLevel | number;
+    /** Show/hide the navigation */
+    visible?: boolean;
+    /** Glassmorphism configuration (only for GLASS variant) */
+    glassConfig?: Partial<GlassConfig>;
+    /** Animation configuration */
+    animationConfig?: Partial<AnimationConfig>;
+    /** ARIA label for accessibility */
+    "aria-label"?: string;
+    /** Use full width container (adds max-width and centers) */
+    full?: boolean;
+    /** Border radius preset or custom value */
+    rounded?: NavBorderRadius | number;
+    /** Gap between nav items (uses NavGap enum or custom rem value) */
+    gap?: NavGap | number;
+}
+/**
+ * Props for the NavList component
+ * @interface NavListProps
+ * @extends {BaseNavProps}
+ * @description Configuration for the navigation items container
+ */
+export interface NavListProps extends BaseNavProps, Omit<ComponentPropsWithoutRef<"ul">, "className" | "style"> {
+    /** NavItem children */
+    children: ReactNode;
+    /** Gap between items (in rem or px) */
+    gap?: number;
+    /** Justify content alignment */
+    justify?: "start" | "center" | "end" | "around" | "between" | "evenly";
+}
+/**
+ * Props for the NavItem component
+ * @interface NavItemProps
+ * @extends {BaseNavProps}
+ * @extends {Omit<ComponentPropsWithoutRef<"button">, "className" | "style" | "children">}
+ * @description Configuration for individual navigation items
+ */
+export interface NavItemProps extends BaseNavProps, Omit<ComponentPropsWithoutRef<"button">, "className" | "style" | "children"> {
+    /** Icon element to display */
+    icon: ReactNode;
+    /** Label text */
+    label: string;
+    /** Current state of the item */
+    state?: NavItemState;
+    /** Label position relative to icon */
+    labelPosition?: LabelPosition;
+    /** Click handler */
+    onClick?: () => void;
+    /** Href for navigation (renders as anchor) */
+    href?: string;
+    /** Icon size */
+    iconSize?: IconSize | number;
+    /** Show badge indicator */
+    badge?: ReactNode;
+    /** Accessible name override */
+    "aria-label"?: string;
+}
+/**
+ * Navigation context value
+ * @interface NavContextValue
+ * @description Shared context for navigation components
+ */
+export interface NavContextValue {
+    /** Current variant */
+    variant: NavVariant;
+    /** Current size */
+    size: NavSize;
+    /** Animation configuration */
+    animationConfig: AnimationConfig;
+    /** Gap between items (inherited from Root) */
+    gap?: NavGap | number;
+    /** Currently active item ID */
+    activeItemId?: string;
+    /** Callback to set active item */
+    setActiveItem?: (id: string) => void;
+}
+/**
+ * Default spring animation configuration
+ * @constant
+ */
+export declare const DEFAULT_SPRING_CONFIG: SpringConfig;
+/**
+ * Default tween animation configuration
+ * @constant
+ */
+export declare const DEFAULT_TWEEN_CONFIG: TweenConfig;
+/**
+ * Default animation configuration
+ * @constant
+ */
+export declare const DEFAULT_ANIMATION_CONFIG: AnimationConfig;
+/**
+ * Default glassmorphism configuration
+ * @constant
+ */
+export declare const DEFAULT_GLASS_CONFIG: GlassConfig;
+/**
+ * Extract the value type from an enum
+ * @template T - Enum type
+ */
+export type EnumValue<T> = T[keyof T];
+/**
+ * Make specific keys optional
+ * @template T - Base type
+ * @template K - Keys to make optional
+ */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/BottomNavBar/types.d.ts.map

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

package/dist/components/BottomNavBar/useIOSSafariFix.d.ts

@@ -0,0 +1,74 @@
+import type React from "react";
+/**
+ * iOS version detection result
+ * @interface IOSVersion
+ */
+interface IOSVersion {
+    /** Whether the device is running iOS */
+    isIOS: boolean;
+    /** Whether the browser is Safari */
+    isSafari: boolean;
+    /** Major iOS version number (e.g., 26 for iOS 26) */
+    majorVersion: number | null;
+    /** Minor iOS version number */
+    minorVersion: number | null;
+    /** Whether this is iOS 26 or later with known bugs */
+    hasViewportBugs: boolean;
+}
+/**
+ * Detects iOS version and Safari browser
+ * @returns {IOSVersion} iOS detection result
+ */
+export declare function detectIOSVersion(): IOSVersion;
+/**
+ * Configuration for iOS Safari fix
+ * @interface IOSSafariFixConfig
+ */
+export interface IOSSafariFixConfig {
+    /** Enable scroll-based body fix (moves scroll from window to body) */
+    enableScrollFix?: boolean;
+    /** Enable keyboard visibility detection */
+    enableKeyboardFix?: boolean;
+    /** Callback when keyboard visibility changes */
+    onKeyboardVisibilityChange?: (visible: boolean) => void;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Hook to apply iOS Safari viewport bug fixes
+ *
+ * @param {IOSSafariFixConfig} config - Configuration options
+ * @returns {{ isKeyboardVisible: boolean; iosInfo: IOSVersion }} Hook state
+ *
+ * @example
+ * ```tsx
+ * const { isKeyboardVisible, iosInfo } = useIOSSafariFix({
+ *   enableScrollFix: true,
+ *   enableKeyboardFix: true,
+ *   onKeyboardVisibilityChange: (visible) => console.log('Keyboard:', visible)
+ * });
+ * ```
+ */
+export declare function useIOSSafariFix(config?: IOSSafariFixConfig): {
+    isKeyboardVisible: boolean;
+    iosInfo: IOSVersion;
+};
+/**
+ * Hook to force reset fixed element positioning after iOS viewport bugs
+ *
+ * @param {React.RefObject<HTMLElement>} elementRef - Ref to the fixed element
+ * @returns {{ forceReset: () => void }} Reset function
+ *
+ * @example
+ * ```tsx
+ * const navRef = useRef<HTMLElement>(null);
+ * const { forceReset } = useIOSFixedReset(navRef);
+ *
+ * // Call forceReset() after keyboard dismissal or scroll issues
+ * ```
+ */
+export declare function useIOSFixedReset(elementRef: React.RefObject<HTMLElement | null>): {
+    forceReset: () => void;
+};
+export default useIOSSafariFix;
+//# sourceMappingURL=useIOSSafariFix.d.ts.map

package/dist/components/BottomNavBar/useIOSSafariFix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIOSSafariFix.d.ts","sourceRoot":"","sources":["../../../src/components/BottomNavBar/useIOSSafariFix.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAmB9B;;;GAGG;AACH,UAAU,UAAU;IAClB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAA;IACd,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAA;IACjB,qDAAqD;IACrD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,sDAAsD;IACtD,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAoC7C;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,gDAAgD;IAChD,0BAA0B,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,kBAAuB;;;EAyI9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC;;EAkB/E;AAED,eAAe,eAAe,CAAA"}