ts-time-utils 1.1.0 → 3.0.0

package/dist/esm/cron.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Cron expression utilities for scheduling
+ */
+export interface CronParts {
+    minute: string;
+    hour: string;
+    dayOfMonth: string;
+    month: string;
+    dayOfWeek: string;
+}
+export interface ParsedCronField {
+    type: 'all' | 'specific' | 'range' | 'step' | 'list';
+    values: number[];
+}
+/**
+ * Parse a cron expression into its parts
+ * @param expression - cron expression (5 fields: minute hour dayOfMonth month dayOfWeek)
+ */
+export declare function parseCronExpression(expression: string): CronParts | null;
+/**
+ * Parse a cron field into its numeric values
+ * @param field - cron field string (e.g., "star/5", "1-5", "1,2,3", "*")
+ * @param min - minimum valid value
+ * @param max - maximum valid value
+ */
+export declare function parseCronField(field: string, min: number, max: number): ParsedCronField | null;
+/**
+ * Check if a date matches a cron expression
+ * @param date - date to check
+ * @param expression - cron expression
+ */
+export declare function matchesCron(date: Date, expression: string): boolean;
+/**
+ * Get the next date that matches a cron expression
+ * @param expression - cron expression
+ * @param after - start searching after this date (default: now)
+ * @param maxIterations - maximum iterations to prevent infinite loops
+ */
+export declare function getNextCronDate(expression: string, after?: Date, maxIterations?: number): Date | null;
+/**
+ * Get the N next dates that match a cron expression
+ * @param expression - cron expression
+ * @param count - number of dates to get
+ * @param after - start searching after this date
+ */
+export declare function getNextCronDates(expression: string, count: number, after?: Date): Date[];
+/**
+ * Get the previous date that matched a cron expression
+ * @param expression - cron expression
+ * @param before - start searching before this date
+ * @param maxIterations - maximum iterations to prevent infinite loops
+ */
+export declare function getPreviousCronDate(expression: string, before?: Date, maxIterations?: number): Date | null;
+/**
+ * Validate a cron expression
+ * @param expression - cron expression to validate
+ */
+export declare function isValidCron(expression: string): boolean;
+/**
+ * Convert a cron expression to a human-readable description
+ * @param expression - cron expression
+ */
+export declare function describeCron(expression: string): string | null;
+/**
+ * Common cron expressions
+ */
+export declare const CRON_PRESETS: {
+    readonly everyMinute: "* * * * *";
+    readonly everyHour: "0 * * * *";
+    readonly everyDay: "0 0 * * *";
+    readonly everyDayAt9am: "0 9 * * *";
+    readonly everyDayAt6pm: "0 18 * * *";
+    readonly everyWeek: "0 0 * * 0";
+    readonly everyMonth: "0 0 1 * *";
+    readonly everyYear: "0 0 1 1 *";
+    readonly weekdays: "0 0 * * 1-5";
+    readonly weekends: "0 0 * * 0,6";
+    readonly every5Minutes: "*/5 * * * *";
+    readonly every15Minutes: "*/15 * * * *";
+    readonly every30Minutes: "*/30 * * * *";
+};
+//# sourceMappingURL=cron.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/cron.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAcxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA+D9F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAqBnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,IAAiB,EACxB,aAAa,GAAE,MAAe,GAC7B,IAAI,GAAG,IAAI,CAiCb;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,IAAiB,GACvB,IAAI,EAAE,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,IAAiB,EACzB,aAAa,GAAE,MAAe,GAC7B,IAAI,GAAG,IAAI,CAiCb;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAWvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwE9D;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAcf,CAAC"}

package/dist/esm/cron.js

