@lifesg/react-design-system 4.0.0-alpha.1 → 4.0.0-alpha.10

package/util/time-helper.js.map

@@ -1 +1 @@
-{"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    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,\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\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","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/util/use-countdown.d.ts

@@ -3,6 +3,14 @@ export interface UseCountdownOptions {
     duration: number;
     /** Called when countdown ends */
     onComplete?: () => void;
+    /** Time in seconds between reminder announcements */
+    reminderInterval?: number;
+    /** Build the message announced when countdown timer starts */
+    getStartMessage?: (duration: number) => string;
+    /** Build the message announced when countdown reaches each interval based on `reminderInterval` */
+    getIntervalMessage?: (remaining: number) => string;
+    /** Build the message announced when countdown timer completes */
+    getCompletionMessage?: () => string;
 }
 export interface UseCountdownReturn {
     /** Current countdown time in seconds */
@@ -21,4 +29,4 @@ export interface UseCountdownReturn {
 /**
  * Countdown hook
  */
-export declare const useCountdown: ({ duration, onComplete, }: UseCountdownOptions) => UseCountdownReturn;
+export declare const useCountdown: ({ duration, onComplete, reminderInterval, getStartMessage, getIntervalMessage, getCompletionMessage, }: UseCountdownOptions) => UseCountdownReturn;

package/util/use-countdown.js

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

package/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\";\n\nexport interface UseCountdownOptions {\n    /** Duration in seconds */\n    duration: number;\n    /** Called when countdown ends */\n    onComplete?: () => void;\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}: 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 formatTime = (time?: number) => {\n        const t = time ?? timeLeft;\n        return `${t} second${t === 1 ? \"\" : \"s\"}`;\n    };\n\n    const start = () => {\n        if (isRunning) return;\n\n        startTimeRef.current = Date.now();\n        setIsRunning(true);\n\n        intervalRef.current = setInterval(() => {\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 (remaining <= 0) {\n                setIsRunning(false);\n                if (intervalRef.current) {\n                    clearInterval(intervalRef.current);\n                    intervalRef.current = null;\n                }\n                onComplete?.();\n            }\n        }, 1000);\n    };\n\n    const stop = () => {\n        setIsRunning(false);\n        if (intervalRef.current) {\n            clearInterval(intervalRef.current);\n            intervalRef.current = null;\n        }\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    return {\n        timeLeft,\n        isRunning,\n        start,\n        stop,\n        reset,\n        formatTime,\n    };\n};\n"],"names":["useCountdown","duration","onComplete","timeLeft","setTimeLeft","useState","isRunning","setIsRunning","intervalRef","useRef","startTimeRef","stop","current","clearInterval","useEffect","start","Date","now","setInterval","elapsed","Math","floor","remaining","max","reset","formatTime","time","t"],"mappings":"4DA2BO,MAAMA,EAAe,EACxBC,WACAC,iBAEA,MAAOC,EAAUC,GAAeC,EAASJ,IAClCK,EAAWC,GAAgBF,GAAS,GACrCG,EAAcC,EAA8C,MAC5DC,EAAeD,EAAsB,MAgCrCE,EAAO,KACTJ,GAAa,GACTC,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,KAC1B,EAgBJ,OANAE,GAAU,KACDR,GACDF,EAAYH,EAChB,GACD,CAACA,EAAUK,IAEP,CACHH,WACAG,YACAS,MAjDU,KACNT,IAEJI,EAAaE,QAAUI,KAAKC,MAC5BV,GAAa,GAEbC,EAAYI,QAAUM,aAAY,KAC9B,MAAMC,EAAUC,KAAKC,OAChBL,KAAKC,MAAQP,EAAaE,SAAY,KAErCU,EAAYF,KAAKG,IAAI,EAAGtB,EAAWkB,GAEzCf,EAAYkB,GAERA,GAAa,IACbf,GAAa,GACTC,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,MAE1BV,SAAAA,IACJ,GACD,KAAK,EA4BRS,OACAa,MAlBU,KACVb,IACAP,EAAYH,GACZS,EAAaE,QAAU,IAAI,EAgB3Ba,WAzDgBC,IAChB,MAAMC,EAAID,QAAAA,EAAQvB,EAClB,MAAO,GAAGwB,WAAiB,IAANA,EAAU,GAAK,KAAK,EAwD5C"}
+{"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":["useCountdown","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":"sIAoCO,MAAMA,EAAe,EACxBC,WACAC,aACAC,mBACAC,kBACAC,qBACAC,2BAEA,MAAOC,EAAUC,GAAeC,EAASR,IAClCS,EAAWC,GAAgBF,GAAS,GACrCG,EAAcC,EAA8C,MAC5DC,EAAeD,EAAsB,MAErCE,EAAa,KACXH,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,KAC1B,EAQEE,EAAkBC,IACpBC,EAAe,UACfC,EAASF,EAAS,SAAS,EAsDzBG,EAAO,KACTX,GAAa,GACbI,GAAY,EAsBhB,OAZAQ,GAAU,KACDb,GACDF,EAAYP,EAChB,GACD,CAACA,EAAUS,IAEda,GAAU,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/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":["useEventListener","eventName","handler","target","options","savedHandler","useRef","useEffect","current","element","window","document","addEventListener","eventListener","event","_a","call","removeEventListener"],"mappings":"8CAQO,MAAMA,EAAmB,CAC5BC,EACAC,EACAC,EAAiB,SACjBC,KAGA,MAAMC,EAAeC,IAGrBC,GAAU,KACNF,EAAaG,QAAUN,CAAO,GAC/B,CAACA,IAEJK,GACI,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":["useEventListener","eventName","handler","target","options","savedHandler","useRef","useEffect","current","element","window","document","addEventListener","eventListener","event","_a","call","removeEventListener"],"mappings":"8CAQO,MAAMA,EAAmB,CAC5BC,EACAC,EACAC,EAAiB,SACjBC,KAGA,MAAMC,EAAeC,IAGrBC,GAAU,KACNF,EAAaG,QAAUN,CAAO,GAC/B,CAACA,IAEJK,GACI,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/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\";\n\nimport type { 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":["useStateActions","initialState","reducers","name","debug","state","dispatch","useReducer","action","type","payload","Object","fromEntries","keys","map","actionType","logAction","args","push","console","log"],"mappings":"mCAuDO,MAAMA,EAAkB,EAC3BC,eACAC,WACAC,OACAC,YAEA,MAMOC,EAAOC,GAAYC,GANV,CAACF,EAAcG,IACvBN,EAASM,EAAOC,MACTP,EAASM,EAAOC,MAAMJ,EAAOG,EAAOE,SAExCL,GAEmCJ,GAiB9C,MAAO,CAACI,EAhBQM,OAAOC,YACnBD,OAAOE,KAAKX,GAAUY,KAAKC,GAChB,CACHA,EACCL,IACON,GACAY,EAAUb,EAAMY,EAAYL,GAEhCJ,EAAS,CACLG,KAAMM,EACNL,WACF,MAK0C,EAG1DM,EAAY,CACdb,EACAM,EACAC,KAEA,MAAMO,EAAO,GACHA,EAAKC,KAAK,IAAIf,MACxBc,EAAKC,KAAKT,EAAMC,GAEhBS,QAAQC,OAAOH,EAAK"}
+{"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":["useStateActions","initialState","reducers","name","debug","state","dispatch","useReducer","action","type","payload","Object","fromEntries","keys","map","actionType","logAction","args","push","console","log"],"mappings":"mCAwDO,MAAMA,EAAkB,EAC3BC,eACAC,WACAC,OACAC,YAGA,MAMOC,EAAOC,GAAYC,GANV,CAACF,EAAcG,IACvBN,EAASM,EAAOC,MACTP,EAASM,EAAOC,MAAMJ,EAAOG,EAAOE,SAExCL,GAEmCJ,GAiB9C,MAAO,CAACI,EAhBQM,OAAOC,YACnBD,OAAOE,KAAKX,GAAUY,KAAKC,GAChB,CACHA,EACCL,IACON,GACAY,EAAUb,EAAMY,EAAYL,GAEhCJ,EAAS,CACLG,KAAMM,EACNL,WACF,MAK0C,EAG1DM,EAAY,CACdb,EACAM,EACAC,KAEA,MAAMO,EAAO,GACHA,EAAKC,KAAK,IAAIf,MACxBc,EAAKC,KAAKT,EAAMC,GAEhBS,QAAQC,OAAOH,EAAK"}

package/util/use-throttle.d.ts

@@ -0,0 +1 @@
+export declare function useThrottle<T extends (...args: any[]) => any>(callback: T, wait: number): T;

package/util/use-throttle.js

@@ -0,0 +1,2 @@
+import{useRef as r,useEffect as t,useCallback as n}from"react";function e(e,u){const c=r(e),l=r(0),o=r(null);return t((()=>{c.current=e}),[e]),t((()=>()=>{null!==o.current&&clearTimeout(o.current)}),[]),n(((...r)=>{const t=Date.now(),n=t-l.current;null!==o.current&&(clearTimeout(o.current),o.current=null),n>=u?(l.current=t,c.current(...r)):o.current=setTimeout((()=>{l.current=Date.now(),o.current=null,c.current(...r)}),u-n)}),[u])}export{e as useThrottle};
+//# sourceMappingURL=use-throttle.js.map

package/util/use-throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-throttle.js","sources":["../../src/util/use-throttle.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from \"react\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useThrottle<T extends (...args: any[]) => any>(\n    callback: T,\n    wait: number\n): T {\n    const callbackRef = useRef<T>(callback);\n    const lastCalledRef = useRef<number>(0);\n    const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    useEffect(() => {\n        callbackRef.current = callback;\n    }, [callback]);\n\n    useEffect(() => {\n        return () => {\n            if (timeoutRef.current !== null) {\n                clearTimeout(timeoutRef.current);\n            }\n        };\n    }, []);\n\n    return useCallback(\n        (...args: Parameters<T>) => {\n            const now = Date.now();\n            const elapsed = now - lastCalledRef.current;\n\n            if (timeoutRef.current !== null) {\n                clearTimeout(timeoutRef.current);\n                timeoutRef.current = null;\n            }\n\n            if (elapsed >= wait) {\n                lastCalledRef.current = now;\n                callbackRef.current(...args);\n            } else {\n                timeoutRef.current = setTimeout(() => {\n                    lastCalledRef.current = Date.now();\n                    timeoutRef.current = null;\n                    callbackRef.current(...args);\n                }, wait - elapsed);\n            }\n        },\n        [wait]\n    ) as T;\n}\n"],"names":["useThrottle","callback","wait","callbackRef","useRef","lastCalledRef","timeoutRef","useEffect","current","clearTimeout","useCallback","args","now","Date","elapsed","setTimeout"],"mappings":"+DAGM,SAAUA,EACZC,EACAC,GAEA,MAAMC,EAAcC,EAAUH,GACxBI,EAAgBD,EAAe,GAC/BE,EAAaF,EAA6C,MAchE,OAZAG,GAAU,KACNJ,EAAYK,QAAUP,CAAQ,GAC/B,CAACA,IAEJM,GAAU,IACC,KACwB,OAAvBD,EAAWE,SACXC,aAAaH,EAAWE,QAC5B,GAEL,IAEIE,GACH,IAAIC,KACA,MAAMC,EAAMC,KAAKD,MACXE,EAAUF,EAAMP,EAAcG,QAET,OAAvBF,EAAWE,UACXC,aAAaH,EAAWE,SACxBF,EAAWE,QAAU,MAGrBM,GAAWZ,GACXG,EAAcG,QAAUI,EACxBT,EAAYK,WAAWG,IAEvBL,EAAWE,QAAUO,YAAW,KAC5BV,EAAcG,QAAUK,KAAKD,MAC7BN,EAAWE,QAAU,KACrBL,EAAYK,WAAWG,EAAK,GAC7BT,EAAOY,EACd,GAEJ,CAACZ,GAET"}

