ymy-components 0.0.49 → 0.0.50

package/dist/bottom-sheet/BottomSheet.d.ts

@@ -0,0 +1,8 @@
+import { ReactElement } from 'react';
+import { BottomSheetProps } from './BottomSheet.types';
+/**
+ * Draggable bottom sheet modal with gesture support.
+ * Features rubber-band physics, velocity-based swipe detection, and smooth animations.
+ */
+export declare function BottomSheet({ isOpen, onClose, children, title, maxHeight, velocityThreshold, closeThreshold, }: BottomSheetProps): ReactElement;
+export default BottomSheet;

package/dist/bottom-sheet/BottomSheet.styles.d.ts

@@ -0,0 +1,5 @@
+export declare const SheetOverlay: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const SheetContent: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const SheetHandle: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const SheetBody: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const VisuallyHidden: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;

package/dist/bottom-sheet/BottomSheet.types.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+export interface BottomSheetProps {
+    /** Whether the sheet is open */
+    isOpen: boolean;
+    /** Callback when the sheet should close */
+    onClose: () => void;
+    /** Content to render inside the sheet */
+    children: ReactNode;
+    /** Accessible title for screen readers */
+    title?: string;
+    /** Max height of the sheet (default: 300) */
+    maxHeight?: number;
+    /** Velocity threshold for swipe-to-close in px/ms (default: 0.4) */
+    velocityThreshold?: number;
+    /** Percentage of height drag required to close (default: 0.25) */
+    closeThreshold?: number;
+}

package/dist/constants/spring.config.d.ts

@@ -0,0 +1,25 @@
+import { SpringConfig } from '@react-spring/web';
+/**
+ * Shared React Spring configuration constants.
+ * Centralizes animation configs for consistent feel across applications.
+ */
+/** Base comfortable config - smooth, relaxed animations */
+export declare const SPRING_COMFORTABLE: SpringConfig;
+/** Slower comfortable variant for background/gradient transitions */
+export declare const SPRING_COMFORTABLE_SLOW: SpringConfig;
+/** Snappy config - quick, responsive animations */
+export declare const SPRING_SNAPPY: SpringConfig;
+/** Responsive config - for UI elements that need quick feedback */
+export declare const SPRING_RESPONSIVE: SpringConfig;
+/** Staggered/lagged config - for cascading animations */
+export declare const SPRING_STAGGERED: SpringConfig;
+/** Instant config - near-immediate transitions */
+export declare const SPRING_INSTANT: SpringConfig;
+/** Gentle config - subtle, unobtrusive animations */
+export declare const SPRING_GENTLE: SpringConfig;
+/** Very slow config - for delayed/transitional animations */
+export declare const SPRING_VERY_SLOW: SpringConfig;
+/** Landing config - for "settling" hero animations with slight overshoot */
+export declare const SPRING_LANDING: SpringConfig;
+/** Rising config - for reverse hero animations, smoother deceleration */
+export declare const SPRING_RISING: SpringConfig;

package/dist/hooks/useReducedMotion.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hook to detect if the user prefers reduced motion.
+ * Listens to the prefers-reduced-motion media query and updates reactively.
+ * @returns boolean - true if user prefers reduced motion
+ */
+export declare function useReducedMotion(): boolean;

package/dist/hooks/useReportPosition.d.ts

@@ -0,0 +1,27 @@
+import { RefCallback } from 'react';
+export interface SerializableRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+    x: number;
+    y: number;
+}
+export interface UseReportPositionOptions {
+    /** When false, position tracking is paused (default: true) */
+    enabled?: boolean;
+    /** Include margins in height calculation (default: true) */
+    includeMargins?: boolean;
+    /** Throttle interval in ms (default: 16 for ~60fps) */
+    throttleMs?: number;
+}
+/**
+ * Hook to track an element's position and report changes via callback.
+ * Uses ResizeObserver and scroll/resize listeners with throttling.
+ * @param onPositionChange - Callback fired when position changes meaningfully (>0.5px)
+ * @param options - Configuration options
+ * @returns RefCallback to attach to the target element
+ */
+export declare function useReportPosition(onPositionChange: (rect: SerializableRect) => void, options?: UseReportPositionOptions): RefCallback<HTMLElement>;

package/dist/hooks/useViewportSize.d.ts

@@ -0,0 +1,11 @@
+export interface ViewportSize {
+    width: number;
+    height: number;
+}
+/**
+ * Hook to track viewport dimensions with debounced updates.
+ * Listens to resize and orientation change events.
+ * @param debounceMs - Debounce delay in milliseconds (default: 100)
+ * @returns ViewportSize - Current viewport width and height
+ */
+export declare function useViewportSize(debounceMs?: number): ViewportSize;