@lifesg/react-design-system 3.5.0-canary.7 → 4.0.0-alpha.10

package/cjs/util/time-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"time-helper.js","sources":["../../../src/util/time-helper.ts"],"sourcesContent":["import dayjs from \"dayjs\";\nimport { StringHelper } from \"./string-helper\";\n\n// =============================================================================\n// INTERFACES\n// =============================================================================\nexport type TimeFormat = \"12hr\" | \"24hr\";\n\nexport enum EPeriod {\n    AM = \"AM\",\n    PM = \"PM\",\n}\n\nexport interface TimeValues {\n    hour: string;\n    minute: string;\n    period: EPeriod;\n}\n\nexport interface CalculateScrollPositionProps {\n    /** The time to scroll to in HH:mm format */\n    scrollTime: string;\n    /** The minimum time of the scrollable range in HH:mm format */\n    minTime: string;\n    /** The maximum time of the scrollable range in HH:mm format */\n    maxTime: string;\n    /** The interval in minutes (e.g., 15, 30, 60) */\n    interval: number;\n    /** The width in pixels of each interval */\n    intervalWidth: number;\n    /** Optional configuration */\n    options?: {\n        /** Round the scroll time to the nearest interval */\n        roundToInterval?: boolean;\n    };\n}\n\n// unexportable\ninterface TimeValuesPlain {\n    hour: string;\n    minute: string;\n    period?: string;\n}\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\nexport namespace TimeHelper {\n    /**\n     * Rounds time to the nearest interval, e.g 6:30 will be clamped to 6:00 when interval = 60\n     * @param time the input time in HH:mm format\n     * @param interval the interval in minutes (e.g., 15 for 15 minutes, 60 for 1 hour)\n     * @param toNextInterval to clamp to next interval instead, e.g. 6:30 will be clamped to 7:00 when interval = 60.\n     * If the time is already a valid interval, it will not be rounded\n     * @returns the rounded time in HH:mm format,\n     */\n    export const roundToNearestInterval = (\n        time: string,\n        interval: number,\n        toNextInterval?: boolean\n    ): string => {\n        const [hoursStr, minutesStr] = time.split(\":\");\n        const hours = parseInt(hoursStr, 10);\n        const minutes = parseInt(minutesStr, 10);\n\n        // Handle invalid inputs\n        if (isNaN(hours) || isNaN(minutes) || minutes < 0 || minutes >= 60) {\n            throw new Error(\"Invalid time format\");\n        }\n\n        // Convert the time to total minutes\n        const totalMinutes = hours * 60 + minutes;\n        const remainder = totalMinutes % interval;\n\n        // Calculate the rounded total minutes\n        const roundedMinutes =\n            remainder === 0\n                ? totalMinutes\n                : toNextInterval\n                ? totalMinutes + (interval - remainder)\n                : totalMinutes - remainder;\n\n        // Convert the rounded total minutes back to hours and minutes\n        const roundedHours = Math.floor(roundedMinutes / 60);\n        const roundedMinutesWithinHour = roundedMinutes % 60;\n\n        // Format the result as HH:mm, allowing for hours >= 24\n        const formattedHours = roundedHours.toString().padStart(2, \"0\");\n        const formattedMinutes = roundedMinutesWithinHour\n            .toString()\n            .padStart(2, \"0\");\n\n        return `${formattedHours}:${formattedMinutes}`;\n    };\n\n    export const generateHourlyIntervals = (\n        startTime: string,\n        endTime: string,\n        generatedFormat = \"ha\"\n    ) => {\n        const format = \"HH:mm\";\n        let start = dayjs(startTime, format);\n        let end = dayjs(endTime, format);\n\n        if (start.isSame(end)) {\n            end = end.add(1, \"day\");\n        }\n\n        const intervals: string[] = [];\n\n        while (start.isBefore(end)) {\n            intervals.push(start.format(generatedFormat));\n            start = start.add(1, \"hour\");\n        }\n\n        return intervals;\n    };\n\n    export const getTimeValues = (\n        format: TimeFormat,\n        value: string | undefined\n    ): TimeValues => {\n        // Default value\n        const timeValues: TimeValues = {\n            hour: \"\",\n            minute: \"\",\n            period: EPeriod.AM,\n        };\n\n        if (!value) return timeValues;\n\n        try {\n            if (format === \"24hr\") {\n                const plain = convertToPlain(value, format);\n                // Add minute\n                timeValues.minute = StringHelper.padValue(plain.minute);\n\n                // Determine period, and convert to 12 hour value\n                const hour = parseInt(plain.hour);\n\n                if (Math.floor(hour / 12) === 0) {\n                    timeValues.period = EPeriod.AM;\n                    timeValues.hour =\n                        hour === 0\n                            ? \"12\"\n                            : StringHelper.padValue(hour.toString());\n                } else {\n                    timeValues.period = EPeriod.PM;\n                    timeValues.hour =\n                        hour === 12\n                            ? hour.toString()\n                            : StringHelper.padValue((hour - 12).toString());\n                }\n            } else {\n                const {\n                    hour,\n                    minute,\n                    period = \"\",\n                } = convertToPlain(value, format);\n\n                timeValues.hour = StringHelper.padValue(hour);\n                timeValues.minute = StringHelper.padValue(minute);\n                timeValues.period =\n                    period.toLowerCase() === \"am\" ? EPeriod.AM : EPeriod.PM;\n            }\n\n            return timeValues;\n        } catch {\n            return timeValues;\n        }\n    };\n\n    export const updateMinutes = (\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string => {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"0\") : \"55\";\n        }\n\n        /**\n         * We would increment or decrement by steps of 5\n         * Hence from 0 to 55, there are 12 steps\n         */\n        const steps = 12;\n\n        /**\n         * Look for last nearest step\n         * E.g. value 4 would be step 0 = 0, value 6 would be step 1 = 5\n         */\n        const lastNearestStep = Math.floor(currentValue / 5);\n\n        /**\n         * Getting the next step value would have to incorporate a cycle of the upper\n         * and lower limits. In this case upper = 12, lower = 0.\n         * If one is to increment from step 12, it would then go back to 0.\n         * If one is to decrement from step 0, it would then go back to 12.\n         * Reference: https://dev.to/turneremma21/circular-access-of-array-in-javascript-j52\n         */\n        const nextStep =\n            direction === \"add\"\n                ? lastNearestStep + 1\n                : currentValue % 5 === 0\n                ? lastNearestStep - 1 // if it is a value on the step, decrement one more\n                : lastNearestStep; // else the last nearest step would suffice\n        const newStep = ((nextStep % steps) + steps) % steps;\n\n        return StringHelper.padValue((newStep * 5).toString());\n    };\n\n    export const updateHours = (\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string => {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"1\") : \"12\";\n        }\n\n        const nextValue =\n            direction === \"add\" ? currentValue + 1 : currentValue - 1;\n\n        return nextValue <= 12 && nextValue > 0\n            ? StringHelper.padValue(nextValue.toString())\n            : nextValue === 13\n            ? StringHelper.padValue(\"1\")\n            : \"12\";\n    };\n\n    export const convertTo24HourFormat = (values: TimeValues): string => {\n        const hour = parseInt(values.hour);\n        let hourString: string;\n\n        if (values.period === EPeriod.PM) {\n            hourString = hour === 12 ? hour.toString() : (hour + 12).toString();\n        } else {\n            hourString = hour === 12 ? \"00\" : values.hour;\n        }\n\n        return `${hourString}:${values.minute}`;\n    };\n\n    export const convertHourTo12HourFormat = (hourValue: string): string => {\n        const hour = parseInt(hourValue);\n        const hourString =\n            hour % 12 === 0 ? (12).toString() : (hour % 12).toString();\n\n        return StringHelper.padValue(hourString);\n    };\n\n    /**\n     * Formats a 24hr time range into a 12hr display string.\n     * @param start - \"HH:mm\" e.g. \"13:00\"\n     * @param end   - \"HH:mm\" e.g. \"14:30\"\n     * @returns e.g. \"1:00PM to 2:30PM\"\n     */\n    export const formatTimeRange = (start: string, end: string) => {\n        return `${dayjs(start, \"HH:mm\").format(\"h:mmA\")} to ${dayjs(\n            end,\n            \"HH:mm\"\n        ).format(\"h:mmA\")}`;\n    };\n\n    export const isSameTime = (a: string, b: string) => {\n        return dayjs(a, \"H:mm\").isSame(dayjs(b, \"H:mm\"), \"minute\");\n    };\n\n    export const formatDisplayValue = (\n        value: string | undefined,\n        format: TimeFormat\n    ): string => {\n        try {\n            const { hour, minute, period = \"\" } = convertToPlain(value, format);\n\n            const paddedHour = StringHelper.padValue(hour);\n            const paddedMinute = StringHelper.padValue(minute);\n\n            let formatted = `${paddedHour}:${paddedMinute}`;\n\n            if (format === \"12hr\") {\n                formatted += period.toLowerCase();\n\n                return formatted;\n            }\n\n            return formatted;\n        } catch {\n            return \"\";\n        }\n    };\n\n    export const toMinutesSeconds = (_seconds: number) => {\n        const minutes = Math.floor(_seconds / 60);\n        const seconds = _seconds % 60;\n\n        return {\n            minutes,\n            seconds,\n        };\n    };\n\n    // Converts h:mma/hh:mma to 24hr (eg. 13:00)\n    export const to24Hour = (time: string) => {\n        if (time?.includes(\"am\") || time?.includes(\"pm\")) {\n            const [t, p] = time.split(/(am|pm)/i);\n            const [hr, m] = t.split(\":\").map(Number);\n            let h = hr;\n            if (p === \"pm\" && h < 12) h += 12;\n            if (p === \"am\" && h === 12) h = 0;\n            return toTimeString(h, m);\n        }\n        return time; // No conversion if string alr has am/pm\n    };\n\n    // Generates an array of timings based on given startTime/interval/format\n    export const generateTimings = (\n        interval: number, // In minutes\n        format: TimeFormat = \"12hr\",\n        startTime?: string | undefined,\n        endTime?: string | undefined // Inclusive\n    ): string[] => {\n        const timings = [];\n        let currentMinutes = 0;\n        let endMinutes = 1440 - interval; // Do not include next day's 12am\n\n        // Convert startTime (h:mma) to minutes\n        if (startTime) {\n            currentMinutes = timeToMinutes(startTime);\n        }\n        if (endTime) {\n            endMinutes = timeToMinutes(endTime);\n        }\n\n        while (currentMinutes <= endMinutes) {\n            let hours = Math.floor(currentMinutes / 60);\n            const minutes = currentMinutes % 60;\n\n            if (format === \"12hr\") {\n                const period = hours >= 12 ? \"pm\" : \"am\";\n\n                hours = hours % 12;\n                hours = hours ? hours : 12; // Convert hour 0 to 12\n\n                const timeString = toTimeString(hours, minutes, period);\n                timings.push(timeString);\n            } else {\n                const timeString = toTimeString(hours, minutes);\n                timings.push(timeString);\n            }\n\n            currentMinutes += interval;\n        }\n\n        return timings;\n    };\n\n    // Return undefined = invalid field, \"\" = empty field, else returns h:mma\n    export const parseInput = (\n        input: string | undefined,\n        format: TimeFormat = \"12hr\" // Returned format\n    ): string | undefined => {\n        if (input === \"\" || input === undefined) return input;\n\n        const sanitizedInput = input.trim().toLowerCase();\n        const timeRegex = /^(?:(\\d{1,2})([:.])?(\\d{2})?)?(a|p|am|pm)?$/;\n        const match = timeRegex.exec(sanitizedInput);\n\n        if (!match) return;\n\n        let hours = parseInt(match[1] || \"0\", 10);\n        const minutes = parseInt(match[3] || \"0\", 10);\n        let period = match[4];\n\n        // Ensure hours/mins are valid\n        if (match[1] === undefined || hours > 24 || minutes > 59) return;\n\n        // Convert single-character periods to full am/pm\n        if (period === \"a\") {\n            period = \"am\";\n        } else if (period === \"p\") {\n            period = \"pm\";\n        }\n\n        if (format === \"24hr\") {\n            // Convert 12-hour input to 24-hour format if period is present\n            if (period === \"pm\" && hours < 12) {\n                hours += 12;\n            } else if ((period === \"am\" && hours === 12) || hours === 24) {\n                hours = 0; // Midnight case\n            }\n\n            // Return time in 24-hour format (HH:mm)\n            return toTimeString(hours, minutes);\n        }\n\n        // Handle 24-hour times or AM/PM conversion\n        if (period) {\n            if (hours === 0 || hours === 24) {\n                period = \"am\";\n                hours = 12;\n            } else if (hours > 12) {\n                period = \"pm\";\n                hours -= 12;\n            }\n        } else {\n            period =\n                // NOTE: 12 or 1-6 will default to pm for convenience\n                hours === 0 || hours === 24 || (hours > 6 && hours < 12)\n                    ? \"am\"\n                    : \"pm\";\n            hours = hours % 12 || 12;\n        }\n\n        // Format the time as h:mma\n        const formattedTime = toTimeString(hours, minutes, period);\n\n        return formattedTime;\n    };\n\n    export const findClosestFlooredTime = (\n        inputTime: string | undefined,\n        timeArray: string[] // Should already be sorted in ascending order\n    ): string | undefined => {\n        if (!inputTime) return inputTime;\n        const flooredInputMinutes = timeToMinutes(inputTime);\n\n        let closestTime = \"\";\n        let minDifference = Infinity;\n\n        for (const time of timeArray) {\n            const timeInMinutes = timeToMinutes(time);\n            const difference = timeInMinutes - flooredInputMinutes;\n\n            // If the difference is negative or zero, update the closest time\n            if (difference <= 0 && Math.abs(difference) < minDifference) {\n                minDifference = Math.abs(difference);\n                closestTime = time;\n            }\n            // If the difference becomes positive, we've passed the closest time\n            else if (difference > 0) {\n                break;\n            }\n        }\n\n        return closestTime;\n    };\n\n    // Accepts both 12hr and 24hr formats\n    export const timeToMinutes = (time: string) => {\n        const [startHourMin, ampm] = time.toLowerCase().split(/(am|pm)/);\n        const [startHoursRaw, startMinutes] = startHourMin\n            .split(\":\")\n            .map(Number);\n        let startHours = startHoursRaw;\n\n        if (ampm === \"pm\" && startHours !== 12) {\n            startHours += 12; // Convert PM hours to 24-hour format\n        }\n        if (ampm === \"am\" && startHours === 12) {\n            startHours = 0; // Convert 12am to 0 hours\n        }\n\n        return startHours * 60 + startMinutes;\n    };\n\n    // Calculate duration between two time strings\n    export const calculateDuration = (\n        startTime: string,\n        endTime: string\n    ): number => {\n        const startMinutes = timeToMinutes(startTime);\n        const endMinutes = timeToMinutes(endTime);\n        return endMinutes - startMinutes;\n    };\n\n    /**\n     * Validates and calculates scroll position for a given time\n     * @param props - The configuration object for calculating scroll position\n     * @returns the calculated scroll position in pixels, or null if invalid\n     */\n    export const calculateScrollPosition = (\n        props: CalculateScrollPositionProps\n    ): number | null => {\n        const {\n            scrollTime,\n            minTime,\n            maxTime,\n            interval,\n            intervalWidth,\n            options,\n        } = props;\n\n        try {\n            // Validate time format (HH:mm)\n            const timeRegex = /^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/;\n            if (!timeRegex.test(scrollTime)) {\n                console.warn(\n                    `Invalid scrollTime format: \"${scrollTime}\". Expected format: HH:mm.`\n                );\n                return null;\n            }\n\n            // Round to nearest interval if specified\n            const timeToUse = options?.roundToInterval\n                ? roundToNearestInterval(scrollTime, interval)\n                : scrollTime;\n\n            const [hours, minutes] = parseTimeToNumbers(timeToUse);\n\n            // Validate parsed values\n            if (isNaN(hours) || isNaN(minutes)) {\n                console.warn(`Invalid scrollTime: \"${scrollTime}\".`);\n                return null;\n            }\n\n            const scrollMinutes = hours * 60 + minutes;\n\n            const [minHours, minMinutes] = parseTimeToNumbers(minTime);\n            const minTotalMinutes = minHours * 60 + minMinutes;\n\n            const [maxHours, maxMinutes] = parseTimeToNumbers(maxTime);\n            const maxTotalMinutes = maxHours * 60 + maxMinutes;\n\n            // Warn if time is outside the visible range\n            if (\n                scrollMinutes < minTotalMinutes ||\n                scrollMinutes > maxTotalMinutes\n            ) {\n                console.warn(\n                    `scrollTime \"${scrollTime}\" is outside the range (${minTime} - ${maxTime}).`\n                );\n            }\n\n            const minutesFromStart = scrollMinutes - minTotalMinutes;\n            const intervalsFromStart = minutesFromStart / interval;\n            const scrollPosition = intervalsFromStart * intervalWidth;\n\n            return scrollPosition;\n        } catch (error) {\n            console.warn(\n                `Error processing scrollTime: \"${scrollTime}\".`,\n                error\n            );\n            return null;\n        }\n    };\n}\n\n// =============================================================================\n// NON-EXPORTABLES\n// =============================================================================\n\n/**\n * Parses a time string in HH:mm format to separate hour and minute values\n * @param timeString - Time string in HH:mm format (e.g., \"09:30\", \"14:45\")\n * @returns Array containing [hours, minutes] as numbers\n * @example\n * parseTimeToNumbers(\"09:30\") // returns [9, 30]\n * parseTimeToNumbers(\"14:45\") // returns [14, 45]\n */\nconst parseTimeToNumbers = (timeString: string): number[] => {\n    return timeString.split(\":\").map(Number);\n};\nconst isValidHour = (hourString: string, format: TimeFormat): boolean => {\n    const numValue = parseInt(hourString);\n    return format === \"24hr\"\n        ? numValue >= 0 && numValue <= 23\n        : numValue >= 1 && numValue <= 12;\n};\n\nconst isValidMinutes = (hourString: string): boolean => {\n    const numValue = parseInt(hourString);\n    return numValue >= 0 && numValue <= 59;\n};\n\nconst isValidTimePeriod = (timePeriodString: string): boolean => {\n    return (\n        timePeriodString.toLowerCase() === \"am\" ||\n        timePeriodString.toLowerCase() === \"pm\"\n    );\n};\n\nconst convertToPlain = (\n    value: string | undefined,\n    format: TimeFormat\n): TimeValuesPlain => {\n    const timeArr = value ? value.split(\":\") : [];\n    const error = new Error(\"Invalid format\");\n\n    if (format === \"12hr\") {\n        // Check format\n        if (timeArr.length !== 2 || timeArr[1].length !== 4) throw error;\n\n        const minute = timeArr[1].substring(0, 2);\n        const period = timeArr[1].substring(2);\n\n        // Validate hour, minute and time period values\n        if (\n            !isValidHour(timeArr[0], format) ||\n            !isValidMinutes(minute) ||\n            !isValidTimePeriod(period)\n        ) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute,\n            period: timeArr[1].substring(2),\n        };\n    } else {\n        // Check format\n        if (timeArr.length !== 2) throw error;\n        // Validate hour and minute values\n        if (!isValidHour(timeArr[0], format) || !isValidMinutes(timeArr[1])) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute: timeArr[1],\n        };\n    }\n};\n\nconst toTimeString = (hours: number, minutes: number, period?: string) => {\n    return period\n        ? `${hours}:${minutes.toString().padStart(2, \"0\")}${period}`\n        : `${hours.toString().padStart(2, \"0\")}:${minutes\n              .toString()\n              .padStart(2, \"0\")}`;\n};\n"],"names":["EPeriod","TimeHelper","roundToNearestInterval","time","interval","toNextInterval","hoursStr","minutesStr","split","hours","parseInt","minutes","isNaN","Error","totalMinutes","remainder","roundedMinutes","roundedMinutesWithinHour","Math","floor","toString","padStart","generateHourlyIntervals","startTime","endTime","generatedFormat","format","start","dayjs","end","isSame","add","intervals","isBefore","push","getTimeValues","value","timeValues","hour","minute","period","AM","plain","convertToPlain","StringHelper","padValue","PM","toLowerCase","_a","updateMinutes","valueString","direction","currentValue","lastNearestStep","newStep","updateHours","nextValue","convertTo24HourFormat","values","hourString","convertHourTo12HourFormat","hourValue","formatTimeRange","isSameTime","a","b","formatDisplayValue","paddedHour","formatted","toMinutesSeconds","_seconds","seconds","to24Hour","includes","t","p","hr","m","map","Number","h","toTimeString","generateTimings","timings","currentMinutes","endMinutes","timeToMinutes","timeString","parseInput","input","undefined","sanitizedInput","trim","match","exec","findClosestFlooredTime","inputTime","timeArray","flooredInputMinutes","closestTime","minDifference","Infinity","difference","abs","startHourMin","ampm","startHoursRaw","startMinutes","startHours","calculateDuration","calculateScrollPosition","props","scrollTime","minTime","maxTime","intervalWidth","options","test","console","warn","timeToUse","roundToInterval","parseTimeToNumbers","scrollMinutes","minHours","minMinutes","minTotalMinutes","maxHours","maxMinutes","error","isValidHour","numValue","isValidMinutes","timeArr","length","substring","timePeriodString"],"mappings":"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"}
+{"version":3,"file":"time-helper.js","sources":["../../../src/util/time-helper.ts"],"sourcesContent":["import dayjs from \"dayjs\";\n\nimport { StringHelper } from \"./string-helper\";\n\n// =============================================================================\n// INTERFACES\n// =============================================================================\nexport type TimeFormat = \"12hr\" | \"24hr\";\n\nexport enum EPeriod {\n    AM = \"AM\",\n    PM = \"PM\",\n}\n\nexport interface TimeValues {\n    hour: string;\n    minute: string;\n    period: EPeriod;\n}\n\nexport interface CalculateScrollPositionProps {\n    /** The time to scroll to in HH:mm format */\n    scrollTime: string;\n    /** The minimum time of the scrollable range in HH:mm format */\n    minTime: string;\n    /** The maximum time of the scrollable range in HH:mm format */\n    maxTime: string;\n    /** The interval in minutes (e.g., 15, 30, 60) */\n    interval: number;\n    /** The width in pixels of each interval */\n    intervalWidth: number;\n    /** Optional configuration */\n    options?: {\n        /** Round the scroll time to the nearest interval */\n        roundToInterval?: boolean;\n    };\n}\n\n// unexportable\ninterface TimeValuesPlain {\n    hour: string;\n    minute: string;\n    period?: string;\n}\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\nexport class TimeHelper {\n    /**\n     * Rounds time to the nearest interval, e.g 6:30 will be clamped to 6:00 when interval = 60\n     * @param time the input time in HH:mm format\n     * @param interval the interval in minutes (e.g., 15 for 15 minutes, 60 for 1 hour)\n     * @param toNextInterval to clamp to next interval instead, e.g. 6:30 will be clamped to 7:00 when interval = 60.\n     * If the time is already a valid interval, it will not be rounded\n     * @returns the rounded time in HH:mm format,\n     */\n    public static roundToNearestInterval(\n        time: string,\n        interval: number,\n        toNextInterval?: boolean\n    ): string {\n        const [hoursStr, minutesStr] = time.split(\":\");\n        const hours = parseInt(hoursStr, 10);\n        const minutes = parseInt(minutesStr, 10);\n\n        // Handle invalid inputs\n        if (isNaN(hours) || isNaN(minutes) || minutes < 0 || minutes >= 60) {\n            throw new Error(\"Invalid time format\");\n        }\n\n        // Convert the time to total minutes\n        const totalMinutes = hours * 60 + minutes;\n        const remainder = totalMinutes % interval;\n\n        // Calculate the rounded total minutes\n        const roundedMinutes =\n            remainder === 0\n                ? totalMinutes\n                : toNextInterval\n                ? totalMinutes + (interval - remainder)\n                : totalMinutes - remainder;\n\n        // Convert the rounded total minutes back to hours and minutes\n        const roundedHours = Math.floor(roundedMinutes / 60);\n        const roundedMinutesWithinHour = roundedMinutes % 60;\n\n        // Format the result as HH:mm, allowing for hours >= 24\n        const formattedHours = roundedHours.toString().padStart(2, \"0\");\n        const formattedMinutes = roundedMinutesWithinHour\n            .toString()\n            .padStart(2, \"0\");\n\n        return `${formattedHours}:${formattedMinutes}`;\n    }\n\n    public static generateHourlyIntervals(\n        startTime: string,\n        endTime: string,\n        generatedFormat = \"ha\"\n    ): string[] {\n        const format = \"HH:mm\";\n        let start = dayjs(startTime, format);\n        let end = dayjs(endTime, format);\n\n        if (start.isSame(end)) {\n            end = end.add(1, \"day\");\n        }\n\n        const intervals: string[] = [];\n\n        while (start.isBefore(end)) {\n            intervals.push(start.format(generatedFormat));\n            start = start.add(1, \"hour\");\n        }\n\n        return intervals;\n    }\n\n    public static getTimeValues(\n        format: TimeFormat,\n        value: string | undefined\n    ): TimeValues {\n        // Default value\n        const timeValues: TimeValues = {\n            hour: \"\",\n            minute: \"\",\n            period: EPeriod.AM,\n        };\n\n        if (!value) return timeValues;\n\n        try {\n            if (format === \"24hr\") {\n                const plain = convertToPlain(value, format);\n                // Add minute\n                timeValues.minute = StringHelper.padValue(plain.minute);\n\n                // Determine period, and convert to 12 hour value\n                const hour = parseInt(plain.hour);\n\n                if (Math.floor(hour / 12) === 0) {\n                    timeValues.period = EPeriod.AM;\n                    timeValues.hour =\n                        hour === 0\n                            ? \"12\"\n                            : StringHelper.padValue(hour.toString());\n                } else {\n                    timeValues.period = EPeriod.PM;\n                    timeValues.hour =\n                        hour === 12\n                            ? hour.toString()\n                            : StringHelper.padValue((hour - 12).toString());\n                }\n            } else {\n                const {\n                    hour,\n                    minute,\n                    period = \"\",\n                } = convertToPlain(value, format);\n\n                timeValues.hour = StringHelper.padValue(hour);\n                timeValues.minute = StringHelper.padValue(minute);\n                timeValues.period =\n                    period.toLowerCase() === \"am\" ? EPeriod.AM : EPeriod.PM;\n            }\n\n            return timeValues;\n        } catch {\n            return timeValues;\n        }\n    }\n\n    public static updateMinutes(\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"0\") : \"55\";\n        }\n\n        /**\n         * We would increment or decrement by steps of 5\n         * Hence from 0 to 55, there are 12 steps\n         */\n        const steps = 12;\n\n        /**\n         * Look for last nearest step\n         * E.g. value 4 would be step 0 = 0, value 6 would be step 1 = 5\n         */\n        const lastNearestStep = Math.floor(currentValue / 5);\n\n        /**\n         * Getting the next step value would have to incorporate a cycle of the upper\n         * and lower limits. In this case upper = 12, lower = 0.\n         * If one is to increment from step 12, it would then go back to 0.\n         * If one is to decrement from step 0, it would then go back to 12.\n         * Reference: https://dev.to/turneremma21/circular-access-of-array-in-javascript-j52\n         */\n        const nextStep =\n            direction === \"add\"\n                ? lastNearestStep + 1\n                : currentValue % 5 === 0\n                ? lastNearestStep - 1 // if it is a value on the step, decrement one more\n                : lastNearestStep; // else the last nearest step would suffice\n        const newStep = ((nextStep % steps) + steps) % steps;\n\n        return StringHelper.padValue((newStep * 5).toString());\n    }\n\n    public static updateHours(\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"1\") : \"12\";\n        }\n\n        const nextValue =\n            direction === \"add\" ? currentValue + 1 : currentValue - 1;\n\n        return nextValue <= 12 && nextValue > 0\n            ? StringHelper.padValue(nextValue.toString())\n            : nextValue === 13\n            ? StringHelper.padValue(\"1\")\n            : \"12\";\n    }\n\n    public static convertTo24HourFormat(values: TimeValues): string {\n        const hour = parseInt(values.hour);\n        let hourString: string;\n\n        if (values.period === EPeriod.PM) {\n            hourString = hour === 12 ? hour.toString() : (hour + 12).toString();\n        } else {\n            hourString = hour === 12 ? \"00\" : values.hour;\n        }\n\n        return `${hourString}:${values.minute}`;\n    }\n\n    public static convertHourTo12HourFormat(hourValue: string): string {\n        const hour = parseInt(hourValue);\n        const hourString =\n            hour % 12 === 0 ? (12).toString() : (hour % 12).toString();\n\n        return StringHelper.padValue(hourString);\n    }\n\n    /**\n     * Formats a 24hr time range into a 12hr display string.\n     * @param start - \"HH:mm\" e.g. \"13:00\"\n     * @param end   - \"HH:mm\" e.g. \"14:30\"\n     * @returns e.g. \"1:00PM to 2:30PM\"\n     */\n    public static formatTimeRange(start: string, end: string): string {\n        return `${dayjs(start, \"HH:mm\").format(\"h:mmA\")} to ${dayjs(\n            end,\n            \"HH:mm\"\n        ).format(\"h:mmA\")}`;\n    }\n\n    public static isSameTime(a: string, b: string): boolean {\n        return dayjs(a, \"H:mm\").isSame(dayjs(b, \"H:mm\"), \"minute\");\n    }\n\n    public static formatDisplayValue(\n        value: string | undefined,\n        format: TimeFormat\n    ): string {\n        try {\n            const { hour, minute, period = \"\" } = convertToPlain(value, format);\n\n            const paddedHour = StringHelper.padValue(hour);\n            const paddedMinute = StringHelper.padValue(minute);\n\n            let formatted = `${paddedHour}:${paddedMinute}`;\n\n            if (format === \"12hr\") {\n                formatted += period.toLowerCase();\n\n                return formatted;\n            }\n\n            return formatted;\n        } catch {\n            return \"\";\n        }\n    }\n\n    public static toMinutesSeconds(_seconds: number) {\n        const minutes = Math.floor(_seconds / 60);\n        const seconds = _seconds % 60;\n\n        return {\n            minutes,\n            seconds,\n        };\n    }\n\n    // Converts h:mma/hh:mma to 24hr (eg. 13:00)\n    public static to24Hour(time: string) {\n        if (time?.includes(\"am\") || time?.includes(\"pm\")) {\n            const [t, p] = time.split(/(am|pm)/i);\n            const [hr, m] = t.split(\":\").map(Number);\n            let h = hr;\n            if (p === \"pm\" && h < 12) h += 12;\n            if (p === \"am\" && h === 12) h = 0;\n            return toTimeString(h, m);\n        }\n        return time; // No conversion if string alr has am/pm\n    }\n\n    // Generates an array of timings based on given startTime/interval/format\n    public static generateTimings(\n        interval: number, // In minutes\n        format: TimeFormat = \"12hr\",\n        startTime?: string | undefined,\n        endTime?: string | undefined // Inclusive\n    ): string[] {\n        const timings = [];\n        let currentMinutes = 0;\n        let endMinutes = 1440 - interval; // Do not include next day's 12am\n\n        // Convert startTime (h:mma) to minutes\n        if (startTime) {\n            currentMinutes = TimeHelper.timeToMinutes(startTime);\n        }\n        if (endTime) {\n            endMinutes = TimeHelper.timeToMinutes(endTime);\n        }\n\n        while (currentMinutes <= endMinutes) {\n            let hours = Math.floor(currentMinutes / 60);\n            const minutes = currentMinutes % 60;\n\n            if (format === \"12hr\") {\n                const period = hours >= 12 ? \"pm\" : \"am\";\n\n                hours = hours % 12;\n                hours = hours ? hours : 12; // Convert hour 0 to 12\n\n                const timeString = toTimeString(hours, minutes, period);\n                timings.push(timeString);\n            } else {\n                const timeString = toTimeString(hours, minutes);\n                timings.push(timeString);\n            }\n\n            currentMinutes += interval;\n        }\n\n        return timings;\n    }\n\n    // Return undefined = invalid field, \"\" = empty field, else returns h:mma\n    public static parseInput(\n        input: string | undefined,\n        format: TimeFormat = \"12hr\" // Returned format\n    ): string | undefined {\n        if (input === \"\" || input === undefined) return input;\n\n        const sanitizedInput = input.trim().toLowerCase();\n        const timeRegex = /^(?:(\\d{1,2})([:.])?(\\d{2})?)?(a|p|am|pm)?$/;\n        const match = timeRegex.exec(sanitizedInput);\n\n        if (!match) return;\n\n        let hours = parseInt(match[1] || \"0\", 10);\n        const minutes = parseInt(match[3] || \"0\", 10);\n        let period = match[4];\n\n        // Ensure hours/mins are valid\n        if (match[1] === undefined || hours > 24 || minutes > 59) return;\n\n        // Convert single-character periods to full am/pm\n        if (period === \"a\") {\n            period = \"am\";\n        } else if (period === \"p\") {\n            period = \"pm\";\n        }\n\n        if (format === \"24hr\") {\n            // Convert 12-hour input to 24-hour format if period is present\n            if (period === \"pm\" && hours < 12) {\n                hours += 12;\n            } else if ((period === \"am\" && hours === 12) || hours === 24) {\n                hours = 0; // Midnight case\n            }\n\n            // Return time in 24-hour format (HH:mm)\n            return toTimeString(hours, minutes);\n        }\n\n        // Handle 24-hour times or AM/PM conversion\n        if (period) {\n            if (hours === 0 || hours === 24) {\n                period = \"am\";\n                hours = 12;\n            } else if (hours > 12) {\n                period = \"pm\";\n                hours -= 12;\n            }\n        } else {\n            period =\n                // NOTE: 12 or 1-6 will default to pm for convenience\n                hours === 0 || hours === 24 || (hours > 6 && hours < 12)\n                    ? \"am\"\n                    : \"pm\";\n            hours = hours % 12 || 12;\n        }\n\n        // Format the time as h:mma\n        const formattedTime = toTimeString(hours, minutes, period);\n\n        return formattedTime;\n    }\n\n    public static findClosestFlooredTime(\n        inputTime: string | undefined,\n        timeArray: string[] // Should already be sorted in ascending order\n    ): string | undefined {\n        if (!inputTime) return inputTime;\n        const flooredInputMinutes = TimeHelper.timeToMinutes(inputTime);\n\n        let closestTime = \"\";\n        let minDifference = Infinity;\n\n        for (const time of timeArray) {\n            const timeInMinutes = TimeHelper.timeToMinutes(time);\n            const difference = timeInMinutes - flooredInputMinutes;\n\n            // If the difference is negative or zero, update the closest time\n            if (difference <= 0 && Math.abs(difference) < minDifference) {\n                minDifference = Math.abs(difference);\n                closestTime = time;\n            }\n            // If the difference becomes positive, we've passed the closest time\n            else if (difference > 0) {\n                break;\n            }\n        }\n\n        return closestTime;\n    }\n\n    // Accepts both 12hr and 24hr formats\n    public static timeToMinutes(time: string): number {\n        const [startHourMin, ampm] = time.toLowerCase().split(/(am|pm)/);\n        const [startHoursRaw, startMinutes] = startHourMin\n            .split(\":\")\n            .map(Number);\n        let startHours = startHoursRaw;\n\n        if (ampm === \"pm\" && startHours !== 12) {\n            startHours += 12; // Convert PM hours to 24-hour format\n        }\n        if (ampm === \"am\" && startHours === 12) {\n            startHours = 0; // Convert 12am to 0 hours\n        }\n\n        return startHours * 60 + startMinutes;\n    }\n\n    // Calculate duration between two time strings\n    public static calculateDuration(\n        startTime: string,\n        endTime: string\n    ): number {\n        const startMinutes = TimeHelper.timeToMinutes(startTime);\n        const endMinutes = TimeHelper.timeToMinutes(endTime);\n        return endMinutes - startMinutes;\n    }\n\n    /**\n     * Validates and calculates scroll position for a given time\n     * @param props - The configuration object for calculating scroll position\n     * @returns the calculated scroll position in pixels, or null if invalid\n     */\n    public static calculateScrollPosition(\n        props: CalculateScrollPositionProps\n    ): number | null {\n        const {\n            scrollTime,\n            minTime,\n            maxTime,\n            interval,\n            intervalWidth,\n            options,\n        } = props;\n\n        try {\n            // Validate time format (HH:mm)\n            const timeRegex = /^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/;\n            if (!timeRegex.test(scrollTime)) {\n                console.warn(\n                    `Invalid scrollTime format: \"${scrollTime}\". Expected format: HH:mm.`\n                );\n                return null;\n            }\n\n            // Round to nearest interval if specified\n            const timeToUse = options?.roundToInterval\n                ? TimeHelper.roundToNearestInterval(scrollTime, interval)\n                : scrollTime;\n\n            const [hours, minutes] = parseTimeToNumbers(timeToUse);\n\n            // Validate parsed values\n            if (isNaN(hours) || isNaN(minutes)) {\n                console.warn(`Invalid scrollTime: \"${scrollTime}\".`);\n                return null;\n            }\n\n            const scrollMinutes = hours * 60 + minutes;\n\n            const [minHours, minMinutes] = parseTimeToNumbers(minTime);\n            const minTotalMinutes = minHours * 60 + minMinutes;\n\n            const [maxHours, maxMinutes] = parseTimeToNumbers(maxTime);\n            const maxTotalMinutes = maxHours * 60 + maxMinutes;\n\n            // Warn if time is outside the visible range\n            if (\n                scrollMinutes < minTotalMinutes ||\n                scrollMinutes > maxTotalMinutes\n            ) {\n                console.warn(\n                    `scrollTime \"${scrollTime}\" is outside the range (${minTime} - ${maxTime}).`\n                );\n            }\n\n            const minutesFromStart = scrollMinutes - minTotalMinutes;\n            const intervalsFromStart = minutesFromStart / interval;\n            const scrollPosition = intervalsFromStart * intervalWidth;\n\n            return scrollPosition;\n        } catch (error) {\n            console.warn(\n                `Error processing scrollTime: \"${scrollTime}\".`,\n                error\n            );\n            return null;\n        }\n    }\n}\n\n// =============================================================================\n// NON-EXPORTABLES\n// =============================================================================\n\n/**\n * Parses a time string in HH:mm format to separate hour and minute values\n * @param timeString - Time string in HH:mm format (e.g., \"09:30\", \"14:45\")\n * @returns Array containing [hours, minutes] as numbers\n * @example\n * parseTimeToNumbers(\"09:30\") // returns [9, 30]\n * parseTimeToNumbers(\"14:45\") // returns [14, 45]\n */\nconst parseTimeToNumbers = (timeString: string): number[] => {\n    return timeString.split(\":\").map(Number);\n};\nconst isValidHour = (hourString: string, format: TimeFormat): boolean => {\n    const numValue = parseInt(hourString);\n    return format === \"24hr\"\n        ? numValue >= 0 && numValue <= 23\n        : numValue >= 1 && numValue <= 12;\n};\n\nconst isValidMinutes = (hourString: string): boolean => {\n    const numValue = parseInt(hourString);\n    return numValue >= 0 && numValue <= 59;\n};\n\nconst isValidTimePeriod = (timePeriodString: string): boolean => {\n    return (\n        timePeriodString.toLowerCase() === \"am\" ||\n        timePeriodString.toLowerCase() === \"pm\"\n    );\n};\n\nconst convertToPlain = (\n    value: string | undefined,\n    format: TimeFormat\n): TimeValuesPlain => {\n    const timeArr = value ? value.split(\":\") : [];\n    const error = new Error(\"Invalid format\");\n\n    if (format === \"12hr\") {\n        // Check format\n        if (timeArr.length !== 2 || timeArr[1].length !== 4) throw error;\n\n        const minute = timeArr[1].substring(0, 2);\n        const period = timeArr[1].substring(2);\n\n        // Validate hour, minute and time period values\n        if (\n            !isValidHour(timeArr[0], format) ||\n            !isValidMinutes(minute) ||\n            !isValidTimePeriod(period)\n        ) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute,\n            period: timeArr[1].substring(2),\n        };\n    } else {\n        // Check format\n        if (timeArr.length !== 2) throw error;\n        // Validate hour and minute values\n        if (!isValidHour(timeArr[0], format) || !isValidMinutes(timeArr[1])) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute: timeArr[1],\n        };\n    }\n};\n\nconst toTimeString = (hours: number, minutes: number, period?: string) => {\n    return period\n        ? `${hours}:${minutes.toString().padStart(2, \"0\")}${period}`\n        : `${hours.toString().padStart(2, \"0\")}:${minutes\n              .toString()\n              .padStart(2, \"0\")}`;\n};\n"],"names":["EPeriod","TimeHelper","roundToNearestInterval","time","interval","toNextInterval","hoursStr","minutesStr","split","hours","parseInt","minutes","isNaN","Error","totalMinutes","remainder","roundedMinutes","roundedMinutesWithinHour","Math","floor","toString","padStart","generateHourlyIntervals","startTime","endTime","generatedFormat","format","start","dayjs","end","isSame","add","intervals","isBefore","push","getTimeValues","value","timeValues","hour","minute","period","AM","plain","convertToPlain","StringHelper","padValue","PM","toLowerCase","_a","updateMinutes","valueString","direction","currentValue","lastNearestStep","newStep","updateHours","nextValue","convertTo24HourFormat","values","hourString","convertHourTo12HourFormat","hourValue","formatTimeRange","isSameTime","a","b","formatDisplayValue","paddedHour","formatted","toMinutesSeconds","_seconds","seconds","to24Hour","includes","t","p","hr","m","map","Number","h","toTimeString","generateTimings","timings","currentMinutes","endMinutes","timeToMinutes","timeString","parseInput","input","undefined","sanitizedInput","trim","match","exec","findClosestFlooredTime","inputTime","timeArray","flooredInputMinutes","closestTime","minDifference","Infinity","difference","abs","startHourMin","ampm","startHoursRaw","startMinutes","startHours","calculateDuration","calculateScrollPosition","props","scrollTime","minTime","maxTime","intervalWidth","options","test","console","warn","timeToUse","roundToInterval","parseTimeToNumbers","scrollMinutes","minHours","minMinutes","minTotalMinutes","maxHours","maxMinutes","error","isValidHour","numValue","isValidMinutes","timeArr","length","substring","timePeriodString"],"mappings":"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"}