package/_virtual/react-responsive.js

@@ -1,2 +0,0 @@
-var e={exports:{}};export{e as __module};
-//# sourceMappingURL=react-responsive.js.map

package/_virtual/react-responsive.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"react-responsive.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/accordion/accordion-item.style.d.ts

@@ -1,25 +0,0 @@
-import type { AccordionItemType } from "./types";
-interface ContainerStyleProps {
-    $expanded?: boolean | undefined;
-}
-interface ExpandCollapseButtonProps {
-    $expanded: boolean;
-    $collapsible: boolean;
-}
-interface TitleProps {
-    $type: AccordionItemType;
-    $isCollapsed?: boolean | undefined;
-}
-export declare const Container: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, ContainerStyleProps>> & string;
-export declare const ExpandCollapseButton: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, ExpandCollapseButtonProps>> & string;
-export declare const Title: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, TitleProps>> & string;
-export declare const IconContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, ContainerStyleProps>> & string;
-export declare const ChevronIcon: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<Omit<import("react").SVGProps<SVGSVGElement>, "ref"> & {
-    ref?: ((instance: SVGSVGElement | null) => void) | import("react").RefObject<SVGSVGElement> | null | undefined;
-}, never>> & string & Omit<{
-    (props: import("react").SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-}, keyof import("react").Component<any, {}, any>>;
-export declare const Expandable: import("@react-spring/web").AnimatedComponent<import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string>;
-export declare const ContentContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
-export {};

package/accordion/accordion-item.style.js

@@ -1,58 +0,0 @@
-import{ChevronUpIcon as e}from"@lifesg/react-icons/chevron-up";import{animated as o}from"@react-spring/web";import i,{css as t}from"styled-components";import{V3_Colour as n,V3_Border as r,V3_Spacing as d,V3_Radius as a,V3_Motion as s,V3_Font as l,V3_MediaQuery as p}from"../v3_theme/index.js";const $=i.div`
-    background-color: ${n.bg};
-    border-top: ${r["width-010"]} ${r.solid} ${n.border};
-    ${e=>e.$expanded&&t`
-            padding-bottom: ${d["spacing-16"]};
-        `}
-`,c=i.button`
-    background: transparent;
-    border: none;
-    border-radius: ${a.sm};
-    outline: none;
-    text-align: left;
-    user-select: text;
-
-    width: 100%;
-    display: flex;
-    flex-direction: row;
-    align-items: center;
-    justify-content: space-between;
-    gap: ${d["spacing-48"]};
-    padding: ${d["spacing-16"]} 0;
-
-    ${e=>e.$expanded&&t`
-            padding-bottom: ${d["spacing-8"]};
-        `}
-
-    ${e=>e.$collapsible&&t`
-            cursor: pointer;
-        `}
-
-    &:focus-visible {
-        outline: 2px solid ${n["focus-ring"]};
-        outline-offset: 0;
-    }
-`,g=i.span`
-    flex: 1;
-    transition: all ${s["duration-250"]} ${s["ease-standard"]};
-    color: ${n.text};
-
-    ${e=>"small"===e.$type?l["heading-xs-bold"]:l["heading-sm-bold"]}
-`,m=i.span`
-    transform: rotate(${e=>e.$expanded?0:180}deg);
-    transition: transform ${s["duration-250"]}${s["ease-default"]};
-`,f=i(e)`
-    height: 1.25rem;
-    width: 1.25rem;
-    color: ${n["icon-primary"]};
-`,b=o(i.div`
-    overflow: hidden;
-`),u=i.div`
-    display: inline-block;
-    padding-right: ${d["spacing-64"]};
-
-    ${p.MaxWidth.lg} {
-        padding-right: 0;
-    }
-`;export{f as ChevronIcon,$ as Container,u as ContentContainer,c as ExpandCollapseButton,b as Expandable,m as IconContainer,g as Title};
-//# sourceMappingURL=accordion-item.style.js.map

package/accordion/accordion-item.style.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"accordion-item.style.js","sources":["../../src/accordion/accordion-item.style.tsx"],"sourcesContent":["import { ChevronUpIcon } from \"@lifesg/react-icons/chevron-up\";\nimport { animated } from \"@react-spring/web\";\nimport styled, { css } from \"styled-components\";\n\nimport {\n    V3_Border,\n    V3_Colour,\n    V3_Font,\n    V3_MediaQuery,\n    V3_Motion,\n    V3_Radius,\n    V3_Spacing,\n} from \"../v3_theme\";\nimport type { AccordionItemType } from \"./types\";\n\n// =============================================================================\n// STYLE INTERFACE, transient props are denoted with $\n// See more https://styled-components.com/docs/api#transient-props\n// =============================================================================\ninterface ContainerStyleProps {\n    $expanded?: boolean | undefined;\n}\n\ninterface ExpandCollapseButtonProps {\n    $expanded: boolean;\n    $collapsible: boolean;\n}\n\ninterface TitleProps {\n    $type: AccordionItemType;\n    $isCollapsed?: boolean | undefined;\n}\n\n// =============================================================================\n// STYLING\n// =============================================================================\nexport const Container = styled.div<ContainerStyleProps>`\n    background-color: ${V3_Colour.bg};\n    border-top: ${V3_Border[\"width-010\"]} ${V3_Border.solid} ${V3_Colour.border};\n    ${(props) =>\n        props.$expanded &&\n        css`\n            padding-bottom: ${V3_Spacing[\"spacing-16\"]};\n        `}\n`;\n\nexport const ExpandCollapseButton = styled.button<ExpandCollapseButtonProps>`\n    background: transparent;\n    border: none;\n    border-radius: ${V3_Radius[\"sm\"]};\n    outline: none;\n    text-align: left;\n    user-select: text;\n\n    width: 100%;\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    justify-content: space-between;\n    gap: ${V3_Spacing[\"spacing-48\"]};\n    padding: ${V3_Spacing[\"spacing-16\"]} 0;\n\n    ${(props) =>\n        props.$expanded &&\n        css`\n            padding-bottom: ${V3_Spacing[\"spacing-8\"]};\n        `}\n\n    ${(props) =>\n        props.$collapsible &&\n        css`\n            cursor: pointer;\n        `}\n\n    &:focus-visible {\n        outline: 2px solid ${V3_Colour[\"focus-ring\"]};\n        outline-offset: 0;\n    }\n`;\n\nexport const Title = styled.span<TitleProps>`\n    flex: 1;\n    transition: all ${V3_Motion[\"duration-250\"]} ${V3_Motion[\"ease-standard\"]};\n    color: ${V3_Colour[\"text\"]};\n\n    ${(props) =>\n        props.$type === \"small\"\n            ? V3_Font[\"heading-xs-bold\"]\n            : V3_Font[\"heading-sm-bold\"]}\n`;\n\nexport const IconContainer = styled.span<ContainerStyleProps>`\n    transform: rotate(${(props) => (props.$expanded ? 0 : 180)}deg);\n    transition: transform ${V3_Motion[\"duration-250\"]}${V3_Motion[\"ease-default\"]};\n`;\n\nexport const ChevronIcon = styled(ChevronUpIcon)`\n    height: 1.25rem;\n    width: 1.25rem;\n    color: ${V3_Colour[\"icon-primary\"]};\n`;\n\nexport const Expandable = animated(styled.div`\n    overflow: hidden;\n`);\n\nexport const ContentContainer = styled.div`\n    display: inline-block;\n    padding-right: ${V3_Spacing[\"spacing-64\"]};\n\n    ${V3_MediaQuery.MaxWidth.lg} {\n        padding-right: 0;\n    }\n`;\n"],"names":["Container","styled","div","V3_Colour","bg","V3_Border","solid","border","props","$expanded","css","V3_Spacing","ExpandCollapseButton","button","V3_Radius","$collapsible","Title","span","V3_Motion","$type","V3_Font","IconContainer","ChevronIcon","ChevronUpIcon","Expandable","animated","ContentContainer","V3_MediaQuery","MaxWidth","lg"],"mappings":"qSAoCO,MAAMA,EAAYC,EAAOC,GAAwB;wBAChCC,EAAUC;kBAChBC,EAAU,gBAAgBA,EAAUC,SAASH,EAAUI;MAClEC,GACCA,EAAMC,WACNC,CAAG;8BACmBC,EAAW;;EAI5BC,EAAuBX,EAAOY,MAAiC;;;qBAGvDC,EAAc;;;;;;;;;;WAUxBH,EAAW;eACPA,EAAW;;MAEnBH,GACCA,EAAMC,WACNC,CAAG;8BACmBC,EAAW;;;MAGlCH,GACCA,EAAMO,cACNL,CAAG;;;;;6BAKkBP,EAAU;;;EAK1Ba,EAAQf,EAAOgB,IAAgB;;sBAEtBC,EAAU,mBAAmBA,EAAU;aAChDf,EAAgB;;MAEtBK,GACiB,UAAhBA,EAAMW,MACAC,EAAQ,mBACRA,EAAQ;EAGTC,EAAgBpB,EAAOgB,IAAyB;wBACpCT,GAAWA,EAAMC,UAAY,EAAI;4BAC9BS,EAAU,kBAAkBA,EAAU;EAGrDI,EAAcrB,EAAOsB,EAAc;;;aAGnCpB,EAAU;EAGVqB,EAAaC,EAASxB,EAAOC,GAAG;;GAIhCwB,EAAmBzB,EAAOC,GAAG;;qBAErBS,EAAW;;MAE1BgB,EAAcC,SAASC;;;"}