@@ -0,0 +1,294 @@
+/**
+ * Cron expression utilities for scheduling
+ */
+/**
+ * Parse a cron expression into its parts
+ * @param expression - cron expression (5 fields: minute hour dayOfMonth month dayOfWeek)
+ */
+export function parseCronExpression(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        return null;
+    }
+    return {
+        minute: parts[0],
+        hour: parts[1],
+        dayOfMonth: parts[2],
+        month: parts[3],
+        dayOfWeek: parts[4],
+    };
+}
+/**
+ * Parse a cron field into its numeric values
+ * @param field - cron field string (e.g., "star/5", "1-5", "1,2,3", "*")
+ * @param min - minimum valid value
+ * @param max - maximum valid value
+ */
+export function parseCronField(field, min, max) {
+    const values = [];
+    // Handle wildcard
+    if (field === '*') {
+        for (let i = min; i <= max; i++) {
+            values.push(i);
+        }
+        return { type: 'all', values };
+    }
+    // Handle step values (*/n or range/n)
+    if (field.includes('/')) {
+        const [range, stepStr] = field.split('/');
+        const step = parseInt(stepStr, 10);
+        if (isNaN(step) || step <= 0)
+            return null;
+        let start = min;
+        let end = max;
+        if (range !== '*') {
+            if (range.includes('-')) {
+                const [s, e] = range.split('-').map(Number);
+                start = s;
+                end = e;
+            }
+            else {
+                start = parseInt(range, 10);
+            }
+        }
+        for (let i = start; i <= end; i += step) {
+            values.push(i);
+        }
+        return { type: 'step', values };
+    }
+    // Handle range (n-m)
+    if (field.includes('-')) {
+        const [start, end] = field.split('-').map(Number);
+        if (isNaN(start) || isNaN(end) || start > end)
+            return null;
+        for (let i = start; i <= end; i++) {
+            values.push(i);
+        }
+        return { type: 'range', values };
+    }
+    // Handle list (n,m,o)
+    if (field.includes(',')) {
+        const items = field.split(',').map(Number);
+        if (items.some(isNaN))
+            return null;
+        return { type: 'list', values: items.sort((a, b) => a - b) };
+    }
+    // Handle specific value
+    const value = parseInt(field, 10);
+    if (isNaN(value) || value < min || value > max)
+        return null;
+    return { type: 'specific', values: [value] };
+}
+/**
+ * Check if a date matches a cron expression
+ * @param date - date to check
+ * @param expression - cron expression
+ */
+export function matchesCron(date, expression) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return false;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek) {
+        return false;
+    }
+    return (minute.values.includes(date.getMinutes()) &&
+        hour.values.includes(date.getHours()) &&
+        dayOfMonth.values.includes(date.getDate()) &&
+        month.values.includes(date.getMonth() + 1) &&
+        dayOfWeek.values.includes(date.getDay()));
+}
+/**
+ * Get the next date that matches a cron expression
+ * @param expression - cron expression
+ * @param after - start searching after this date (default: now)
+ * @param maxIterations - maximum iterations to prevent infinite loops
+ */
+export function getNextCronDate(expression, after = new Date(), maxIterations = 525600 // Max 1 year in minutes
+) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return null;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek) {
+        return null;
+    }
+    const candidate = new Date(after);
+    candidate.setSeconds(0, 0);
+    candidate.setMinutes(candidate.getMinutes() + 1);
+    for (let i = 0; i < maxIterations; i++) {
+        if (minute.values.includes(candidate.getMinutes()) &&
+            hour.values.includes(candidate.getHours()) &&
+            dayOfMonth.values.includes(candidate.getDate()) &&
+            month.values.includes(candidate.getMonth() + 1) &&
+            dayOfWeek.values.includes(candidate.getDay())) {
+            return candidate;
+        }
+        candidate.setMinutes(candidate.getMinutes() + 1);
+    }
+    return null;
+}
+/**
+ * Get the N next dates that match a cron expression
+ * @param expression - cron expression
+ * @param count - number of dates to get
+ * @param after - start searching after this date
+ */
+export function getNextCronDates(expression, count, after = new Date()) {
+    const dates = [];
+    let currentAfter = after;
+    for (let i = 0; i < count; i++) {
+        const next = getNextCronDate(expression, currentAfter);
+        if (!next)
+            break;
+        dates.push(next);
+        currentAfter = next;
+    }
+    return dates;
+}
+/**
+ * Get the previous date that matched a cron expression
+ * @param expression - cron expression
+ * @param before - start searching before this date
+ * @param maxIterations - maximum iterations to prevent infinite loops
+ */
+export function getPreviousCronDate(expression, before = new Date(), maxIterations = 525600) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return null;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek) {
+        return null;
+    }
+    const candidate = new Date(before);
+    candidate.setSeconds(0, 0);
+    candidate.setMinutes(candidate.getMinutes() - 1);
+    for (let i = 0; i < maxIterations; i++) {
+        if (minute.values.includes(candidate.getMinutes()) &&
+            hour.values.includes(candidate.getHours()) &&
+            dayOfMonth.values.includes(candidate.getDate()) &&
+            month.values.includes(candidate.getMonth() + 1) &&
+            dayOfWeek.values.includes(candidate.getDay())) {
+            return candidate;
+        }
+        candidate.setMinutes(candidate.getMinutes() - 1);
+    }
+    return null;
+}
+/**
+ * Validate a cron expression
+ * @param expression - cron expression to validate
+ */
+export function isValidCron(expression) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return false;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    return !!(minute && hour && dayOfMonth && month && dayOfWeek);
+}
+/**
+ * Convert a cron expression to a human-readable description
+ * @param expression - cron expression
+ */
+export function describeCron(expression) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return null;
+    const descriptions = [];
+    // Handle common patterns
+    if (expression === '* * * * *') {
+        return 'Every minute';
+    }
+    if (expression === '0 * * * *') {
+        return 'Every hour';
+    }
+    if (expression === '0 0 * * *') {
+        return 'Every day at midnight';
+    }
+    if (expression === '0 0 * * 0') {
+        return 'Every Sunday at midnight';
+    }
+    if (expression === '0 0 1 * *') {
+        return 'First day of every month at midnight';
+    }
+    // Build description
+    const minute = parts.minute;
+    const hour = parts.hour;
+    if (minute === '0' && hour !== '*') {
+        if (hour.includes('/')) {
+            const step = hour.split('/')[1];
+            descriptions.push(`Every ${step} hours`);
+        }
+        else if (hour.includes('-')) {
+            descriptions.push(`Every hour from ${hour} at minute 0`);
+        }
+        else {
+            descriptions.push(`At ${hour}:00`);
+        }
+    }
+    else if (minute !== '*' && hour === '*') {
+        descriptions.push(`At minute ${minute} of every hour`);
+    }
+    else if (minute.includes('/')) {
+        const step = minute.split('/')[1];
+        descriptions.push(`Every ${step} minutes`);
+    }
+    if (parts.dayOfMonth !== '*') {
+        descriptions.push(`on day ${parts.dayOfMonth} of the month`);
+    }
+    if (parts.month !== '*') {
+        const monthNames = ['', 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+        const monthNum = parseInt(parts.month, 10);
+        if (!isNaN(monthNum) && monthNum >= 1 && monthNum <= 12) {
+            descriptions.push(`in ${monthNames[monthNum]}`);
+        }
+        else {
+            descriptions.push(`in month ${parts.month}`);
+        }
+    }
+    if (parts.dayOfWeek !== '*') {
+        const dayNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+        const dayNum = parseInt(parts.dayOfWeek, 10);
+        if (!isNaN(dayNum) && dayNum >= 0 && dayNum <= 6) {
+            descriptions.push(`on ${dayNames[dayNum]}`);
+        }
+        else {
+            descriptions.push(`on day of week ${parts.dayOfWeek}`);
+        }
+    }
+    return descriptions.join(' ') || expression;
+}
+/**
+ * Common cron expressions
+ */
+export const CRON_PRESETS = {
+    everyMinute: '* * * * *',
+    everyHour: '0 * * * *',
+    everyDay: '0 0 * * *',
+    everyDayAt9am: '0 9 * * *',
+    everyDayAt6pm: '0 18 * * *',
+    everyWeek: '0 0 * * 0',
+    everyMonth: '0 0 1 * *',
+    everyYear: '0 0 1 1 *',
+    weekdays: '0 0 * * 1-5',
+    weekends: '0 0 * * 0,6',
+    every5Minutes: '*/5 * * * *',
+    every15Minutes: '*/15 * * * *',
+    every30Minutes: '*/30 * * * *',
+};