package/cjs/util/use-container-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-container-query.js","sources":["../../../src/util/use-container-query.tsx"],"sourcesContent":["import { RefObject, useCallback, useState } from \"react\";\nimport { useResizeDetector } from \"react-resize-detector\";\n\ninterface Options<T> {\n    maxWidth: number;\n    targetRef?: RefObject<T>;\n}\n\n/**\n * Detect if container width satisfies the breakpoint\n */\nexport const useContainerQuery = <T extends HTMLElement>({\n    maxWidth,\n    targetRef,\n}: Options<T>): boolean => {\n    const [belowBreakpoint, setBelowBreakpoint] = useState(false);\n\n    const handleResize = useCallback(\n        (width) => {\n            setBelowBreakpoint(width <= maxWidth);\n        },\n        [maxWidth]\n    );\n\n    useResizeDetector<T>({\n        targetRef,\n        refreshMode: \"throttle\",\n        refreshRate: 300,\n        handleHeight: false,\n        onResize: handleResize,\n    });\n\n    return belowBreakpoint;\n};\n"],"names":["maxWidth","targetRef","belowBreakpoint","setBelowBreakpoint","useState","handleResize","useCallback","width","useResizeDetector","refreshMode","refreshRate","handleHeight","onResize"],"mappings":"gIAWiC,EAC7BA,WACAC,gBAEA,MAAOC,EAAiBC,GAAsBC,EAAAA,UAAS,GAEjDC,EAAeC,eAChBC,IACGJ,EAAmBI,GAASP,EAAS,GAEzC,CAACA,IAWL,OARAQ,oBAAqB,CACjBP,YACAQ,YAAa,WACbC,YAAa,IACbC,cAAc,EACdC,SAAUP,IAGPH,CAAe"}
+{"version":3,"file":"use-container-query.js","sources":["../../../src/util/use-container-query.tsx"],"sourcesContent":["import type { RefObject } from \"react\";\nimport { useCallback, useState } from \"react\";\nimport { useResizeDetector } from \"react-resize-detector\";\n\ninterface Options<T> {\n    maxWidth: number;\n    targetRef?: RefObject<T>;\n}\n\n/**\n * Detect if container width satisfies the breakpoint\n */\nexport const useContainerQuery = <T extends HTMLElement>({\n    maxWidth,\n    targetRef,\n}: Options<T>): boolean => {\n    const [belowBreakpoint, setBelowBreakpoint] = useState(false);\n\n    const handleResize = useCallback(\n        (width) => {\n            setBelowBreakpoint(width <= maxWidth);\n        },\n        [maxWidth]\n    );\n\n    useResizeDetector<T>({\n        targetRef,\n        refreshMode: \"throttle\",\n        refreshRate: 300,\n        handleHeight: false,\n        onResize: handleResize,\n    });\n\n    return belowBreakpoint;\n};\n"],"names":["maxWidth","targetRef","belowBreakpoint","setBelowBreakpoint","useState","handleResize","useCallback","width","useResizeDetector","refreshMode","refreshRate","handleHeight","onResize"],"mappings":"gIAYiC,EAC7BA,WACAC,gBAEA,MAAOC,EAAiBC,GAAsBC,EAAAA,UAAS,GAEjDC,EAAeC,eAChBC,IACGJ,EAAmBI,GAASP,EAAS,GAEzC,CAACA,IAWL,OARAQ,oBAAqB,CACjBP,YACAQ,YAAa,WACbC,YAAa,IACbC,cAAc,EACdC,SAAUP,IAGPH,CAAe"}

