ts-time-utils 0.0.1 → 1.1.0

package/dist/esm/naturalLanguage.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Natural language date parsing utilities
+ * Provides intelligent parsing of human-readable date strings
+ */
+/**
+ * Options for natural language parsing
+ */
+export interface NaturalParseOptions {
+    /** Reference date for relative parsing (defaults to now) */
+    referenceDate?: Date;
+    /** Preferred time for dates without time specified */
+    defaultTime?: {
+        hour: number;
+        minute: number;
+        second?: number;
+    };
+    /** Locale for language-specific parsing */
+    locale?: string;
+    /** Whether to use strict parsing */
+    strict?: boolean;
+}
+/**
+ * Extracted date information from text
+ */
+export interface ExtractedDate {
+    /** The parsed date */
+    date: Date;
+    /** The original text that was matched */
+    text: string;
+    /** Starting position in the original text */
+    index: number;
+    /** Type of date pattern matched */
+    type: 'absolute' | 'relative' | 'range' | 'time';
+    /** Confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Parses natural language date strings into Date objects
+ * @param input - Natural language date string
+ * @param options - Parsing options
+ * @returns Parsed date or null if unable to parse
+ *
+ * @example
+ * ```ts
+ * parseNaturalDate('tomorrow at 3pm');
+ * // Date for tomorrow at 15:00
+ *
+ * parseNaturalDate('next Friday');
+ * // Date for next Friday
+ *
+ * parseNaturalDate('in 2 weeks');
+ * // Date 2 weeks from now
+ *
+ * parseNaturalDate('December 25th');
+ * // Date for Dec 25 this year (or next if passed)
+ * ```
+ */
+export declare function parseNaturalDate(input: string, options?: NaturalParseOptions): Date | null;
+/**
+ * Parses a relative time phrase into a Date
+ * @param input - Relative time phrase
+ * @param referenceDate - Reference date (defaults to now)
+ * @returns Parsed date or null
+ *
+ * @example
+ * ```ts
+ * parseRelativePhrase('in 2 hours'); // 2 hours from now
+ * parseRelativePhrase('5 minutes ago'); // 5 minutes ago
+ * parseRelativePhrase('next week'); // 7 days from now
+ * ```
+ */
+export declare function parseRelativePhrase(input: string, referenceDate?: Date): Date | null;
+/**
+ * Extracts all dates from a text string
+ * @param text - Text to extract dates from
+ * @param options - Extraction options
+ * @returns Array of extracted date information
+ *
+ * @example
+ * ```ts
+ * const text = "Meeting tomorrow at 3pm and dinner next Friday at 7pm";
+ * const dates = extractDatesFromText(text);
+ * // [
+ * //   { date: Date(...), text: 'tomorrow at 3pm', index: 8, ... },
+ * //   { date: Date(...), text: 'next Friday at 7pm', index: 37, ... }
+ * // ]
+ * ```
+ */
+export declare function extractDatesFromText(text: string, options?: NaturalParseOptions): ExtractedDate[];
+/**
+ * Suggests possible dates based on context
+ * @param context - Context string to analyze
+ * @param options - Parsing options
+ * @returns Array of suggested dates with confidence scores
+ *
+ * @example
+ * ```ts
+ * suggestDateFromContext('deadline is end of month');
+ * // [{ date: Date(last day of current month), confidence: 0.8, ... }]
+ * ```
+ */
+export declare function suggestDateFromContext(context: string, options?: NaturalParseOptions): Array<{
+    date: Date;
+    text: string;
+    confidence: number;
+}>;
+//# sourceMappingURL=naturalLanguage.d.ts.map

package/dist/esm/naturalLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naturalLanguage.d.ts","sourceRoot":"","sources":["../../src/naturalLanguage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,GAAG,IAAI,CA8C9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,GAAE,IAAiB,GAAG,IAAI,GAAG,IAAI,CA6DhG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,aAAa,EAAE,CAkDjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,KAAK,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAkDzD"}

package/dist/esm/naturalLanguage.js

@@ -0,0 +1,344 @@
+/**
+ * @fileoverview Natural language date parsing utilities
+ * Provides intelligent parsing of human-readable date strings
+ */
+import { addTime } from './calculate.js';
+import { parseRelativeDate } from './parse.js';
+/**
+ * Parses natural language date strings into Date objects
+ * @param input - Natural language date string
+ * @param options - Parsing options
+ * @returns Parsed date or null if unable to parse
+ *
+ * @example
+ * ```ts
+ * parseNaturalDate('tomorrow at 3pm');
+ * // Date for tomorrow at 15:00
+ *
+ * parseNaturalDate('next Friday');
+ * // Date for next Friday
+ *
+ * parseNaturalDate('in 2 weeks');
+ * // Date 2 weeks from now
+ *
+ * parseNaturalDate('December 25th');
+ * // Date for Dec 25 this year (or next if passed)
+ * ```
+ */
+export function parseNaturalDate(input, options = {}) {
+    const { referenceDate = new Date(), defaultTime } = options;
+    const normalized = input.toLowerCase().trim();
+    // Try relative phrase parser first (handles "next week", "last month", etc.)
+    const relativePhraseResult = parseRelativePhrase(input, referenceDate);
+    if (relativePhraseResult)
+        return relativePhraseResult;
+    // Try existing relative date parser
+    const relativeResult = parseRelativeDate(input);
+    if (relativeResult)
+        return relativeResult;
+    // Common absolute patterns
+    const absolutePatterns = [
+        // "next Friday", "last Monday"
+        /^(next|last|this)\s+(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/,
+        // "Friday", "Monday" (interpreted as next occurrence)
+        /^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/,
+        // "tomorrow at 3pm", "today at noon"
+        /^(today|tomorrow|yesterday)\s+at\s+(.+)$/,
+        // "3pm today", "noon tomorrow"
+        /^(.+?)\s+(today|tomorrow|yesterday)$/,
+        // "in 2 weeks", "in 3 days"
+        /^in\s+(\d+)\s+(minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)$/,
+        // "2 weeks from now", "3 days ago"
+        /^(\d+)\s+(minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)\s+(from now|ago)$/,
+        // "December 25", "Dec 25", "25 December"
+        /^(january|february|march|april|may|june|july|august|september|october|november|december|jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\s+(\d{1,2})(st|nd|rd|th)?$/,
+        /^(\d{1,2})(st|nd|rd|th)?\s+(january|february|march|april|may|june|july|august|september|october|november|december|jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)$/,
+    ];
+    // Check each pattern
+    for (const pattern of absolutePatterns) {
+        const match = normalized.match(pattern);
+        if (match) {
+            return parseMatchedPattern(match, referenceDate, defaultTime);
+        }
+    }
+    // Try standard Date parsing as fallback
+    const standardDate = new Date(input);
+    if (!isNaN(standardDate.getTime())) {
+        return standardDate;
+    }
+    return null;
+}
+/**
+ * Parses a relative time phrase into a Date
+ * @param input - Relative time phrase
+ * @param referenceDate - Reference date (defaults to now)
+ * @returns Parsed date or null
+ *
+ * @example
+ * ```ts
+ * parseRelativePhrase('in 2 hours'); // 2 hours from now
+ * parseRelativePhrase('5 minutes ago'); // 5 minutes ago
+ * parseRelativePhrase('next week'); // 7 days from now
+ * ```
+ */
+export function parseRelativePhrase(input, referenceDate = new Date()) {
+    const normalized = input.toLowerCase().trim();
+    // "in X units"
+    const inPattern = /^in\s+(\d+)\s+(millisecond|milliseconds|second|seconds|minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)$/;
+    let match = normalized.match(inPattern);
+    if (match) {
+        const amount = parseInt(match[1], 10);
+        const unit = normalizeUnit(match[2]);
+        return addTime(referenceDate, amount, unit);
+    }
+    // "X units ago"
+    const agoPattern = /^(\d+)\s+(millisecond|milliseconds|second|seconds|minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)\s+ago$/;
+    match = normalized.match(agoPattern);
+    if (match) {
+        const amount = parseInt(match[1], 10);
+        const unit = normalizeUnit(match[2]);
+        return addTime(referenceDate, -amount, unit);
+    }
+    // "X units from now"
+    const fromNowPattern = /^(\d+)\s+(millisecond|milliseconds|second|seconds|minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)\s+from\s+now$/;
+    match = normalized.match(fromNowPattern);
+    if (match) {
+        const amount = parseInt(match[1], 10);
+        const unit = normalizeUnit(match[2]);
+        return addTime(referenceDate, amount, unit);
+    }
+    // Common shortcuts - use switch/case to properly use the referenceDate parameter
+    switch (normalized) {
+        case 'now':
+            return new Date(referenceDate);
+        case 'today': {
+            const d = new Date(referenceDate);
+            d.setHours(0, 0, 0, 0);
+            return d;
+        }
+        case 'tomorrow':
+            return addTime(referenceDate, 1, 'day');
+        case 'yesterday':
+            return addTime(referenceDate, -1, 'day');
+        case 'next week':
+            return addTime(referenceDate, 1, 'week');
+        case 'last week':
+            return addTime(referenceDate, -1, 'week');
+        case 'next month':
+            return addTime(referenceDate, 1, 'month');
+        case 'last month':
+            return addTime(referenceDate, -1, 'month');
+        case 'next year':
+            return addTime(referenceDate, 1, 'year');
+        case 'last year':
+            return addTime(referenceDate, -1, 'year');
+        default:
+            return null;
+    }
+}
+/**
+ * Extracts all dates from a text string
+ * @param text - Text to extract dates from
+ * @param options - Extraction options
+ * @returns Array of extracted date information
+ *
+ * @example
+ * ```ts
+ * const text = "Meeting tomorrow at 3pm and dinner next Friday at 7pm";
+ * const dates = extractDatesFromText(text);
+ * // [
+ * //   { date: Date(...), text: 'tomorrow at 3pm', index: 8, ... },
+ * //   { date: Date(...), text: 'next Friday at 7pm', index: 37, ... }
+ * // ]
+ * ```
+ */
+export function extractDatesFromText(text, options = {}) {
+    const { referenceDate = new Date() } = options;
+    const results = [];
+    // Patterns to match
+    const patterns = [
+        // Relative dates
+        /\b(tomorrow|yesterday|today)\b/gi,
+        /\b(next|last|this)\s+(monday|tuesday|wednesday|thursday|friday|saturday|sunday|week|month|year)\b/gi,
+        /\bin\s+\d+\s+(minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)\b/gi,
+        /\b\d+\s+(minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)\s+(ago|from now)\b/gi,
+        // Absolute dates
+        /\b(january|february|march|april|may|june|july|august|september|october|november|december|jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\s+\d{1,2}(st|nd|rd|th)?\b/gi,
+        /\b\d{1,2}(st|nd|rd|th)?\s+(of\s+)?(january|february|march|april|may|june|july|august|september|october|november|december|jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\b/gi,
+        // Date formats
+        /\b\d{1,2}[\/\-\.]\d{1,2}[\/\-\.]\d{2,4}\b/g,
+        /\b\d{4}[\/\-\.]\d{1,2}[\/\-\.]\d{1,2}\b/g,
+        // Time patterns (when found with dates)
+        /\bat\s+\d{1,2}(:\d{2})?\s*(am|pm|AM|PM)?\b/gi,
+    ];
+    const processed = new Set();
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const matchedText = match[0];
+            const index = match.index;
+            // Skip if already processed
+            if (processed.has(`${index}-${matchedText}`))
+                continue;
+            processed.add(`${index}-${matchedText}`);
+            // Try to parse the matched text
+            const parsed = parseNaturalDate(matchedText, { referenceDate });
+            if (parsed) {
+                results.push({
+                    date: parsed,
+                    text: matchedText,
+                    index,
+                    type: determineType(matchedText),
+                    confidence: calculateConfidence(matchedText)
+                });
+            }
+        }
+    }
+    // Sort by index (order in text)
+    return results.sort((a, b) => a.index - b.index);
+}
+/**
+ * Suggests possible dates based on context
+ * @param context - Context string to analyze
+ * @param options - Parsing options
+ * @returns Array of suggested dates with confidence scores
+ *
+ * @example
+ * ```ts
+ * suggestDateFromContext('deadline is end of month');
+ * // [{ date: Date(last day of current month), confidence: 0.8, ... }]
+ * ```
+ */
+export function suggestDateFromContext(context, options = {}) {
+    const { referenceDate = new Date() } = options;
+    const suggestions = [];
+    const normalized = context.toLowerCase();
+    // End of month
+    if (normalized.includes('end of month') || normalized.includes('eom')) {
+        const date = new Date(referenceDate.getFullYear(), referenceDate.getMonth() + 1, 0);
+        suggestions.push({ date, text: 'end of month', confidence: 0.85 });
+    }
+    // Beginning of month
+    if (normalized.includes('beginning of month') || normalized.includes('start of month')) {
+        const date = new Date(referenceDate.getFullYear(), referenceDate.getMonth(), 1);
+        suggestions.push({ date, text: 'beginning of month', confidence: 0.85 });
+    }
+    // End of year
+    if (normalized.includes('end of year') || normalized.includes('eoy')) {
+        const date = new Date(referenceDate.getFullYear(), 11, 31);
+        suggestions.push({ date, text: 'end of year', confidence: 0.85 });
+    }
+    // Beginning of year
+    if (normalized.includes('beginning of year') || normalized.includes('start of year')) {
+        const date = new Date(referenceDate.getFullYear(), 0, 1);
+        suggestions.push({ date, text: 'beginning of year', confidence: 0.85 });
+    }
+    // End of week
+    if (normalized.includes('end of week') || normalized.includes('eow')) {
+        const date = new Date(referenceDate);
+        const day = date.getDay();
+        const diff = 6 - day; // Saturday
+        date.setDate(date.getDate() + diff);
+        suggestions.push({ date, text: 'end of week', confidence: 0.85 });
+    }
+    // Extract any explicit dates
+    const extracted = extractDatesFromText(context, options);
+    for (const item of extracted) {
+        suggestions.push({
+            date: item.date,
+            text: item.text,
+            confidence: item.confidence
+        });
+    }
+    // Sort by confidence
+    return suggestions.sort((a, b) => b.confidence - a.confidence);
+}
+// Helper functions
+function parseMatchedPattern(match, referenceDate, defaultTime) {
+    const pattern = match[0];
+    // Weekday patterns
+    if (pattern.includes('monday') || pattern.includes('tuesday') ||
+        pattern.includes('wednesday') || pattern.includes('thursday') ||
+        pattern.includes('friday') || pattern.includes('saturday') ||
+        pattern.includes('sunday')) {
+        const weekdayMap = {
+            'sunday': 0, 'monday': 1, 'tuesday': 2, 'wednesday': 3,
+            'thursday': 4, 'friday': 5, 'saturday': 6
+        };
+        const weekday = Object.keys(weekdayMap).find(day => pattern.includes(day));
+        if (!weekday)
+            return null;
+        const targetDay = weekdayMap[weekday];
+        const currentDay = referenceDate.getDay();
+        let daysToAdd = targetDay - currentDay;
+        if (pattern.includes('next')) {
+            if (daysToAdd <= 0)
+                daysToAdd += 7;
+        }
+        else if (pattern.includes('last')) {
+            if (daysToAdd >= 0)
+                daysToAdd -= 7;
+        }
+        else {
+            // "this" or just the weekday name - go to next occurrence
+            if (daysToAdd <= 0)
+                daysToAdd += 7;
+        }
+        return addTime(referenceDate, daysToAdd, 'day');
+    }
+    // "in X units" pattern
+    if (match[1] && match[2]) {
+        const amount = parseInt(match[1], 10);
+        const unit = normalizeUnit(match[2]);
+        if (match[3] === 'ago') {
+            return addTime(referenceDate, -amount, unit);
+        }
+        return addTime(referenceDate, amount, unit);
+    }
+    return null;
+}
+function normalizeUnit(unit) {
+    const normalized = unit.toLowerCase().replace(/s$/, '');
+    switch (normalized) {
+        case 'millisecond': return 'millisecond';
+        case 'second': return 'second';
+        case 'minute': return 'minute';
+        case 'hour': return 'hour';
+        case 'day': return 'day';
+        case 'week': return 'week';
+        case 'month': return 'month';
+        case 'year': return 'year';
+        default: return 'day';
+    }
+}
+function determineType(text) {
+    const lower = text.toLowerCase();
+    if (lower.includes('ago') || lower.includes('from now') || lower.includes('in ')) {
+        return 'relative';
+    }
+    if (lower.includes('to') || lower.includes(' - ') || lower.includes('between')) {
+        return 'range';
+    }
+    if (lower.includes('at ') || lower.includes('am') || lower.includes('pm') || /\d{1,2}:\d{2}/.test(lower)) {
+        return 'time';
+    }
+    return 'absolute';
+}
+function calculateConfidence(text) {
+    const lower = text.toLowerCase();
+    let confidence = 0.5; // Base confidence
+    // Higher confidence for specific patterns
+    if (lower.includes('tomorrow') || lower.includes('yesterday') || lower.includes('today')) {
+        confidence += 0.4;
+    }
+    if (/\d{4}/.test(text)) { // Has year
+        confidence += 0.2;
+    }
+    if (/\d{1,2}:\d{2}/.test(text)) { // Has time
+        confidence += 0.15;
+    }
+    if (lower.includes('next') || lower.includes('last')) {
+        confidence += 0.1;
+    }
+    return Math.min(1.0, confidence);
+}

package/dist/esm/performance.d.ts

@@ -91,16 +91,9 @@ export declare function measureTime<T>(fn: () => T): [T, number];
  */
 export declare function measureAsync<T>(fn: () => Promise<T>): Promise<[T, number]>;
 /**
- * Benchmark result interface
+ * Performance measurement and async utilities
  */
-export interface BenchmarkResult {
-    totalTime: number;
-    averageTime: number;
-    minTime: number;
-    maxTime: number;
-    iterations: number;
-    opsPerSecond: number;
-}
+import type { BenchmarkResult } from './types.js';
 /**
  * Benchmark a function by running it multiple times
  * @param fn - function to benchmark

package/dist/esm/performance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/performance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,cAAc,SAAwB,GACrC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAOlC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,GAAE,MAAU,EACvB,SAAS,GAAE,MAAa,EACxB,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAuB;IAEzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,MAAM;IAed;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,IAAI,MAAM;IAepB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAKvD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAKhF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,UAAU,GAAE,MAAa,GAAG,eAAe,CAsBpF"}
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/performance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,cAAc,SAAwB,GACrC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAOlC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,GAAE,MAAU,EACvB,SAAS,GAAE,MAAa,EACxB,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAuB;IAEzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,MAAM;IAed;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,IAAI,MAAM;IAepB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAKvD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAKhF;AAED;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,UAAU,GAAE,MAAa,GAAG,eAAe,CAqBpF"}

package/dist/esm/performance.js

@@ -207,16 +207,15 @@ export function benchmark(fn, iterations = 1000) {
         times.push(elapsed);
     }
     const totalTime = times.reduce((sum, time) => sum + time, 0);
-    const averageTime = totalTime / iterations;
-    const minTime = Math.min(...times);
-    const maxTime = Math.max(...times);
-    const opsPerSecond = 1000 / averageTime;
+    const average = totalTime / iterations;
+    const min = Math.min(...times);
+    const max = Math.max(...times);
     return {
         totalTime,
-        averageTime,
-        minTime,
-        maxTime,
+        average,
+        min,
+        max,
         iterations,
-        opsPerSecond
+        total: totalTime
     };
 }

package/dist/esm/rangePresets.d.ts

@@ -1,8 +1,7 @@
-/** Predefined date range helpers (returns [start,end]) */
-export interface DateRange {
-    start: Date;
-    end: Date;
-}
+/**
+ * Predefined date range helpers for common time periods
+ */
+import type { DateRange } from './types.js';
 export declare function today(now?: Date): DateRange;
 export declare function yesterday(now?: Date): DateRange;
 export declare function tomorrow(now?: Date): DateRange;
@@ -18,9 +17,9 @@ export declare function thisYear(now?: Date): DateRange;
 export declare function lastYear(now?: Date): DateRange;
 export declare function nextYear(now?: Date): DateRange;
 export declare function rollingWindowDays(days: number, now?: Date): DateRange;
-export declare function quarterRange(date?: Date): DateRange;
-export declare function lastQuarter(date?: Date): DateRange;
-export declare function nextQuarter(date?: Date): DateRange;
+export declare function quarterRange(now?: Date): DateRange;
+export declare function lastQuarter(now?: Date): DateRange;
+export declare function nextQuarter(now?: Date): DateRange;
 /** Map of preset functions for dynamic access */
 export declare const RANGE_PRESETS: {
     today: typeof today;

package/dist/esm/rangePresets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rangePresets.d.ts","sourceRoot":"","sources":["../../src/rangePresets.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;CAAE;AAQtD,wBAAgB,KAAK,CAAC,GAAG,OAAa,GAAG,SAAS,CAA4B;AAC9E,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAOpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAIrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAIpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAI3E;AAED,wBAAgB,YAAY,CAAC,IAAI,OAAa,GAAG,SAAS,CAKzD;AAED,wBAAgB,WAAW,CAAC,IAAI,OAAa,GAAG,SAAS,CAKxD;AAED,wBAAgB,WAAW,CAAC,IAAI,OAAa,GAAG,SAAS,CAKxD;AAED,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;sBAEN,IAAI;uBACH,IAAI;sBACL,IAAI;;;;;;;;;;;;;CAKvB,CAAC"}
+{"version":3,"file":"rangePresets.d.ts","sourceRoot":"","sources":["../../src/rangePresets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQ5C,wBAAgB,KAAK,CAAC,GAAG,OAAa,GAAG,SAAS,CAA4B;AAC9E,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAOpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAIrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAIpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAI3E;AAED,wBAAgB,YAAY,CAAC,GAAG,OAAa,GAAG,SAAS,CAKxD;AAED,wBAAgB,WAAW,CAAC,GAAG,OAAa,GAAG,SAAS,CAKvD;AAED,wBAAgB,WAAW,CAAC,GAAG,OAAa,GAAG,SAAS,CAKvD;AAED,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;sBAEN,IAAI;uBACH,IAAI;sBACL,IAAI;;;;;;;;;;;;;CAKvB,CAAC"}

package/dist/esm/rangePresets.js

@@ -1,4 +1,6 @@
-/** Predefined date range helpers (returns [start,end]) */
+/**
+ * Predefined date range helpers for common time periods
+ */
 function todayRange(now = new Date()) {
     const start = new Date(now);
     start.setHours(0, 0, 0, 0);
@@ -93,20 +95,20 @@ export function rollingWindowDays(days, now = new Date()) {
     start.setDate(start.getDate() - days);
     return { start, end };
 }
-export function quarterRange(date = new Date()) {
-    const q = Math.floor(date.getMonth() / 3); // 0-3
-    const start = new Date(date.getFullYear(), q * 3, 1);
-    const end = new Date(date.getFullYear(), q * 3 + 3, 1);
+export function quarterRange(now = new Date()) {
+    const q = Math.floor(now.getMonth() / 3); // 0-3
+    const start = new Date(now.getFullYear(), q * 3, 1);
+    const end = new Date(now.getFullYear(), q * 3 + 3, 1);
     return { start, end };
 }
-export function lastQuarter(date = new Date()) {
-    const q = quarterRange(date);
+export function lastQuarter(now = new Date()) {
+    const q = quarterRange(now);
     q.start.setMonth(q.start.getMonth() - 3);
     q.end.setMonth(q.end.getMonth() - 3);
     return q;
 }
-export function nextQuarter(date = new Date()) {
-    const q = quarterRange(date);
+export function nextQuarter(now = new Date()) {
+    const q = quarterRange(now);
     q.start.setMonth(q.start.getMonth() + 3);
     q.end.setMonth(q.end.getMonth() + 3);
     return q;