veilkit 0.0.0-stage → 0.2.1

package/dist/react/index.d.cts

@@ -0,0 +1,121 @@
+import * as react from 'react';
+import react__default, { ReactNode, ButtonHTMLAttributes } from 'react';
+import { d as VeilGlobalConfig, V as VeilThemeName, C as CustomThemeInput, a as VeilAnimationName, S as SkeletonProps, A as AutoMeasureOptions, P as PresetProps, c as SpinnerProps, b as ProgressProps, O as OverlayProps, L as LoadingButtonProps, m as LazyImageProps } from '../types-CnR-rU97.cjs';
+
+interface VeilContextValue extends VeilGlobalConfig {
+    theme?: VeilThemeName | CustomThemeInput;
+    animation?: VeilAnimationName;
+}
+interface VeilProviderProps extends VeilGlobalConfig {
+    children?: ReactNode;
+}
+declare function VeilProvider({ children, theme, animation, nonce, locale, labels, antiFlicker, }: VeilProviderProps): react.JSX.Element;
+declare function useVeil(): VeilContextValue;
+
+interface UseDelayedLoadingOptions {
+    delay?: number;
+    minVisible?: number;
+}
+/**
+ * Suppresses loading state if brief (delay) and prevents rapid flickering (minVisible)
+ */
+declare function useDelayedLoading(loading: boolean, options?: UseDelayedLoadingOptions): boolean;
+/**
+ * Tracks promise execution and returns state + execute trigger
+ */
+declare function useLoading<T, Args extends any[]>(asyncFn: (...args: Args) => Promise<T>, options?: UseDelayedLoadingOptions): {
+    loading: boolean;
+    rawLoading: boolean;
+    data: T | null;
+    error: Error | null;
+    execute: (...args: Args) => Promise<T>;
+};
+/**
+ * Controls top progress bar from React
+ */
+declare function useProgress(): {
+    start: () => void;
+    set: (n: number) => void;
+    inc: (amount?: number) => void;
+    done: () => void;
+    fail: () => void;
+};
+
+interface ReactSkeletonProps extends SkeletonProps {
+    children?: ReactNode;
+    circle?: boolean;
+}
+declare function Skeleton({ type, circle, width, height, radius, count, gap, lines, lastLineWidth, animation, theme, direction, speed, className, style, ariaLabel, children, }: ReactSkeletonProps): react.JSX.Element;
+interface VeilWrapperProps extends AutoMeasureOptions {
+    loading: boolean;
+    children: ReactNode;
+    skeletonProps?: SkeletonProps;
+}
+/**
+ * Auto-Measure wrapper component
+ * Wraps real content, measures layout upon loading, and reveals cleanly with no hydration mismatches
+ */
+declare function Veil({ loading, children, cacheKey, persistCache, ignoreSelector, observeResize, observeMutations, preserveBackground, reveal, revealDuration, revealEasing, delay, minVisible, skeletonProps, }: VeilWrapperProps): react.JSX.Element;
+
+declare function SkeletonPreset(props: PresetProps): react.JSX.Element;
+declare const SkeletonCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProductCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProductGrid: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonListItem: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTable: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProfile: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonFeedPost: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonArticle: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonDashboard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonForm: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonNavbar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonSidebar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProductDetail: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonNewsFeed: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonInboxList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonNotificationList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonOrderList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonKpiCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonChartBar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonChartLine: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonChartPie: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonSearchResults: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonVideoPlayer: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonMusicPlayer: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonStoriesRow: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonReels: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTabs: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonCalendar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonKanban: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTimeline: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonMapCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonPricingCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTestimonial: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonFaqAccordion: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+
+declare function Spinner(props: SpinnerProps): react.JSX.Element;
+
+declare function ProgressBar(props: ProgressProps): react.JSX.Element;
+interface RouteProgressProps {
+    color?: string;
+}
+/**
+ * Route Progress Bar for Next.js and React SPA routers
+ */
+declare function RouteProgress({ color }: RouteProgressProps): null;
+
+interface ReactOverlayProps extends OverlayProps {
+    children?: react__default.ReactNode;
+}
+declare function Overlay({ visible, blur, opacity, color, spinner, message, lockScroll, className, zIndex, children, }: ReactOverlayProps): react__default.JSX.Element;
+
+interface ReactLoadingButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'>, LoadingButtonProps {
+    children?: ReactNode;
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => Promise<any> | void;
+}
+declare function LoadingButton({ status, loading, styleType, spinner, spinnerPlacement, loadingText, successText, errorText, resetAfter, progress, pressFeedback, resultAnimation, haptics, disabled, children, className, onStatusChange, onClick, ...rest }: ReactLoadingButtonProps): react.JSX.Element;
+
+declare function LazyImage(props: LazyImageProps): react.JSX.Element;
+
+export { LazyImage, LoadingButton, Overlay, ProgressBar, type ReactLoadingButtonProps, type ReactOverlayProps, type ReactSkeletonProps, RouteProgress, type RouteProgressProps, Skeleton, SkeletonArticle, SkeletonCalendar, SkeletonCard, SkeletonChartBar, SkeletonChartLine, SkeletonChartPie, SkeletonDashboard, SkeletonFaqAccordion, SkeletonFeedPost, SkeletonForm, SkeletonInboxList, SkeletonKanban, SkeletonKpiCard, SkeletonList, SkeletonListItem, SkeletonMapCard, SkeletonMusicPlayer, SkeletonNavbar, SkeletonNewsFeed, SkeletonNotificationList, SkeletonOrderList, SkeletonPreset, SkeletonPricingCard, SkeletonProductCard, SkeletonProductDetail, SkeletonProductGrid, SkeletonProfile, SkeletonReels, SkeletonSearchResults, SkeletonSidebar, SkeletonStoriesRow, SkeletonTable, SkeletonTabs, SkeletonTestimonial, SkeletonTimeline, SkeletonVideoPlayer, Spinner, type UseDelayedLoadingOptions, Veil, VeilProvider, type VeilProviderProps, type VeilWrapperProps, useDelayedLoading, useLoading, useProgress, useVeil };

