@djangocfg/ui-tools 2.1.129 → 2.1.131

package/dist/index.d.cts

@@ -1226,6 +1226,112 @@ interface ImageViewerProps {
  */
 declare const LazyImageViewer: React$1.ComponentType<ImageViewerProps>;
 
+/**
+ * CronScheduler Types
+ *
+ * Unix 5-field cron format: minute hour day-of-month month day-of-week
+ */
+type ScheduleType = 'daily' | 'weekly' | 'monthly' | 'custom';
+/** Day of week: 0 = Sunday, 1 = Monday, ..., 6 = Saturday */
+type WeekDay = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** Day of month: 1-31 */
+type MonthDay = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31;
+interface CronSchedulerState {
+    /** Current schedule type */
+    type: ScheduleType;
+    /** Hour (0-23) */
+    hour: number;
+    /** Minute (0-59) */
+    minute: number;
+    /** Selected week days (for weekly type) */
+    weekDays: WeekDay[];
+    /** Selected month days (for monthly type) */
+    monthDays: MonthDay[];
+    /** Raw cron expression (for custom type) */
+    customCron: string;
+    /** Whether current state produces valid cron */
+    isValid: boolean;
+}
+interface CronSchedulerComputed {
+    /** Generated cron expression */
+    cronExpression: string;
+    /** Human-readable description */
+    humanDescription: string;
+}
+interface CronSchedulerActions {
+    /** Set schedule type */
+    setType: (type: ScheduleType) => void;
+    /** Set time (hour and minute) */
+    setTime: (hour: number, minute: number) => void;
+    /** Toggle a week day selection */
+    toggleWeekDay: (day: WeekDay) => void;
+    /** Set all week days at once */
+    setWeekDays: (days: WeekDay[]) => void;
+    /** Toggle a month day selection */
+    toggleMonthDay: (day: MonthDay) => void;
+    /** Set all month days at once */
+    setMonthDays: (days: MonthDay[]) => void;
+    /** Set custom cron expression */
+    setCustomCron: (cron: string) => void;
+    /** Reset to default state */
+    reset: () => void;
+}
+interface CronSchedulerContextValue extends CronSchedulerState, CronSchedulerComputed, CronSchedulerActions {
+}
+interface CronSchedulerProps {
+    /** Current cron expression (Unix 5-field format) */
+    value?: string;
+    /** Callback when schedule changes */
+    onChange?: (cron: string) => void;
+    /** Initial schedule type (default: 'daily') */
+    defaultType?: ScheduleType;
+    /** Show human-readable preview (default: true) */
+    showPreview?: boolean;
+    /** Show raw cron expression in preview (default: false) */
+    showCronExpression?: boolean;
+    /** Allow copying cron expression (default: false) */
+    allowCopy?: boolean;
+    /** 12h or 24h time format (default: '24h') */
+    timeFormat?: '12h' | '24h';
+    /** Disable all interactions */
+    disabled?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+interface CronSchedulerProviderProps {
+    children: React.ReactNode;
+    value?: string;
+    onChange?: (cron: string) => void;
+    defaultType?: ScheduleType;
+}
+
+/**
+ * LazyCronScheduler - Lazy-loaded cron expression builder
+ *
+ * Automatically shows loading state while CronScheduler loads (~15KB).
+ * Uses createLazyComponent factory for optimal code-splitting.
+ *
+ * @example
+ * // Basic usage
+ * <LazyCronScheduler
+ *   value="0 9 * * *"
+ *   onChange={handleChange}
+ * />
+ *
+ * @example
+ * // With all options
+ * <LazyCronScheduler
+ *   value={cron}
+ *   onChange={setCron}
+ *   defaultType="weekly"
+ *   showPreview
+ *   showCronExpression
+ *   allowCopy
+ *   timeFormat="24h"
+ * />
+ */
+declare const LazyCronScheduler: React$1.ComponentType<CronSchedulerProps>;
+
 /**
  * Mermaid Component - Dynamic Import Wrapper
  *
@@ -1792,6 +1898,179 @@ declare function formatTime(seconds: number): string;
 
 declare function ImageViewer({ file, content, src: directSrc, inDialog }: ImageViewerProps): react_jsx_runtime.JSX.Element;
 
+declare function CronSchedulerProvider({ children, value, onChange, defaultType, }: CronSchedulerProviderProps): react_jsx_runtime.JSX.Element;
+declare function useCronSchedulerContext(): CronSchedulerContextValue;
+
+/**
+ * Hook for schedule type selection
+ * Re-renders only when type changes
+ */
+declare function useCronType(): {
+    type: ScheduleType;
+    setType: (type: ScheduleType) => void;
+};
+/**
+ * Hook for time selection
+ * Re-renders only when hour/minute changes
+ */
+declare function useCronTime(): {
+    hour: number;
+    minute: number;
+    setTime: (hour: number, minute: number) => void;
+};
+/**
+ * Hook for week days selection
+ * Re-renders only when weekDays changes
+ */
+declare function useCronWeekDays(): {
+    weekDays: WeekDay[];
+    toggleWeekDay: (day: WeekDay) => void;
+    setWeekDays: (days: WeekDay[]) => void;
+};
+/**
+ * Hook for month days selection
+ * Re-renders only when monthDays changes
+ */
+declare function useCronMonthDays(): {
+    monthDays: MonthDay[];
+    toggleMonthDay: (day: MonthDay) => void;
+    setMonthDays: (days: MonthDay[]) => void;
+};
+/**
+ * Hook for custom cron input
+ * Re-renders only when customCron/isValid changes
+ */
+declare function useCronCustom(): {
+    customCron: string;
+    isValid: boolean;
+    setCustomCron: (cron: string) => void;
+};
+/**
+ * Hook for preview display
+ * Re-renders only when computed values change
+ */
+declare function useCronPreview(): {
+    cronExpression: string;
+    humanDescription: string;
+    isValid: boolean;
+};
+/**
+ * Full context access
+ * Use sparingly - causes re-render on any state change
+ */
+declare function useCronScheduler(): CronSchedulerContextValue;
+
+/**
+ * Cron Builder
+ *
+ * Converts CronSchedulerState to Unix 5-field cron expression
+ * Format: minute hour day-of-month month day-of-week
+ */
+
+/**
+ * Builds Unix 5-field cron expression from state
+ *
+ * @example
+ * // Daily at 9:00
+ * buildCron({ type: 'daily', hour: 9, minute: 0, ... }) // '0 9 * * *'
+ *
+ * // Weekly on Mon, Wed, Fri at 14:30
+ * buildCron({ type: 'weekly', hour: 14, minute: 30, weekDays: [1, 3, 5], ... }) // '30 14 * * 1,3,5'
+ *
+ * // Monthly on 1st and 15th at 0:00
+ * buildCron({ type: 'monthly', hour: 0, minute: 0, monthDays: [1, 15], ... }) // '0 0 1,15 * *'
+ */
+declare function buildCron(state: CronSchedulerState): string;
+
+/**
+ * Cron Parser
+ *
+ * Parses Unix 5-field cron expression into CronSchedulerState
+ * Format: minute hour day-of-month month day-of-week
+ */
+
+/**
+ * Parses Unix 5-field cron expression into state
+ *
+ * @param cron - Cron expression to parse
+ * @returns Parsed state or null if invalid
+ *
+ * @example
+ * parseCron('0 9 * * *')
+ * // { type: 'daily', hour: 9, minute: 0, ... }
+ *
+ * parseCron('30 14 * * 1,3,5')
+ * // { type: 'weekly', hour: 14, minute: 30, weekDays: [1, 3, 5], ... }
+ */
+declare function parseCron(cron: string): CronSchedulerState | null;
+/**
+ * Validates cron expression syntax
+ */
+declare function isValidCron(cron: string): boolean;
+
+/**
+ * Cron Humanize
+ *
+ * Converts cron expressions to human-readable descriptions
+ */
+/**
+ * Converts cron expression to human-readable description
+ *
+ * Examples:
+ * - humanizeCron('0 9 * * *') returns "Every day at 09:00"
+ * - humanizeCron('30 14 * * 1,3,5') returns "Mon, Wed, Fri at 14:30"
+ * - humanizeCron('0 0 1 * *') returns "1st of every month at 00:00"
+ */
+declare function humanizeCron(cron: string): string;
+
+interface ScheduleTypeSelectorProps {
+    disabled?: boolean;
+    className?: string;
+}
+declare function ScheduleTypeSelector({ disabled, className, }: ScheduleTypeSelectorProps): react_jsx_runtime.JSX.Element;
+
+interface TimeSelectorProps {
+    format?: '12h' | '24h';
+    disabled?: boolean;
+    className?: string;
+}
+declare function TimeSelector({ format, disabled, className, }: TimeSelectorProps): react_jsx_runtime.JSX.Element;
+
+interface DayChipsProps {
+    disabled?: boolean;
+    showPresets?: boolean;
+    className?: string;
+}
+declare function DayChips({ disabled, showPresets, className, }: DayChipsProps): react_jsx_runtime.JSX.Element;
+
+interface MonthDayGridProps {
+    disabled?: boolean;
+    showPresets?: boolean;
+    className?: string;
+}
+declare function MonthDayGrid({ disabled, showPresets, className, }: MonthDayGridProps): react_jsx_runtime.JSX.Element;
+
+interface CustomInputProps {
+    disabled?: boolean;
+    className?: string;
+}
+declare function CustomInput({ disabled, className }: CustomInputProps): react_jsx_runtime.JSX.Element;
+
+interface SchedulePreviewProps {
+    /** Show raw cron expression (default: true) */
+    showCronExpression?: boolean;
+    /** Enable copy to clipboard */
+    allowCopy?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+declare function SchedulePreview({ showCronExpression, allowCopy, className, }: SchedulePreviewProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * CronScheduler with Suspense wrapper
+ */
+declare function CronScheduler(props: CronSchedulerProps): react_jsx_runtime.JSX.Element;
+
 interface BlobUrlEntry {
     url: string;
     refCount: number;
@@ -1970,4 +2249,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, type DASHSource, type DataUrlSource, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyHybridAudioPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps$1 as MermaidProps, MeshEffect, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, type UrlSource, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type YouTubeSource, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, isSimpleStreamSource, mergeDefaults, normalizeFormData, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };
+export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps$1 as MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };

package/dist/index.d.ts

@@ -1226,6 +1226,112 @@ interface ImageViewerProps {
  */
 declare const LazyImageViewer: React$1.ComponentType<ImageViewerProps>;
 
+/**
+ * CronScheduler Types
+ *
+ * Unix 5-field cron format: minute hour day-of-month month day-of-week
+ */
+type ScheduleType = 'daily' | 'weekly' | 'monthly' | 'custom';
+/** Day of week: 0 = Sunday, 1 = Monday, ..., 6 = Saturday */
+type WeekDay = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** Day of month: 1-31 */
+type MonthDay = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31;
+interface CronSchedulerState {
+    /** Current schedule type */
+    type: ScheduleType;
+    /** Hour (0-23) */
+    hour: number;
+    /** Minute (0-59) */
+    minute: number;
+    /** Selected week days (for weekly type) */
+    weekDays: WeekDay[];
+    /** Selected month days (for monthly type) */
+    monthDays: MonthDay[];
+    /** Raw cron expression (for custom type) */
+    customCron: string;
+    /** Whether current state produces valid cron */
+    isValid: boolean;
+}
+interface CronSchedulerComputed {
+    /** Generated cron expression */
+    cronExpression: string;
+    /** Human-readable description */
+    humanDescription: string;
+}
+interface CronSchedulerActions {
+    /** Set schedule type */
+    setType: (type: ScheduleType) => void;
+    /** Set time (hour and minute) */
+    setTime: (hour: number, minute: number) => void;
+    /** Toggle a week day selection */
+    toggleWeekDay: (day: WeekDay) => void;
+    /** Set all week days at once */
+    setWeekDays: (days: WeekDay[]) => void;
+    /** Toggle a month day selection */
+    toggleMonthDay: (day: MonthDay) => void;
+    /** Set all month days at once */
+    setMonthDays: (days: MonthDay[]) => void;
+    /** Set custom cron expression */
+    setCustomCron: (cron: string) => void;
+    /** Reset to default state */
+    reset: () => void;
+}
+interface CronSchedulerContextValue extends CronSchedulerState, CronSchedulerComputed, CronSchedulerActions {
+}
+interface CronSchedulerProps {
+    /** Current cron expression (Unix 5-field format) */
+    value?: string;
+    /** Callback when schedule changes */
+    onChange?: (cron: string) => void;
+    /** Initial schedule type (default: 'daily') */
+    defaultType?: ScheduleType;
+    /** Show human-readable preview (default: true) */
+    showPreview?: boolean;
+    /** Show raw cron expression in preview (default: false) */
+    showCronExpression?: boolean;
+    /** Allow copying cron expression (default: false) */
+    allowCopy?: boolean;
+    /** 12h or 24h time format (default: '24h') */
+    timeFormat?: '12h' | '24h';
+    /** Disable all interactions */
+    disabled?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+interface CronSchedulerProviderProps {
+    children: React.ReactNode;
+    value?: string;
+    onChange?: (cron: string) => void;
+    defaultType?: ScheduleType;
+}
+
+/**
+ * LazyCronScheduler - Lazy-loaded cron expression builder
+ *
+ * Automatically shows loading state while CronScheduler loads (~15KB).
+ * Uses createLazyComponent factory for optimal code-splitting.
+ *
+ * @example
+ * // Basic usage
+ * <LazyCronScheduler
+ *   value="0 9 * * *"
+ *   onChange={handleChange}
+ * />
+ *
+ * @example
+ * // With all options
+ * <LazyCronScheduler
+ *   value={cron}
+ *   onChange={setCron}
+ *   defaultType="weekly"
+ *   showPreview
+ *   showCronExpression
+ *   allowCopy
+ *   timeFormat="24h"
+ * />
+ */
+declare const LazyCronScheduler: React$1.ComponentType<CronSchedulerProps>;
+
 /**
  * Mermaid Component - Dynamic Import Wrapper
  *
@@ -1792,6 +1898,179 @@ declare function formatTime(seconds: number): string;
 
 declare function ImageViewer({ file, content, src: directSrc, inDialog }: ImageViewerProps): react_jsx_runtime.JSX.Element;
 
+declare function CronSchedulerProvider({ children, value, onChange, defaultType, }: CronSchedulerProviderProps): react_jsx_runtime.JSX.Element;
+declare function useCronSchedulerContext(): CronSchedulerContextValue;
+
+/**
+ * Hook for schedule type selection
+ * Re-renders only when type changes
+ */
+declare function useCronType(): {
+    type: ScheduleType;
+    setType: (type: ScheduleType) => void;
+};
+/**
+ * Hook for time selection
+ * Re-renders only when hour/minute changes
+ */
+declare function useCronTime(): {
+    hour: number;
+    minute: number;
+    setTime: (hour: number, minute: number) => void;
+};
+/**
+ * Hook for week days selection
+ * Re-renders only when weekDays changes
+ */
+declare function useCronWeekDays(): {
+    weekDays: WeekDay[];
+    toggleWeekDay: (day: WeekDay) => void;
+    setWeekDays: (days: WeekDay[]) => void;
+};
+/**
+ * Hook for month days selection
+ * Re-renders only when monthDays changes
+ */
+declare function useCronMonthDays(): {
+    monthDays: MonthDay[];
+    toggleMonthDay: (day: MonthDay) => void;
+    setMonthDays: (days: MonthDay[]) => void;
+};
+/**
+ * Hook for custom cron input
+ * Re-renders only when customCron/isValid changes
+ */
+declare function useCronCustom(): {
+    customCron: string;
+    isValid: boolean;
+    setCustomCron: (cron: string) => void;
+};
+/**
+ * Hook for preview display
+ * Re-renders only when computed values change
+ */
+declare function useCronPreview(): {
+    cronExpression: string;
+    humanDescription: string;
+    isValid: boolean;
+};
+/**
+ * Full context access
+ * Use sparingly - causes re-render on any state change
+ */
+declare function useCronScheduler(): CronSchedulerContextValue;
+
+/**
+ * Cron Builder
+ *
+ * Converts CronSchedulerState to Unix 5-field cron expression
+ * Format: minute hour day-of-month month day-of-week
+ */
+
+/**
+ * Builds Unix 5-field cron expression from state
+ *
+ * @example
+ * // Daily at 9:00
+ * buildCron({ type: 'daily', hour: 9, minute: 0, ... }) // '0 9 * * *'
+ *
+ * // Weekly on Mon, Wed, Fri at 14:30
+ * buildCron({ type: 'weekly', hour: 14, minute: 30, weekDays: [1, 3, 5], ... }) // '30 14 * * 1,3,5'
+ *
+ * // Monthly on 1st and 15th at 0:00
+ * buildCron({ type: 'monthly', hour: 0, minute: 0, monthDays: [1, 15], ... }) // '0 0 1,15 * *'
+ */
+declare function buildCron(state: CronSchedulerState): string;
+
+/**
+ * Cron Parser
+ *
+ * Parses Unix 5-field cron expression into CronSchedulerState
+ * Format: minute hour day-of-month month day-of-week
+ */
+
+/**
+ * Parses Unix 5-field cron expression into state
+ *
+ * @param cron - Cron expression to parse
+ * @returns Parsed state or null if invalid
+ *
+ * @example
+ * parseCron('0 9 * * *')
+ * // { type: 'daily', hour: 9, minute: 0, ... }
+ *
+ * parseCron('30 14 * * 1,3,5')
+ * // { type: 'weekly', hour: 14, minute: 30, weekDays: [1, 3, 5], ... }
+ */
+declare function parseCron(cron: string): CronSchedulerState | null;
+/**
+ * Validates cron expression syntax
+ */
+declare function isValidCron(cron: string): boolean;
+
+/**
+ * Cron Humanize
+ *
+ * Converts cron expressions to human-readable descriptions
+ */
+/**
+ * Converts cron expression to human-readable description
+ *
+ * Examples:
+ * - humanizeCron('0 9 * * *') returns "Every day at 09:00"
+ * - humanizeCron('30 14 * * 1,3,5') returns "Mon, Wed, Fri at 14:30"
+ * - humanizeCron('0 0 1 * *') returns "1st of every month at 00:00"
+ */
+declare function humanizeCron(cron: string): string;
+
+interface ScheduleTypeSelectorProps {
+    disabled?: boolean;
+    className?: string;
+}
+declare function ScheduleTypeSelector({ disabled, className, }: ScheduleTypeSelectorProps): react_jsx_runtime.JSX.Element;
+
+interface TimeSelectorProps {
+    format?: '12h' | '24h';
+    disabled?: boolean;
+    className?: string;
+}
+declare function TimeSelector({ format, disabled, className, }: TimeSelectorProps): react_jsx_runtime.JSX.Element;
+
+interface DayChipsProps {
+    disabled?: boolean;
+    showPresets?: boolean;
+    className?: string;
+}
+declare function DayChips({ disabled, showPresets, className, }: DayChipsProps): react_jsx_runtime.JSX.Element;
+
+interface MonthDayGridProps {
+    disabled?: boolean;
+    showPresets?: boolean;
+    className?: string;
+}
+declare function MonthDayGrid({ disabled, showPresets, className, }: MonthDayGridProps): react_jsx_runtime.JSX.Element;
+
+interface CustomInputProps {
+    disabled?: boolean;
+    className?: string;
+}
+declare function CustomInput({ disabled, className }: CustomInputProps): react_jsx_runtime.JSX.Element;
+
+interface SchedulePreviewProps {
+    /** Show raw cron expression (default: true) */
+    showCronExpression?: boolean;
+    /** Enable copy to clipboard */
+    allowCopy?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+declare function SchedulePreview({ showCronExpression, allowCopy, className, }: SchedulePreviewProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * CronScheduler with Suspense wrapper
+ */
+declare function CronScheduler(props: CronSchedulerProps): react_jsx_runtime.JSX.Element;
+
 interface BlobUrlEntry {
     url: string;
     refCount: number;
@@ -1970,4 +2249,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, type DASHSource, type DataUrlSource, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyHybridAudioPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps$1 as MermaidProps, MeshEffect, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, type UrlSource, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type YouTubeSource, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, isSimpleStreamSource, mergeDefaults, normalizeFormData, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };
+export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps$1 as MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };

package/dist/index.mjs

@@ -3,6 +3,7 @@ export { NativeProvider, StreamProvider, VideoControls, VideoErrorFallback, Vide
 import './chunk-JWB2EWQO.mjs';
 export { ImageViewer } from './chunk-2DSR7V2L.mjs';
 export { generateContentKey, useAudioCache, useBlobUrlCleanup, useImageCache, useMediaCacheStore, useVideoCache, useVideoPlayerSettings } from './chunk-LTJX2JXE.mjs';
+export { CronSchedulerProvider, CustomInput, DayChips, MonthDayGrid, SchedulePreview, ScheduleTypeSelector, TimeSelector, buildCron, humanizeCron, isValidCron, parseCron, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays } from './chunk-MQDWUBVX.mjs';
 import { PlaygroundProvider, PrettyCode_default } from './chunk-XZZ22EHP.mjs';
 export { PrettyCode_default as PrettyCode } from './chunk-XZZ22EHP.mjs';
 export { JsonTree_default as JsonTree } from './chunk-XXFYTIQK.mjs';
@@ -823,6 +824,20 @@ var LazyImageViewer = createLazyComponent(
     fallback: /* @__PURE__ */ jsx(LoadingFallback, { minHeight: 200, text: "Loading image viewer..." })
   }
 );
+var LazyCronScheduler = createLazyComponent(
+  () => import('./CronScheduler.client-5UEBG4EY.mjs'),
+  {
+    displayName: "LazyCronScheduler",
+    fallback: /* @__PURE__ */ jsx(
+      LoadingFallback,
+      {
+        minHeight: 120,
+        showText: false,
+        className: "rounded-lg"
+      }
+    )
+  }
+);
 var LottiePlayerClient = lazy(
   () => import('./LottiePlayer.client-B4I6WNZM.mjs').then((mod) => ({ default: mod.LottiePlayer }))
 );
@@ -842,7 +857,23 @@ var Playground = /* @__PURE__ */ __name(({ config }) => {
   return /* @__PURE__ */ jsx(PlaygroundProvider, { config, children: /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(LoadingFallback9, {}), children: /* @__PURE__ */ jsx(PlaygroundLayout, {}) }) });
 }, "Playground");
 var OpenapiViewer_default = Playground;
+var CronSchedulerClient = lazy(() => import('./CronScheduler.client-5UEBG4EY.mjs'));
+function CronScheduler(props) {
+  return /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(CronSchedulerFallback, {}), children: /* @__PURE__ */ jsx(CronSchedulerClient, { ...props }) });
+}
+__name(CronScheduler, "CronScheduler");
+function CronSchedulerFallback() {
+  return /* @__PURE__ */ jsx(
+    LoadingFallback,
+    {
+      minHeight: 120,
+      showText: false,
+      className: "rounded-lg"
+    }
+  );
+}
+__name(CronSchedulerFallback, "CronSchedulerFallback");
 
-export { CardLoadingFallback, LazyHybridAudioPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, LoadingFallback, LottiePlayer, MapLoadingFallback, MarkdownMessage, Mermaid_default as Mermaid, OpenapiViewer_default as OpenapiViewer, Spinner, createLazyComponent, useCollapsibleContent };
+export { CardLoadingFallback, CronScheduler, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, LoadingFallback, LottiePlayer, MapLoadingFallback, MarkdownMessage, Mermaid_default as Mermaid, OpenapiViewer_default as OpenapiViewer, Spinner, createLazyComponent, useCollapsibleContent };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map