tyrell-components 1.0.0-RC10

package/lib/utils/calendar-utils.js

@@ -0,0 +1,370 @@
+/**
+ * Calendar Utilities
+ *
+ * Pure TypeScript utilities for calendar month generation and localization.
+ * Ported from ClojureScript ty/date/core.cljs
+ *
+ * Key Features:
+ * - 42-day calendar grid generation (6 weeks × 7 days)
+ * - Monday-first week ordering
+ * - Rich day context with metadata
+ * - Localized weekday names
+ * - No external dependencies (native Date API only)
+ *
+ * Note on Timestamps:
+ * - `value`: UTC timestamp at midnight UTC (timezone-independent, use for storage/server)
+ * - `localValue`: Local timestamp at midnight local time (use for display/local calculations)
+ * - `year/month/dayInMonth`: Calendar date components (user's mental model)
+ *
+ * Example for October 13, 2025:
+ * - value = Date.UTC(2025, 9, 13) = consistent worldwide
+ * - localValue = new Date(2025, 9, 13).getTime() = varies by timezone
+ * - Both represent the same calendar date, different moments in time
+ */
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Validate month value (1-12)
+ */
+function validateMonth(month) {
+    if (!Number.isInteger(month) || month < 1 || month > 12) {
+        throw new RangeError(`Invalid month: ${month}. Must be an integer between 1 and 12.`);
+    }
+}
+/**
+ * Validate year value (reasonable range)
+ */
+function validateYear(year) {
+    if (!Number.isInteger(year) || year < 1 || year > 9999) {
+        throw new RangeError(`Invalid year: ${year}. Must be an integer between 1 and 9999.`);
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Check if two dates are on the same day (ignoring time)
+ * Works in local timezone
+ */
+function isSameDay(date1, date2) {
+    return date1.getFullYear() === date2.getFullYear()
+        && date1.getMonth() === date2.getMonth()
+        && date1.getDate() === date2.getDate();
+}
+/**
+ * Create a date at midnight local time
+ * This ensures consistent behavior across the application
+ */
+function createMidnightDate(year, month, day) {
+    return new Date(year, month - 1, day, 0, 0, 0, 0);
+}
+/**
+ * Get today's date at midnight local time
+ * Used for consistent "today" detection
+ */
+function getTodayMidnight() {
+    const now = new Date();
+    return new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0, 0);
+}
+/**
+ * Create a DayContext from a Date object
+ *
+ * @param date - The date to create context for (should be at midnight)
+ * @param targetYear - The year of the calendar month being displayed
+ * @param targetMonth - The month (1-12) of the calendar month being displayed
+ * @param selection - Optional selection state from calendar
+ * @returns Rich day context with metadata
+ */
+function createDayContext(date, targetYear, targetMonth, selection) {
+    const year = date.getFullYear();
+    const month = date.getMonth() + 1; // Convert to 1-based
+    const dayInMonth = date.getDate();
+    const dayOfWeek = date.getDay(); // 0 = Sunday, 6 = Saturday
+    // Check if this day is from a different month
+    const isOtherMonth = year !== targetYear || month !== targetMonth;
+    // Determine if previous or next month
+    let isPrevMonth = false;
+    let isNextMonth = false;
+    if (isOtherMonth) {
+        if (year < targetYear || (year === targetYear && month < targetMonth)) {
+            isPrevMonth = true;
+        }
+        else {
+            isNextMonth = true;
+        }
+    }
+    // Check if today (compare dates at midnight for consistency)
+    const todayMidnight = getTodayMidnight();
+    const isToday = isSameDay(date, todayMidnight);
+    // Check if this day is selected
+    const isSelected = selection?.year === year
+        && selection?.month === month
+        && selection?.day === dayInMonth;
+    // Calculate both UTC and local timestamps
+    // value: UTC midnight (consistent worldwide for the same date)
+    // localValue: Local midnight (respects user's timezone)
+    const utcValue = Date.UTC(year, month - 1, dayInMonth, 0, 0, 0, 0);
+    const localValue = date.getTime();
+    return {
+        value: utcValue,
+        localValue,
+        year,
+        month,
+        dayInMonth,
+        weekend: dayOfWeek === 0 || dayOfWeek === 6,
+        otherMonth: isOtherMonth,
+        prevMonth: isPrevMonth,
+        nextMonth: isNextMonth,
+        today: isToday,
+        isSelected,
+        selectedYear: selection?.year,
+        selectedMonth: selection?.month,
+        selectedDay: selection?.day,
+    };
+}
+/**
+ * Get the Monday at or before a given date
+ * (Monday = start of week in ISO 8601)
+ *
+ * @param date - Any date
+ * @returns The Monday of that week at midnight
+ */
+function getMondayOfWeek(date) {
+    const dayOfWeek = date.getDay(); // 0 = Sunday, 1 = Monday, etc.
+    // Calculate days to subtract to get to Monday
+    // Sunday (0) → go back 6 days
+    // Monday (1) → go back 0 days
+    // Tuesday (2) → go back 1 day
+    // ...
+    const daysToMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
+    // Create new date at Monday midnight
+    const monday = new Date(date);
+    monday.setDate(date.getDate() - daysToMonday);
+    monday.setHours(0, 0, 0, 0); // Ensure midnight
+    return monday;
+}
+/**
+ * Get the start date for the calendar grid
+ * (The Monday at or before the first day of the month)
+ *
+ * @param year - Year
+ * @param month - Month (1-12)
+ * @returns The Monday that starts the calendar grid
+ */
+function getMonthGridStart(year, month) {
+    // Get first day of month at midnight (month is 1-based, Date constructor is 0-based)
+    const firstDay = createMidnightDate(year, month, 1);
+    // Get the Monday of that week
+    return getMondayOfWeek(firstDay);
+}
+/**
+ * Add days to a date safely
+ * Creates a new date without mutating the original
+ *
+ * @param date - Starting date
+ * @param days - Number of days to add
+ * @returns New date with days added
+ */
+function addDays(date, days) {
+    const result = new Date(date);
+    result.setDate(result.getDate() + days);
+    return result;
+}
+/**
+ * Generate N consecutive days starting from a date
+ *
+ * @param startDate - Starting date
+ * @param count - Number of days to generate
+ * @param targetYear - Year of the calendar month
+ * @param targetMonth - Month (1-12) of the calendar month
+ * @param selection - Optional selection state to include in day contexts
+ * @returns Array of day contexts
+ */
+function generateDays(startDate, count, targetYear, targetMonth, selection) {
+    const days = [];
+    for (let i = 0; i < count; i++) {
+        const date = addDays(startDate, i);
+        days.push(createDayContext(date, targetYear, targetMonth, selection));
+    }
+    return days;
+}
+// ============================================================================
+// Main Calendar Functions
+// ============================================================================
+/**
+ * Generate a 42-day calendar grid for a given month
+ *
+ * Returns 6 weeks (42 days) starting from the Monday at or before
+ * the first day of the month. This ensures a complete calendar view
+ * with days from the previous and next months as needed.
+ *
+ * @param year - Year (e.g., 2025)
+ * @param month - Month (1-12, 1 = January)
+ * @param selection - Optional selection state to include in day contexts
+ * @returns Array of 42 day contexts with rich metadata
+ *
+ * @throws {RangeError} If year or month are invalid
+ *
+ * @example
+ * const days = getCalendarMonthDays(2025, 10); // October 2025
+ * console.log(days.length); // 42
+ * console.log(days[0].dayInMonth); // First day shown (might be from September)
+ */
+export function getCalendarMonthDays(year, month, selection) {
+    // Validate inputs
+    validateYear(year);
+    validateMonth(month);
+    const startDate = getMonthGridStart(year, month);
+    return generateDays(startDate, 42, year, month, selection);
+}
+/**
+ * Get localized weekday names in Monday-first order
+ *
+ * Note: Intl.DateTimeFormat returns Sunday-first by default,
+ * so we reorder to Monday-first: [Mon, Tue, Wed, Thu, Fri, Sat, Sun]
+ *
+ * @param locale - Locale string (e.g., "en-US", "de-DE", "ja-JP")
+ * @param style - Display style: "long" (Monday), "short" (Mon), "narrow" (M)
+ * @returns Array of 7 weekday names starting with Monday
+ *
+ * @example
+ * getLocalizedWeekdays("en-US", "short")
+ * // Returns: ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
+ *
+ * getLocalizedWeekdays("de-DE", "long")
+ * // Returns: ["Montag", "Dienstag", "Mittwoch", ...]
+ */
+export function getLocalizedWeekdays(locale, style = 'short') {
+    const formatter = new Intl.DateTimeFormat(locale, { weekday: style });
+    // Create a Sunday (base date) - January 7, 2024 is a Sunday
+    const sunday = new Date(2024, 0, 7);
+    // Generate Sunday-first array: [Sun, Mon, Tue, Wed, Thu, Fri, Sat]
+    const sundayFirst = Array.from({ length: 7 }, (_, i) => {
+        const date = addDays(sunday, i);
+        return formatter.format(date);
+    });
+    // Reorder to Monday-first: [Mon, Tue, Wed, Thu, Fri, Sat, Sun]
+    const [firstDay, ...rest] = sundayFirst;
+    return [...rest, firstDay];
+}
+// ============================================================================
+// Utility Functions (for testing and debugging)
+// ============================================================================
+/**
+ * Get month name in specified locale
+ *
+ * @param month - Month (1-12)
+ * @param locale - Locale string
+ * @param style - Display style
+ * @returns Localized month name
+ *
+ * @throws {RangeError} If month is invalid
+ */
+export function getMonthName(month, locale = 'en-US', style = 'long') {
+    validateMonth(month);
+    const date = new Date(2024, month - 1, 1);
+    const formatter = new Intl.DateTimeFormat(locale, { month: style });
+    return formatter.format(date);
+}
+/**
+ * Format a day context as an ISO date string
+ *
+ * @param dayContext - Day context to format
+ * @returns ISO date string (YYYY-MM-DD)
+ *
+ * @example
+ * formatDayContext({ year: 2025, month: 10, dayInMonth: 13, ... })
+ * // Returns: "2025-10-13"
+ */
+export function formatDayContext(dayContext) {
+    const { year, month, dayInMonth } = dayContext;
+    const monthStr = month.toString().padStart(2, '0');
+    const dayStr = dayInMonth.toString().padStart(2, '0');
+    return `${year}-${monthStr}-${dayStr}`;
+}
+/**
+ * Check if a day context matches a specific date
+ *
+ * @param dayContext - Day context to check
+ * @param year - Target year
+ * @param month - Target month (1-12)
+ * @param day - Target day
+ * @returns True if the day context matches
+ *
+ * @example
+ * isDayContext(dayCtx, 2025, 10, 13) // true if context is Oct 13, 2025
+ */
+export function isDayContext(dayContext, year, month, day) {
+    return dayContext.year === year
+        && dayContext.month === month
+        && dayContext.dayInMonth === day;
+}
+/**
+ * Parse an ISO date string (YYYY-MM-DD) into year, month, day components
+ *
+ * @param isoString - ISO date string (YYYY-MM-DD)
+ * @returns Object with year, month (1-12), and day, or null if invalid
+ *
+ * @example
+ * parseISODate("2025-10-13")
+ * // Returns: { year: 2025, month: 10, day: 13 }
+ */
+export function parseISODate(isoString) {
+    const match = isoString.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+    if (!match)
+        return null;
+    const year = parseInt(match[1], 10);
+    const month = parseInt(match[2], 10);
+    const day = parseInt(match[3], 10);
+    // Validate ranges
+    if (year < 1 || year > 9999)
+        return null;
+    if (month < 1 || month > 12)
+        return null;
+    if (day < 1 || day > 31)
+        return null;
+    // Check if date is valid (handles Feb 30, etc.)
+    const date = new Date(year, month - 1, day);
+    if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+        return null;
+    }
+    return { year, month, day };
+}
+/**
+ * Convert a UTC timestamp to an ISO date string
+ * Interprets the timestamp as UTC midnight and returns the date
+ *
+ * @param utcTimestamp - UTC timestamp in milliseconds
+ * @returns ISO date string (YYYY-MM-DD)
+ *
+ * @example
+ * const ctx = getCalendarMonthDays(2025, 10)[0];
+ * utcTimestampToISO(ctx.value) // "2025-10-13"
+ */
+export function utcTimestampToISO(utcTimestamp) {
+    const date = new Date(utcTimestamp);
+    const year = date.getUTCFullYear();
+    const month = (date.getUTCMonth() + 1).toString().padStart(2, '0');
+    const day = date.getUTCDate().toString().padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+/**
+ * Convert a local timestamp to an ISO date string
+ * Interprets the timestamp in local timezone and returns the date
+ *
+ * @param localTimestamp - Local timestamp in milliseconds
+ * @returns ISO date string (YYYY-MM-DD)
+ *
+ * @example
+ * const ctx = getCalendarMonthDays(2025, 10)[0];
+ * localTimestampToISO(ctx.localValue) // "2025-10-13"
+ */
+export function localTimestampToISO(localTimestamp) {
+    const date = new Date(localTimestamp);
+    const year = date.getFullYear();
+    const month = (date.getMonth() + 1).toString().padStart(2, '0');
+    const day = date.getDate().toString().padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+//# sourceMappingURL=calendar-utils.js.map

package/lib/utils/calendar-utils.js.map

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

package/lib/utils/custom-scrollbar.d.ts

@@ -0,0 +1,82 @@
+/**
+ * CustomScrollbar - Reusable scrollbar utility
+ *
+ * Attaches a custom rendered scrollbar (vertical and/or horizontal) to any
+ * scrollable element. Uses the overlay approach: native overflow:auto is
+ * preserved for scroll physics, native scrollbar is hidden via CSS,
+ * and custom track/thumb elements are synced on top.
+ *
+ * Usage:
+ *   const scrollbar = new CustomScrollbar(scrollEl, { vertical: true })
+ *   // scrollbar.trackY, scrollbar.thumbY — append these to your DOM
+ *   // scrollbar.trackX, scrollbar.thumbX — for horizontal
+ *   scrollbar.destroy()  // cleanup
+ *
+ * CSS classes applied:
+ *   .ty-scrollbar-track-y / .ty-scrollbar-track-x
+ *   .ty-scrollbar-thumb-y / .ty-scrollbar-thumb-x
+ *   .has-overflow — when content overflows
+ *   .dragging — during thumb drag
+ *   .scrolling — briefly after scroll (auto-hide)
+ */
+export interface CustomScrollbarOptions {
+    vertical?: boolean;
+    horizontal?: boolean;
+    autoHideDelay?: number;
+}
+/**
+ * Check if custom scrollbar is enabled globally.
+ * Default: true (custom scrollbar on).
+ * Set data-ty-scrollbar="native" on <html> to opt out.
+ */
+export declare function isCustomScrollbarEnabled(): boolean;
+export declare class CustomScrollbar {
+    private _scrollEl;
+    private _vertical;
+    private _horizontal;
+    private _autoHideDelay;
+    readonly trackY: HTMLElement | null;
+    readonly thumbY: HTMLElement | null;
+    readonly trackX: HTMLElement | null;
+    readonly thumbX: HTMLElement | null;
+    private _isDragging;
+    private _dragAxis;
+    private _dragStartPos;
+    private _dragStartScroll;
+    private _rafId;
+    private _hideTimeout;
+    private _resizeObserver;
+    private _onScroll;
+    private _onThumbYDown;
+    private _onThumbXDown;
+    private _onTrackYDown;
+    private _onTrackXDown;
+    private _onDragMove;
+    private _onDragEnd;
+    constructor(scrollEl: HTMLElement, options?: CustomScrollbarOptions);
+    private _createTrack;
+    private _createThumb;
+    /** Force update thumb size and position */
+    update(): void;
+    /** Reset scroll position */
+    scrollToTop(smooth?: boolean): void;
+    scrollToBottom(smooth?: boolean): void;
+    scrollToLeft(smooth?: boolean): void;
+    scrollToRight(smooth?: boolean): void;
+    /** Cleanup all listeners and observers */
+    destroy(): void;
+    private _handleScroll;
+    private _updateVertical;
+    private _updateHorizontal;
+    private _updateThumbPositions;
+    private _updateThumbY;
+    private _updateThumbX;
+    private _showScrollbars;
+    private _handleThumbYDown;
+    private _handleThumbXDown;
+    private _handleDragMove;
+    private _handleDragEnd;
+    private _handleTrackYDown;
+    private _handleTrackXDown;
+}
+//# sourceMappingURL=custom-scrollbar.d.ts.map

package/lib/utils/custom-scrollbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-scrollbar.d.ts","sourceRoot":"","sources":["../../src/utils/custom-scrollbar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAQ;IAG9B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAO;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAO;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAO;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAO;IAG1C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,eAAe,CAA8B;IAGrD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,UAAU,CAA2B;gBAEjC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,sBAA2B;IAsDvE,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAQpB,2CAA2C;IAC3C,MAAM,IAAI,IAAI;IAKd,4BAA4B;IAC5B,WAAW,CAAC,MAAM,UAAQ,GAAG,IAAI;IAIjC,cAAc,CAAC,MAAM,UAAQ,GAAG,IAAI;IAIpC,YAAY,CAAC,MAAM,UAAQ,GAAG,IAAI;IAIlC,aAAa,CAAC,MAAM,UAAQ,GAAG,IAAI;IAInC,0CAA0C;IAC1C,OAAO,IAAI,IAAI;IAkCf,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;CAa1B"}