package/dist/react/index.d.ts

@@ -0,0 +1,121 @@
+import * as react from 'react';
+import react__default, { ReactNode, ButtonHTMLAttributes } from 'react';
+import { d as VeilGlobalConfig, V as VeilThemeName, C as CustomThemeInput, a as VeilAnimationName, S as SkeletonProps, A as AutoMeasureOptions, P as PresetProps, c as SpinnerProps, b as ProgressProps, O as OverlayProps, L as LoadingButtonProps, m as LazyImageProps } from '../types-CnR-rU97.js';
+
+interface VeilContextValue extends VeilGlobalConfig {
+    theme?: VeilThemeName | CustomThemeInput;
+    animation?: VeilAnimationName;
+}
+interface VeilProviderProps extends VeilGlobalConfig {
+    children?: ReactNode;
+}
+declare function VeilProvider({ children, theme, animation, nonce, locale, labels, antiFlicker, }: VeilProviderProps): react.JSX.Element;
+declare function useVeil(): VeilContextValue;
+
+interface UseDelayedLoadingOptions {
+    delay?: number;
+    minVisible?: number;
+}
+/**
+ * Suppresses loading state if brief (delay) and prevents rapid flickering (minVisible)
+ */
+declare function useDelayedLoading(loading: boolean, options?: UseDelayedLoadingOptions): boolean;
+/**
+ * Tracks promise execution and returns state + execute trigger
+ */
+declare function useLoading<T, Args extends any[]>(asyncFn: (...args: Args) => Promise<T>, options?: UseDelayedLoadingOptions): {
+    loading: boolean;
+    rawLoading: boolean;
+    data: T | null;
+    error: Error | null;
+    execute: (...args: Args) => Promise<T>;
+};
+/**
+ * Controls top progress bar from React
+ */
+declare function useProgress(): {
+    start: () => void;
+    set: (n: number) => void;
+    inc: (amount?: number) => void;
+    done: () => void;
+    fail: () => void;
+};
+
+interface ReactSkeletonProps extends SkeletonProps {
+    children?: ReactNode;
+    circle?: boolean;
+}
+declare function Skeleton({ type, circle, width, height, radius, count, gap, lines, lastLineWidth, animation, theme, direction, speed, className, style, ariaLabel, children, }: ReactSkeletonProps): react.JSX.Element;
+interface VeilWrapperProps extends AutoMeasureOptions {
+    loading: boolean;
+    children: ReactNode;
+    skeletonProps?: SkeletonProps;
+}
+/**
+ * Auto-Measure wrapper component
+ * Wraps real content, measures layout upon loading, and reveals cleanly with no hydration mismatches
+ */
+declare function Veil({ loading, children, cacheKey, persistCache, ignoreSelector, observeResize, observeMutations, preserveBackground, reveal, revealDuration, revealEasing, delay, minVisible, skeletonProps, }: VeilWrapperProps): react.JSX.Element;
+
+declare function SkeletonPreset(props: PresetProps): react.JSX.Element;
+declare const SkeletonCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProductCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProductGrid: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonListItem: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTable: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProfile: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonFeedPost: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonArticle: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonDashboard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonForm: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonNavbar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonSidebar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonProductDetail: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonNewsFeed: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonInboxList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonNotificationList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonOrderList: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonKpiCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonChartBar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonChartLine: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonChartPie: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonSearchResults: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonVideoPlayer: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonMusicPlayer: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonStoriesRow: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonReels: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTabs: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonCalendar: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonKanban: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTimeline: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonMapCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonPricingCard: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonTestimonial: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+declare const SkeletonFaqAccordion: (props: Omit<PresetProps, "name">) => react.JSX.Element;
+
+declare function Spinner(props: SpinnerProps): react.JSX.Element;
+
+declare function ProgressBar(props: ProgressProps): react.JSX.Element;
+interface RouteProgressProps {
+    color?: string;
+}
+/**
+ * Route Progress Bar for Next.js and React SPA routers
+ */
+declare function RouteProgress({ color }: RouteProgressProps): null;
+
+interface ReactOverlayProps extends OverlayProps {
+    children?: react__default.ReactNode;
+}
+declare function Overlay({ visible, blur, opacity, color, spinner, message, lockScroll, className, zIndex, children, }: ReactOverlayProps): react__default.JSX.Element;
+
+interface ReactLoadingButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'>, LoadingButtonProps {
+    children?: ReactNode;
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => Promise<any> | void;
+}
+declare function LoadingButton({ status, loading, styleType, spinner, spinnerPlacement, loadingText, successText, errorText, resetAfter, progress, pressFeedback, resultAnimation, haptics, disabled, children, className, onStatusChange, onClick, ...rest }: ReactLoadingButtonProps): react.JSX.Element;
+
+declare function LazyImage(props: LazyImageProps): react.JSX.Element;
+
+export { LazyImage, LoadingButton, Overlay, ProgressBar, type ReactLoadingButtonProps, type ReactOverlayProps, type ReactSkeletonProps, RouteProgress, type RouteProgressProps, Skeleton, SkeletonArticle, SkeletonCalendar, SkeletonCard, SkeletonChartBar, SkeletonChartLine, SkeletonChartPie, SkeletonDashboard, SkeletonFaqAccordion, SkeletonFeedPost, SkeletonForm, SkeletonInboxList, SkeletonKanban, SkeletonKpiCard, SkeletonList, SkeletonListItem, SkeletonMapCard, SkeletonMusicPlayer, SkeletonNavbar, SkeletonNewsFeed, SkeletonNotificationList, SkeletonOrderList, SkeletonPreset, SkeletonPricingCard, SkeletonProductCard, SkeletonProductDetail, SkeletonProductGrid, SkeletonProfile, SkeletonReels, SkeletonSearchResults, SkeletonSidebar, SkeletonStoriesRow, SkeletonTable, SkeletonTabs, SkeletonTestimonial, SkeletonTimeline, SkeletonVideoPlayer, Spinner, type UseDelayedLoadingOptions, Veil, VeilProvider, type VeilProviderProps, type VeilWrapperProps, useDelayedLoading, useLoading, useProgress, useVeil };