package/dist/esm/fiscal.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @fileoverview Fiscal year and accounting period utilities
+ * Supports configurable fiscal year start months for business calculations
+ */
+/**
+ * Fiscal year configuration
+ */
+export interface FiscalConfig {
+    /** Month when fiscal year starts (1-12, default: 1 for January) */
+    startMonth: number;
+}
+/**
+ * Get the fiscal year for a given date
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal year number
+ * @example
+ * // Calendar year (Jan start)
+ * getFiscalYear(new Date('2024-03-15')) // 2024
+ *
+ * // April fiscal year (UK/India style)
+ * getFiscalYear(new Date('2024-03-15'), { startMonth: 4 }) // 2023
+ * getFiscalYear(new Date('2024-04-15'), { startMonth: 4 }) // 2024
+ *
+ * // July fiscal year (Australia style)
+ * getFiscalYear(new Date('2024-06-15'), { startMonth: 7 }) // 2023
+ * getFiscalYear(new Date('2024-07-15'), { startMonth: 7 }) // 2024
+ */
+export declare function getFiscalYear(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the fiscal quarter for a given date (1-4)
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal quarter (1-4)
+ * @example
+ * // Calendar year quarters
+ * getFiscalQuarter(new Date('2024-01-15')) // 1
+ * getFiscalQuarter(new Date('2024-04-15')) // 2
+ *
+ * // April fiscal year
+ * getFiscalQuarter(new Date('2024-04-15'), { startMonth: 4 }) // 1
+ * getFiscalQuarter(new Date('2024-07-15'), { startMonth: 4 }) // 2
+ */
+export declare function getFiscalQuarter(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the start date of a fiscal year
+ * @param fiscalYear - The fiscal year
+ * @param config - Fiscal year configuration
+ * @returns Start date of the fiscal year
+ * @example
+ * getFiscalYearStart(2024) // 2024-01-01
+ * getFiscalYearStart(2024, { startMonth: 4 }) // 2024-04-01 (FY2024 starts Apr 2024)
+ * getFiscalYearStart(2024, { startMonth: 7 }) // 2024-07-01 (FY2024 starts Jul 2024)
+ */
+export declare function getFiscalYearStart(fiscalYear: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Get the end date of a fiscal year
+ * @param fiscalYear - The fiscal year
+ * @param config - Fiscal year configuration
+ * @returns End date of the fiscal year (last day, 23:59:59.999)
+ * @example
+ * getFiscalYearEnd(2024) // 2024-12-31
+ * getFiscalYearEnd(2024, { startMonth: 4 }) // 2025-03-31 (FY2024 ends Mar 2025)
+ * getFiscalYearEnd(2024, { startMonth: 7 }) // 2025-06-30 (FY2024 ends Jun 2025)
+ */
+export declare function getFiscalYearEnd(fiscalYear: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Get the start date of a fiscal quarter
+ * @param fiscalYear - The fiscal year
+ * @param quarter - The quarter (1-4)
+ * @param config - Fiscal year configuration
+ * @returns Start date of the fiscal quarter
+ * @example
+ * getFiscalQuarterStart(2024, 1) // 2024-01-01
+ * getFiscalQuarterStart(2024, 2) // 2024-04-01
+ * getFiscalQuarterStart(2024, 1, { startMonth: 4 }) // 2023-04-01
+ * getFiscalQuarterStart(2024, 2, { startMonth: 4 }) // 2023-07-01
+ */
+export declare function getFiscalQuarterStart(fiscalYear: number, quarter: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Get the end date of a fiscal quarter
+ * @param fiscalYear - The fiscal year
+ * @param quarter - The quarter (1-4)
+ * @param config - Fiscal year configuration
+ * @returns End date of the fiscal quarter (last day, 23:59:59.999)
+ * @example
+ * getFiscalQuarterEnd(2024, 1) // 2024-03-31
+ * getFiscalQuarterEnd(2024, 2) // 2024-06-30
+ * getFiscalQuarterEnd(2024, 1, { startMonth: 4 }) // 2023-06-30
+ */
+export declare function getFiscalQuarterEnd(fiscalYear: number, quarter: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Check if two dates are in the same fiscal year
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @param config - Fiscal year configuration
+ * @returns True if both dates are in the same fiscal year
+ */
+export declare function isSameFiscalYear(date1: Date, date2: Date, config?: Partial<FiscalConfig>): boolean;
+/**
+ * Check if two dates are in the same fiscal quarter
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @param config - Fiscal year configuration
+ * @returns True if both dates are in the same fiscal year and quarter
+ */
+export declare function isSameFiscalQuarter(date1: Date, date2: Date, config?: Partial<FiscalConfig>): boolean;
+/**
+ * Get the fiscal month (1-12) within the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal month (1-12, where 1 is the first month of fiscal year)
+ * @example
+ * getFiscalMonth(new Date('2024-01-15')) // 1
+ * getFiscalMonth(new Date('2024-04-15'), { startMonth: 4 }) // 1
+ * getFiscalMonth(new Date('2024-03-15'), { startMonth: 4 }) // 12
+ */
+export declare function getFiscalMonth(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the number of days remaining in the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns Number of days remaining in the fiscal year
+ */
+export declare function getDaysRemainingInFiscalYear(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the number of days elapsed in the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns Number of days elapsed in the fiscal year (including the given date)
+ */
+export declare function getDaysElapsedInFiscalYear(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get fiscal year progress as a percentage
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns Percentage of fiscal year completed (0-100)
+ */
+export declare function getFiscalYearProgress(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the fiscal week number (1-53) within the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal week number
+ */
+export declare function getFiscalWeek(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Common fiscal year configurations
+ */
+export declare const FISCAL_PRESETS: {
+    /** Calendar year (January start) - Default */
+    readonly CALENDAR: FiscalConfig;
+    /** UK/India government fiscal year (April start) */
+    readonly UK_INDIA: FiscalConfig;
+    /** Australian fiscal year (July start) */
+    readonly AUSTRALIA: FiscalConfig;
+    /** US federal government fiscal year (October start) */
+    readonly US_FEDERAL: FiscalConfig;
+};
+/**
+ * Format fiscal year as string (e.g., "FY2024" or "FY2023/24")
+ * @param fiscalYear - The fiscal year
+ * @param config - Fiscal year configuration
+ * @param format - Format style: 'short' (FY2024) or 'long' (FY2023/24)
+ * @returns Formatted fiscal year string
+ */
+export declare function formatFiscalYear(fiscalYear: number, config?: Partial<FiscalConfig>, format?: 'short' | 'long'): string;
+/**
+ * Format fiscal quarter as string (e.g., "Q1 FY2024")
+ * @param fiscalYear - The fiscal year
+ * @param quarter - The quarter (1-4)
+ * @param config - Fiscal year configuration
+ * @returns Formatted fiscal quarter string
+ */
+export declare function formatFiscalQuarter(fiscalYear: number, quarter: number, config?: Partial<FiscalConfig>): string;
+/**
+ * Get fiscal period info for a date
+ * @param date - The date to analyze
+ * @param config - Fiscal year configuration
+ * @returns Object with fiscal period information
+ */
+export declare function getFiscalPeriodInfo(date: Date, config?: Partial<FiscalConfig>): {
+    fiscalYear: number;
+    fiscalQuarter: number;
+    fiscalMonth: number;
+    fiscalWeek: number;
+    daysElapsed: number;
+    daysRemaining: number;
+    progress: number;
+    quarterStart: Date;
+    quarterEnd: Date;
+    yearStart: Date;
+    yearEnd: Date;
+};
+//# sourceMappingURL=fiscal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal.d.ts","sourceRoot":"","sources":["../../src/fiscal.ts"],"names":[],"mappings":"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"}