@mks2508/mks-ui 0.6.7 → 0.7.0

package/dist/react-ui/blocks/BottomNavBar/index.js

@@ -0,0 +1,4 @@
+import { AnimationType, BlurIntensity, DEFAULT_ANIMATION_CONFIG, DEFAULT_GLASS_CONFIG, DEFAULT_SPRING_CONFIG, DEFAULT_TWEEN_CONFIG, IconSize, LabelPosition, NavItemState, NavSize, NavVariant, ZIndexLevel } from "./types.js";
+import { badgeVariants, iconVariants, labelVariants, navItemVariants, navListVariants, rootVariants, spacerVariants } from "./MobileBottomNav.styles.js";
+import useIOSSafariFix, { detectIOSVersion, useIOSFixedReset } from "./useIOSSafariFix.js";
+import MobileBottomNav from "./MobileBottomNav.js";

package/dist/react-ui/blocks/BottomNavBar/types.d.ts

@@ -0,0 +1,362 @@
+/**
+ * @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: unknown) => void;
+    onDragStart?: (event: MouseEvent | TouchEvent | PointerEvent, info: unknown) => void;
+    onDragEnd?: (event: MouseEvent | TouchEvent | PointerEvent, info: unknown) => void;
+    drag?: boolean | "x" | "y";
+    dragConstraints?: unknown;
+    dragMomentum?: boolean;
+    dragElastic?: boolean;
+    dragPropagation?: boolean;
+    dragTransition?: unknown;
+    whileTap?: unknown;
+    whileHover?: unknown;
+    animate?: unknown;
+    initial?: unknown;
+    exit?: unknown;
+    transition?: unknown;
+}
+/**
+ * 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/react-ui/blocks/BottomNavBar/types.d.ts.map

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

package/dist/react-ui/blocks/BottomNavBar/types.js

@@ -0,0 +1,175 @@
+//#region src/react-ui/blocks/BottomNavBar/types.ts
+/**
+* Visual variant of the navigation bar
+* @enum {string}
+* @description Defines the visual style of the bottom navigation
+*/
+let NavVariant = /* @__PURE__ */ function(NavVariant) {
+	/** Glassmorphism effect with blur and transparency */
+	NavVariant["GLASS"] = "glass";
+	/** Solid background without transparency */
+	NavVariant["SOLID"] = "solid";
+	/** Transparent background - headless mode for custom styling */
+	NavVariant["HEADLESS"] = "headless";
+	return NavVariant;
+}({});
+/**
+* Size preset for the navigation bar
+* @enum {string}
+* @description Controls the overall size and spacing of navigation elements
+*/
+let NavSize = /* @__PURE__ */ function(NavSize) {
+	/** Compact size - 56px height, smaller touch targets */
+	NavSize["SMALL"] = "sm";
+	/** Default size - 72px height, optimal touch targets */
+	NavSize["MEDIUM"] = "md";
+	/** Large size - 88px height, larger touch targets */
+	NavSize["LARGE"] = "lg";
+	return NavSize;
+}({});
+/**
+* Position of the label relative to the icon
+* @enum {string}
+* @description Determines how labels are displayed in navigation items
+*/
+let LabelPosition = /* @__PURE__ */ function(LabelPosition) {
+	/** Label below the icon (default mobile pattern) */
+	LabelPosition["BELOW"] = "below";
+	/** Label beside the icon (horizontal layout) */
+	LabelPosition["BESIDE"] = "beside";
+	/** No label, icon only */
+	LabelPosition["HIDDEN"] = "hidden";
+	return LabelPosition;
+}({});
+/**
+* Animation type for navigation interactions
+* @enum {string}
+* @description Defines the animation behavior for navigation items
+*/
+let AnimationType = /* @__PURE__ */ function(AnimationType) {
+	/** Spring animation for natural feel */
+	AnimationType["SPRING"] = "spring";
+	/** Tween animation for precise timing */
+	AnimationType["TWEEN"] = "tween";
+	/** No animation */
+	AnimationType["NONE"] = "none";
+	return AnimationType;
+}({});
+/**
+* State of a navigation item
+* @enum {string}
+* @description Represents the current state of a navigation item
+*/
+let NavItemState = /* @__PURE__ */ function(NavItemState) {
+	/** Default inactive state */
+	NavItemState["INACTIVE"] = "inactive";
+	/** Currently selected/active item */
+	NavItemState["ACTIVE"] = "active";
+	/** Disabled and non-interactive */
+	NavItemState["DISABLED"] = "disabled";
+	return NavItemState;
+}({});
+/**
+* Icon size preset
+* @enum {number}
+* @description Standard icon sizes in pixels
+*/
+let IconSize = /* @__PURE__ */ function(IconSize) {
+	/** Small icons - 18px */
+	IconSize[IconSize["SMALL"] = 18] = "SMALL";
+	/** Medium icons - 24px (default) */
+	IconSize[IconSize["MEDIUM"] = 24] = "MEDIUM";
+	/** Large icons - 28px */
+	IconSize[IconSize["LARGE"] = 28] = "LARGE";
+	return IconSize;
+}({});
+/**
+* Z-index levels for layering
+* @enum {number}
+* @description Consistent z-index values for proper stacking
+*/
+let ZIndexLevel = /* @__PURE__ */ function(ZIndexLevel) {
+	/** Below default content */
+	ZIndexLevel[ZIndexLevel["BELOW"] = 40] = "BELOW";
+	/** Default navigation level */
+	ZIndexLevel[ZIndexLevel["DEFAULT"] = 50] = "DEFAULT";
+	/** Above most content */
+	ZIndexLevel[ZIndexLevel["ELEVATED"] = 60] = "ELEVATED";
+	/** Maximum elevation */
+	ZIndexLevel[ZIndexLevel["MAX"] = 100] = "MAX";
+	return ZIndexLevel;
+}({});
+/**
+* Blur intensity for glassmorphism
+* @enum {number}
+* @description Backdrop blur values in pixels
+*/
+let BlurIntensity = /* @__PURE__ */ function(BlurIntensity) {
+	/** Subtle blur - 8px */
+	BlurIntensity[BlurIntensity["LIGHT"] = 8] = "LIGHT";
+	/** Standard blur - 20px (default) */
+	BlurIntensity[BlurIntensity["MEDIUM"] = 20] = "MEDIUM";
+	/** Heavy blur - 40px */
+	BlurIntensity[BlurIntensity["HEAVY"] = 40] = "HEAVY";
+	return BlurIntensity;
+}({});
+/**
+* Border radius preset for navigation
+* @enum {string}
+* @description Defines the border radius style
+*/
+let NavBorderRadius = /* @__PURE__ */ function(NavBorderRadius) {
+	/** No border radius */
+	NavBorderRadius["NONE"] = "none";
+	/** Small radius - 8px */
+	NavBorderRadius["SMALL"] = "sm";
+	/** Medium radius - 16px (default) */
+	NavBorderRadius["MEDIUM"] = "md";
+	/** Large radius - 24px */
+	NavBorderRadius["LARGE"] = "lg";
+	/** Extra large radius - 32px */
+	NavBorderRadius["EXTRA_LARGE"] = "xl";
+	/** Full rounded (pill shape) */
+	NavBorderRadius["FULL"] = "full";
+	return NavBorderRadius;
+}({});
+/**
+* Default spring animation configuration
+* @constant
+*/
+const DEFAULT_SPRING_CONFIG = {
+	stiffness: 400,
+	damping: 30,
+	mass: 1
+};
+/**
+* Default tween animation configuration
+* @constant
+*/
+const DEFAULT_TWEEN_CONFIG = {
+	duration: .2,
+	ease: "easeOut"
+};
+/**
+* Default animation configuration
+* @constant
+*/
+const DEFAULT_ANIMATION_CONFIG = {
+	type: AnimationType.SPRING,
+	spring: DEFAULT_SPRING_CONFIG,
+	pressScale: .95,
+	hoverScale: 1.05
+};
+/**
+* Default glassmorphism configuration
+* @constant
+*/
+const DEFAULT_GLASS_CONFIG = {
+	blur: BlurIntensity.MEDIUM,
+	saturation: 180,
+	opacity: .72,
+	borderOpacity: .18
+};
+
+//#endregion
+export { AnimationType, BlurIntensity, DEFAULT_ANIMATION_CONFIG, DEFAULT_GLASS_CONFIG, DEFAULT_SPRING_CONFIG, DEFAULT_TWEEN_CONFIG, IconSize, LabelPosition, NavBorderRadius, NavItemState, NavSize, NavVariant, ZIndexLevel };

package/dist/react-ui/blocks/BottomNavBar/useIOSSafariFix.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 18+ 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/react-ui/blocks/BottomNavBar/useIOSSafariFix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIOSSafariFix.d.ts","sourceRoot":"","sources":["../../../../src/react-ui/blocks/BottomNavBar/useIOSSafariFix.ts"],"names":[],"mappings":"AAmBA;;;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,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAmC7C;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"}