package/cjs/util/use-countdown.js

@@ -1,2 +1,2 @@
-"use strict";var e=require("react"),t=require("@react-aria/live-announcer");exports.useCountdown=({duration:r,onComplete:n,reminderInterval:u,getStartMessage:a,getIntervalMessage:l,getCompletionMessage:s})=>{const[o,c]=e.useState(r),[i,f]=e.useState(!1),m=e.useRef(null),g=e.useRef(null),p=()=>{m.current&&(clearInterval(m.current),m.current=null)},v=e=>{t.clearAnnouncer("polite"),t.announce(e,"polite")},M=()=>{f(!1),p()};return e.useEffect((()=>{i||c(r)}),[r,i]),e.useEffect((()=>()=>{p()}),[]),{timeLeft:o,isRunning:i,start:()=>{i||(p(),c(r),f(!0),g.current=Date.now(),a&&v(a(r)),m.current=setInterval((()=>{if(null==g.current)return;const e=Math.floor((Date.now()-g.current)/1e3),t=Math.max(0,r-e);c(t),"number"==typeof u&&u>0&&t>0&&t<r&&t%u==0&&l&&v(l(t)),t<=0&&(f(!1),p(),s&&v(s()),null==n||n())}),1e3))},stop:M,reset:()=>{M(),c(r),g.current=null},formatTime:e=>{const t=null!=e?e:o;return`${t} second${1===t?"":"s"}`}}};
+"use strict";var e=require("@react-aria/live-announcer"),t=require("react");exports.useCountdown=({duration:r,onComplete:n,reminderInterval:u,getStartMessage:a,getIntervalMessage:l,getCompletionMessage:s})=>{const[o,c]=t.useState(r),[i,f]=t.useState(!1),m=t.useRef(null),g=t.useRef(null),p=()=>{m.current&&(clearInterval(m.current),m.current=null)},v=t=>{e.clearAnnouncer("polite"),e.announce(t,"polite")},M=()=>{f(!1),p()};return t.useEffect((()=>{i||c(r)}),[r,i]),t.useEffect((()=>()=>{p()}),[]),{timeLeft:o,isRunning:i,start:()=>{i||(p(),c(r),f(!0),g.current=Date.now(),a&&v(a(r)),m.current=setInterval((()=>{if(null==g.current)return;const e=Math.floor((Date.now()-g.current)/1e3),t=Math.max(0,r-e);c(t),"number"==typeof u&&u>0&&t>0&&t<r&&t%u==0&&l&&v(l(t)),t<=0&&(f(!1),p(),s&&v(s()),null==n||n())}),1e3))},stop:M,reset:()=>{M(),c(r),g.current=null},formatTime:e=>{const t=null!=e?e:o;return`${t} second${1===t?"":"s"}`}}};
 //# sourceMappingURL=use-countdown.js.map