package/accordion/accordion.style.d.ts

@@ -1,5 +0,0 @@
-import type { TitleStyleProps, TitleWrapperStyleProps } from "./types";
-export declare const Content: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
-export declare const TitleWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, TitleWrapperStyleProps>> & string;
-export declare const Title: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, TitleStyleProps>> & string;
-export declare const ExpandCollapseLink: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("..").ButtonProps & import("react").RefAttributes<HTMLButtonElement>, never>> & string & Omit<(props: import("..").ButtonProps & import("react").RefAttributes<HTMLButtonElement>) => React.ReactElement | null, keyof import("react").Component<any, {}, any>>;

package/accordion/accordion.style.js

@@ -1,44 +0,0 @@
-import e,{css as t}from"styled-components";import{Button as i}from"../button/button.js";import{V3_Border as o,V3_Colour as n,V3_MediaQuery as l,V3_Font as r}from"../v3_theme/index.js";const d=e.div`
-    width: 100%;
-    border-bottom: ${o["width-010"]} ${o.solid}
-        ${n.border};
-`,a=e.div`
-    display: flex;
-    flex-direction: row;
-    align-items: center;
-    justify-content: flex-end;
-    padding-bottom: 1rem;
-
-    ${l.MaxWidth.sm} {
-        justify-content: flex-end;
-    }
-
-    ${e=>{if(!e.$showTitleInMobile&&!e.$hasExpandAll)return t`
-                ${l.MaxWidth.sm} {
-                    display: none;
-                }
-            `}}
-`,m=e.h2`
-    display: flex;
-    align-self: flex-start;
-    flex: 1;
-
-    ${r["heading-md-bold"]}
-    color: ${n.text};
-
-    ${l.MaxWidth.sm} {
-        text-align: left;
-    }
-
-    ${e=>{if(!e.$showInMobile)return t`
-                ${l.MaxWidth.sm} {
-                    display: none;
-                    visibility: hidden;
-                }
-            `}}
-`,s=e(i.Small)`
-    padding: 1.75rem 1rem; // larger clickable area
-    margin: -1rem -1rem -1rem 0px;
-    white-space: nowrap;
-`;export{d as Content,s as ExpandCollapseLink,m as Title,a as TitleWrapper};
-//# sourceMappingURL=accordion.style.js.map

