@md2do/core 0.2.3 → 0.4.0

package/src/utils/dates.ts

@@ -5,11 +5,41 @@ import {
   addWeeks,
   addMonths,
   startOfWeek,
+  setHours,
+  setMinutes,
 } from 'date-fns';
 import { PATTERNS } from '../parser/patterns.js';
 
 /**
- * Parse an absolute date string in various formats
+ * Parse a time string in HH:MM or H:MM format
+ *
+ * @param timeStr - Time string to parse (e.g., "17:00", "9:00")
+ * @returns Object with hours and minutes, or null if invalid
+ *
+ * @example
+ * parseTime("17:00") // => { hours: 17, minutes: 0 }
+ * parseTime("9:30") // => { hours: 9, minutes: 30 }
+ * parseTime("25:00") // => null (invalid hour)
+ */
+export function parseTime(
+  timeStr: string,
+): { hours: number; minutes: number } | null {
+  const match = timeStr.match(/^(\d{1,2}):(\d{2})$/);
+  if (!match || !match[1] || !match[2]) return null;
+
+  const hours = parseInt(match[1], 10);
+  const minutes = parseInt(match[2], 10);
+
+  // Validate ranges
+  if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59) {
+    return null;
+  }
+
+  return { hours, minutes };
+}
+
+/**
+ * Parse an absolute date string in various formats, with optional time
  *
  * Supported formats:
  *   - ISO: 2026-01-25
@@ -17,24 +47,42 @@ import { PATTERNS } from '../parser/patterns.js';
  *   - US full: 1/25/2026
  *
  * @param dateStr - Date string to parse
+ * @param timeStr - Optional time string in HH:MM or H:MM format
  * @returns Parsed Date object or null if invalid
+ *
+ * @example
+ * parseAbsoluteDate("2026-01-25") // => Date at midnight
+ * parseAbsoluteDate("2026-01-25", "17:00") // => Date at 5 PM
  */
-export function parseAbsoluteDate(dateStr: string): Date | null {
+export function parseAbsoluteDate(
+  dateStr: string,
+  timeStr?: string,
+): Date | null {
   const referenceDate = new Date();
 
   // Try ISO format: 2026-01-25
   let date = parse(dateStr, 'yyyy-MM-dd', referenceDate);
-  if (isValid(date)) return date;
+  if (!isValid(date)) {
+    // Try US short format with 2-digit year: 1/25/26
+    date = parse(dateStr, 'M/d/yy', referenceDate);
+  }
+  if (!isValid(date)) {
+    // Try US full format: 1/25/2026
+    date = parse(dateStr, 'M/d/yyyy', referenceDate);
+  }
 
-  // Try US short format with 2-digit year: 1/25/26
-  date = parse(dateStr, 'M/d/yy', referenceDate);
-  if (isValid(date)) return date;
+  if (!isValid(date)) return null;
 
-  // Try US full format: 1/25/2026
-  date = parse(dateStr, 'M/d/yyyy', referenceDate);
-  if (isValid(date)) return date;
+  // Apply time if provided
+  if (timeStr) {
+    const time = parseTime(timeStr);
+    if (time) {
+      date = setHours(date, time.hours);
+      date = setMinutes(date, time.minutes);
+    }
+  }
 
-  return null;
+  return date;
 }
 
 /**

package/src/warnings/filter.ts

@@ -0,0 +1,93 @@
+import type { Warning } from '../types/index.js';
+
+export interface WarningFilterConfig {
+  enabled?: boolean | undefined;
+  rules?: Record<string, 'error' | 'warn' | 'info' | 'off'> | undefined;
+}
+
+/**
+ * Filter warnings based on configuration rules
+ *
+ * This function applies warning configuration rules to filter out disabled warnings
+ * and optionally all warnings if globally disabled.
+ *
+ * @param warnings - Array of warnings to filter
+ * @param config - Warning configuration with enabled flag and rule overrides
+ * @returns Filtered array of warnings
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   enabled: true,
+ *   rules: {
+ *     'missing-due-date': 'off',
+ *     'duplicate-todoist-id': 'error',
+ *   },
+ * };
+ *
+ * const filtered = filterWarnings(allWarnings, config);
+ * // Returns warnings except those with ruleId 'missing-due-date'
+ * ```
+ */
+export function filterWarnings(
+  warnings: Warning[],
+  config: WarningFilterConfig = {},
+): Warning[] {
+  // If warnings are globally disabled, return empty array
+  if (config.enabled === false) {
+    return [];
+  }
+
+  // If no rules specified, return all warnings
+  if (!config.rules) {
+    return warnings;
+  }
+
+  // Filter based on rule configuration
+  return warnings.filter((warning) => {
+    const level = config.rules?.[warning.ruleId];
+
+    // If rule is not configured, include the warning (default: show)
+    if (level === undefined) {
+      return true;
+    }
+
+    // Exclude if rule is set to 'off'
+    return level !== 'off';
+  });
+}
+
+/**
+ * Group warnings by severity
+ *
+ * Useful for displaying warnings in order of importance or
+ * treating errors differently from warnings.
+ *
+ * @param warnings - Array of warnings to group
+ * @returns Object with warnings grouped by severity level
+ *
+ * @example
+ * ```typescript
+ * const grouped = groupWarningsBySeverity(warnings);
+ * console.log(`${grouped.error.length} errors`);
+ * console.log(`${grouped.warning.length} warnings`);
+ * console.log(`${grouped.info.length} info messages`);
+ * ```
+ */
+export function groupWarningsBySeverity(warnings: Warning[]): {
+  error: Warning[];
+  warning: Warning[];
+  info: Warning[];
+} {
+  return warnings.reduce(
+    (acc, warning) => {
+      acc[warning.severity].push(warning);
+      return acc;
+    },
+    { error: [], warning: [], info: [] } as {
+      error: Warning[];
+      warning: Warning[];
+      info: Warning[];
+    },
+  );
+}