package/cjs/util/use-countdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-countdown.js","sources":["../../../src/util/use-countdown.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { announce, clearAnnouncer } from \"@react-aria/live-announcer\";\n\nexport interface UseCountdownOptions {\n    /** Duration in seconds */\n    duration: number;\n    /** Called when countdown ends */\n    onComplete?: () => void;\n    /** Time in seconds between reminder announcements */\n    reminderInterval?: number;\n    /** Build the message announced when countdown timer starts */\n    getStartMessage?: (duration: number) => string;\n    /** Build the message announced when countdown reaches each interval based on `reminderInterval` */\n    getIntervalMessage?: (remaining: number) => string;\n    /** Build the message announced when countdown timer completes */\n    getCompletionMessage?: () => string;\n}\n\nexport interface UseCountdownReturn {\n    /** Current countdown time in seconds */\n    timeLeft: number;\n    /** Whether countdown is currently running */\n    isRunning: boolean;\n    /** Start the countdown */\n    start: () => void;\n    /** Stop the countdown */\n    stop: () => void;\n    /** Reset countdown to initial duration */\n    reset: () => void;\n    /** Format time as \"X second(s)\" */\n    formatTime: (time?: number) => string;\n}\n\n/**\n * Countdown hook\n */\nexport const useCountdown = ({\n    duration,\n    onComplete,\n    reminderInterval,\n    getStartMessage,\n    getIntervalMessage,\n    getCompletionMessage,\n}: UseCountdownOptions): UseCountdownReturn => {\n    const [timeLeft, setTimeLeft] = useState(duration);\n    const [isRunning, setIsRunning] = useState(false);\n\n    const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);\n    const startTimeRef = useRef<number | null>(null);\n\n    const clearTimer = () => {\n        if (intervalRef.current) {\n            clearInterval(intervalRef.current);\n            intervalRef.current = null;\n        }\n    };\n\n    const formatTime = (time?: number) => {\n        const t = time ?? timeLeft;\n        return `${t} second${t === 1 ? \"\" : \"s\"}`;\n    };\n\n    const handleAnnounce = (message: string) => {\n        clearAnnouncer(\"polite\");\n        announce(message, \"polite\");\n    };\n\n    const start = () => {\n        if (isRunning) return;\n\n        clearTimer();\n\n        setTimeLeft(duration);\n        setIsRunning(true);\n        startTimeRef.current = Date.now();\n\n        // First resend reminder message\n        if (getStartMessage) {\n            handleAnnounce(getStartMessage(duration));\n        }\n\n        intervalRef.current = setInterval(() => {\n            if (startTimeRef.current == null) return;\n\n            const elapsed = Math.floor(\n                (Date.now() - startTimeRef.current!) / 1000\n            );\n            const remaining = Math.max(0, duration - elapsed);\n\n            setTimeLeft(remaining);\n\n            if (\n                typeof reminderInterval === \"number\" &&\n                reminderInterval > 0 &&\n                remaining > 0 &&\n                remaining < duration &&\n                remaining % reminderInterval === 0\n            ) {\n                // second resend reminder message in intervals\n                if (getIntervalMessage) {\n                    handleAnnounce(getIntervalMessage(remaining));\n                }\n            }\n\n            if (remaining <= 0) {\n                setIsRunning(false);\n                clearTimer();\n\n                // final reminder message\n                if (getCompletionMessage) {\n                    handleAnnounce(getCompletionMessage());\n                }\n\n                onComplete?.();\n            }\n        }, 1000);\n    };\n\n    const stop = () => {\n        setIsRunning(false);\n        clearTimer();\n    };\n\n    const reset = () => {\n        stop();\n        setTimeLeft(duration);\n        startTimeRef.current = null;\n    };\n\n    // Update timeLeft when duration changes\n    useEffect(() => {\n        if (!isRunning) {\n            setTimeLeft(duration);\n        }\n    }, [duration, isRunning]);\n\n    useEffect(() => {\n        return () => {\n            clearTimer();\n        };\n    }, []);\n\n    return {\n        timeLeft,\n        isRunning,\n        start,\n        stop,\n        reset,\n        formatTime,\n    };\n};\n"],"names":["duration","onComplete","reminderInterval","getStartMessage","getIntervalMessage","getCompletionMessage","timeLeft","setTimeLeft","useState","isRunning","setIsRunning","intervalRef","useRef","startTimeRef","clearTimer","current","clearInterval","handleAnnounce","message","clearAnnouncer","announce","stop","useEffect","start","Date","now","setInterval","elapsed","Math","floor","remaining","max","reset","formatTime","time","t"],"mappings":"iGAoC4B,EACxBA,WACAC,aACAC,mBACAC,kBACAC,qBACAC,2BAEA,MAAOC,EAAUC,GAAeC,EAAAA,SAASR,IAClCS,EAAWC,GAAgBF,EAAAA,UAAS,GAErCG,EAAcC,EAAAA,OAA8C,MAC5DC,EAAeD,EAAAA,OAAsB,MAErCE,EAAa,KACXH,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,KAC1B,EAQEE,EAAkBC,IACpBC,EAAAA,eAAe,UACfC,EAAAA,SAASF,EAAS,SAAS,EAsDzBG,EAAO,KACTX,GAAa,GACbI,GAAY,EAsBhB,OAZAQ,EAAAA,WAAU,KACDb,GACDF,EAAYP,EAChB,GACD,CAACA,EAAUS,IAEda,EAAAA,WAAU,IACC,KACHR,GAAY,GAEjB,IAEI,CACHR,WACAG,YACAc,MA9EU,KACNd,IAEJK,IAEAP,EAAYP,GACZU,GAAa,GACbG,EAAaE,QAAUS,KAAKC,MAGxBtB,GACAc,EAAed,EAAgBH,IAGnCW,EAAYI,QAAUW,aAAY,KAC9B,GAA4B,MAAxBb,EAAaE,QAAiB,OAElC,MAAMY,EAAUC,KAAKC,OAChBL,KAAKC,MAAQZ,EAAaE,SAAY,KAErCe,EAAYF,KAAKG,IAAI,EAAG/B,EAAW2B,GAEzCpB,EAAYuB,GAGoB,iBAArB5B,GACPA,EAAmB,GACnB4B,EAAY,GACZA,EAAY9B,GACZ8B,EAAY5B,GAAqB,GAG7BE,GACAa,EAAeb,EAAmB0B,IAItCA,GAAa,IACbpB,GAAa,GACbI,IAGIT,GACAY,EAAeZ,KAGnBJ,SAAAA,IACJ,GACD,KAAK,EA+BRoB,OACAW,MAxBU,KACVX,IACAd,EAAYP,GACZa,EAAaE,QAAU,IAAI,EAsB3BkB,WA3FgBC,IAChB,MAAMC,EAAID,QAAAA,EAAQ5B,EAClB,MAAO,GAAG6B,WAAiB,IAANA,EAAU,GAAK,KAAK,EA0F5C"}
+{"version":3,"file":"use-countdown.js","sources":["../../../src/util/use-countdown.ts"],"sourcesContent":["import { announce, clearAnnouncer } from \"@react-aria/live-announcer\";\nimport { useEffect, useRef, useState } from \"react\";\n\nexport interface UseCountdownOptions {\n    /** Duration in seconds */\n    duration: number;\n    /** Called when countdown ends */\n    onComplete?: () => void;\n    /** Time in seconds between reminder announcements */\n    reminderInterval?: number;\n    /** Build the message announced when countdown timer starts */\n    getStartMessage?: (duration: number) => string;\n    /** Build the message announced when countdown reaches each interval based on `reminderInterval` */\n    getIntervalMessage?: (remaining: number) => string;\n    /** Build the message announced when countdown timer completes */\n    getCompletionMessage?: () => string;\n}\n\nexport interface UseCountdownReturn {\n    /** Current countdown time in seconds */\n    timeLeft: number;\n    /** Whether countdown is currently running */\n    isRunning: boolean;\n    /** Start the countdown */\n    start: () => void;\n    /** Stop the countdown */\n    stop: () => void;\n    /** Reset countdown to initial duration */\n    reset: () => void;\n    /** Format time as \"X second(s)\" */\n    formatTime: (time?: number) => string;\n}\n\n/**\n * Countdown hook\n */\nexport const useCountdown = ({\n    duration,\n    onComplete,\n    reminderInterval,\n    getStartMessage,\n    getIntervalMessage,\n    getCompletionMessage,\n}: UseCountdownOptions): UseCountdownReturn => {\n    const [timeLeft, setTimeLeft] = useState(duration);\n    const [isRunning, setIsRunning] = useState(false);\n    const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);\n    const startTimeRef = useRef<number | null>(null);\n\n    const clearTimer = () => {\n        if (intervalRef.current) {\n            clearInterval(intervalRef.current);\n            intervalRef.current = null;\n        }\n    };\n\n    const formatTime = (time?: number) => {\n        const t = time ?? timeLeft;\n        return `${t} second${t === 1 ? \"\" : \"s\"}`;\n    };\n\n    const handleAnnounce = (message: string) => {\n        clearAnnouncer(\"polite\");\n        announce(message, \"polite\");\n    };\n\n    const start = () => {\n        if (isRunning) return;\n\n        clearTimer();\n\n        setTimeLeft(duration);\n        setIsRunning(true);\n        startTimeRef.current = Date.now();\n\n        // First resend reminder message\n        if (getStartMessage) {\n            handleAnnounce(getStartMessage(duration));\n        }\n\n        intervalRef.current = setInterval(() => {\n            if (startTimeRef.current == null) return;\n\n            const elapsed = Math.floor(\n                (Date.now() - startTimeRef.current!) / 1000\n            );\n            const remaining = Math.max(0, duration - elapsed);\n\n            setTimeLeft(remaining);\n\n            if (\n                typeof reminderInterval === \"number\" &&\n                reminderInterval > 0 &&\n                remaining > 0 &&\n                remaining < duration &&\n                remaining % reminderInterval === 0\n            ) {\n                // second resend reminder message in intervals\n                if (getIntervalMessage) {\n                    handleAnnounce(getIntervalMessage(remaining));\n                }\n            }\n\n            if (remaining <= 0) {\n                setIsRunning(false);\n                clearTimer();\n\n                // final reminder message\n                if (getCompletionMessage) {\n                    handleAnnounce(getCompletionMessage());\n                }\n\n                onComplete?.();\n            }\n        }, 1000);\n    };\n\n    const stop = () => {\n        setIsRunning(false);\n        clearTimer();\n    };\n\n    const reset = () => {\n        stop();\n        setTimeLeft(duration);\n        startTimeRef.current = null;\n    };\n\n    // Update timeLeft when duration changes\n    useEffect(() => {\n        if (!isRunning) {\n            setTimeLeft(duration);\n        }\n    }, [duration, isRunning]);\n\n    useEffect(() => {\n        return () => {\n            clearTimer();\n        };\n    }, []);\n\n    return {\n        timeLeft,\n        isRunning,\n        start,\n        stop,\n        reset,\n        formatTime,\n    };\n};\n"],"names":["duration","onComplete","reminderInterval","getStartMessage","getIntervalMessage","getCompletionMessage","timeLeft","setTimeLeft","useState","isRunning","setIsRunning","intervalRef","useRef","startTimeRef","clearTimer","current","clearInterval","handleAnnounce","message","clearAnnouncer","announce","stop","useEffect","start","Date","now","setInterval","elapsed","Math","floor","remaining","max","reset","formatTime","time","t"],"mappings":"iGAoC4B,EACxBA,WACAC,aACAC,mBACAC,kBACAC,qBACAC,2BAEA,MAAOC,EAAUC,GAAeC,EAAAA,SAASR,IAClCS,EAAWC,GAAgBF,EAAAA,UAAS,GACrCG,EAAcC,EAAAA,OAA8C,MAC5DC,EAAeD,EAAAA,OAAsB,MAErCE,EAAa,KACXH,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,KAC1B,EAQEE,EAAkBC,IACpBC,EAAAA,eAAe,UACfC,EAAAA,SAASF,EAAS,SAAS,EAsDzBG,EAAO,KACTX,GAAa,GACbI,GAAY,EAsBhB,OAZAQ,EAAAA,WAAU,KACDb,GACDF,EAAYP,EAChB,GACD,CAACA,EAAUS,IAEda,EAAAA,WAAU,IACC,KACHR,GAAY,GAEjB,IAEI,CACHR,WACAG,YACAc,MA9EU,KACNd,IAEJK,IAEAP,EAAYP,GACZU,GAAa,GACbG,EAAaE,QAAUS,KAAKC,MAGxBtB,GACAc,EAAed,EAAgBH,IAGnCW,EAAYI,QAAUW,aAAY,KAC9B,GAA4B,MAAxBb,EAAaE,QAAiB,OAElC,MAAMY,EAAUC,KAAKC,OAChBL,KAAKC,MAAQZ,EAAaE,SAAY,KAErCe,EAAYF,KAAKG,IAAI,EAAG/B,EAAW2B,GAEzCpB,EAAYuB,GAGoB,iBAArB5B,GACPA,EAAmB,GACnB4B,EAAY,GACZA,EAAY9B,GACZ8B,EAAY5B,GAAqB,GAG7BE,GACAa,EAAeb,EAAmB0B,IAItCA,GAAa,IACbpB,GAAa,GACbI,IAGIT,GACAY,EAAeZ,KAGnBJ,SAAAA,IACJ,GACD,KAAK,EA+BRoB,OACAW,MAxBU,KACVX,IACAd,EAAYP,GACZa,EAAaE,QAAU,IAAI,EAsB3BkB,WA3FgBC,IAChB,MAAMC,EAAID,QAAAA,EAAQ5B,EAClB,MAAO,GAAG6B,WAAiB,IAANA,EAAU,GAAK,KAAK,EA0F5C"}

