@bereasoftware/time-guard 2.0.4 → 2.0.6

package/dist/types/time-guard.d.ts

@@ -1,1130 +1,151 @@
-import { Temporal } from '@js-temporal/polyfill';
-
-export declare class AdvancedFormatPlugin implements ITimeGuardPlugin {
-    name: string;
-    version: string;
-    /**
-     * Install plugin into TimeGuard
-     */
-    install(TimeGuardClass: typeof TimeGuard): void;
-    /**
-     * Get ordinal suffix (1st, 2nd, 3rd, etc.)
-     */
-    private getOrdinal;
-    /**
-     * Pad number with leading zeros
-     */
-    private padNumber;
-    /**
-     * Get ISO week number
-     */
-    private getISOWeek;
-    /**
-     * Get week of year (locale-based)
-     */
-    private getWeekOfYear;
-    /**
-     * Get ISO week year
-     */
-    private getISOWeekYear;
-    /**
-     * Get week year
-     */
-    private getWeekYear;
-    /**
-     * Get timezone offset short form
-     */
-    private getTimezoneOffset;
-    /**
-     * Get timezone offset long form
-     */
-    private getTimezoneOffsetLong;
-}
-
-/**
- * Create and export default instance
- */
-export declare const advancedFormatPlugin: AdvancedFormatPlugin;
-
-/**
- * Aggregated locale data from all modules
- */
-export declare const ALL_LOCALES: Record<string, ILocale>;
-
-/**
- * Buddhist Calendar
- * @experimental Uses Gregorian rules with BE year offset (CE + 543).
- */
-export declare class BuddhistCalendar implements ICalendarSystem {
-    readonly id = "buddhist";
-    readonly name = "Buddhist Calendar";
-    readonly locale = "th";
-    private monthNames;
-    getMonthName(month: number): string;
-    getWeekdayName(day: number): string;
-    isLeapYear(year: number): boolean;
-    daysInMonth(year: number, month: number): number;
-    daysInYear(year: number): number;
-}
-
-/**
- * Calendar Manager - Singleton for managing calendar systems
- */
-export declare class CalendarManager implements ICalendarManager {
-    private static instance;
-    private calendars;
-    private defaultCalendar;
-    private constructor();
-    /**
-     * Get singleton instance
-     */
-    static getInstance(): CalendarManager;
-    /**
-     * Register a new calendar system
-     */
-    register(calendar: ICalendarSystem): void;
-    /**
-     * Get calendar by ID
-     */
-    get(id: string): ICalendarSystem | undefined;
-    /**
-     * List all available calendars
-     */
-    list(): string[];
-    /**
-     * Set default calendar
-     */
-    setDefault(id: string): void;
-    /**
-     * Get default calendar
-     */
-    getDefault(): ICalendarSystem;
-}
-
-export declare const calendarManager: CalendarManager;
-
-/**
- * Chinese Calendar
- * @experimental Uses simplified calculations. May not be accurate for all dates.
- */
-export declare class ChineseCalendar implements ICalendarSystem {
-    readonly id = "chinese";
-    readonly name = "Chinese Calendar";
-    readonly locale = "zh";
-    private monthNames;
-    private terrestrialBranches;
-    getMonthName(month: number): string;
-    getWeekdayName(day: number, short?: boolean): string;
-    isLeapYear(year: number): boolean;
-    daysInMonth(_year: number, month: number): number;
-    daysInYear(year: number): number;
-    /**
-     * Get zodiac sign for year
-     */
-    getZodiacSign(year: number): string;
-}
-
-/**
- * Date Formatter implementation
- */
-export declare class DateFormatter implements IDateFormatter {
-    private localeManager;
-    constructor();
-    /**
-     * Format date with pattern and locale
-     */
-    format(date: Temporal.PlainDateTime, pattern: string, locale?: string): string;
-    /**
-     * Get format pattern for preset
-     */
-    getPreset(preset: FormatPreset): string;
-    /**
-     * Format with preset
-     */
-    formatPreset(date: Temporal.PlainDateTime, preset: FormatPreset, locale?: string): string;
-}
-
-/**
- * Duration class - represents time span following ISO 8601 standard
- */
-export declare class Duration implements IDuration {
-    private years;
-    private months;
-    private weeks;
-    private days;
-    private hours;
-    private minutes;
-    private seconds;
-    private milliseconds;
-    constructor(input: DurationInput);
-    /**
-     * Create Duration from ISO 8601 string
-     * @example Duration.fromISO("P3Y6M4DT12H30M5S")
-     */
-    static fromISO(iso: string): Duration;
-    /**
-     * Create a Duration between this date and another
-     */
-    static between(from: TimeGuard, to: TimeGuard): Duration;
-    /**
-     * Create Duration from milliseconds
-     */
-    static fromMilliseconds(ms: number): Duration;
-    /**
-     * Get duration in specific unit
-     */
-    as(unit: DurationUnit): number;
-    /**
-     * Get duration as milliseconds
-     */
-    asMilliseconds(): number;
-    /**
-     * Get duration as seconds
-     */
-    asSeconds(): number;
-    /**
-     * Get duration as minutes
-     */
-    asMinutes(): number;
-    /**
-     * Get duration as hours
-     */
-    asHours(): number;
-    /**
-     * Get duration as days
-     */
-    asDays(): number;
-    /**
-     * Get duration as weeks
-     */
-    asWeeks(): number;
-    /**
-     * Get duration as months
-     */
-    asMonths(): number;
-    /**
-     * Get duration as years
-     */
-    asYears(): number;
-    /**
-     * Get all components
-     */
-    toObject(): DurationObject;
-    /**
-     * Get ISO 8601 string representation
-     * @example "P3Y6M4DT12H30M5S"
-     */
-    toISO(): string;
-    /**
-     * Get human-readable string
-     */
-    humanize(): string;
-    /**
-     * Check if duration is negative
-     */
-    isNegative(): boolean;
-    /**
-     * Get absolute duration
-     */
-    abs(): Duration;
-    /**
-     * String representation
-     */
-    toString(): string;
-}
-
-export declare interface DurationInput {
-    years?: number;
-    months?: number;
-    weeks?: number;
-    days?: number;
-    hours?: number;
-    minutes?: number;
-    seconds?: number;
-    milliseconds?: number;
-}
-
-export declare interface DurationObject {
-    years: number;
-    months: number;
-    weeks: number;
-    days: number;
-    hours: number;
-    minutes: number;
-    seconds: number;
-    milliseconds: number;
-}
-
-/**
- * Duration Plugin
- */
-export declare class DurationPlugin implements ITimeGuardPlugin {
-    name: string;
-    version: string;
-    /**
-     * Install plugin into TimeGuard
-     */
-    install(TimeGuardClass: typeof TimeGuard): void;
-}
-
-/**
- * Create and export default instance
- */
-export declare const durationPlugin: DurationPlugin;
-
-/**
- * Duration Plugin Types
- */
-export declare type DurationUnit = 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds' | 'milliseconds';
-
-/**
- * English locale data
- */
-export declare const EN_LOCALE: ILocale;
-
-/**
- * Spanish locale data (sample for i18n support)
- */
-export declare const ES_LOCALE: ILocale;
-
-/**
- * Format preset strings for common patterns
- */
-export declare type FormatPreset = 'iso' | 'date' | 'time' | 'datetime' | 'rfc2822' | 'rfc3339' | 'utc';
-
-/**
- * Get all available locales
- */
-export declare function getAvailableLocales(): string[];
-
-/**
- * Gregorian Calendar System (ISO 8601 default)
- */
-export declare class GregorianCalendar implements ICalendarSystem {
-    readonly id = "gregory";
-    readonly name = "Gregorian Calendar";
-    readonly locale = "en";
-    private monthNames;
-    private monthNamesShort;
-    private weekdayNames;
-    private weekdayNamesShort;
-    getMonthName(month: number, short?: boolean): string;
-    getWeekdayName(day: number, short?: boolean): string;
-    isLeapYear(year: number): boolean;
-    daysInMonth(year: number, month: number): number;
-    daysInYear(year: number): number;
-}
-
-/**
- * Hebrew Calendar
- * @experimental Uses simplified calculations. May not be accurate for all dates.
- */
-export declare class HebrewCalendar implements ICalendarSystem {
-    readonly id = "hebrew";
-    readonly name = "Hebrew Calendar";
-    readonly locale = "he";
-    private monthNames;
-    getMonthName(month: number): string;
-    getWeekdayName(day: number, short?: boolean): string;
-    isLeapYear(year: number): boolean;
-    daysInMonth(_year: number, month: number): number;
-    daysInYear(year: number): number;
-}
-
-/**
- * Calendar manager interface
- */
-export declare interface ICalendarManager {
-    register(calendar: ICalendarSystem): void;
-    get(id: string): ICalendarSystem | undefined;
-    list(): string[];
-    setDefault(id: string): void;
-    getDefault(): ICalendarSystem;
-}
-
-/**
- * Calendar system interface
- */
-export declare interface ICalendarSystem {
-    id: string;
-    name: string;
-    locale?: string;
-    getMonthName(month: number, short?: boolean): string;
-    getWeekdayName(day: number, short?: boolean): string;
-    isLeapYear(year: number): boolean;
-    daysInMonth(year: number, month: number): number;
-    daysInYear(year: number): number;
-}
-
-/**
- * Interface for arithmetic operations
- */
-export declare interface IDateArithmetic {
-    add(units: Partial<Record<Unit, number>> | IDuration_2): TimeGuard_2;
-    subtract(units: Partial<Record<Unit, number>> | IDuration_2): TimeGuard_2;
-    diff(other: TimeGuard_2, unit?: Unit): number;
-    until(other: TimeGuard_2, options?: IRoundOptions): IDuration_2;
-    round(options: IRoundOptions): TimeGuard_2;
-}
-
-/**
- * Interface for date/time formatting (Strategy Pattern)
- */
-export declare interface IDateFormatter {
-    format(date: any, pattern: string): string;
-    getPreset(preset: FormatPreset): string;
-}
-
-/**
- * Interface for manipulation operations
- */
-export declare interface IDateManipulation {
-    clone(): TimeGuard_2;
-    startOf(unit: Unit): TimeGuard_2;
-    endOf(unit: Unit): TimeGuard_2;
-    set(values: Partial<Record<Unit, number>>): TimeGuard_2;
-    year(): number;
-    month(): number;
-    day(): number;
-    hour(): number;
-    minute(): number;
-    second(): number;
-    millisecond(): number;
-    dayOfWeek(): number;
-    dayOfYear(): number;
-    weekOfYear(): number;
-    daysInMonth(): number;
-    daysInYear(): number;
-    inLeapYear(): boolean;
-}
-
-/**
- * Interface for date/time parsing strategy (Strategy Pattern)
- */
-export declare interface IDateParser {
-    parse(input: unknown): any | null;
-    canHandle(input: unknown): boolean;
-}
-
-/**
- * Interface for query operations
- */
-export declare interface IDateQuery {
-    isBefore(other: TimeGuard_2): boolean;
-    isAfter(other: TimeGuard_2): boolean;
-    isSame(other: TimeGuard_2, unit?: Unit): boolean;
-    isBetween(start: TimeGuard_2, end: TimeGuard_2, unit?: Unit, inclusivity?: '[)' | '()' | '[]' | '(]'): boolean;
-}
-
-/**
- * Duration class for ISO 8601 durations
- */
-export declare interface IDuration {
-    /**
-     * Get duration in specific unit
-     */
-    as(unit: DurationUnit): number;
-    /**
-     * Get duration as milliseconds
-     */
-    asMilliseconds(): number;
-    /**
-     * Get duration as seconds
-     */
-    asSeconds(): number;
-    /**
-     * Get duration as minutes
-     */
-    asMinutes(): number;
-    /**
-     * Get duration as hours
-     */
-    asHours(): number;
-    /**
-     * Get duration as days
-     */
-    asDays(): number;
-    /**
-     * Get duration as weeks
-     */
-    asWeeks(): number;
-    /**
-     * Get duration as months
-     */
-    asMonths(): number;
-    /**
-     * Get duration as years
-     */
-    asYears(): number;
-    /**
-     * Get all components
-     */
-    toObject(): DurationObject;
-    /**
-     * Get ISO 8601 string representation
-     */
-    toISO(): string;
-    /**
-     * Get human-readable string
-     */
-    humanize(): string;
-    /**
-     * Check if duration is negative
-     */
-    isNegative(): boolean;
-    /**
-     * Get absolute duration
-     */
-    abs(): IDuration;
-}
-
-/**
- * Duration-like object for arithmetic operations
- */
-declare interface IDuration_2 {
-    years?: number;
-    months?: number;
-    weeks?: number;
-    days?: number;
-    hours?: number;
-    minutes?: number;
-    seconds?: number;
-    milliseconds?: number;
-    microseconds?: number;
-    nanoseconds?: number;
-}
-
-/**
- * Locale configuration interface
- */
-export declare interface ILocale {
-    name: string;
-    months: string[];
-    monthsShort: string[];
-    weekdays: string[];
-    weekdaysShort: string[];
-    weekdaysMin: string[];
-    meridiem?: {
-        am: string;
-        pm: string;
-    };
-    formats?: Record<string, string>;
-}
-
-/**
- * Interface for locale management (Single Responsibility)
- */
-export declare interface ILocaleManager {
-    setLocale(locale: string, data?: ILocale): void;
-    getLocale(locale?: string): ILocale;
-    listLocales(): string[];
-}
-
-/**
- * Round options for precision control
- */
-export declare interface IRoundOptions {
-    smallestUnit?: Unit;
-    roundingMode?: 'ceil' | 'floor' | 'expand' | 'trunc' | 'halfExpand' | 'halfFloor' | 'halfCeil' | 'halfTrunc';
-    roundingIncrement?: number;
-}
-
-/**
- * Islamic Calendar (Hijri)
- * @experimental Uses simplified calculations. May not be accurate for all dates.
- */
-export declare class IslamicCalendar implements ICalendarSystem {
-    readonly id = "islamic";
-    readonly name = "Islamic Calendar (Hijri)";
-    readonly locale = "ar";
-    private monthNames;
-    getMonthName(month: number): string;
-    getWeekdayName(day: number, short?: boolean): string;
-    isLeapYear(year: number): boolean;
-    daysInMonth(year: number, month: number): number;
-    daysInYear(year: number): number;
-}
-
-/**
- * Main TimeGuard interface (Facade Pattern)
- */
-export declare interface ITimeGuard extends IDateArithmetic, IDateQuery, IDateManipulation {
-    /**
-     * Get the underlying Temporal date object
-     */
-    toTemporal(): any;
-    /**
-     * Get as JavaScript Date (compatibility)
-     */
-    toDate(): Date;
-    /**
-     * Get as ISO string
-     */
-    toISOString(): string;
-    /**
-     * Get as Unix timestamp (milliseconds)
-     */
-    valueOf(): number;
-    /**
-     * Format the date with pattern or preset
-     */
-    format(pattern: string | FormatPreset): string;
-    /**
-     * Get accessor for components
-     */
-    get(component: Unit): number;
-    /**
-     * Locale of this instance
-     */
-    locale(): string;
-    /**
-     * Clone with new locale
-     */
-    locale(locale: string): TimeGuard_2;
-    /**
-     * Timezone info
-     */
-    timezone(): string | null;
-    /**
-     * Convert to another timezone
-     */
-    timezone(timezone: string): TimeGuard_2;
-    /**
-     * Get Unix timestamp in seconds
-     */
-    unix(): number;
-    /**
-     * Convert to JSON
-     */
-    toJSON(): string;
-    /**
-     * String representation
-     */
-    toString(): string;
-    /**
-     * Convert to PlainDate object
-     */
-    toPlainDate(): {
-        year: number;
-        month: number;
-        day: number;
-        dayOfWeek: number;
-    };
-    /**
-     * Convert to PlainTime object
-     */
-    toPlainTime(): {
-        hour: number;
-        minute: number;
-        second: number;
-        millisecond: number;
-    };
-    /**
-     * Get timezone offset (±HH:mm format or Z)
-     */
-    getOffset(): string;
-    /**
-     * Get timezone offset in nanoseconds
-     */
-    getOffsetNanoseconds(): number;
-    /**
-     * Get timezone ID
-     */
-    getTimeZoneId(): string | null;
-    /**
-     * Start of day
-     */
-    startOfDay(): TimeGuard_2;
-    /**
-     * End of day
-     */
-    endOfDay(): TimeGuard_2;
-    /**
-     * Duration from another date (inverse of until)
-     */
-    since(other: TimeGuard_2): IDuration_2;
-    /**
-     * ISO 8601 duration string (P1Y2M3DT4H5M6S)
-     */
-    toDurationString(other?: TimeGuard_2): string;
-    /**
-     * Check if in past
-     */
-    isPast(): boolean;
-    /**
-     * Check if in future
-     */
-    isFuture(): boolean;
-    /**
-     * Check if today
-     */
-    isToday(): boolean;
-    /**
-     * Check if tomorrow
-     */
-    isTomorrow(): boolean;
-    /**
-     * Check if yesterday
-     */
-    isYesterday(): boolean;
-}
-
-/**
- * Configuration options for TimeGuard instance
- */
-export declare interface ITimeGuardConfig {
-    locale?: string;
-    timezone?: string;
-    strict?: boolean;
-}
-
-/**
- * Factory interface
- */
-export declare interface ITimeGuardFactory {
-    create(input?: unknown, config?: ITimeGuardConfig): ITimeGuard;
-    now(config?: ITimeGuardConfig): ITimeGuard;
-    fromTemporal(date: any, config?: ITimeGuardConfig): ITimeGuard;
-}
-
-/**
- * Plugin interface for extending functionality
- */
-export declare interface ITimeGuardPlugin {
-    name: string;
-    version: string;
-    install(timeGuard: typeof TimeGuard_2, config?: unknown): void;
-}
-
-/**
- * Interface for timezone operations
- */
-export declare interface ITimezoneAdapter {
-    toTimezone(date: any, timezone: string): any;
-    fromTimezone(date: any, targetTimezone: string): any;
-    getOffset(timezone: string): number;
-}
-
-/**
- * Japanese Calendar
- * @experimental Uses Gregorian rules post-1873. Historical dates may not be accurate.
- */
-export declare class JapaneseCalendar implements ICalendarSystem {
-    readonly id = "japanese";
-    readonly name = "Japanese Calendar";
-    readonly locale = "ja";
-    private monthNames;
-    getMonthName(month: number): string;
-    getWeekdayName(day: number, short?: boolean): string;
-    isLeapYear(year: number): boolean;
-    daysInMonth(year: number, month: number): number;
-    daysInYear(year: number): number;
-}
-
-/**
- * Locale Manager - implements ILocaleManager
- */
-export declare class LocaleManager implements ILocaleManager {
-    private static instance;
-    private locales;
-    private currentLocale;
-    /**
-     * Singleton pattern
-     */
-    static getInstance(): LocaleManager;
-    private constructor();
-    /**
-     * Set or register a locale
-     */
-    setLocale(locale: string, data?: ILocale): void;
-    /**
-     * Get locale information
-     */
-    getLocale(locale?: string): ILocale;
-    /**
-     * List all registered locales
-     */
-    listLocales(): string[];
-    /**
-     * Get current locale
-     */
-    getCurrentLocale(): string;
-    /**
-     * Load multiple locales
-     */
-    loadLocales(locales: Record<string, ILocale>): void;
-}
-
-/**
- * Total locales count (minimum 40 required)
- */
-export declare const LOCALES_COUNT = 40;
-
-/**
- * Plugin Manager - handles plugin registration and initialization
- * Uses Singleton pattern to ensure single instance across application
- */
-export declare class PluginManager {
-    private static instance;
-    private plugins;
-    /**
-     * Get singleton instance
-     */
-    static getInstance(): PluginManager;
-    /**
-     * Register a plugin
-     * @param plugin - The plugin to register
-     * @param timeGuardClass - Reference to TimeGuard class
-     * @param config - Optional plugin configuration
-     */
-    static use(plugin: ITimeGuardPlugin, timeGuardClass: typeof TimeGuard, config?: unknown): void;
-    /**
-     * Register multiple plugins at once
-     * @param plugins - Array of plugins to register
-     * @param timeGuardClass - Reference to TimeGuard class
-     * @param config - Optional plugin configuration
-     */
-    static useMultiple(plugins: ITimeGuardPlugin[], timeGuardClass: typeof TimeGuard, config?: unknown): void;
-    /**
-     * Get registered plugin by name
-     * @param name - Plugin name
-     * @returns Plugin instance or undefined
-     */
-    static getPlugin(name: string): ITimeGuardPlugin | undefined;
-    /**
-     * Check if plugin is registered
-     * @param name - Plugin name
-     * @returns True if plugin is registered
-     */
-    static hasPlugin(name: string): boolean;
-    /**
-     * Get all registered plugins
-     * @returns Array of registered plugin names
-     */
-    static listPlugins(): string[];
-    /**
-     * Unregister a plugin
-     * @param name - Plugin name
-     */
-    static unuse(name: string): boolean;
-    /**
-     * Clear all plugins
-     */
-    static clear(): void;
-    /**
-     * Internal register method
-     */
-    private register;
-}
-
-/**
- * Register all locales into a locale map
- */
-export declare function registerAllLocales(localeMap: Map<string, ILocale> | Record<string, ILocale>): void;
-
-/**
- * RelativeTime Plugin Types
- */
-export declare interface RelativeTimeConfig {
-    thresholds?: RelativeTimeThreshold[];
-    rounding?: (value: number) => number;
-}
-
-export declare interface RelativeTimeFormats {
-    future: string;
-    past: string;
-    s: string;
-    m: string;
-    mm: string;
-    h: string;
-    hh: string;
-    d: string;
-    dd: string;
-    M: string;
-    MM: string;
-    y: string;
-    yy: string;
-}
-
-export declare class RelativeTimePlugin implements ITimeGuardPlugin {
-    name: string;
-    version: string;
-    private config;
-    private formats;
-    constructor(config?: RelativeTimeConfig);
-    /**
-     * Install plugin into TimeGuard
-     */
-    install(TimeGuardClass: typeof TimeGuard): void;
-    /**
-     * Format relative time
-     */
-    private formatRelativeTime;
-    /**
-     * Get relative time string based on milliseconds
-     */
-    private getRelativeTimeString;
-    /**
-     * Get milliseconds per unit
-     */
-    private getUnitMilliseconds;
-    /**
-     * Set format strings
-     */
-    setFormats(formats: Partial<RelativeTimeFormats>): void;
-    /**
-     * Get current formats
-     */
-    getFormats(): RelativeTimeFormats;
-}
-
-/**
- * Create and export default instance
- */
-export declare const relativeTimePlugin: RelativeTimePlugin;
-
-export declare interface RelativeTimeThreshold {
-    l: string;
-    r?: number;
-    d?: string;
-}
-
-/**
- * Adapter for Temporal date/time operations
- */
-export declare class TemporalAdapter {
-    /**
-     * Parse various input formats to Temporal.PlainDateTime
-     */
-    static parseToPlainDateTime(input: unknown): TemporalPlainDateTime;
-    /**
-     * Convert JavaScript Date to Temporal.PlainDateTime
-     */
-    static fromDate(date: Date): TemporalPlainDateTime;
-    /**
-     * Convert Unix timestamp (milliseconds) to Temporal.PlainDateTime
-     */
-    static fromUnix(timestamp: number): TemporalPlainDateTime;
-    /**
-     * Parse ISO string to Temporal.PlainDateTime
-     */
-    static parseISOString(iso: string): TemporalPlainDateTime;
-    /**
-     * Create from object with date components
-     */
-    static fromObject(obj: Record<string, any>): TemporalPlainDateTime;
-    /**
-     * Convert Temporal.PlainDateTime to JavaScript Date
-     */
-    static toDate(temporal: TemporalPlainDateTime | TemporalZonedDateTime): Date;
-    /**
-     * Convert to Unix timestamp (milliseconds)
-     */
-    static toUnix(temporal: TemporalPlainDateTime | TemporalZonedDateTime): number;
-    /**
-     * Convert to ISO string
-     */
-    static toISOString(temporal: TemporalPlainDateTime | TemporalZonedDateTime): string;
-    /**
-     * Ensure we have a PlainDateTime
-     */
-    static toPlainDateTime(temporal: TemporalPlainDateTime | TemporalZonedDateTime): TemporalPlainDateTime;
-    /**
-     * Type guards
-     */
-    static isPlainDateTime(obj: unknown): obj is TemporalPlainDateTime;
-    static isZonedDateTime(obj: unknown): obj is TemporalZonedDateTime;
-    static isPlainDate(obj: unknown): obj is any;
-    static isPlainTime(obj: unknown): obj is any;
-    /**
-     * Get current time as PlainDateTime
-     */
-    static now(): TemporalPlainDateTime;
-    /**
-     * Get current time as ZonedDateTime with timezone
-     */
-    static nowInTimezone(timezone: string): TemporalZonedDateTime;
-}
-
-declare type TemporalPlainDateTime = Temporal.PlainDateTime;
-
-declare type TemporalZonedDateTime = Temporal.ZonedDateTime;
-
-/**
- * TimeGuard implementation - Main facade class
- */
-export declare class TimeGuard implements ITimeGuard {
-    private temporal;
-    private config;
-    private formatterInstance;
-    constructor(input?: unknown, config?: ITimeGuardConfig);
-    /**
-     * Static factory methods
-     */
-    static now(config?: ITimeGuardConfig): TimeGuard;
-    static from(input: unknown, config?: ITimeGuardConfig): TimeGuard;
-    static fromTemporal(temporal: any, // Temporal.PlainDateTime | Temporal.ZonedDateTime
-    config?: ITimeGuardConfig): TimeGuard;
-    toTemporal(): any;
-    toDate(): Date;
-    toISOString(): string;
-    valueOf(): number;
-    unix(): number;
-    toJSON(): string;
-    toString(): string;
-    locale(): string;
-    locale(locale: string): TimeGuard;
-    timezone(): string | null;
-    timezone(timezone: string): TimeGuard;
-    format(pattern: string | FormatPreset): string;
-    get(component: Unit): number;
-    add(units: Partial<Record<Unit, number>>): TimeGuard;
-    subtract(units: Partial<Record<Unit, number>>): TimeGuard;
-    diff(other: TimeGuard, unit?: Unit): number;
-    isBefore(other: TimeGuard): boolean;
-    isAfter(other: TimeGuard): boolean;
-    isSame(other: TimeGuard, unit?: Unit): boolean;
-    isBetween(start: TimeGuard, end: TimeGuard, unit?: Unit, inclusivity?: '[)' | '()' | '[]' | '(]'): boolean;
-    clone(): TimeGuard;
-    startOf(unit: Unit): TimeGuard;
-    endOf(unit: Unit): TimeGuard;
-    set(values: Partial<Record<Unit, number>>): TimeGuard;
-    year(): number;
-    month(): number;
-    day(): number;
-    hour(): number;
-    minute(): number;
-    second(): number;
-    millisecond(): number;
-    dayOfWeek(): number;
-    dayOfYear(): number;
-    weekOfYear(): number;
-    daysInMonth(): number;
-    daysInYear(): number;
-    inLeapYear(): boolean;
-    /**
-     * Calculate duration until another TimeGuard
-     */
-    until(other: TimeGuard): {
-        years: number;
-        months: number;
-        days: number;
-        hours: number;
-        minutes: number;
-        seconds: number;
-        milliseconds: number;
-    };
-    /**
-     * Round to a specific unit with optional rounding mode
-     */
-    round(options?: IRoundOptions): TimeGuard;
-    /**
-     * Convert to PlainDate (removes time information)
-     */
-    toPlainDate(): {
-        year: number;
-        month: number;
-        day: number;
-        dayOfWeek: number;
-    };
-    /**
-     * Convert to PlainTime (removes date information)
-     */
-    toPlainTime(): {
-        hour: number;
-        minute: number;
-        second: number;
-        millisecond: number;
-    };
-    /**
-     * Create new TimeGuard with only date, keeping time from parameter
-     */
-    withDate(year: number, month: number, day: number): TimeGuard;
-    /**
-     * Create new TimeGuard with only time, keeping date
-     */
-    withTime(hour: number, minute?: number, second?: number, millisecond?: number): TimeGuard;
-    /**
-     * Get timezone offset in format ±HH:mm
-     */
-    getOffset(): string;
-    /**
-     * Get timezone offset in nanoseconds
-     */
-    getOffsetNanoseconds(): number;
-    /**
-     * Get timezone ID
-     */
-    getTimeZoneId(): string | null;
-    /**
-     * Start of the day in current timezone
-     */
-    startOfDay(): TimeGuard;
-    /**
-     * End of the day in current timezone
-     */
-    endOfDay(): TimeGuard;
-    /**
-     * Calculate duration from another TimeGuard (inverse of until)
-     * Returns negative values if other is before this
-     */
-    since(other: TimeGuard): {
-        years: number;
-        months: number;
-        days: number;
-        hours: number;
-        minutes: number;
-        seconds: number;
-        milliseconds: number;
-    };
-    /**
-     * Get ISO 8601 duration string
-     * Example: P1Y2M3DT4H5M6S
-     */
-    toDurationString(other?: TimeGuard): string;
-    /**
-     * Check if this date is in the past
-     */
-    isPast(): boolean;
-    /**
-     * Check if this date is in the future
-     */
-    isFuture(): boolean;
-    /**
-     * Check if this date is today
-     */
-    isToday(): boolean;
-    /**
-     * Check if this date is tomorrow
-     */
-    isTomorrow(): boolean;
-    /**
-     * Check if this date is yesterday
-     */
-    isYesterday(): boolean;
-}
-
-export declare function timeGuard(input?: unknown, config?: ITimeGuardConfig): TimeGuard;
-
-/**
- * Forward declaration for TimeGuard class
- * Implementation is in ./time-guard.ts, exported via ./index.ts
- */
-declare class TimeGuard_2 {
-    constructor(input?: unknown, config?: ITimeGuardConfig);
-}
-
-/**
- * TimeGuard - Core Types and Interfaces
- * Following SOLID principles and TypeScript best practices
- *
- * Temporal types are provided natively by TypeScript (lib.esnext.temporal).
- */
-/**
- * Unit type for date/time operations
- */
-export declare type Unit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond' | 'microsecond' | 'nanosecond';
-
-export declare const version: string;
-
-export { }
+import { ITimeGuard, ITimeGuardConfig, Unit, FormatPreset, IRoundOptions } from './types';
+type DurationParts = {
+    years: number;
+    months: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+};
+/**
+ * TimeGuard implementation - Main facade class
+ */
+export declare class TimeGuard implements ITimeGuard {
+    private temporal;
+    private config;
+    private formatterInstance;
+    private static readonly ZERO_DURATION;
+    private static isLeapYearValue;
+    private static toDurationParts;
+    constructor(input?: unknown, config?: ITimeGuardConfig);
+    /**
+     * Static factory methods
+     */
+    static now(config?: ITimeGuardConfig): TimeGuard;
+    static from(input: unknown, config?: ITimeGuardConfig): TimeGuard;
+    static fromTemporal(temporal: any, // Temporal.PlainDateTime | Temporal.ZonedDateTime
+    config?: ITimeGuardConfig): TimeGuard;
+    toTemporal(): any;
+    toDate(): Date;
+    toISOString(): string;
+    valueOf(): number;
+    unix(): number;
+    toJSON(): string;
+    toString(): string;
+    locale(): string;
+    locale(locale: string): TimeGuard;
+    timezone(): string | null;
+    timezone(timezone: string): TimeGuard;
+    format(pattern: string | FormatPreset): string;
+    get(component: Unit): number;
+    add(units: Partial<Record<Unit, number>>): TimeGuard;
+    subtract(units: Partial<Record<Unit, number>>): TimeGuard;
+    diff(other: TimeGuard, unit?: Unit): number;
+    isBefore(other: TimeGuard): boolean;
+    isAfter(other: TimeGuard): boolean;
+    isSame(other: TimeGuard, unit?: Unit): boolean;
+    isBetween(start: TimeGuard, end: TimeGuard, unit?: Unit, inclusivity?: '[)' | '()' | '[]' | '(]'): boolean;
+    clone(): TimeGuard;
+    startOf(unit: Unit): TimeGuard;
+    endOf(unit: Unit): TimeGuard;
+    set(values: Partial<Record<Unit, number>>): TimeGuard;
+    year(): number;
+    month(): number;
+    day(): number;
+    hour(): number;
+    minute(): number;
+    second(): number;
+    millisecond(): number;
+    dayOfWeek(): number;
+    dayOfYear(): number;
+    weekOfYear(): number;
+    daysInMonth(): number;
+    daysInYear(): number;
+    inLeapYear(): boolean;
+    /**
+     * Calculate duration until another TimeGuard
+     */
+    until(other: TimeGuard): DurationParts;
+    /**
+     * Round to a specific unit with optional rounding mode
+     */
+    round(options?: IRoundOptions): TimeGuard;
+    /**
+     * Convert to PlainDate (removes time information)
+     */
+    toPlainDate(): {
+        year: number;
+        month: number;
+        day: number;
+        dayOfWeek: number;
+    };
+    /**
+     * Convert to PlainTime (removes date information)
+     */
+    toPlainTime(): {
+        hour: number;
+        minute: number;
+        second: number;
+        millisecond: number;
+    };
+    /**
+     * Create new TimeGuard with only date, keeping time from parameter
+     */
+    withDate(year: number, month: number, day: number): TimeGuard;
+    /**
+     * Create new TimeGuard with only time, keeping date
+     */
+    withTime(hour: number, minute?: number, second?: number, millisecond?: number): TimeGuard;
+    /**
+     * Get timezone offset in format ±HH:mm
+     */
+    getOffset(): string;
+    /**
+     * Get timezone offset in nanoseconds
+     */
+    getOffsetNanoseconds(): number;
+    /**
+     * Get timezone ID
+     */
+    getTimeZoneId(): string | null;
+    /**
+     * Start of the day in current timezone
+     */
+    startOfDay(): TimeGuard;
+    /**
+     * End of the day in current timezone
+     */
+    endOfDay(): TimeGuard;
+    /**
+     * Calculate duration from another TimeGuard (inverse of until)
+     * Returns negative values if other is before this
+     */
+    since(other: TimeGuard): DurationParts;
+    /**
+     * Get ISO 8601 duration string
+     * Example: P1Y2M3DT4H5M6S
+     */
+    toDurationString(other?: TimeGuard): string;
+    /**
+     * Check if this date is in the past
+     */
+    isPast(): boolean;
+    /**
+     * Check if this date is in the future
+     */
+    isFuture(): boolean;
+    /**
+     * Check if this date is today
+     */
+    isToday(): boolean;
+    /**
+     * Check if this date is tomorrow
+     */
+    isTomorrow(): boolean;
+    /**
+     * Check if this date is yesterday
+     */
+    isYesterday(): boolean;
+}
+export {};