@djangocfg/ui-tools 2.1.130 → 2.1.132

package/src/tools/CronScheduler/utils/cron-parser.ts

@@ -0,0 +1,188 @@
+/**
+ * Cron Parser
+ *
+ * Parses Unix 5-field cron expression into CronSchedulerState
+ * Format: minute hour day-of-month month day-of-week
+ */
+
+import type { CronSchedulerState, ScheduleType, WeekDay, MonthDay } from '../types';
+
+/**
+ * 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], ... }
+ */
+export function parseCron(cron: string): CronSchedulerState | null {
+  if (!cron || typeof cron !== 'string') return null;
+
+  const parts = cron.trim().split(/\s+/);
+
+  // Unix cron has exactly 5 fields
+  if (parts.length !== 5) return null;
+
+  const [minutePart, hourPart, dayOfMonthPart, monthPart, dayOfWeekPart] = parts;
+
+  // Parse minute (0-59 or *)
+  const minute = parseField(minutePart, 0, 59);
+  if (minute === null && minutePart !== '*') return null;
+
+  // Parse hour (0-23 or *)
+  const hour = parseField(hourPart, 0, 23);
+  if (hour === null && hourPart !== '*') return null;
+
+  // Determine schedule type based on field patterns
+  const result = detectScheduleType(
+    minutePart,
+    hourPart,
+    dayOfMonthPart,
+    monthPart,
+    dayOfWeekPart
+  );
+
+  return {
+    type: result.type,
+    hour: hour ?? 0,
+    minute: minute ?? 0,
+    weekDays: result.weekDays,
+    monthDays: result.monthDays,
+    customCron: cron,
+    isValid: true,
+  };
+}
+
+/**
+ * Detects schedule type from cron fields
+ */
+function detectScheduleType(
+  _minutePart: string,
+  _hourPart: string,
+  dayOfMonthPart: string,
+  monthPart: string,
+  dayOfWeekPart: string
+): {
+  type: ScheduleType;
+  weekDays: WeekDay[];
+  monthDays: MonthDay[];
+} {
+  // Default values
+  let type: ScheduleType = 'custom';
+  let weekDays: WeekDay[] = [1, 2, 3, 4, 5]; // Mon-Fri
+  let monthDays: MonthDay[] = [1];
+
+  // Daily: M H * * *
+  if (dayOfMonthPart === '*' && monthPart === '*' && dayOfWeekPart === '*') {
+    type = 'daily';
+  }
+  // Weekly: M H * * 1,2,3 (or ranges like 1-5)
+  else if (dayOfMonthPart === '*' && monthPart === '*' && dayOfWeekPart !== '*') {
+    type = 'weekly';
+    weekDays = parseWeekDays(dayOfWeekPart);
+  }
+  // Monthly: M H 1,15 * * (day-of-month specified)
+  else if (dayOfMonthPart !== '*' && monthPart === '*' && dayOfWeekPart === '*') {
+    type = 'monthly';
+    monthDays = parseMonthDays(dayOfMonthPart);
+  }
+  // Everything else is custom
+
+  return { type, weekDays, monthDays };
+}
+
+/**
+ * Parses a single numeric field
+ */
+function parseField(part: string, min: number, max: number): number | null {
+  // Handle simple number
+  if (/^\d+$/.test(part)) {
+    const num = parseInt(part, 10);
+    if (num >= min && num <= max) return num;
+  }
+  return null;
+}
+
+/**
+ * Parses week days from cron field
+ * Supports: 1,2,3 or 1-5 or MON,WED,FRI
+ */
+function parseWeekDays(part: string): WeekDay[] {
+  const result: WeekDay[] = [];
+
+  // Handle ranges like 1-5
+  if (part.includes('-')) {
+    const [start, end] = part.split('-').map(s => parseInt(s, 10));
+    if (!isNaN(start) && !isNaN(end)) {
+      for (let i = start; i <= end && i <= 6; i++) {
+        if (i >= 0) result.push(i as WeekDay);
+      }
+    }
+    return result.length > 0 ? result : [1, 2, 3, 4, 5];
+  }
+
+  // Handle comma-separated list
+  for (const segment of part.split(',')) {
+    const num = parseInt(segment.trim(), 10);
+    if (!isNaN(num) && num >= 0 && num <= 6) {
+      result.push(num as WeekDay);
+    }
+  }
+
+  return result.length > 0 ? result : [1, 2, 3, 4, 5];
+}
+
+/**
+ * Parses month days from cron field
+ * Supports: 1,15 or 1-15
+ */
+function parseMonthDays(part: string): MonthDay[] {
+  const result: MonthDay[] = [];
+
+  // Handle ranges like 1-15
+  if (part.includes('-')) {
+    const [start, end] = part.split('-').map(s => parseInt(s, 10));
+    if (!isNaN(start) && !isNaN(end)) {
+      for (let i = start; i <= end && i <= 31; i++) {
+        if (i >= 1) result.push(i as MonthDay);
+      }
+    }
+    return result.length > 0 ? result : [1];
+  }
+
+  // Handle comma-separated list
+  for (const segment of part.split(',')) {
+    const num = parseInt(segment.trim(), 10);
+    if (!isNaN(num) && num >= 1 && num <= 31) {
+      result.push(num as MonthDay);
+    }
+  }
+
+  return result.length > 0 ? result : [1];
+}
+
+/**
+ * Validates cron expression syntax
+ */
+export function isValidCron(cron: string): boolean {
+  if (!cron || typeof cron !== 'string') return false;
+
+  const parts = cron.trim().split(/\s+/);
+  if (parts.length !== 5) return false;
+
+  // Basic validation for each field
+  const patterns = [
+    /^(\*|\d{1,2}|\d{1,2}-\d{1,2}|\d{1,2}(,\d{1,2})*|\*\/\d{1,2})$/, // minute
+    /^(\*|\d{1,2}|\d{1,2}-\d{1,2}|\d{1,2}(,\d{1,2})*|\*\/\d{1,2})$/, // hour
+    /^(\*|\d{1,2}|\d{1,2}-\d{1,2}|\d{1,2}(,\d{1,2})*|\*\/\d{1,2})$/, // day of month
+    /^(\*|\d{1,2}|\d{1,2}-\d{1,2}|\d{1,2}(,\d{1,2})*|\*\/\d{1,2})$/, // month
+    /^(\*|\d{1}|\d{1}-\d{1}|\d{1}(,\d{1})*|\*\/\d{1,2})$/,           // day of week
+  ];
+
+  return parts.every((part, i) => patterns[i].test(part));
+}