package/cjs/util/use-event-listener.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-event-listener.js","sources":["../../../src/util/use-event-listener.tsx"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\ntype Target = \"window\" | \"document\" | HTMLElement | null;\ntype Element = Window | Document | HTMLElement | null;\ntype EventHandler<K extends keyof WindowEventMap> = (\n    event: WindowEventMap[K]\n) => void;\n\nexport const useEventListener = <K extends keyof WindowEventMap>(\n    eventName: K,\n    handler: EventHandler<K>,\n    target: Target = \"window\",\n    options?: AddEventListenerOptions | boolean\n) => {\n    // Create a ref that stores handler\n    const savedHandler = useRef<EventHandler<K>>();\n    // Update ref.current value if handler changes.\n    // This allows our effect below to always get latest handler ...\n    useEffect(() => {\n        savedHandler.current = handler;\n    }, [handler]);\n\n    useEffect(\n        () => {\n            let element: Element;\n            switch (target) {\n                case \"window\":\n                    element = window;\n                    break;\n                case \"document\":\n                    element = document;\n                    break;\n                default:\n                    element = target;\n            }\n\n            // Make sure element supports addEventListener\n            if (!element || !element.addEventListener) return;\n\n            // Create event listener that calls handler function stored in ref\n            const eventListener = ((event: WindowEventMap[K]) =>\n                savedHandler.current?.(event)) as EventListener;\n            // Add event listener\n            element.addEventListener(eventName, eventListener, options);\n            // Remove event listener on cleanup\n            return () => {\n                element?.removeEventListener(eventName, eventListener, options);\n            };\n        },\n        [eventName, target] // Re-run if eventName or element changes\n    );\n};\n"],"names":["eventName","handler","target","options","savedHandler","useRef","useEffect","current","element","window","document","addEventListener","eventListener","event","_a","call","removeEventListener"],"mappings":"6DAQgC,CAC5BA,EACAC,EACAC,EAAiB,SACjBC,KAGA,MAAMC,EAAeC,EAAAA,SAGrBC,EAAAA,WAAU,KACNF,EAAaG,QAAUN,CAAO,GAC/B,CAACA,IAEJK,EAAAA,WACI,KACI,IAAIE,EACJ,OAAQN,GACJ,IAAK,SACDM,EAAUC,OACV,MACJ,IAAK,WACDD,EAAUE,SACV,MACJ,QACIF,EAAUN,EAIlB,IAAKM,IAAYA,EAAQG,iBAAkB,OAG3C,MAAMC,EAAkBC,IAA4B,IAAAC,EAChD,OAAoB,UAApBV,EAAaG,eAAO,IAAAO,OAAA,EAAAA,EAAAC,KAAAX,EAAGS,EAAM,EAIjC,OAFAL,EAAQG,iBAAiBX,EAAWY,EAAeT,GAE5C,KACHK,SAAAA,EAASQ,oBAAoBhB,EAAWY,EAAeT,EAAQ,CAClE,GAEL,CAACH,EAAWE,GACf"}
+{"version":3,"file":"use-event-listener.js","sources":["../../../src/util/use-event-listener.tsx"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\ntype Target = \"window\" | \"document\" | HTMLElement | null;\ntype Element = Window | Document | HTMLElement | null;\ntype EventHandler<K extends keyof WindowEventMap> = (\n    event: WindowEventMap[K]\n) => void;\n\nexport const useEventListener = <K extends keyof WindowEventMap>(\n    eventName: K,\n    handler: EventHandler<K>,\n    target: Target = \"window\",\n    options?: AddEventListenerOptions | boolean\n) => {\n    // Create a ref that stores handler\n    const savedHandler = useRef<EventHandler<K>>();\n    // Update ref.current value if handler changes.\n    // This allows our effect below to always get latest handler ...\n    useEffect(() => {\n        savedHandler.current = handler;\n    }, [handler]);\n\n    useEffect(\n        () => {\n            let element: Element;\n            switch (target) {\n                case \"window\":\n                    element = window;\n                    break;\n                case \"document\":\n                    element = document;\n                    break;\n                default:\n                    element = target;\n            }\n\n            // Make sure element supports addEventListener\n            if (!element || !element.addEventListener) return;\n\n            // Create event listener that calls handler function stored in ref\n            const eventListener = ((event: WindowEventMap[K]) =>\n                savedHandler.current?.(event)) as EventListener;\n            // Add event listener\n            element.addEventListener(eventName, eventListener, options);\n            // Remove event listener on cleanup\n            return () => {\n                element?.removeEventListener(eventName, eventListener, options);\n            };\n        },\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n        [eventName, target] // Re-run if eventName or element changes\n    );\n};\n"],"names":["eventName","handler","target","options","savedHandler","useRef","useEffect","current","element","window","document","addEventListener","eventListener","event","_a","call","removeEventListener"],"mappings":"6DAQgC,CAC5BA,EACAC,EACAC,EAAiB,SACjBC,KAGA,MAAMC,EAAeC,EAAAA,SAGrBC,EAAAA,WAAU,KACNF,EAAaG,QAAUN,CAAO,GAC/B,CAACA,IAEJK,EAAAA,WACI,KACI,IAAIE,EACJ,OAAQN,GACJ,IAAK,SACDM,EAAUC,OACV,MACJ,IAAK,WACDD,EAAUE,SACV,MACJ,QACIF,EAAUN,EAIlB,IAAKM,IAAYA,EAAQG,iBAAkB,OAG3C,MAAMC,EAAkBC,IAA4B,IAAAC,EAChD,OAAoB,UAApBV,EAAaG,eAAO,IAAAO,OAAA,EAAAA,EAAAC,KAAAX,EAAGS,EAAM,EAIjC,OAFAL,EAAQG,iBAAiBX,EAAWY,EAAeT,GAE5C,KACHK,SAAAA,EAASQ,oBAAoBhB,EAAWY,EAAeT,EAAQ,CAClE,GAGL,CAACH,EAAWE,GACf"}