package/accordion/accordion.style.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"accordion.style.js","sources":["../../src/accordion/accordion.style.tsx"],"sourcesContent":["import styled, { css } from \"styled-components\";\n\nimport { Button } from \"../button\";\nimport { V3_Border, V3_Colour, V3_Font, V3_MediaQuery } from \"../v3_theme\";\nimport type { TitleStyleProps, TitleWrapperStyleProps } from \"./types\";\n\n// ============================================================================\n// STYLING\n// =============================================================================\nexport const Content = styled.div`\n    width: 100%;\n    border-bottom: ${V3_Border[\"width-010\"]} ${V3_Border.solid}\n        ${V3_Colour.border};\n`;\n\nexport const TitleWrapper = styled.div<TitleWrapperStyleProps>`\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    justify-content: flex-end;\n    padding-bottom: 1rem;\n\n    ${V3_MediaQuery.MaxWidth.sm} {\n        justify-content: flex-end;\n    }\n\n    ${(props) => {\n        if (!props.$showTitleInMobile && !props.$hasExpandAll) {\n            return css`\n                ${V3_MediaQuery.MaxWidth.sm} {\n                    display: none;\n                }\n            `;\n        }\n    }}\n`;\n\nexport const Title = styled.h2<TitleStyleProps>`\n    display: flex;\n    align-self: flex-start;\n    flex: 1;\n\n    ${V3_Font[\"heading-md-bold\"]}\n    color: ${V3_Colour[\"text\"]};\n\n    ${V3_MediaQuery.MaxWidth.sm} {\n        text-align: left;\n    }\n\n    ${(props) => {\n        if (!props.$showInMobile) {\n            return css`\n                ${V3_MediaQuery.MaxWidth.sm} {\n                    display: none;\n                    visibility: hidden;\n                }\n            `;\n        }\n    }}\n`;\n\nexport const ExpandCollapseLink = styled(Button.Small)`\n    padding: 1.75rem 1rem; // larger clickable area\n    margin: -1rem -1rem -1rem 0px;\n    white-space: nowrap;\n`;\n"],"names":["Content","styled","div","V3_Border","solid","V3_Colour","border","TitleWrapper","V3_MediaQuery","MaxWidth","sm","props","$showTitleInMobile","$hasExpandAll","css","Title","h2","V3_Font","$showInMobile","ExpandCollapseLink","Button","Small"],"mappings":"wLASO,MAAMA,EAAUC,EAAOC,GAAG;;qBAEZC,EAAU,gBAAgBA,EAAUC;UAC/CC,EAAUC;EAGPC,EAAeN,EAAOC,GAA2B;;;;;;;MAOxDM,EAAcC,SAASC;;;;MAItBC,IACC,IAAKA,EAAMC,qBAAuBD,EAAME,cACpC,OAAOC,CAAG;kBACJN,EAAcC,SAASC;;;aAIjC;EAIKK,EAAQd,EAAOe,EAAmB;;;;;MAKzCC,EAAQ;aACDZ,EAAgB;;MAEvBG,EAAcC,SAASC;;;;MAItBC,IACC,IAAKA,EAAMO,cACP,OAAOJ,CAAG;kBACJN,EAAcC,SAASC;;;;aAKjC;EAIKS,EAAqBlB,EAAOmB,EAAOC,MAAM;;;;"}