package/src/tools/CronScheduler/utils/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Cron Utilities
+ */
+
+export { buildCron, buildDefaultCron } from './cron-builder';
+export { parseCron, isValidCron } from './cron-parser';
+export {
+  humanizeCron,
+  formatTime12h,
+  getWeekdayName,
+  getWeekdayShort,
+} from './cron-humanize';

package/src/tools/index.ts

@@ -11,6 +11,7 @@
  * - VideoPlayer: ~150KB (Professional video player with Vidstack)
  * - AudioPlayer: ~200KB (Audio player with WaveSurfer.js)
  * - ImageViewer: ~50KB (Image viewer with zoom/pan/rotate)
+ * - CronScheduler: ~15KB (Cron expression builder)
  *
  * Works in any React environment: Next.js, Vite, Wails, CRA
  */
@@ -161,6 +162,41 @@ export type {
 export { ImageViewer } from './ImageViewer';
 export type { ImageViewerProps, ImageFile } from './ImageViewer';
 
+// Export CronScheduler (~15KB)
+export {
+  CronScheduler,
+  // Context & Hooks
+  CronSchedulerProvider,
+  useCronSchedulerContext,
+  useCronType,
+  useCronTime,
+  useCronWeekDays,
+  useCronMonthDays,
+  useCronCustom,
+  useCronPreview,
+  useCronScheduler,
+  // Utilities
+  buildCron,
+  parseCron,
+  isValidCron,
+  humanizeCron,
+  // Components
+  ScheduleTypeSelector,
+  TimeSelector,
+  DayChips,
+  MonthDayGrid,
+  CustomInput,
+  SchedulePreview,
+} from './CronScheduler';
+export type {
+  CronSchedulerProps,
+  ScheduleType,
+  WeekDay,
+  MonthDay,
+  CronSchedulerState,
+  CronSchedulerContextValue,
+} from './CronScheduler';
+
 // Export Media Cache Store
 export {
   useMediaCacheStore,