package/cjs/util/use-state-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-state-actions.js","sources":["../../../src/util/use-state-actions.ts"],"sourcesContent":["import { useReducer } from \"react\";\nimport { RequiredKeys } from \"./utility-types\";\n\ntype ReducerObj<State> = {\n    [action: string]: (state: State, payload: any) => State;\n};\n\ntype Actions<State, Reducers extends ReducerObj<State>> = {\n    [T in keyof Reducers]: Reducers[T] extends (state: State) => State\n        ? () => void\n        : Reducers[T] extends (\n              state: State,\n              payload: Parameters<Reducers[T]>[1]\n          ) => State\n        ? (\n              ...args: RequiredKeys<Parameters<Reducers[T]>[1]> extends never\n                  ? [payload?: Parameters<Reducers[T]>[1]]\n                  : [payload: Parameters<Reducers[T]>[1]]\n          ) => void\n        : never;\n};\n\ninterface StateActions<State, Reducers> {\n    /** reducer initial state */\n    initialState: State;\n    /** specify functions that return the new state. must be immutable */\n    reducers: Reducers;\n    /** identify the reducer for debugging */\n    name?: string;\n    /** enable debugging */\n    debug?: boolean;\n}\n\n/**\n * An interface around `React.useReducer` to limit boilerplate. Each action\n * is a function that takes in state and payload, then returns the updated state\n * immutably. Inspired by redux toolkit's createSlice api.\n *\n * Example:\n * ```\n * const initialState = { count: 0 };\n * const reducers = {\n *     increment: (state) => ({ ...state, count: state.count + 1 }),\n *     multiplyBy: (state, multiplier: number) => ({\n *         ...state,\n *         count: state.count * multiplier,\n *     }),\n * };\n * const [state, actions] = useStateActions({ initialState, reducers });\n * actions.increment();\n * actions.multiplyBy(2);\n * ```\n *\n */\nexport const useStateActions = <State, Reducers extends ReducerObj<State>>({\n    initialState,\n    reducers,\n    name,\n    debug,\n}: StateActions<State, Reducers>): [State, Actions<State, Reducers>] => {\n    const reducer = (state: State, action: { type: string; payload: any }) => {\n        if (reducers[action.type]) {\n            return reducers[action.type](state, action.payload);\n        }\n        return state;\n    };\n    const [state, dispatch] = useReducer(reducer, initialState);\n    const actions = Object.fromEntries(\n        Object.keys(reducers).map((actionType) => {\n            return [\n                actionType,\n                (payload: unknown) => {\n                    if (debug) {\n                        logAction(name, actionType, payload);\n                    }\n                    dispatch({\n                        type: actionType,\n                        payload,\n                    });\n                },\n            ];\n        })\n    );\n    return [state, actions] as [State, Actions<State, Reducers>];\n};\n\nconst logAction = (\n    name: string | undefined,\n    type: string,\n    payload: unknown\n) => {\n    const args = [];\n    if (name) args.push(`[${name}]`);\n    args.push(type, payload);\n\n    console.log(...args);\n};\n"],"names":["logAction","name","type","payload","args","push","console","log","initialState","reducers","debug","state","dispatch","useReducer","action","Object","fromEntries","keys","map","actionType"],"mappings":"oCAsDO,MAgCDA,EAAY,CACdC,EACAC,EACAC,KAEA,MAAMC,EAAO,GACHA,EAAKC,KAAK,IAAIJ,MACxBG,EAAKC,KAAKH,EAAMC,GAEhBG,QAAQC,OAAOH,EAAK,0BAzCO,EAC3BI,eACAC,WACAR,OACAS,YAEA,MAMOC,EAAOC,GAAYC,EAAAA,YANV,CAACF,EAAcG,IACvBL,EAASK,EAAOZ,MACTO,EAASK,EAAOZ,MAAMS,EAAOG,EAAOX,SAExCQ,GAEmCH,GAiB9C,MAAO,CAACG,EAhBQI,OAAOC,YACnBD,OAAOE,KAAKR,GAAUS,KAAKC,GAChB,CACHA,EACChB,IACOO,GACAV,EAAUC,EAAMkB,EAAYhB,GAEhCS,EAAS,CACLV,KAAMiB,EACNhB,WACF,MAK0C"}
+{"version":3,"file":"use-state-actions.js","sources":["../../../src/util/use-state-actions.ts"],"sourcesContent":["import { useReducer } from \"react\";\n\nimport type { RequiredKeys } from \"./utility-types\";\n\ntype ReducerObj<State> = {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    [action: string]: (state: State, payload: any) => State;\n};\n\ntype Actions<State, Reducers extends ReducerObj<State>> = {\n    [T in keyof Reducers]: Reducers[T] extends (state: State) => State\n        ? () => void\n        : Reducers[T] extends (\n              state: State,\n              payload: Parameters<Reducers[T]>[1]\n          ) => State\n        ? (\n              ...args: RequiredKeys<Parameters<Reducers[T]>[1]> extends never\n                  ? [payload?: Parameters<Reducers[T]>[1]]\n                  : [payload: Parameters<Reducers[T]>[1]]\n          ) => void\n        : never;\n};\n\ninterface StateActions<State, Reducers> {\n    /** reducer initial state */\n    initialState: State;\n    /** specify functions that return the new state. must be immutable */\n    reducers: Reducers;\n    /** identify the reducer for debugging */\n    name?: string;\n    /** enable debugging */\n    debug?: boolean;\n}\n\n/**\n * An interface around `React.useReducer` to limit boilerplate. Each action\n * is a function that takes in state and payload, then returns the updated state\n * immutably. Inspired by redux toolkit's createSlice api.\n *\n * Example:\n * ```\n * const initialState = { count: 0 };\n * const reducers = {\n *     increment: (state) => ({ ...state, count: state.count + 1 }),\n *     multiplyBy: (state, multiplier: number) => ({\n *         ...state,\n *         count: state.count * multiplier,\n *     }),\n * };\n * const [state, actions] = useStateActions({ initialState, reducers });\n * actions.increment();\n * actions.multiplyBy(2);\n * ```\n *\n */\nexport const useStateActions = <State, Reducers extends ReducerObj<State>>({\n    initialState,\n    reducers,\n    name,\n    debug,\n}: StateActions<State, Reducers>): [State, Actions<State, Reducers>] => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const reducer = (state: State, action: { type: string; payload: any }) => {\n        if (reducers[action.type]) {\n            return reducers[action.type](state, action.payload);\n        }\n        return state;\n    };\n    const [state, dispatch] = useReducer(reducer, initialState);\n    const actions = Object.fromEntries(\n        Object.keys(reducers).map((actionType) => {\n            return [\n                actionType,\n                (payload: unknown) => {\n                    if (debug) {\n                        logAction(name, actionType, payload);\n                    }\n                    dispatch({\n                        type: actionType,\n                        payload,\n                    });\n                },\n            ];\n        })\n    );\n    return [state, actions] as [State, Actions<State, Reducers>];\n};\n\nconst logAction = (\n    name: string | undefined,\n    type: string,\n    payload: unknown\n) => {\n    const args = [];\n    if (name) args.push(`[${name}]`);\n    args.push(type, payload);\n\n    console.log(...args);\n};\n"],"names":["logAction","name","type","payload","args","push","console","log","initialState","reducers","debug","state","dispatch","useReducer","action","Object","fromEntries","keys","map","actionType"],"mappings":"oCAwDO,MAiCDA,EAAY,CACdC,EACAC,EACAC,KAEA,MAAMC,EAAO,GACHA,EAAKC,KAAK,IAAIJ,MACxBG,EAAKC,KAAKH,EAAMC,GAEhBG,QAAQC,OAAOH,EAAK,0BA1CO,EAC3BI,eACAC,WACAR,OACAS,YAGA,MAMOC,EAAOC,GAAYC,EAAAA,YANV,CAACF,EAAcG,IACvBL,EAASK,EAAOZ,MACTO,EAASK,EAAOZ,MAAMS,EAAOG,EAAOX,SAExCQ,GAEmCH,GAiB9C,MAAO,CAACG,EAhBQI,OAAOC,YACnBD,OAAOE,KAAKR,GAAUS,KAAKC,GAChB,CACHA,EACChB,IACOO,GACAV,EAAUC,EAAMkB,EAAYhB,GAEhCS,EAAS,CACLV,KAAMiB,EACNhB,WACF,MAK0C"}