package/alert/alert.style.d.ts

@@ -1,29 +0,0 @@
-import type { AlertSizeType, AlertType } from "./types";
-interface StyleProps {
-    $type: AlertType;
-    $sizeType: AlertSizeType;
-}
-export interface TextWrapperContainerStyleProps {
-    $showMore: boolean;
-    $hasActionLink: boolean;
-    $maxCollapsedHeight?: number;
-}
-export interface ShowMoreIconStyleProps {
-    $expanded: boolean;
-}
-export declare const Wrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, StyleProps>> & string;
-export declare const AlertIconWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, StyleProps>> & string;
-export declare const ActionLinkText: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("..").TypographyLinkProps & {
-    ref?: import("react").RefObject<HTMLAnchorElement> | undefined;
-}, StyleProps>> & string;
-export declare const ContentContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
-export declare const TextWrapperContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, TextWrapperContainerStyleProps>> & string;
-export declare const TextWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, StyleProps>> & string;
-export declare const ShowMoreButton: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, StyleProps>> & string;
-export declare const ChevronIcon: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<Omit<import("react").SVGProps<SVGSVGElement>, "ref"> & {
-    ref?: ((instance: SVGSVGElement | null) => void) | import("react").RefObject<SVGSVGElement> | null | undefined;
-}, ShowMoreIconStyleProps>> & string & Omit<{
-    (props: import("react").SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-}, keyof import("react").Component<any, {}, any>>;
-export {};

package/alert/alert.style.js

@@ -1,83 +0,0 @@
-import{ChevronDownIcon as e}from"@lifesg/react-icons";import r,{css as i}from"styled-components";import{applyHtmlContentStyle as t}from"../shared/html-content/html-content.js";import{Typography as o}from"../typography/index.js";import{V3_Spacing as s,V3_Colour as n,V3_Border as a,V3_Font as l,V3_Motion as c}from"../v3_theme/index.js";const d=r.div`
-    padding: ${s["spacing-8"]} ${s["spacing-16"]};
-    display: flex;
-
-    ${e=>{let r,t;switch(e.$type){case"error":r=n["bg-error"](e),t=n["border-error"](e);break;case"success":r=n["bg-success"](e),t=n["border-success"](e);break;case"warning":default:r=n["bg-warning"](e),t=n["border-warning"](e);break;case"info":r=n["bg-info"](e),t=n["border-info"](e);break;case"description":r=n["bg-strong"](e),t=n["border-strong"](e)}return i`
-            background: ${r};
-            border-left: ${a["width-020"]} ${a.solid}
-                ${t};
-        `}}
-`,m=r.div`
-    display: flex;
-    align-items: center;
-    height: 1lh;
-    margin-right: ${s["spacing-8"]};
-
-    ${e=>{let r;const t="small"===e.$sizeType?"1.25rem":"1.5rem";switch(e.$type){case"error":r=n["icon-error"](e);break;case"success":r=n["icon-success"](e);break;case"warning":default:r=n["icon-warning"](e);break;case"info":r=n["icon-info"](e);break;case"description":r=n["icon-subtle"](e)}return i`
-            svg {
-                color: ${r};
-                width: ${t};
-                height: ${t};
-            }
-        `}}
-`,g=r(o.LinkSM)`
-    ${e=>"small"===e.$sizeType?i`
-                ${l["body-sm-semibold"]}
-                margin-top: ${s["spacing-4"]};
-            `:i`
-                ${l["body-md-semibold"]}
-                margin-top: ${s["spacing-8"]};
-            `}
-    display: flex;
-    align-items: center;
-    align-self: flex-start;
-
-    svg {
-        height: 1rem;
-        width: 1rem;
-        margin-left: ${s["spacing-4"]};
-    }
-`,$=r.div`
-    display: flex;
-    flex-direction: column;
-    flex: 1;
-    overflow-wrap: anywhere;
-`,p=r.div`
-    display: flex;
-    flex-direction: column;
-    flex: 1;
-    order: 1;
-    ${e=>{if(e.$showMore&&e.$hasActionLink)return i`
-                margin-bottom: ${s["spacing-8"]};
-            `}}
-    ${e=>{const r="linear-gradient(to bottom, black 50%, transparent 100%)";if(!e.$showMore&&e.$maxCollapsedHeight)return`\n                max-height: ${e.$maxCollapsedHeight}px;\n\t\t\t\toverflow: hidden;\n                -webkit-mask-image: ${r};\n                mask-image: ${r};\n\t\t\t`}}
-`,b=r.div`
-    color: ${n.text};
-
-    ${e=>"small"===e.$sizeType?t({textSize:"body-sm"}):t({textSize:"body-md"})}
-`,f=r.button`
-    ${e=>"small"===e.$sizeType?i`
-                ${l["body-sm-semibold"]}
-            `:i`
-                ${l["body-md-semibold"]}
-            `}
-
-    display: flex;
-    align-items: center;
-    align-self: flex-start;
-    gap: ${s["spacing-4"]};
-    margin-top: ${s["spacing-8"]};
-    order: 2;
-
-    cursor: pointer;
-    user-select: none;
-    border: none;
-    background: transparent;
-
-    color: ${n["text-primary"]};
-`,h=r(e)`
-    transform: rotate(${e=>e.$expanded?180:0}deg);
-    transition: transform ${c["duration-350"]}
-        ${c["ease-standard"]};
-`;export{g as ActionLinkText,m as AlertIconWrapper,h as ChevronIcon,$ as ContentContainer,f as ShowMoreButton,b as TextWrapper,p as TextWrapperContainer,d as Wrapper};
-//# sourceMappingURL=alert.style.js.map

package/alert/alert.style.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"alert.style.js","sources":["../../src/alert/alert.style.tsx"],"sourcesContent":["import { ChevronDownIcon } from \"@lifesg/react-icons\";\nimport styled, { css } from \"styled-components\";\n\nimport { applyHtmlContentStyle } from \"../shared/html-content/html-content\";\nimport { Typography } from \"../typography\";\nimport {\n    V3_Border,\n    V3_Colour,\n    V3_Font,\n    V3_Motion,\n    V3_Spacing,\n} from \"../v3_theme\";\nimport type { AlertSizeType, AlertType } from \"./types\";\n\n// =============================================================================\n// STYLE INTERFACES, transient props are denoted with $\n// See more https://styled-components.com/docs/api#transient-props\n// =============================================================================\ninterface StyleProps {\n    $type: AlertType;\n    $sizeType: AlertSizeType;\n}\nexport interface TextWrapperContainerStyleProps {\n    $showMore: boolean;\n    $hasActionLink: boolean;\n    $maxCollapsedHeight?: number;\n}\n\nexport interface ShowMoreIconStyleProps {\n    $expanded: boolean;\n}\n// =============================================================================\n// STYLING\n// =============================================================================\n\nexport const Wrapper = styled.div<StyleProps>`\n    padding: ${V3_Spacing[\"spacing-8\"]} ${V3_Spacing[\"spacing-16\"]};\n    display: flex;\n\n    ${(props) => {\n        let backgroundColor: string;\n        let borderColor: string;\n        switch (props.$type) {\n            case \"error\":\n                backgroundColor = V3_Colour[\"bg-error\"](props);\n                borderColor = V3_Colour[\"border-error\"](props);\n                break;\n            case \"success\":\n                backgroundColor = V3_Colour[\"bg-success\"](props);\n                borderColor = V3_Colour[\"border-success\"](props);\n                break;\n            case \"warning\":\n                backgroundColor = V3_Colour[\"bg-warning\"](props);\n                borderColor = V3_Colour[\"border-warning\"](props);\n                break;\n            case \"info\":\n                backgroundColor = V3_Colour[\"bg-info\"](props);\n                borderColor = V3_Colour[\"border-info\"](props);\n                break;\n            case \"description\":\n                backgroundColor = V3_Colour[\"bg-strong\"](props);\n                borderColor = V3_Colour[\"border-strong\"](props);\n                break;\n            default:\n                backgroundColor = V3_Colour[\"bg-warning\"](props);\n                borderColor = V3_Colour[\"border-warning\"](props);\n                break;\n        }\n\n        return css`\n            background: ${backgroundColor};\n            border-left: ${V3_Border[\"width-020\"]} ${V3_Border[\"solid\"]}\n                ${borderColor};\n        `;\n    }}\n`;\n\nexport const AlertIconWrapper = styled.div<StyleProps>`\n    display: flex;\n    align-items: center;\n    height: 1lh;\n    margin-right: ${V3_Spacing[\"spacing-8\"]};\n\n    ${(props) => {\n        let iconColor: string;\n        const iconSize = props.$sizeType === \"small\" ? \"1.25rem\" : \"1.5rem\";\n        switch (props.$type) {\n            case \"error\":\n                iconColor = V3_Colour[\"icon-error\"](props);\n                break;\n            case \"success\":\n                iconColor = V3_Colour[\"icon-success\"](props);\n                break;\n            case \"warning\":\n                iconColor = V3_Colour[\"icon-warning\"](props);\n                break;\n            case \"info\":\n                iconColor = V3_Colour[\"icon-info\"](props);\n                break;\n            case \"description\":\n                iconColor = V3_Colour[\"icon-subtle\"](props);\n                break;\n            default:\n                iconColor = V3_Colour[\"icon-warning\"](props);\n                break;\n        }\n\n        return css`\n            svg {\n                color: ${iconColor};\n                width: ${iconSize};\n                height: ${iconSize};\n            }\n        `;\n    }}\n`;\n\nexport const ActionLinkText = styled(Typography.LinkSM)<StyleProps>`\n    ${(props) => {\n        if (props.$sizeType === \"small\")\n            return css`\n                ${V3_Font[\"body-sm-semibold\"]}\n                margin-top: ${V3_Spacing[\"spacing-4\"]};\n            `;\n        else {\n            return css`\n                ${V3_Font[\"body-md-semibold\"]}\n                margin-top: ${V3_Spacing[\"spacing-8\"]};\n            `;\n        }\n    }}\n    display: flex;\n    align-items: center;\n    align-self: flex-start;\n\n    svg {\n        height: 1rem;\n        width: 1rem;\n        margin-left: ${V3_Spacing[\"spacing-4\"]};\n    }\n`;\n\nexport const ContentContainer = styled.div`\n    display: flex;\n    flex-direction: column;\n    flex: 1;\n    overflow-wrap: anywhere;\n`;\n\nexport const TextWrapperContainer = styled.div<TextWrapperContainerStyleProps>`\n    display: flex;\n    flex-direction: column;\n    flex: 1;\n    order: 1;\n    ${(props) => {\n        if (props.$showMore && props.$hasActionLink)\n            return css`\n                margin-bottom: ${V3_Spacing[\"spacing-8\"]};\n            `;\n    }}\n    ${(props) => {\n        const gradient =\n            \"linear-gradient(to bottom, black 50%, transparent 100%)\";\n        if (!props.$showMore && props.$maxCollapsedHeight)\n            return `\n                max-height: ${props.$maxCollapsedHeight}px;\n\t\t\t\toverflow: hidden;\n                -webkit-mask-image: ${gradient};\n                mask-image: ${gradient};\n\t\t\t`;\n    }}\n`;\n\nexport const TextWrapper = styled.div<StyleProps>`\n    color: ${V3_Colour.text};\n\n    ${(props) => {\n        if (props.$sizeType === \"small\") {\n            return applyHtmlContentStyle({ textSize: \"body-sm\" });\n        }\n        return applyHtmlContentStyle({ textSize: \"body-md\" });\n    }}\n`;\n\nexport const ShowMoreButton = styled.button<StyleProps>`\n    ${(props) => {\n        if (props.$sizeType === \"small\")\n            return css`\n                ${V3_Font[\"body-sm-semibold\"]}\n            `;\n        else {\n            return css`\n                ${V3_Font[\"body-md-semibold\"]}\n            `;\n        }\n    }}\n\n    display: flex;\n    align-items: center;\n    align-self: flex-start;\n    gap: ${V3_Spacing[\"spacing-4\"]};\n    margin-top: ${V3_Spacing[\"spacing-8\"]};\n    order: 2;\n\n    cursor: pointer;\n    user-select: none;\n    border: none;\n    background: transparent;\n\n    color: ${V3_Colour[\"text-primary\"]};\n`;\n\nexport const ChevronIcon = styled(ChevronDownIcon)<ShowMoreIconStyleProps>`\n    transform: rotate(${(props) => (props.$expanded ? 180 : 0)}deg);\n    transition: transform ${V3_Motion[\"duration-350\"]}\n        ${V3_Motion[\"ease-standard\"]};\n`;\n"],"names":["Wrapper","styled","div","V3_Spacing","props","backgroundColor","borderColor","$type","V3_Colour","css","V3_Border","AlertIconWrapper","iconColor","iconSize","$sizeType","ActionLinkText","Typography","LinkSM","V3_Font","ContentContainer","TextWrapperContainer","$showMore","$hasActionLink","gradient","$maxCollapsedHeight","TextWrapper","text","applyHtmlContentStyle","textSize","ShowMoreButton","button","ChevronIcon","ChevronDownIcon","$expanded","V3_Motion"],"mappings":"gVAmCO,MAAMA,EAAUC,EAAOC,GAAe;eAC9BC,EAAW,gBAAgBA,EAAW;;;MAG9CC,IACC,IAAIC,EACAC,EACJ,OAAQF,EAAMG,OACV,IAAK,QACDF,EAAkBG,EAAU,YAAYJ,GACxCE,EAAcE,EAAU,gBAAgBJ,GACxC,MACJ,IAAK,UACDC,EAAkBG,EAAU,cAAcJ,GAC1CE,EAAcE,EAAU,kBAAkBJ,GAC1C,MACJ,IAAK,UAYL,QACIC,EAAkBG,EAAU,cAAcJ,GAC1CE,EAAcE,EAAU,kBAAkBJ,GAC1C,MAXJ,IAAK,OACDC,EAAkBG,EAAU,WAAWJ,GACvCE,EAAcE,EAAU,eAAeJ,GACvC,MACJ,IAAK,cACDC,EAAkBG,EAAU,aAAaJ,GACzCE,EAAcE,EAAU,iBAAiBJ,GAQjD,OAAOK,CAAG;0BACQJ;2BACCK,EAAU,gBAAgBA,EAAiB;kBACpDJ;SACT;EAIIK,EAAmBV,EAAOC,GAAe;;;;oBAIlCC,EAAW;;MAExBC,IACC,IAAIQ,EACJ,MAAMC,EAA+B,UAApBT,EAAMU,UAAwB,UAAY,SAC3D,OAAQV,EAAMG,OACV,IAAK,QACDK,EAAYJ,EAAU,cAAcJ,GACpC,MACJ,IAAK,UACDQ,EAAYJ,EAAU,gBAAgBJ,GACtC,MACJ,IAAK,UASL,QACIQ,EAAYJ,EAAU,gBAAgBJ,GACtC,MARJ,IAAK,OACDQ,EAAYJ,EAAU,aAAaJ,GACnC,MACJ,IAAK,cACDQ,EAAYJ,EAAU,eAAeJ,GAO7C,OAAOK,CAAG;;yBAEOG;yBACAC;0BACCA;;SAEjB;EAIIE,EAAiBd,EAAOe,EAAWC,OAAmB;MAC5Db,GACyB,UAApBA,EAAMU,UACCL,CAAG;kBACJS,EAAQ;8BACIf,EAAW;cAGtBM,CAAG;kBACJS,EAAQ;8BACIf,EAAW;;;;;;;;;uBAWlBA,EAAW;;EAIrBgB,EAAmBlB,EAAOC,GAAG;;;;;EAO7BkB,EAAuBnB,EAAOC,GAAmC;;;;;MAKvEE,IACC,GAAIA,EAAMiB,WAAajB,EAAMkB,eACzB,OAAOb,CAAG;iCACWN,EAAW;aAC/B;MAENC,IACC,MAAMmB,EACF,0DACJ,IAAKnB,EAAMiB,WAAajB,EAAMoB,oBAC1B,MAAO,iCACWpB,EAAMoB,0FAEED,mCACRA,YAC1B;EAISE,EAAcxB,EAAOC,GAAe;aACpCM,EAAUkB;;MAEhBtB,GACyB,UAApBA,EAAMU,UACCa,EAAsB,CAAEC,SAAU,YAEtCD,EAAsB,CAAEC,SAAU;EAIpCC,EAAiB5B,EAAO6B,MAAkB;MAChD1B,GACyB,UAApBA,EAAMU,UACCL,CAAG;kBACJS,EAAQ;cAGPT,CAAG;kBACJS,EAAQ;;;;;;WAQff,EAAW;kBACJA,EAAW;;;;;;;;aAQhBK,EAAU;EAGVuB,EAAc9B,EAAO+B,EAAwC;wBACjD5B,GAAWA,EAAM6B,UAAY,IAAM;4BAChCC,EAAU;UAC5BA,EAAU;"}

package/avatar/avatar.style.d.ts

@@ -1,11 +0,0 @@
-import type { AvatarSize } from "./types";
-export interface AvatarDisplayProps {
-    $sizeType?: AvatarSize;
-}
-export declare const AvatarDisplay: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, AvatarDisplayProps>> & string;
-export declare const AvatarBaselineText: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("..").TypographyProps & {
-    ref?: import("react").RefObject<HTMLParagraphElement> | undefined;
-}, never>> & string;
-export declare const AvatarBodySmallText: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("..").TypographyProps & {
-    ref?: import("react").RefObject<HTMLParagraphElement> | undefined;
-}, never>> & string;