package/codemod-utils.d.ts

@@ -1,8 +1,9 @@
-import { API, ASTPath, Collection, MemberExpression } from "jscodeshift";
-export declare namespace CodemodUtils {
-    function hasImport(source: Collection, api: API, importPath: string | string[], importSpecifier: string): boolean;
-    function addImport(source: Collection, api: API, importPath: string, importSpecifier: string): void;
-    function removeImport(source: Collection, api: API, importPath: string | string[], importSpecifier: string): void;
-    function hasReferences(source: Collection, api: API, importPath: string | string[], importSpecifier: string): boolean;
-    function getObjectPath(source: Collection, api: API, path: ASTPath<MemberExpression>): string | undefined;
+import type { API, ASTPath, Collection, MemberExpression } from "jscodeshift";
+export declare class CodemodUtils {
+    static hasImport(source: Collection, api: API, importPath: string | string[], importSpecifier: string): boolean;
+    static addImport(source: Collection, api: API, importPath: string, importSpecifier: string): void;
+    static removeImport(source: Collection, api: API, importPath: string | string[], importSpecifier: string): void;
+    static replaceImport(source: Collection, api: API, oldImportPath: string | string[], oldImportSpecifier: string, newImportPath: string, newImportSpecifier: string): void;
+    static hasReferences(source: Collection, api: API, importPath: string | string[], importSpecifier: string): boolean;
+    static getObjectPath(source: Collection, api: API, path: ASTPath<MemberExpression>): string | undefined;
 }

package/codemods/codemod-utils.ts

@@ -1,4 +1,4 @@
-import {
+import type {
     API,
     ASTPath,
     Collection,
@@ -6,8 +6,8 @@ import {
     MemberExpression,
 } from "jscodeshift";
 
-export namespace CodemodUtils {
-    export function hasImport(
+export class CodemodUtils {
+    public static hasImport(
         source: Collection,
         api: API,
         importPath: string | string[],
@@ -42,7 +42,7 @@ export namespace CodemodUtils {
         return imported;
     }
 
-    export function addImport(
+    public static addImport(
         source: Collection,
         api: API,
         importPath: string,
@@ -85,7 +85,7 @@ export namespace CodemodUtils {
         }
     }
 
-    export function removeImport(
+    public static removeImport(
         source: Collection,
         api: API,
         importPath: string | string[],
@@ -122,7 +122,24 @@ export namespace CodemodUtils {
         });
     }
 
-    export function hasReferences(
+    public static replaceImport(
+        source: Collection,
+        api: API,
+        oldImportPath: string | string[],
+        oldImportSpecifier: string,
+        newImportPath: string,
+        newImportSpecifier: string
+    ) {
+        CodemodUtils.addImport(source, api, newImportPath, newImportSpecifier);
+        CodemodUtils.removeImport(
+            source,
+            api,
+            oldImportPath,
+            oldImportSpecifier
+        );
+    }
+
+    public static hasReferences(
         source: Collection,
         api: API,
         importPath: string | string[],
@@ -130,7 +147,12 @@ export namespace CodemodUtils {
     ) {
         const j: JSCodeshift = api.jscodeshift;
 
-        const imported = hasImport(source, api, importPath, importSpecifier);
+        const imported = CodemodUtils.hasImport(
+            source,
+            api,
+            importPath,
+            importSpecifier
+        );
         if (imported) {
             return (
                 source
@@ -145,7 +167,7 @@ export namespace CodemodUtils {
         return false;
     }
 
-    export function getObjectPath(
+    public static getObjectPath(
         source: Collection,
         api: API,
         path: ASTPath<MemberExpression>