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

package/unit-number/unit-number-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"unit-number-input.js","sources":["../../src/unit-number/unit-number-input.tsx"],"sourcesContent":["import type React from \"react\";\nimport { useEffect, useMemo, useRef, useState } from \"react\";\n\nimport { concatIds, VisuallyHidden } from \"../shared/accessibility\";\nimport { InputWrapper } from \"../shared/input-wrapper/input-wrapper\";\nimport { SimpleIdGenerator, StringHelper, useNextInputState } from \"../util\";\nimport type { UnitNumberInputProps } from \"./types\";\nimport {\n    FloorInput,\n    HashContainer,\n    ReadOnlyContainer,\n    ReadOnlyLabel,\n    UnitInput,\n    UnitNumberDivider,\n} from \"./unit-number-input.style\";\n\ntype FieldType = \"floor\" | \"unit\" | \"none\";\ntype ValueFieldTypes = Exclude<FieldType, \"none\">;\n\nexport const UnitNumberInput = ({\n    disabled,\n    error,\n    value,\n    onChange,\n    onBlur,\n    onChangeRaw,\n    onBlurRaw,\n    readOnly,\n    placeholder = \"00-8888\",\n    autoComplete,\n    \"aria-labelledby\": ariaLabelledBy,\n    \"aria-describedby\": ariaDescribedBy,\n    \"aria-invalid\": ariaInvalid,\n    ...otherProps\n}: UnitNumberInputProps) => {\n    // =============================================================================\n    // CONST, STATE, REF\n    // =============================================================================\n    const [floorValue, _setFloorValue] = useState<string>(\"\");\n    const [unitValue, _setUnitValue] = useState<string>(\"\");\n    const [currentFocus, _setCurrentFocus] = useState<FieldType>(\"none\");\n    const [internalId] = useState<string>(() => SimpleIdGenerator.generate());\n    const floorLabelId = `${internalId}-floor-label`;\n    const unitLabelId = `${internalId}-unit-label`;\n    const liveMessageId = `${internalId}-live-message`;\n\n    const nodeRef = useRef<HTMLDivElement>(null);\n    const floorInputRef = useRef<HTMLInputElement>(null);\n    const unitInputRef = useRef<HTMLInputElement>(null);\n\n    /**\n     * Have to use refs to allow the state values to be accessible\n     * by the event listener callback functions\n     * Reference:\n     * https://stackoverflow.com/questions/55265255/react-usestate-hook-event-handler-using-initial-state\n     */\n\n    const floorValueStateRef = useRef<string>(floorValue);\n    const unitValueStateRef = useRef<string>(unitValue);\n    const currentFocusStateRef = useRef<FieldType>(currentFocus);\n\n    const formatter = (value: string) =>\n        value.toLocaleUpperCase().replace(/[^0-9A-Za-z]/g, \"\");\n    const getNextFloorInputState = useNextInputState({\n        ref: floorInputRef,\n        formatter,\n    });\n    const getNextUnitInputState = useNextInputState({\n        ref: unitInputRef,\n        formatter,\n    });\n\n    const liveMessage = useMemo(() => {\n        let msg = \"\";\n        const floorMsg = formatPhraseWithPrefix(\"Hash\", floorValue);\n        const unitMsg = formatPhraseWithPrefix(\"Dash\", unitValue);\n        switch (currentFocus) {\n            case \"floor\":\n                msg = floorMsg;\n                break;\n            case \"unit\":\n                msg = floorValue ? [floorMsg, unitMsg].join(\" \") : unitMsg;\n                break;\n            default:\n                msg = \"\";\n        }\n        return msg;\n    }, [currentFocus, floorValue, unitValue]);\n\n    // =============================================================================\n    // REF FUNCTIONS\n    // =============================================================================\n    const setFloorValue = (data: string) => {\n        floorValueStateRef.current = data;\n        _setFloorValue(data);\n    };\n\n    const setUnitValue = (data: string) => {\n        unitValueStateRef.current = data;\n        _setUnitValue(data);\n    };\n\n    const setCurrentFocus = (data: FieldType) => {\n        currentFocusStateRef.current = data;\n        _setCurrentFocus(data);\n    };\n\n    // =============================================================================\n    // EFFECTS\n    // =============================================================================\n    useEffect(() => {\n        // Auto focus feature\n        if (\n            currentFocus === \"floor\" &&\n            floorValue.length === 3 &&\n            unitInputRef.current\n        ) {\n            unitInputRef.current.focus();\n        }\n    }, [floorValue]);\n\n    useEffect(() => {\n        updateValues(value);\n    }, [value]);\n\n    // =============================================================================\n    // EVENT HANDLERS\n    // =============================================================================\n    const handleFocus = (event: React.FocusEvent<HTMLInputElement>) => {\n        setCurrentFocus(event.target.name as FieldType);\n        event.target.select();\n    };\n\n    const handleBlur = (event: React.FocusEvent<HTMLInputElement>) => {\n        const targetName = event.target.name as FieldType;\n        const targetValue = event.target.value;\n        const formattedInput = formatInput(targetValue);\n\n        if (targetName === \"floor\") {\n            setFloorValue(formattedInput);\n            if (formattedInput !== floorValue) {\n                performOnChangeHandler(formattedInput, targetName);\n            }\n        } else if (targetName === \"unit\") {\n            setUnitValue(formattedInput);\n            if (formattedInput !== unitValue) {\n                performOnChangeHandler(formattedInput, targetName);\n            }\n        }\n    };\n\n    const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {\n        const targetName = event.target.name as FieldType;\n\n        if (targetName === \"floor\") {\n            const nextInputState = getNextFloorInputState();\n            if (!nextInputState) return;\n\n            const { nextValue, updateCaretPosition } = nextInputState;\n            updateCaretPosition();\n            setFloorValue(nextValue);\n            performOnChangeHandler(nextValue, targetName);\n        } else if (targetName === \"unit\") {\n            const nextInputState = getNextUnitInputState();\n            if (!nextInputState) return;\n\n            const { nextValue, updateCaretPosition } = nextInputState;\n            updateCaretPosition();\n            setUnitValue(nextValue);\n            performOnChangeHandler(nextValue, targetName);\n        }\n    };\n\n    const handleNodeClick = () => {\n        if (currentFocus === \"none\" && floorInputRef.current) {\n            floorInputRef.current.focus();\n        }\n    };\n\n    const handleNodeBlur = (event: React.FocusEvent) => {\n        if (nodeRef.current && nodeRef.current.contains(event.relatedTarget)) {\n            // internal element received focus\n            return;\n        }\n        if (currentFocusStateRef.current !== \"none\") {\n            setCurrentFocus(\"none\");\n            performOnBlurHandler();\n        }\n    };\n\n    const handleKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        /**\n         * Allow going to the field before if user presses Backspace\n         * on an empty field\n         */\n        if (event.code === \"Backspace\" || event.key === \"Backspace\") {\n            if (currentFocus === \"unit\" && unitValue.length === 0) {\n                floorInputRef.current?.focus();\n            }\n        }\n    };\n\n    // =============================================================================\n    // HELPER FUNCTIONS\n    // =============================================================================\n    const formatInput = (value: string) => {\n        return /^[0-9]$/.test(value)\n            ? StringHelper.padValue(value, true)\n            : value.toLocaleUpperCase();\n    };\n\n    const updateValues = (value: string | undefined) => {\n        if (value === INVALID_VALUE) {\n            return;\n        } else if (value === undefined || value.length === 0) {\n            setFloorValue(\"\");\n            setUnitValue(\"\");\n        } else {\n            const valueArr = value.split(\"-\");\n            if (valueArr.length === 2) {\n                // Valid value\n                const floor = valueArr[0];\n                const unit = valueArr[1];\n                setFloorValue(\n                    currentFocus === \"floor\" ? floor : formatInput(floor)\n                );\n                setUnitValue(\n                    currentFocus === \"unit\" ? unit : formatInput(unit)\n                );\n            }\n        }\n    };\n\n    const performOnChangeHandler = (\n        changeValue: string,\n        field: ValueFieldTypes\n    ) => {\n        if (!onChange && !onChangeRaw) {\n            return;\n        }\n\n        const values: Record<ValueFieldTypes, string> = {\n            floor: floorValueStateRef.current,\n            unit: unitValueStateRef.current,\n        };\n\n        // Update the specific field value\n        values[field] = changeValue;\n\n        if (onChange) {\n            const returnValue = getFormattedValue(values);\n            onChange(returnValue);\n        }\n\n        if (onChangeRaw) {\n            onChangeRaw([values.floor, values.unit]);\n        }\n    };\n\n    const performOnBlurHandler = () => {\n        if (!onBlur && !onBlurRaw) {\n            return;\n        }\n\n        const values: Record<ValueFieldTypes, string> = {\n            floor: formatInput(floorValueStateRef.current),\n            unit: formatInput(unitValueStateRef.current),\n        };\n\n        if (onBlur) {\n            const returnValue = getFormattedValue(values);\n            onBlur(returnValue);\n        }\n\n        if (onBlurRaw) {\n            onBlurRaw([values.floor, values.unit]);\n        }\n    };\n\n    const getFormattedValue = (values: Record<ValueFieldTypes, string>) => {\n        const valueArr = [values.floor, values.unit];\n\n        if (values.floor.length > 0 && values.unit.length > 0) {\n            return valueArr.join(\"-\");\n        } else if (valueArr.every((value) => value === \"\")) {\n            return \"\";\n        } else {\n            return INVALID_VALUE;\n        }\n    };\n\n    const getPlaceholder = (value: string) => {\n        return value.split(\"-\");\n    };\n\n    function formatPhraseWithPrefix(prefix: string, v: string) {\n        return v ? `${prefix} ${Array.from(v).join(\" \")}` : \"\";\n    }\n\n    // =============================================================================\n    // RENDER FUNCTION\n    // =============================================================================\n    const renderInputs = () => (\n        <>\n            <FloorInput\n                name=\"floor\"\n                maxLength={3}\n                value={floorValue}\n                ref={floorInputRef}\n                onFocus={handleFocus}\n                onBlur={handleBlur}\n                onChange={handleChange}\n                disabled={disabled}\n                readOnly={readOnly}\n                type=\"text\"\n                pattern=\"[0-9A-Z]{2,3}\"\n                data-testid=\"floor-input\"\n                aria-labelledby={concatIds(ariaLabelledBy, floorLabelId)}\n                aria-describedby={concatIds(ariaDescribedBy, liveMessageId)}\n                aria-invalid={ariaInvalid}\n                placeholder={\n                    currentFocus === \"floor\" && !readOnly && !disabled\n                        ? \"\"\n                        : getPlaceholder(placeholder)[0]\n                }\n                autoComplete={autoComplete}\n                styleType=\"no-border\"\n            />\n            <VisuallyHidden aria-hidden id={floorLabelId}>\n                Enter floor number\n            </VisuallyHidden>\n            <UnitNumberDivider $inactive={floorValue.length === 0}>\n                -\n            </UnitNumberDivider>\n            <UnitInput\n                name=\"unit\"\n                maxLength={5}\n                value={unitValue}\n                ref={unitInputRef}\n                onFocus={handleFocus}\n                onBlur={handleBlur}\n                onChange={handleChange}\n                onKeyDown={handleKeyDown}\n                disabled={disabled}\n                readOnly={readOnly}\n                type=\"text\"\n                pattern=\"[0-9A-Z]{2,5}\"\n                data-testid=\"unit-input\"\n                aria-labelledby={concatIds(ariaLabelledBy, unitLabelId)}\n                aria-describedby={concatIds(ariaDescribedBy, liveMessageId)}\n                aria-invalid={ariaInvalid}\n                placeholder={\n                    currentFocus === \"unit\" && !readOnly && !disabled\n                        ? \"\"\n                        : getPlaceholder(placeholder)[1]\n                }\n                autoComplete={autoComplete}\n                styleType=\"no-border\"\n            />\n            <VisuallyHidden aria-hidden id={unitLabelId}>\n                Enter unit number\n            </VisuallyHidden>\n            {/** Live message for AT reader to read with the combination of prefix and current value for both floor input and unit input */}\n            <VisuallyHidden id={liveMessageId} aria-live=\"polite\">\n                {liveMessage}\n            </VisuallyHidden>\n        </>\n    );\n\n    const renderReadOnly = (displayValue: string) => {\n        const displayValueArr = displayValue.split(\"-\");\n        const liveMessageForReadOnly = [\n            formatPhraseWithPrefix(\"Hash\", displayValueArr[0]),\n            formatPhraseWithPrefix(\"Dash\", displayValueArr[1]),\n        ].join(\" \");\n\n        return (\n            <ReadOnlyContainer\n                data-testid=\"readonly-display\"\n                tabIndex={0}\n                role=\"textbox\"\n                aria-readonly\n                aria-labelledby={ariaLabelledBy}\n                aria-describedby={ariaDescribedBy}\n                aria-invalid={ariaInvalid}\n            >\n                <ReadOnlyLabel>{displayValueArr[0]}</ReadOnlyLabel>\n                <UnitNumberDivider>-</UnitNumberDivider>\n                <ReadOnlyLabel>{displayValueArr[1]}</ReadOnlyLabel>\n                <VisuallyHidden>{liveMessageForReadOnly}</VisuallyHidden>\n            </ReadOnlyContainer>\n        );\n    };\n\n    return (\n        <InputWrapper\n            {...otherProps}\n            ref={nodeRef}\n            onClick={handleNodeClick}\n            $disabled={disabled}\n            $error={error}\n            $readOnly={readOnly}\n            tabIndex={-1}\n            onBlur={handleNodeBlur}\n        >\n            <HashContainer\n                data-testid=\"addon\"\n                $disabled={disabled}\n                $readOnly={readOnly}\n            >\n                #\n            </HashContainer>\n            {readOnly && value ? renderReadOnly(value) : renderInputs()}\n        </InputWrapper>\n    );\n};\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\nconst INVALID_VALUE = \"Invalid unit number\";\n"],"names":["UnitNumberInput","_a","disabled","error","value","onChange","onBlur","onChangeRaw","onBlurRaw","readOnly","placeholder","autoComplete","ariaLabelledBy","ariaDescribedBy","ariaInvalid","otherProps","__rest","floorValue","_setFloorValue","useState","unitValue","_setUnitValue","currentFocus","_setCurrentFocus","internalId","SimpleIdGenerator","generate","floorLabelId","unitLabelId","liveMessageId","nodeRef","useRef","floorInputRef","unitInputRef","floorValueStateRef","unitValueStateRef","currentFocusStateRef","formatter","toLocaleUpperCase","replace","getNextFloorInputState","useNextInputState","ref","getNextUnitInputState","liveMessage","useMemo","msg","floorMsg","formatPhraseWithPrefix","unitMsg","join","setFloorValue","data","current","setUnitValue","setCurrentFocus","useEffect","length","focus","updateValues","handleFocus","event","target","name","select","handleBlur","targetName","targetValue","formattedInput","formatInput","performOnChangeHandler","handleChange","nextInputState","nextValue","updateCaretPosition","handleKeyDown","code","key","test","StringHelper","padValue","INVALID_VALUE","undefined","valueArr","split","floor","unit","changeValue","field","values","returnValue","getFormattedValue","performOnBlurHandler","every","getPlaceholder","prefix","v","Array","from","_jsxs","InputWrapper","Object","assign","onClick","$error","$readOnly","tabIndex","contains","relatedTarget","_jsx","HashContainer","$disabled","children","displayValue","displayValueArr","liveMessageForReadOnly","ReadOnlyContainer","role","ReadOnlyLabel","UnitNumberDivider","VisuallyHidden","renderReadOnly","_Fragment","FloorInput","maxLength","onFocus","type","pattern","concatIds","styleType","id","$inactive","UnitInput","onKeyDown"],"mappings":"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"}
+{"version":3,"file":"unit-number-input.js","sources":["../../src/unit-number/unit-number-input.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport type React from \"react\";\nimport { useEffect, useMemo, useRef, useState } from \"react\";\n\nimport { Input } from \"../input\";\nimport * as inputGroupStyles from \"../input-group/input-group.styles\";\nimport { concatIds, VisuallyHidden } from \"../shared/accessibility\";\nimport { InputWrapper } from \"../shared/input-wrapper\";\nimport { Typography } from \"../typography\";\nimport { StringHelper, useId, useNextInputState } from \"../util\";\nimport type { UnitNumberInputProps } from \"./types\";\nimport * as styles from \"./unit-number-input.styles\";\n\ntype FieldType = \"floor\" | \"unit\" | \"none\";\ntype ValueFieldTypes = Exclude<FieldType, \"none\">;\n\nexport const UnitNumberInput = ({\n    disabled,\n    error,\n    value,\n    onChange,\n    onBlur,\n    onChangeRaw,\n    onBlurRaw,\n    readOnly,\n    placeholder = \"00-8888\",\n    autoComplete,\n    \"aria-labelledby\": ariaLabelledBy,\n    \"aria-describedby\": ariaDescribedBy,\n    \"aria-invalid\": ariaInvalid,\n    className,\n    ...otherProps\n}: UnitNumberInputProps) => {\n    // =============================================================================\n    // CONST, STATE, REF\n    // =============================================================================\n    const [floorValue, _setFloorValue] = useState<string>(\"\");\n    const [unitValue, _setUnitValue] = useState<string>(\"\");\n    const [currentFocus, _setCurrentFocus] = useState<FieldType>(\"none\");\n    const internalId = useId();\n    const floorLabelId = `${internalId}-floor-label`;\n    const unitLabelId = `${internalId}-unit-label`;\n    const liveMessageId = `${internalId}-live-message`;\n\n    const nodeRef = useRef<HTMLDivElement>(null);\n    const floorInputRef = useRef<HTMLInputElement>(null);\n    const unitInputRef = useRef<HTMLInputElement>(null);\n\n    /**\n     * Have to use refs to allow the state values to be accessible\n     * by the event listener callback functions\n     * Reference:\n     * https://stackoverflow.com/questions/55265255/react-usestate-hook-event-handler-using-initial-state\n     */\n\n    const floorValueStateRef = useRef<string>(floorValue);\n    const unitValueStateRef = useRef<string>(unitValue);\n    const currentFocusStateRef = useRef<FieldType>(currentFocus);\n\n    const formatter = (value: string) =>\n        value.toLocaleUpperCase().replace(/[^0-9A-Za-z]/g, \"\");\n    const getNextFloorInputState = useNextInputState({\n        ref: floorInputRef,\n        formatter,\n    });\n    const getNextUnitInputState = useNextInputState({\n        ref: unitInputRef,\n        formatter,\n    });\n\n    const liveMessage = useMemo(() => {\n        let msg = \"\";\n        const floorMsg = formatPhraseWithPrefix(\"Hash\", floorValue);\n        const unitMsg = formatPhraseWithPrefix(\"Dash\", unitValue);\n        switch (currentFocus) {\n            case \"floor\":\n                msg = floorMsg;\n                break;\n            case \"unit\":\n                msg = floorValue ? [floorMsg, unitMsg].join(\" \") : unitMsg;\n                break;\n            default:\n                msg = \"\";\n        }\n        return msg;\n    }, [currentFocus, floorValue, unitValue]);\n\n    // =============================================================================\n    // REF FUNCTIONS\n    // =============================================================================\n    const setFloorValue = (data: string) => {\n        floorValueStateRef.current = data;\n        _setFloorValue(data);\n    };\n\n    const setUnitValue = (data: string) => {\n        unitValueStateRef.current = data;\n        _setUnitValue(data);\n    };\n\n    const setCurrentFocus = (data: FieldType) => {\n        currentFocusStateRef.current = data;\n        _setCurrentFocus(data);\n    };\n\n    // =============================================================================\n    // EFFECTS\n    // =============================================================================\n    useEffect(() => {\n        // Auto focus feature\n        if (\n            currentFocus === \"floor\" &&\n            floorValue.length === 3 &&\n            unitInputRef.current\n        ) {\n            unitInputRef.current.focus();\n        }\n    }, [floorValue]);\n\n    useEffect(() => {\n        updateValues(value);\n    }, [value]);\n\n    // =============================================================================\n    // EVENT HANDLERS\n    // =============================================================================\n    const handleFocus = (event: React.FocusEvent<HTMLInputElement>) => {\n        setCurrentFocus(event.target.name as FieldType);\n        event.target.select();\n    };\n\n    const handleBlur = (event: React.FocusEvent<HTMLInputElement>) => {\n        const targetName = event.target.name as FieldType;\n        const targetValue = event.target.value;\n        const formattedInput = formatInput(targetValue);\n\n        if (targetName === \"floor\") {\n            setFloorValue(formattedInput);\n            if (formattedInput !== floorValue) {\n                performOnChangeHandler(formattedInput, targetName);\n            }\n        } else if (targetName === \"unit\") {\n            setUnitValue(formattedInput);\n            if (formattedInput !== unitValue) {\n                performOnChangeHandler(formattedInput, targetName);\n            }\n        }\n    };\n\n    const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {\n        const targetName = event.target.name as FieldType;\n\n        if (targetName === \"floor\") {\n            const nextInputState = getNextFloorInputState();\n            if (!nextInputState) return;\n\n            const { nextValue, updateCaretPosition } = nextInputState;\n            updateCaretPosition();\n            setFloorValue(nextValue);\n            performOnChangeHandler(nextValue, targetName);\n        } else if (targetName === \"unit\") {\n            const nextInputState = getNextUnitInputState();\n            if (!nextInputState) return;\n\n            const { nextValue, updateCaretPosition } = nextInputState;\n            updateCaretPosition();\n            setUnitValue(nextValue);\n            performOnChangeHandler(nextValue, targetName);\n        }\n    };\n\n    const handleNodeClick = () => {\n        if (currentFocus === \"none\" && floorInputRef.current) {\n            floorInputRef.current.focus();\n        }\n    };\n\n    const handleNodeBlur = (event: React.FocusEvent) => {\n        if (nodeRef.current && nodeRef.current.contains(event.relatedTarget)) {\n            // internal element received focus\n            return;\n        }\n        if (currentFocusStateRef.current !== \"none\") {\n            setCurrentFocus(\"none\");\n            performOnBlurHandler();\n        }\n    };\n\n    const handleKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        /**\n         * Allow going to the field before if user presses Backspace\n         * on an empty field\n         */\n        if (event.code === \"Backspace\" || event.key === \"Backspace\") {\n            if (currentFocus === \"unit\" && unitValue.length === 0) {\n                floorInputRef.current?.focus();\n            }\n        }\n    };\n\n    // =============================================================================\n    // HELPER FUNCTIONS\n    // =============================================================================\n    const formatInput = (value: string) => {\n        return /^[0-9]$/.test(value)\n            ? StringHelper.padValue(value, true)\n            : value.toLocaleUpperCase();\n    };\n\n    const updateValues = (value: string | undefined) => {\n        if (value === INVALID_VALUE) {\n            return;\n        } else if (value === undefined || value.length === 0) {\n            setFloorValue(\"\");\n            setUnitValue(\"\");\n        } else {\n            const valueArr = value.split(\"-\");\n            if (valueArr.length === 2) {\n                // Valid value\n                const floor = valueArr[0];\n                const unit = valueArr[1];\n                setFloorValue(\n                    currentFocus === \"floor\" ? floor : formatInput(floor)\n                );\n                setUnitValue(\n                    currentFocus === \"unit\" ? unit : formatInput(unit)\n                );\n            }\n        }\n    };\n\n    const performOnChangeHandler = (\n        changeValue: string,\n        field: ValueFieldTypes\n    ) => {\n        if (!onChange && !onChangeRaw) {\n            return;\n        }\n\n        const values: Record<ValueFieldTypes, string> = {\n            floor: floorValueStateRef.current,\n            unit: unitValueStateRef.current,\n        };\n\n        // Update the specific field value\n        values[field] = changeValue;\n\n        if (onChange) {\n            const returnValue = getFormattedValue(values);\n            onChange(returnValue);\n        }\n\n        if (onChangeRaw) {\n            onChangeRaw([values.floor, values.unit]);\n        }\n    };\n\n    const performOnBlurHandler = () => {\n        if (!onBlur && !onBlurRaw) {\n            return;\n        }\n\n        const values: Record<ValueFieldTypes, string> = {\n            floor: formatInput(floorValueStateRef.current),\n            unit: formatInput(unitValueStateRef.current),\n        };\n\n        if (onBlur) {\n            const returnValue = getFormattedValue(values);\n            onBlur(returnValue);\n        }\n\n        if (onBlurRaw) {\n            onBlurRaw([values.floor, values.unit]);\n        }\n    };\n\n    const getFormattedValue = (values: Record<ValueFieldTypes, string>) => {\n        const valueArr = [values.floor, values.unit];\n\n        if (values.floor.length > 0 && values.unit.length > 0) {\n            return valueArr.join(\"-\");\n        } else if (valueArr.every((value) => value === \"\")) {\n            return \"\";\n        } else {\n            return INVALID_VALUE;\n        }\n    };\n\n    const getPlaceholder = (value: string) => {\n        return value.split(\"-\");\n    };\n\n    function formatPhraseWithPrefix(prefix: string, v: string) {\n        return v ? `${prefix} ${Array.from(v).join(\" \")}` : \"\";\n    }\n\n    // =============================================================================\n    // RENDER FUNCTION\n    // =============================================================================\n    const renderInputs = () => (\n        <>\n            <Input\n                name=\"floor\"\n                maxLength={3}\n                value={floorValue}\n                ref={floorInputRef}\n                onFocus={handleFocus}\n                onBlur={handleBlur}\n                onChange={handleChange}\n                disabled={disabled}\n                readOnly={readOnly}\n                type=\"text\"\n                pattern=\"[0-9A-Z]{2,3}\"\n                data-testid=\"floor-input\"\n                aria-labelledby={concatIds(ariaLabelledBy, floorLabelId)}\n                aria-describedby={concatIds(ariaDescribedBy, liveMessageId)}\n                aria-invalid={ariaInvalid}\n                placeholder={\n                    currentFocus === \"floor\" && !readOnly && !disabled\n                        ? \"\"\n                        : getPlaceholder(placeholder)[0]\n                }\n                autoComplete={autoComplete}\n                styleType=\"no-border\"\n                className={clsx(styles.input, styles.floorInput)}\n            />\n            <VisuallyHidden aria-hidden id={floorLabelId}>\n                Enter floor number\n            </VisuallyHidden>\n            <Typography.BodyBL\n                className={clsx(\n                    styles.unitNumberDivider,\n                    floorValue.length === 0 && styles.unitNumberDividerInactive\n                )}\n            >\n                -\n            </Typography.BodyBL>\n            <Input\n                name=\"unit\"\n                maxLength={5}\n                value={unitValue}\n                ref={unitInputRef}\n                onFocus={handleFocus}\n                onBlur={handleBlur}\n                onChange={handleChange}\n                onKeyDown={handleKeyDown}\n                disabled={disabled}\n                readOnly={readOnly}\n                type=\"text\"\n                pattern=\"[0-9A-Z]{2,5}\"\n                data-testid=\"unit-input\"\n                aria-labelledby={concatIds(ariaLabelledBy, unitLabelId)}\n                aria-describedby={concatIds(ariaDescribedBy, liveMessageId)}\n                aria-invalid={ariaInvalid}\n                placeholder={\n                    currentFocus === \"unit\" && !readOnly && !disabled\n                        ? \"\"\n                        : getPlaceholder(placeholder)[1]\n                }\n                autoComplete={autoComplete}\n                styleType=\"no-border\"\n                className={clsx(\n                    styles.input,\n                    styles.floorInput,\n                    styles.unitInput\n                )}\n            />\n            <VisuallyHidden aria-hidden id={unitLabelId}>\n                Enter unit number\n            </VisuallyHidden>\n            {/** Live message for AT reader to read with the combination of prefix and current value for both floor input and unit input */}\n            <VisuallyHidden id={liveMessageId} aria-live=\"polite\">\n                {liveMessage}\n            </VisuallyHidden>\n        </>\n    );\n\n    const renderReadOnly = (displayValue: string) => {\n        const displayValueArr = displayValue.split(\"-\");\n        const liveMessageForReadOnly = [\n            formatPhraseWithPrefix(\"Hash\", displayValueArr[0]),\n            formatPhraseWithPrefix(\"Dash\", displayValueArr[1]),\n        ].join(\" \");\n\n        return (\n            <div\n                data-testid=\"readonly-display\"\n                tabIndex={0}\n                role=\"textbox\"\n                aria-readonly\n                aria-labelledby={ariaLabelledBy}\n                aria-describedby={ariaDescribedBy}\n                aria-invalid={ariaInvalid}\n                className={styles.readOnlyContainer}\n            >\n                <Typography.BodyBL>{displayValueArr[0]}</Typography.BodyBL>\n                <Typography.BodyBL className={styles.unitNumberDivider}>\n                    -\n                </Typography.BodyBL>\n                <Typography.BodyBL>{displayValueArr[1]}</Typography.BodyBL>\n                <VisuallyHidden>{liveMessageForReadOnly}</VisuallyHidden>\n            </div>\n        );\n    };\n\n    return (\n        <InputWrapper\n            {...otherProps}\n            ref={nodeRef}\n            onClick={handleNodeClick}\n            disabled={disabled}\n            error={error}\n            readOnly={readOnly}\n            tabIndex={-1}\n            onBlur={handleNodeBlur}\n            className={className}\n        >\n            <div\n                data-testid=\"addon\"\n                className={clsx(\n                    styles.hashContainer,\n                    inputGroupStyles.labelAddonContainer\n                )}\n                data-disabled={disabled}\n                data-read-only={readOnly}\n            >\n                #\n            </div>\n            {readOnly && value ? renderReadOnly(value) : renderInputs()}\n        </InputWrapper>\n    );\n};\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\nconst INVALID_VALUE = \"Invalid unit number\";\n"],"names":["UnitNumberInput","_a","disabled","error","value","onChange","onBlur","onChangeRaw","onBlurRaw","readOnly","placeholder","autoComplete","ariaLabelledBy","ariaDescribedBy","ariaInvalid","className","otherProps","__rest","floorValue","_setFloorValue","useState","unitValue","_setUnitValue","currentFocus","_setCurrentFocus","internalId","useId","floorLabelId","unitLabelId","liveMessageId","nodeRef","useRef","floorInputRef","unitInputRef","floorValueStateRef","unitValueStateRef","currentFocusStateRef","formatter","toLocaleUpperCase","replace","getNextFloorInputState","useNextInputState","ref","getNextUnitInputState","liveMessage","useMemo","msg","floorMsg","formatPhraseWithPrefix","unitMsg","join","setFloorValue","data","current","setUnitValue","setCurrentFocus","useEffect","length","focus","updateValues","handleFocus","event","target","name","select","handleBlur","targetName","targetValue","formattedInput","formatInput","performOnChangeHandler","handleChange","nextInputState","nextValue","updateCaretPosition","handleKeyDown","code","key","test","StringHelper","padValue","INVALID_VALUE","undefined","valueArr","split","floor","unit","changeValue","field","values","returnValue","getFormattedValue","performOnBlurHandler","every","getPlaceholder","prefix","v","Array","from","_jsxs","InputWrapper","Object","assign","onClick","tabIndex","contains","relatedTarget","children","_jsx","clsx","styles.hashContainer","inputGroupStyles.labelAddonContainer","displayValue","displayValueArr","liveMessageForReadOnly","role","styles.readOnlyContainer","Typography","BodyBL","styles.unitNumberDivider","VisuallyHidden","renderReadOnly","_Fragment","Input","maxLength","onFocus","type","pattern","concatIds","styleType","styles.input","styles.floorInput","id","styles.unitNumberDividerInactive","onKeyDown","styles.unitInput"],"mappings":"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"}

package/unit-number/unit-number-input.styles.d.ts

@@ -0,0 +1,7 @@
+export declare const hashContainer: import("@linaria/core").LinariaClassName;
+export declare const input: import("@linaria/core").LinariaClassName;
+export declare const floorInput: import("@linaria/core").LinariaClassName;
+export declare const unitInput: import("@linaria/core").LinariaClassName;
+export declare const unitNumberDivider: import("@linaria/core").LinariaClassName;
+export declare const unitNumberDividerInactive: import("@linaria/core").LinariaClassName;
+export declare const readOnlyContainer: import("@linaria/core").LinariaClassName;

package/unit-number/unit-number-input.styles.js

@@ -0,0 +1,2 @@
+import"./unit-number-input.styles_8yizj.css";const t="h1ujh1ah",u="i1a7rbgo",r="fqv7th5",i="u1g8qqjx",n="u52196f",s="urthzty",h="rwsbmaf";export{r as floorInput,t as hashContainer,u as input,h as readOnlyContainer,i as unitInput,n as unitNumberDivider,s as unitNumberDividerInactive};
+//# sourceMappingURL=unit-number-input.styles.js.map

package/unit-number/unit-number-input.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-number-input.styles.js","sources":["../../src/unit-number/unit-number-input.styles.ts"],"sourcesContent":["import { css } from \"@linaria/core\";\n\nimport { Colour } from \"../theme\";\n\nexport const hashContainer = css`\n    margin-right: 0.5rem;\n`;\n\nexport const input = css`\n    input {\n        text-align: center;\n    }\n`;\n\nexport const floorInput = css`\n    width: 2.5rem;\n`;\n\nexport const unitInput = css`\n    /* Cheat to balance the placeholder look while ensuring enough width */\n    margin-left: 0.5rem;\n    width: 6rem;\n\n    input {\n        text-align: left;\n    }\n`;\n\nexport const unitNumberDivider = css`\n    margin: 0 0.25rem;\n`;\n\nexport const unitNumberDividerInactive = css`\n    color: ${Colour[\"text-disabled\"]};\n`;\n\nexport const readOnlyContainer = css`\n    display: flex;\n    align-items: center;\n    height: calc(3rem - 2px); /* exclude top and bottom borders */\n`;\n"],"names":["hashContainer","input","floorInput","unitInput","unitNumberDivider","unitNumberDividerInactive","readOnlyContainer"],"mappings":"wEAIO,MAAMA,EAAa,WAIbC,EAAK,WAMLC,EAAU,UAIVC,EAAS,WAUTC,EAAiB,UAIjBC,EAAyB,UAIzBC,EAAiB"}

package/unit-number/unit-number-input.styles_8yizj.css

@@ -0,0 +1,7 @@
+.h1ujh1ah{margin-right:0.5rem;}
+.i1a7rbgo input{text-align:center;}
+.fqv7th5{width:2.5rem;}
+.u1g8qqjx{margin-left:0.5rem;width:6rem;}.u1g8qqjx input{text-align:left;}
+.u52196f{margin:0 0.25rem;}
+.urthzty{color:var(--fds-colour-text-disabled);}
+.rwsbmaf{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;height:calc(3rem - 2px);}

package/util/simple-id-generator.d.ts

@@ -4,3 +4,4 @@ export declare class SimpleIdGenerator {
      */
     static generate(): string;
 }
+export declare const useId: () => string;

package/util/simple-id-generator.js

@@ -1,2 +1,2 @@
-class t{static generate(){return Math.random().toString(36).substring(2,9)}}export{t as SimpleIdGenerator};
+import t from"react";var r;class e{static generate(){return Math.random().toString(36).substring(2,9)}}const n=null!==(r=t.useId)&&void 0!==r?r:()=>{const[r]=t.useState((()=>e.generate()));return r};export{e as SimpleIdGenerator,n as useId};
 //# sourceMappingURL=simple-id-generator.js.map

package/util/simple-id-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"simple-id-generator.js","sources":["../../src/util/simple-id-generator.ts"],"sourcesContent":["export class SimpleIdGenerator {\n    /**\n     * Generates a simple generator for element ids\n     */\n    public static generate(): string {\n        return Math.random().toString(36).substring(2, 9);\n    }\n}\n"],"names":["SimpleIdGenerator","generate","Math","random","toString","substring"],"mappings":"MAAaA,EAIF,eAAOC,GACV,OAAOC,KAAKC,SAASC,SAAS,IAAIC,UAAU,EAAG,EACnD"}
+{"version":3,"file":"simple-id-generator.js","sources":["../../src/util/simple-id-generator.ts"],"sourcesContent":["import React from \"react\";\n\nexport class SimpleIdGenerator {\n    /**\n     * Generates a simple generator for element ids\n     */\n    public static generate(): string {\n        return Math.random().toString(36).substring(2, 9);\n    }\n}\n\nconst useSimpleId = () => {\n    const [id] = React.useState(() => SimpleIdGenerator.generate());\n    return id;\n};\n\n// TODO: can be removed when React 17 support is dropped\n// @ts-expect-error useId is only available in React 18+\nexport const useId: () => string = React.useId ?? useSimpleId;\n"],"names":["SimpleIdGenerator","generate","Math","random","toString","substring","useId","_a","React","id","useState"],"mappings":"iCAEaA,EAIF,eAAOC,GACV,OAAOC,KAAKC,SAASC,SAAS,IAAIC,UAAU,EAAG,EACnD,EAGJ,MAOaC,EAAiC,QAAXC,EAAAC,EAAMF,aAAK,IAAAC,EAAAA,EAP1B,KAChB,MAAOE,GAAMD,EAAME,UAAS,IAAMV,EAAkBC,aACpD,OAAOQ,CAAE"}

package/util/string-helper.d.ts

@@ -50,5 +50,6 @@ export declare class StringHelper {
     private static suffixes;
     static formatOrdinal(n: number): string;
     static getMaskedDescription(value: string, displayMaskState: "masked" | "unmasked", maskRange?: number[]): string;
+    static joinNonEmptyStrings(strings: (string | undefined | null)[], delimiter?: string): string;
 }
 export {};

package/util/string-helper.js

@@ -1,2 +1,2 @@
-class t{static transformWithSpaces(t,e){const n="(.{"+e+"})";return t.replace(/[^\dA-Z]/gi,"").replace(new RegExp(n,"g"),"$1 ").trim()}static padValue(t,e){if("0"===t)return e?t:t.padStart(2,"0");if(""===t)return t;return parseInt(t).toString().padStart(2,"0")}static shouldTruncateToTwoLines(t,e){const n=Math.floor(e/9);return t.length>=2*n||1===t.split(" ").length&&t.length>n}static truncateOneLine(t,e,n,r,s=8){let a=0;e>n&&(a=Math.floor((e-n)/s));const i=r+a;if(i<t.length){const e=Math.floor(i/2);return t.substring(0,e)+" ... "+t.substring(t.length-e,t.length)}return t}static truncateTwoLines(t,e,n,r=1.2){const s=Math.floor(2*e/(.6*n))*(2/r);if(t.length<=s)return t;const a=Math.floor(.6*s),i=Math.floor(.2*s);return`${t.substring(0,a)}...${t.substring(t.length-i)}`}static getTextWidth(e,n){if("undefined"==typeof document)return 0;const r=(t.getTextWidth.canvas||(t.getTextWidth.canvas=document.createElement("canvas"))).getContext("2d");r.font=n;return r.measureText(e).width}static maskValue(e,n){if(!e)return e;const{maskRange:r,unmaskRange:s,maskChar:a="•",maskRegex:i,maskTransformer:u}=n;if(u)return u(e);if(i)return e.replace(i,a);if(r){const{startIndex:n,endIndex:s}=t.determineStartAndEndIndex(r[0],r[1]);return e.substring(0,n)+a.repeat(e.substring(n,s+1).length)+e.substring(s+1)}if(s){const{startIndex:n,endIndex:r}=t.determineStartAndEndIndex(s[0],s[1]);return a.repeat(e.substring(0,n).length)+e.substring(n,r+1)+a.repeat(e.substring(r+1).length)}return e}static determineStartAndEndIndex(t,e){return t<e?{startIndex:t,endIndex:e}:{startIndex:e,endIndex:t}}static formatOrdinal(e){const n=t.ordinalPluralRules.select(e);return`${e}${t.suffixes.get(n)}`}static getMaskedDescription(t,e,n){if(!t||"masked"!==e||!n)return"";const[r,s]=n,a=r>0,i=s<t.length-1,u=a?t.substring(0,r):"",d=i?t.substring(s+1):"";return a&&i?`Starting with ${u} and ending with ${d}`:a?`Starting with ${u}`:i?`Ending with ${d}`:""}}t.ordinalPluralRules=new Intl.PluralRules("en",{type:"ordinal"}),t.suffixes=new Map([["one","st"],["two","nd"],["few","rd"],["other","th"]]);export{t as StringHelper};
+class t{static transformWithSpaces(t,e){const n="(.{"+e+"})";return t.replace(/[^\dA-Z]/gi,"").replace(new RegExp(n,"g"),"$1 ").trim()}static padValue(t,e){if("0"===t)return e?t:t.padStart(2,"0");if(""===t)return t;return parseInt(t).toString().padStart(2,"0")}static shouldTruncateToTwoLines(t,e){const n=Math.floor(e/9);return t.length>=2*n||1===t.split(" ").length&&t.length>n}static truncateOneLine(t,e,n,r,s=8){let a=0;e>n&&(a=Math.floor((e-n)/s));const i=r+a;if(i<t.length){const e=Math.floor(i/2);return t.substring(0,e)+" ... "+t.substring(t.length-e,t.length)}return t}static truncateTwoLines(t,e,n,r=1.2){const s=Math.floor(2*e/(.6*n))*(2/r);if(t.length<=s)return t;const a=Math.floor(.6*s),i=Math.floor(.2*s);return`${t.substring(0,a)}...${t.substring(t.length-i)}`}static getTextWidth(e,n){if("undefined"==typeof document)return 0;const r=(t.getTextWidth.canvas||(t.getTextWidth.canvas=document.createElement("canvas"))).getContext("2d");r.font=n;return r.measureText(e).width}static maskValue(e,n){if(!e)return e;const{maskRange:r,unmaskRange:s,maskChar:a="•",maskRegex:i,maskTransformer:u}=n;if(u)return u(e);if(i)return e.replace(i,a);if(r){const{startIndex:n,endIndex:s}=t.determineStartAndEndIndex(r[0],r[1]);return e.substring(0,n)+a.repeat(e.substring(n,s+1).length)+e.substring(s+1)}if(s){const{startIndex:n,endIndex:r}=t.determineStartAndEndIndex(s[0],s[1]);return a.repeat(e.substring(0,n).length)+e.substring(n,r+1)+a.repeat(e.substring(r+1).length)}return e}static determineStartAndEndIndex(t,e){return t<e?{startIndex:t,endIndex:e}:{startIndex:e,endIndex:t}}static formatOrdinal(e){const n=t.ordinalPluralRules.select(e);return`${e}${t.suffixes.get(n)}`}static getMaskedDescription(t,e,n){if(!t||"masked"!==e||!n)return"";const[r,s]=n,a=r>0,i=s<t.length-1,u=a?t.substring(0,r):"",o=i?t.substring(s+1):"";return a&&i?`Starting with ${u} and ending with ${o}`:a?`Starting with ${u}`:i?`Ending with ${o}`:""}static joinNonEmptyStrings(t,e=", "){return t.filter(Boolean).join(e)}}t.ordinalPluralRules=new Intl.PluralRules("en",{type:"ordinal"}),t.suffixes=new Map([["one","st"],["two","nd"],["few","rd"],["other","th"]]);export{t as StringHelper};
 //# sourceMappingURL=string-helper.js.map

package/util/string-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"string-helper.js","sources":["../../src/util/string-helper.ts"],"sourcesContent":["// =============================================================================\n// TYPINGS\n// =============================================================================\ninterface MaskValueOptions {\n    maskRange?: number[] | undefined;\n    unmaskRange?: number[] | undefined;\n    maskRegex?: RegExp | undefined;\n    maskTransformer?: ((value: string) => string) | undefined;\n    maskChar?: string | undefined;\n}\n\n// =============================================================================\n// EXPORTS\n// =============================================================================\nexport class StringHelper {\n    public static transformWithSpaces(\n        value: string | any,\n        groupLength: number\n    ): string {\n        const regex = \"(.{\" + groupLength + \"})\";\n        return value\n            .replace(/[^\\dA-Z]/gi, \"\")\n            .replace(new RegExp(regex, \"g\"), \"$1 \")\n            .trim();\n    }\n\n    /**\n     * Pads single digit values with a zero and trims leading zero for\n     * values of length more than 2\n     * @param value the string value\n     * @param retainSingleZero setting true will allow single zero value\n     */\n    public static padValue(value: string, retainSingleZero?: boolean): string {\n        if (value === \"0\") {\n            return retainSingleZero ? value : value.padStart(2, \"0\");\n        }\n\n        if (value === \"\") {\n            return value;\n        }\n\n        const trimmedValue = parseInt(value);\n        return trimmedValue.toString().padStart(2, \"0\");\n    }\n\n    /**\n     * Checks if the text is required to be truncated and broken into two lines based\n     * on the available width of container. **Note: This is relevant to font size 18px or 1.125rem only **\n     * @param text input text\n     * @param widthOfElement element width in px\n     */\n    public static shouldTruncateToTwoLines(\n        text: string,\n        widthOfElement: number\n    ): boolean {\n        // This is arbitrary and based on tests to derive that every 9px increment ~= 1 char length.\n        // But this applies to font size 18px or 1.125rem only\n        const estimatedCharOnLine = Math.floor(widthOfElement / 9);\n        return (\n            text.length >= estimatedCharOnLine * 2 ||\n            (text.split(\" \").length === 1 && text.length > estimatedCharOnLine)\n        );\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param minDivSize the minimum container size (using size on mobileS viewport as baseline)\n     * @param baselineCharLength the baseline amount of characters to be displayed before truncation kicks. This\n     * will be increased if there is more space available (derived from `widthOfElement`)\n     * @param incrementFactor the size (in px).\n     */\n    public static truncateOneLine(\n        text: string,\n        widthOfElement: number,\n        minDivSize: number,\n        baselineCharLength: number,\n        incrementFactor = 8 // Arbitrary based on tests and applies to font size of 18px or 1.125rem\n    ): string {\n        let additionalCharAllowed = 0;\n        if (widthOfElement > minDivSize) {\n            additionalCharAllowed = Math.floor(\n                (widthOfElement - minDivSize) / incrementFactor\n            );\n        }\n        const allowedCharLength = baselineCharLength + additionalCharAllowed;\n        if (allowedCharLength < text.length) {\n            const thresholdIndex = Math.floor(allowedCharLength / 2); // We will cut it halfway to derive x num of characters\n            return (\n                text.substring(0, thresholdIndex) + // Use the first x\n                \" ... \" +\n                text.substring(text.length - thresholdIndex, text.length) // Use the last x\n            );\n        }\n\n        return text;\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param fontSize the fontsize of the text\n     * @param lineHeight the line height of the text\n     */\n    public static truncateTwoLines(\n        text: string,\n        widthOfElement: number,\n        fontSize: number,\n        lineHeight = 1.2\n    ): string {\n        // Estimate characters per line based on width and font size\n        const charsPerLine = Math.floor(\n            (widthOfElement * 2) / (fontSize * 0.6) // 0.6 is an approximation for average char width\n        );\n\n        // Calculate total characters allowed in two lines\n        const totalCharsAllowed = charsPerLine * (2 / lineHeight);\n\n        if (text.length <= totalCharsAllowed) {\n            return text; // No truncation needed\n        }\n\n        // Calculate the number of characters to keep\n        const keepFromStart = Math.floor(totalCharsAllowed * 0.6); // Keep 60% from start\n        const keepFromEnd = Math.floor(totalCharsAllowed * 0.2); // Keep 20% from end\n\n        // Truncate the text\n        const start = text.substring(0, keepFromStart);\n        const end = text.substring(text.length - keepFromEnd);\n\n        return `${start}...${end}`;\n    }\n\n    /**\n     * Returns the width of the text in the specified font\n     * https://stackoverflow.com/questions/118241/calculate-text-width-with-javascript/21015393#21015393\n     */\n    public static getTextWidth(text: string, font: string): number {\n        if (typeof document === \"undefined\") {\n            return 0;\n        }\n\n        // create a reusable canvas object for better performance\n        const canvas =\n            (StringHelper.getTextWidth as any).canvas ||\n            ((StringHelper.getTextWidth as any).canvas =\n                document.createElement(\"canvas\"));\n        const context = canvas.getContext(\"2d\");\n        context.font = font;\n\n        const metrics = context.measureText(text);\n        return metrics.width;\n    }\n\n    public static maskValue(value: string, options: MaskValueOptions): string {\n        if (!value) {\n            return value;\n        }\n\n        const {\n            maskRange,\n            unmaskRange,\n            maskChar = \"•\",\n            maskRegex,\n            maskTransformer,\n        } = options;\n\n        if (maskTransformer) {\n            return maskTransformer(value);\n        } else if (maskRegex) {\n            return value.replace(maskRegex, maskChar);\n        } else if (maskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    maskRange[0],\n                    maskRange[1]\n                );\n            return (\n                value.substring(0, startIndex) +\n                maskChar.repeat(\n                    value.substring(startIndex, endIndex + 1).length\n                ) +\n                value.substring(endIndex + 1)\n            );\n        } else if (unmaskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    unmaskRange[0],\n                    unmaskRange[1]\n                );\n            return (\n                maskChar.repeat(value.substring(0, startIndex).length) +\n                value.substring(startIndex, endIndex + 1) +\n                maskChar.repeat(value.substring(endIndex + 1).length)\n            );\n        }\n\n        return value;\n    }\n\n    private static determineStartAndEndIndex(index0: number, index1: number) {\n        return index0 < index1\n            ? { startIndex: index0, endIndex: index1 }\n            : { startIndex: index1, endIndex: index0 };\n    }\n\n    private static ordinalPluralRules = new Intl.PluralRules(\"en\", {\n        type: \"ordinal\",\n    });\n\n    private static suffixes = new Map([\n        [\"one\", \"st\"],\n        [\"two\", \"nd\"],\n        [\"few\", \"rd\"],\n        [\"other\", \"th\"],\n    ]);\n\n    public static formatOrdinal(n: number) {\n        const rule = StringHelper.ordinalPluralRules.select(n);\n        const suffix = StringHelper.suffixes.get(rule);\n        return `${n}${suffix}`;\n    }\n\n    public static getMaskedDescription(\n        value: string,\n        displayMaskState: \"masked\" | \"unmasked\",\n        maskRange?: number[]\n    ): string {\n        if (!value || displayMaskState !== \"masked\" || !maskRange) return \"\";\n\n        const [startIndex, endIndex] = maskRange;\n        const hasStart = startIndex > 0;\n        const hasEnd = endIndex < value.length - 1;\n\n        const start = hasStart ? value.substring(0, startIndex) : \"\";\n        const end = hasEnd ? value.substring(endIndex + 1) : \"\";\n\n        if (hasStart && hasEnd)\n            return `Starting with ${start} and ending with ${end}`;\n        if (hasStart) return `Starting with ${start}`;\n        if (hasEnd) return `Ending with ${end}`;\n\n        return \"\";\n    }\n}\n"],"names":["StringHelper","transformWithSpaces","value","groupLength","regex","replace","RegExp","trim","padValue","retainSingleZero","padStart","parseInt","toString","shouldTruncateToTwoLines","text","widthOfElement","estimatedCharOnLine","Math","floor","length","split","truncateOneLine","minDivSize","baselineCharLength","incrementFactor","additionalCharAllowed","allowedCharLength","thresholdIndex","substring","truncateTwoLines","fontSize","lineHeight","totalCharsAllowed","keepFromStart","keepFromEnd","getTextWidth","font","document","context","canvas","createElement","getContext","measureText","width","maskValue","options","maskRange","unmaskRange","maskChar","maskRegex","maskTransformer","startIndex","endIndex","determineStartAndEndIndex","repeat","index0","index1","formatOrdinal","n","rule","ordinalPluralRules","select","suffixes","get","getMaskedDescription","displayMaskState","hasStart","hasEnd","start","end","Intl","PluralRules","type","Map"],"mappings":"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"}
+{"version":3,"file":"string-helper.js","sources":["../../src/util/string-helper.ts"],"sourcesContent":["// =============================================================================\n// TYPINGS\n// =============================================================================\ninterface MaskValueOptions {\n    maskRange?: number[] | undefined;\n    unmaskRange?: number[] | undefined;\n    maskRegex?: RegExp | undefined;\n    maskTransformer?: ((value: string) => string) | undefined;\n    maskChar?: string | undefined;\n}\n\n// =============================================================================\n// EXPORTS\n// =============================================================================\nexport class StringHelper {\n    public static transformWithSpaces(\n        value: string | any,\n        groupLength: number\n    ): string {\n        const regex = \"(.{\" + groupLength + \"})\";\n        return value\n            .replace(/[^\\dA-Z]/gi, \"\")\n            .replace(new RegExp(regex, \"g\"), \"$1 \")\n            .trim();\n    }\n\n    /**\n     * Pads single digit values with a zero and trims leading zero for\n     * values of length more than 2\n     * @param value the string value\n     * @param retainSingleZero setting true will allow single zero value\n     */\n    public static padValue(value: string, retainSingleZero?: boolean): string {\n        if (value === \"0\") {\n            return retainSingleZero ? value : value.padStart(2, \"0\");\n        }\n\n        if (value === \"\") {\n            return value;\n        }\n\n        const trimmedValue = parseInt(value);\n        return trimmedValue.toString().padStart(2, \"0\");\n    }\n\n    /**\n     * Checks if the text is required to be truncated and broken into two lines based\n     * on the available width of container. **Note: This is relevant to font size 18px or 1.125rem only **\n     * @param text input text\n     * @param widthOfElement element width in px\n     */\n    public static shouldTruncateToTwoLines(\n        text: string,\n        widthOfElement: number\n    ): boolean {\n        // This is arbitrary and based on tests to derive that every 9px increment ~= 1 char length.\n        // But this applies to font size 18px or 1.125rem only\n        const estimatedCharOnLine = Math.floor(widthOfElement / 9);\n        return (\n            text.length >= estimatedCharOnLine * 2 ||\n            (text.split(\" \").length === 1 && text.length > estimatedCharOnLine)\n        );\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param minDivSize the minimum container size (using size on mobileS viewport as baseline)\n     * @param baselineCharLength the baseline amount of characters to be displayed before truncation kicks. This\n     * will be increased if there is more space available (derived from `widthOfElement`)\n     * @param incrementFactor the size (in px).\n     */\n    public static truncateOneLine(\n        text: string,\n        widthOfElement: number,\n        minDivSize: number,\n        baselineCharLength: number,\n        incrementFactor = 8 // Arbitrary based on tests and applies to font size of 18px or 1.125rem\n    ): string {\n        let additionalCharAllowed = 0;\n        if (widthOfElement > minDivSize) {\n            additionalCharAllowed = Math.floor(\n                (widthOfElement - minDivSize) / incrementFactor\n            );\n        }\n        const allowedCharLength = baselineCharLength + additionalCharAllowed;\n        if (allowedCharLength < text.length) {\n            const thresholdIndex = Math.floor(allowedCharLength / 2); // We will cut it halfway to derive x num of characters\n            return (\n                text.substring(0, thresholdIndex) + // Use the first x\n                \" ... \" +\n                text.substring(text.length - thresholdIndex, text.length) // Use the last x\n            );\n        }\n\n        return text;\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param fontSize the fontsize of the text\n     * @param lineHeight the line height of the text\n     */\n    public static truncateTwoLines(\n        text: string,\n        widthOfElement: number,\n        fontSize: number,\n        lineHeight = 1.2\n    ): string {\n        // Estimate characters per line based on width and font size\n        const charsPerLine = Math.floor(\n            (widthOfElement * 2) / (fontSize * 0.6) // 0.6 is an approximation for average char width\n        );\n\n        // Calculate total characters allowed in two lines\n        const totalCharsAllowed = charsPerLine * (2 / lineHeight);\n\n        if (text.length <= totalCharsAllowed) {\n            return text; // No truncation needed\n        }\n\n        // Calculate the number of characters to keep\n        const keepFromStart = Math.floor(totalCharsAllowed * 0.6); // Keep 60% from start\n        const keepFromEnd = Math.floor(totalCharsAllowed * 0.2); // Keep 20% from end\n\n        // Truncate the text\n        const start = text.substring(0, keepFromStart);\n        const end = text.substring(text.length - keepFromEnd);\n\n        return `${start}...${end}`;\n    }\n\n    /**\n     * Returns the width of the text in the specified font\n     * https://stackoverflow.com/questions/118241/calculate-text-width-with-javascript/21015393#21015393\n     */\n    public static getTextWidth(text: string, font: string): number {\n        if (typeof document === \"undefined\") {\n            return 0;\n        }\n\n        // create a reusable canvas object for better performance\n        const canvas =\n            (StringHelper.getTextWidth as any).canvas ||\n            ((StringHelper.getTextWidth as any).canvas =\n                document.createElement(\"canvas\"));\n        const context = canvas.getContext(\"2d\");\n        context.font = font;\n\n        const metrics = context.measureText(text);\n        return metrics.width;\n    }\n\n    public static maskValue(value: string, options: MaskValueOptions): string {\n        if (!value) {\n            return value;\n        }\n\n        const {\n            maskRange,\n            unmaskRange,\n            maskChar = \"•\",\n            maskRegex,\n            maskTransformer,\n        } = options;\n\n        if (maskTransformer) {\n            return maskTransformer(value);\n        } else if (maskRegex) {\n            return value.replace(maskRegex, maskChar);\n        } else if (maskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    maskRange[0],\n                    maskRange[1]\n                );\n            return (\n                value.substring(0, startIndex) +\n                maskChar.repeat(\n                    value.substring(startIndex, endIndex + 1).length\n                ) +\n                value.substring(endIndex + 1)\n            );\n        } else if (unmaskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    unmaskRange[0],\n                    unmaskRange[1]\n                );\n            return (\n                maskChar.repeat(value.substring(0, startIndex).length) +\n                value.substring(startIndex, endIndex + 1) +\n                maskChar.repeat(value.substring(endIndex + 1).length)\n            );\n        }\n\n        return value;\n    }\n\n    private static determineStartAndEndIndex(index0: number, index1: number) {\n        return index0 < index1\n            ? { startIndex: index0, endIndex: index1 }\n            : { startIndex: index1, endIndex: index0 };\n    }\n\n    private static ordinalPluralRules = new Intl.PluralRules(\"en\", {\n        type: \"ordinal\",\n    });\n\n    private static suffixes = new Map([\n        [\"one\", \"st\"],\n        [\"two\", \"nd\"],\n        [\"few\", \"rd\"],\n        [\"other\", \"th\"],\n    ]);\n\n    public static formatOrdinal(n: number) {\n        const rule = StringHelper.ordinalPluralRules.select(n);\n        const suffix = StringHelper.suffixes.get(rule);\n        return `${n}${suffix}`;\n    }\n\n    public static getMaskedDescription(\n        value: string,\n        displayMaskState: \"masked\" | \"unmasked\",\n        maskRange?: number[]\n    ): string {\n        if (!value || displayMaskState !== \"masked\" || !maskRange) return \"\";\n\n        const [startIndex, endIndex] = maskRange;\n        const hasStart = startIndex > 0;\n        const hasEnd = endIndex < value.length - 1;\n\n        const start = hasStart ? value.substring(0, startIndex) : \"\";\n        const end = hasEnd ? value.substring(endIndex + 1) : \"\";\n\n        if (hasStart && hasEnd)\n            return `Starting with ${start} and ending with ${end}`;\n        if (hasStart) return `Starting with ${start}`;\n        if (hasEnd) return `Ending with ${end}`;\n\n        return \"\";\n    }\n\n    public static joinNonEmptyStrings(\n        strings: (string | undefined | null)[],\n        delimiter = \", \"\n    ): string {\n        return strings.filter(Boolean).join(delimiter);\n    }\n}\n"],"names":["StringHelper","transformWithSpaces","value","groupLength","regex","replace","RegExp","trim","padValue","retainSingleZero","padStart","parseInt","toString","shouldTruncateToTwoLines","text","widthOfElement","estimatedCharOnLine","Math","floor","length","split","truncateOneLine","minDivSize","baselineCharLength","incrementFactor","additionalCharAllowed","allowedCharLength","thresholdIndex","substring","truncateTwoLines","fontSize","lineHeight","totalCharsAllowed","keepFromStart","keepFromEnd","getTextWidth","font","document","context","canvas","createElement","getContext","measureText","width","maskValue","options","maskRange","unmaskRange","maskChar","maskRegex","maskTransformer","startIndex","endIndex","determineStartAndEndIndex","repeat","index0","index1","formatOrdinal","n","rule","ordinalPluralRules","select","suffixes","get","getMaskedDescription","displayMaskState","hasStart","hasEnd","start","end","joinNonEmptyStrings","strings","delimiter","filter","Boolean","join","Intl","PluralRules","type","Map"],"mappings":"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"}

package/util/styling-helper.d.ts

@@ -0,0 +1,6 @@
+import type { ColourCSSVariableString, RadiusCSSVariableString } from "../theme";
+import { BorderThickness } from "../theme";
+import type { ValueOf } from "./utility-types";
+export declare const isRadiusToken: (value: unknown) => value is RadiusCSSVariableString;
+export declare const isThicknessToken: (value: unknown) => value is ValueOf<typeof BorderThickness>;
+export declare const isColourToken: (value: unknown) => value is ColourCSSVariableString;

package/util/styling-helper.js

@@ -0,0 +1,2 @@
+import"../theme/theme-provider/index.js";import"react";import"../theme/theme-provider/context.js";import{BorderThickness as e}from"../theme/tokens/border.js";import"../theme/tokens/colour.js";import"../theme/tokens/font.js";import"../theme/tokens/media-query.js";import{Radius as t}from"../theme/tokens/radius.js";import{isTokenWithPrefix as r,isTokenFromSet as o}from"../theme/utils/token-resolver.js";import"./calendar-helper.js";import"../external/dayjs/dayjs.min.js";import"./simple-id-generator.js";import"./string-helper.js";import"@react-aria/live-announcer";import"../theme/utils/use-media-query.js";const m=new Set(Object.values(t)),s=new Set(Object.values(e)),i=e=>o(e,m),p=e=>o(e,s),n=e=>r(e,"var(--fds-colour-");export{n as isColourToken,i as isRadiusToken,p as isThicknessToken};
+//# sourceMappingURL=styling-helper.js.map

package/util/styling-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styling-helper.js","sources":["../../src/util/styling-helper.ts"],"sourcesContent":["import type {\n    ColourCSSVariableString,\n    RadiusCSSVariableString,\n} from \"../theme\";\nimport {\n    BorderThickness,\n    isTokenFromSet,\n    isTokenWithPrefix,\n    Radius,\n} from \"../theme\";\nimport type { ValueOf } from \"./utility-types\";\n\nconst radiusTokenSet = new Set<string>(Object.values(Radius));\nconst thicknessTokenSet = new Set<string>(Object.values(BorderThickness));\n\nexport const isRadiusToken = (\n    value: unknown\n): value is RadiusCSSVariableString => {\n    return isTokenFromSet<RadiusCSSVariableString>(value, radiusTokenSet);\n};\n\nexport const isThicknessToken = (\n    value: unknown\n): value is ValueOf<typeof BorderThickness> => {\n    return isTokenFromSet<ValueOf<typeof BorderThickness>>(\n        value,\n        thicknessTokenSet\n    );\n};\n\nexport const isColourToken = (\n    value: unknown\n): value is ColourCSSVariableString => {\n    return isTokenWithPrefix<ColourCSSVariableString>(\n        value,\n        \"var(--fds-colour-\"\n    );\n};\n"],"names":["radiusTokenSet","Set","Object","values","Radius","thicknessTokenSet","BorderThickness","isRadiusToken","value","isTokenFromSet","isThicknessToken","isColourToken","isTokenWithPrefix"],"mappings":"gmBAYA,MAAMA,EAAiB,IAAIC,IAAYC,OAAOC,OAAOC,IAC/CC,EAAoB,IAAIJ,IAAYC,OAAOC,OAAOG,IAE3CC,EACTC,GAEOC,EAAwCD,EAAOR,GAG7CU,EACTF,GAEOC,EACHD,EACAH,GAIKM,EACTH,GAEOI,EACHJ,EACA"}

package/util/time-helper.d.ts

@@ -41,6 +41,14 @@ export declare class TimeHelper {
     static updateHours(valueString: string, direction: "add" | "minus"): string;
     static convertTo24HourFormat(values: TimeValues): string;
     static convertHourTo12HourFormat(hourValue: string): string;
+    /**
+     * Formats a 24hr time range into a 12hr display string.
+     * @param start - "HH:mm" e.g. "13:00"
+     * @param end   - "HH:mm" e.g. "14:30"
+     * @returns e.g. "1:00PM to 2:30PM"
+     */
+    static formatTimeRange(start: string, end: string): string;
+    static isSameTime(a: string, b: string): boolean;
     static formatDisplayValue(value: string | undefined, format: TimeFormat): string;
     static toMinutesSeconds(_seconds: number): {
         minutes: number;
@@ -49,7 +57,7 @@ export declare class TimeHelper {
     static to24Hour(time: string): string;
     static generateTimings(interval: number, // In minutes
     format?: TimeFormat, startTime?: string | undefined, endTime?: string | undefined): string[];
-    static parseInput(input: string, format?: TimeFormat): string | undefined;
+    static parseInput(input: string | undefined, format?: TimeFormat): string | undefined;
     static findClosestFlooredTime(inputTime: string | undefined, timeArray: string[]): string | undefined;
     static timeToMinutes(time: string): number;
     static calculateDuration(startTime: string, endTime: string): number;

package/util/time-helper.js

@@ -1,2 +1,2 @@
-import t from"../external/dayjs/dayjs.min.js";import{StringHelper as r}from"./string-helper.js";var e;!function(t){t.AM="AM",t.PM="PM"}(e||(e={}));class o{static roundToNearestInterval(t,r,e){const[o,n]=t.split(":"),a=parseInt(o,10),i=parseInt(n,10);if(isNaN(a)||isNaN(i)||i<0||i>=60)throw new Error("Invalid time format");const s=60*a+i,u=s%r,l=0===u?s:e?s+(r-u):s-u,c=l%60;return`${Math.floor(l/60).toString().padStart(2,"0")}:${c.toString().padStart(2,"0")}`}static generateHourlyIntervals(r,e,o="ha"){const n="HH:mm";let a=t(r,n),i=t(e,n);a.isSame(i)&&(i=i.add(1,"day"));const s=[];for(;a.isBefore(i);)s.push(a.format(o)),a=a.add(1,"hour");return s}static getTimeValues(t,o){const n={hour:"",minute:"",period:e.AM};if(!o)return n;try{if("24hr"===t){const a=s(o,t);n.minute=r.padValue(a.minute);const i=parseInt(a.hour);0===Math.floor(i/12)?(n.period=e.AM,n.hour=0===i?"12":r.padValue(i.toString())):(n.period=e.PM,n.hour=12===i?i.toString():r.padValue((i-12).toString()))}else{const{hour:a,minute:i,period:u=""}=s(o,t);n.hour=r.padValue(a),n.minute=r.padValue(i),n.period="am"===u.toLowerCase()?e.AM:e.PM}return n}catch(t){return n}}static updateMinutes(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("0"):"55";const n=Math.floor(o/5),a=(("add"===e?n+1:o%5==0?n-1:n)%12+12)%12;return r.padValue((5*a).toString())}static updateHours(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("1"):"12";const n="add"===e?o+1:o-1;return n<=12&&n>0?r.padValue(n.toString()):13===n?r.padValue("1"):"12"}static convertTo24HourFormat(t){const r=parseInt(t.hour);let o;return o=t.period===e.PM?12===r?r.toString():(r+12).toString():12===r?"00":t.hour,`${o}:${t.minute}`}static convertHourTo12HourFormat(t){const e=parseInt(t),o=e%12==0?12..toString():(e%12).toString();return r.padValue(o)}static formatDisplayValue(t,e){try{const{hour:o,minute:n,period:a=""}=s(t,e),i=r.padValue(o);let u=`${i}:${r.padValue(n)}`;return"12hr"===e?(u+=a.toLowerCase(),u):u}catch(t){return""}}static toMinutesSeconds(t){return{minutes:Math.floor(t/60),seconds:t%60}}static to24Hour(t){if((null==t?void 0:t.includes("am"))||(null==t?void 0:t.includes("pm"))){const[r,e]=t.split(/(am|pm)/i),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&a<12&&(a+=12),"am"===e&&12===a&&(a=0),u(a,n)}return t}static generateTimings(t,r="12hr",e,n){const a=[];let i=0,s=1440-t;for(e&&(i=o.timeToMinutes(e)),n&&(s=o.timeToMinutes(n));i<=s;){let e=Math.floor(i/60);const o=i%60;if("12hr"===r){const t=e>=12?"pm":"am";e%=12,e=e||12;const r=u(e,o,t);a.push(r)}else{const t=u(e,o);a.push(t)}i+=t}return a}static parseInput(t,r="12hr"){if(""===t||void 0===t)return t;const e=t.trim().toLowerCase(),o=/^(?:(\d{1,2})([:.])?(\d{2})?)?(a|p|am|pm)?$/.exec(e);if(!o)return;let n=parseInt(o[1]||"0",10);const a=parseInt(o[3]||"0",10);let i=o[4];if(void 0===o[1]||n>24||a>59)return;if("a"===i?i="am":"p"===i&&(i="pm"),"24hr"===r)return"pm"===i&&n<12?n+=12:("am"===i&&12===n||24===n)&&(n=0),u(n,a);i?0===n||24===n?(i="am",n=12):n>12&&(i="pm",n-=12):(i=0===n||24===n||n>6&&n<12?"am":"pm",n=n%12||12);return u(n,a,i)}static findClosestFlooredTime(t,r){if(!t)return t;const e=o.timeToMinutes(t);let n="",a=1/0;for(const t of r){const r=o.timeToMinutes(t)-e;if(r<=0&&Math.abs(r)<a)a=Math.abs(r),n=t;else if(r>0)break}return n}static timeToMinutes(t){const[r,e]=t.toLowerCase().split(/(am|pm)/),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&12!==a&&(a+=12),"am"===e&&12===a&&(a=0),60*a+n}static calculateDuration(t,r){const e=o.timeToMinutes(t);return o.timeToMinutes(r)-e}static calculateScrollPosition(t){const{scrollTime:r,minTime:e,maxTime:a,interval:i,intervalWidth:s,options:u}=t;try{if(!/^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/.test(r))return console.warn(`Invalid scrollTime format: "${r}". Expected format: HH:mm.`),null;const t=(null==u?void 0:u.roundToInterval)?o.roundToNearestInterval(r,i):r,[l,c]=n(t);if(isNaN(l)||isNaN(c))return console.warn(`Invalid scrollTime: "${r}".`),null;const m=60*l+c,[p,d]=n(e),h=60*p+d,[f,g]=n(a);(m<h||m>60*f+g)&&console.warn(`scrollTime "${r}" is outside the range (${e} - ${a}).`);return(m-h)/i*s}catch(t){return console.warn(`Error processing scrollTime: "${r}".`,t),null}}}const n=t=>t.split(":").map(Number),a=(t,r)=>{const e=parseInt(t);return"24hr"===r?e>=0&&e<=23:e>=1&&e<=12},i=t=>{const r=parseInt(t);return r>=0&&r<=59},s=(t,r)=>{const e=t?t.split(":"):[],o=new Error("Invalid format");if("12hr"===r){if(2!==e.length||4!==e[1].length)throw o;const t=e[1].substring(0,2),s=e[1].substring(2);if(!a(e[0],r)||!i(t)||"am"!==(n=s).toLowerCase()&&"pm"!==n.toLowerCase())throw o;return{hour:e[0],minute:t,period:e[1].substring(2)}}if(2!==e.length)throw o;if(!a(e[0],r)||!i(e[1]))throw o;return{hour:e[0],minute:e[1]};var n},u=(t,r,e)=>e?`${t}:${r.toString().padStart(2,"0")}${e}`:`${t.toString().padStart(2,"0")}:${r.toString().padStart(2,"0")}`;export{e as EPeriod,o as TimeHelper};
+import t from"../external/dayjs/dayjs.min.js";import{StringHelper as r}from"./string-helper.js";var e;!function(t){t.AM="AM",t.PM="PM"}(e||(e={}));class o{static roundToNearestInterval(t,r,e){const[o,n]=t.split(":"),a=parseInt(o,10),i=parseInt(n,10);if(isNaN(a)||isNaN(i)||i<0||i>=60)throw new Error("Invalid time format");const s=60*a+i,u=s%r,m=0===u?s:e?s+(r-u):s-u,l=m%60;return`${Math.floor(m/60).toString().padStart(2,"0")}:${l.toString().padStart(2,"0")}`}static generateHourlyIntervals(r,e,o="ha"){const n="HH:mm";let a=t(r,n),i=t(e,n);a.isSame(i)&&(i=i.add(1,"day"));const s=[];for(;a.isBefore(i);)s.push(a.format(o)),a=a.add(1,"hour");return s}static getTimeValues(t,o){const n={hour:"",minute:"",period:e.AM};if(!o)return n;try{if("24hr"===t){const a=s(o,t);n.minute=r.padValue(a.minute);const i=parseInt(a.hour);0===Math.floor(i/12)?(n.period=e.AM,n.hour=0===i?"12":r.padValue(i.toString())):(n.period=e.PM,n.hour=12===i?i.toString():r.padValue((i-12).toString()))}else{const{hour:a,minute:i,period:u=""}=s(o,t);n.hour=r.padValue(a),n.minute=r.padValue(i),n.period="am"===u.toLowerCase()?e.AM:e.PM}return n}catch(t){return n}}static updateMinutes(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("0"):"55";const n=Math.floor(o/5),a=(("add"===e?n+1:o%5==0?n-1:n)%12+12)%12;return r.padValue((5*a).toString())}static updateHours(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("1"):"12";const n="add"===e?o+1:o-1;return n<=12&&n>0?r.padValue(n.toString()):13===n?r.padValue("1"):"12"}static convertTo24HourFormat(t){const r=parseInt(t.hour);let o;return o=t.period===e.PM?12===r?r.toString():(r+12).toString():12===r?"00":t.hour,`${o}:${t.minute}`}static convertHourTo12HourFormat(t){const e=parseInt(t),o=e%12==0?12..toString():(e%12).toString();return r.padValue(o)}static formatTimeRange(r,e){return`${t(r,"HH:mm").format("h:mmA")} to ${t(e,"HH:mm").format("h:mmA")}`}static isSameTime(r,e){return t(r,"H:mm").isSame(t(e,"H:mm"),"minute")}static formatDisplayValue(t,e){try{const{hour:o,minute:n,period:a=""}=s(t,e),i=r.padValue(o);let u=`${i}:${r.padValue(n)}`;return"12hr"===e?(u+=a.toLowerCase(),u):u}catch(t){return""}}static toMinutesSeconds(t){return{minutes:Math.floor(t/60),seconds:t%60}}static to24Hour(t){if((null==t?void 0:t.includes("am"))||(null==t?void 0:t.includes("pm"))){const[r,e]=t.split(/(am|pm)/i),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&a<12&&(a+=12),"am"===e&&12===a&&(a=0),u(a,n)}return t}static generateTimings(t,r="12hr",e,n){const a=[];let i=0,s=1440-t;for(e&&(i=o.timeToMinutes(e)),n&&(s=o.timeToMinutes(n));i<=s;){let e=Math.floor(i/60);const o=i%60;if("12hr"===r){const t=e>=12?"pm":"am";e%=12,e=e||12;const r=u(e,o,t);a.push(r)}else{const t=u(e,o);a.push(t)}i+=t}return a}static parseInput(t,r="12hr"){if(""===t||void 0===t)return t;const e=t.trim().toLowerCase(),o=/^(?:(\d{1,2})([:.])?(\d{2})?)?(a|p|am|pm)?$/.exec(e);if(!o)return;let n=parseInt(o[1]||"0",10);const a=parseInt(o[3]||"0",10);let i=o[4];if(void 0===o[1]||n>24||a>59)return;if("a"===i?i="am":"p"===i&&(i="pm"),"24hr"===r)return"pm"===i&&n<12?n+=12:("am"===i&&12===n||24===n)&&(n=0),u(n,a);i?0===n||24===n?(i="am",n=12):n>12&&(i="pm",n-=12):(i=0===n||24===n||n>6&&n<12?"am":"pm",n=n%12||12);return u(n,a,i)}static findClosestFlooredTime(t,r){if(!t)return t;const e=o.timeToMinutes(t);let n="",a=1/0;for(const t of r){const r=o.timeToMinutes(t)-e;if(r<=0&&Math.abs(r)<a)a=Math.abs(r),n=t;else if(r>0)break}return n}static timeToMinutes(t){const[r,e]=t.toLowerCase().split(/(am|pm)/),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&12!==a&&(a+=12),"am"===e&&12===a&&(a=0),60*a+n}static calculateDuration(t,r){const e=o.timeToMinutes(t);return o.timeToMinutes(r)-e}static calculateScrollPosition(t){const{scrollTime:r,minTime:e,maxTime:a,interval:i,intervalWidth:s,options:u}=t;try{if(!/^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/.test(r))return console.warn(`Invalid scrollTime format: "${r}". Expected format: HH:mm.`),null;const t=(null==u?void 0:u.roundToInterval)?o.roundToNearestInterval(r,i):r,[m,l]=n(t);if(isNaN(m)||isNaN(l))return console.warn(`Invalid scrollTime: "${r}".`),null;const c=60*m+l,[p,d]=n(e),h=60*p+d,[f,g]=n(a);(c<h||c>60*f+g)&&console.warn(`scrollTime "${r}" is outside the range (${e} - ${a}).`);return(c-h)/i*s}catch(t){return console.warn(`Error processing scrollTime: "${r}".`,t),null}}}const n=t=>t.split(":").map(Number),a=(t,r)=>{const e=parseInt(t);return"24hr"===r?e>=0&&e<=23:e>=1&&e<=12},i=t=>{const r=parseInt(t);return r>=0&&r<=59},s=(t,r)=>{const e=t?t.split(":"):[],o=new Error("Invalid format");if("12hr"===r){if(2!==e.length||4!==e[1].length)throw o;const t=e[1].substring(0,2),s=e[1].substring(2);if(!a(e[0],r)||!i(t)||"am"!==(n=s).toLowerCase()&&"pm"!==n.toLowerCase())throw o;return{hour:e[0],minute:t,period:e[1].substring(2)}}if(2!==e.length)throw o;if(!a(e[0],r)||!i(e[1]))throw o;return{hour:e[0],minute:e[1]};var n},u=(t,r,e)=>e?`${t}:${r.toString().padStart(2,"0")}${e}`:`${t.toString().padStart(2,"0")}:${r.toString().padStart(2,"0")}`;export{e as EPeriod,o as TimeHelper};
 //# sourceMappingURL=time-helper.js.map

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":"oGASYA,GAAZ,SAAYA,GACRA,EAAA,GAAA,KACAA,EAAA,GAAA,IACH,CAHD,CAAYA,IAAAA,EAAO,CAAA,UAuCNC,EASF,6BAAOC,CACVC,EACAC,EACAC,GAEA,MAAOC,EAAUC,GAAcJ,EAAKK,MAAM,KACpCC,EAAQC,SAASJ,EAAU,IAC3BK,EAAUD,SAASH,EAAY,IAGrC,GAAIK,MAAMH,IAAUG,MAAMD,IAAYA,EAAU,GAAKA,GAAW,GAC5D,MAAM,IAAIE,MAAM,uBAIpB,MAAMC,EAAuB,GAARL,EAAaE,EAC5BI,EAAYD,EAAeV,EAG3BY,EACY,IAAdD,EACMD,EACAT,EACAS,GAAgBV,EAAWW,GAC3BD,EAAeC,EAInBE,EAA2BD,EAAiB,GAQlD,MAAO,GATcE,KAAKC,MAAMH,EAAiB,IAIbI,WAAWC,SAAS,EAAG,QAClCJ,EACpBG,WACAC,SAAS,EAAG,MAGrB,CAEO,8BAAOC,CACVC,EACAC,EACAC,EAAkB,MAElB,MAAMC,EAAS,QACf,IAAIC,EAAQC,EAAML,EAAWG,GACzBG,EAAMD,EAAMJ,EAASE,GAErBC,EAAMG,OAAOD,KACbA,EAAMA,EAAIE,IAAI,EAAG,QAGrB,MAAMC,EAAsB,GAE5B,KAAOL,EAAMM,SAASJ,IAClBG,EAAUE,KAAKP,EAAMD,OAAOD,IAC5BE,EAAQA,EAAMI,IAAI,EAAG,QAGzB,OAAOC,CACX,CAEO,oBAAOG,CACVT,EACAU,GAGA,MAAMC,EAAyB,CAC3BC,KAAM,GACNC,OAAQ,GACRC,OAAQxC,EAAQyC,IAGpB,IAAKL,EAAO,OAAOC,EAEnB,IACI,GAAe,SAAXX,EAAmB,CACnB,MAAMgB,EAAQC,EAAeP,EAAOV,GAEpCW,EAAWE,OAASK,EAAaC,SAASH,EAAMH,QAGhD,MAAMD,EAAO5B,SAASgC,EAAMJ,MAEE,IAA1BpB,KAAKC,MAAMmB,EAAO,KAClBD,EAAWG,OAASxC,EAAQyC,GAC5BJ,EAAWC,KACE,IAATA,EACM,KACAM,EAAaC,SAASP,EAAKlB,cAErCiB,EAAWG,OAASxC,EAAQ8C,GAC5BT,EAAWC,KACE,KAATA,EACMA,EAAKlB,WACLwB,EAAaC,UAAUP,EAAO,IAAIlB,YAEpD,KAAO,CACH,MAAMkB,KACFA,EAAIC,OACJA,EAAMC,OACNA,EAAS,IACTG,EAAeP,EAAOV,GAE1BW,EAAWC,KAAOM,EAAaC,SAASP,GACxCD,EAAWE,OAASK,EAAaC,SAASN,GAC1CF,EAAWG,OACkB,OAAzBA,EAAOO,cAAyB/C,EAAQyC,GAAKzC,EAAQ8C,EAC7D,CAEA,OAAOT,CACX,CAAE,MAAAW,GACE,OAAOX,CACX,CACJ,CAEO,oBAAOY,CACVC,EACAC,GAEA,MAAMC,EAAe1C,SAASwC,GAE9B,GAAItC,MAAMwC,GACN,MAAqB,QAAdD,EAAsBP,EAAaC,SAAS,KAAO,KAO9D,MAMMQ,EAAkBnC,KAAKC,MAAMiC,EAAe,GAe5CE,IALY,QAAdH,EACME,EAAkB,EAClBD,EAAe,GAAM,EACrBC,EAAkB,EAClBA,GApBI,UAuBd,OAAOT,EAAaC,UAAoB,EAAVS,GAAalC,WAC/C,CAEO,kBAAOmC,CACVL,EACAC,GAEA,MAAMC,EAAe1C,SAASwC,GAE9B,GAAItC,MAAMwC,GACN,MAAqB,QAAdD,EAAsBP,EAAaC,SAAS,KAAO,KAG9D,MAAMW,EACY,QAAdL,EAAsBC,EAAe,EAAIA,EAAe,EAE5D,OAAOI,GAAa,IAAMA,EAAY,EAChCZ,EAAaC,SAASW,EAAUpC,YAClB,KAAdoC,EACAZ,EAAaC,SAAS,KACtB,IACV,CAEO,4BAAOY,CAAsBC,GAChC,MAAMpB,EAAO5B,SAASgD,EAAOpB,MAC7B,IAAIqB,EAQJ,OALIA,EADAD,EAAOlB,SAAWxC,EAAQ8C,GACJ,KAATR,EAAcA,EAAKlB,YAAckB,EAAO,IAAIlB,WAEnC,KAATkB,EAAc,KAAOoB,EAAOpB,KAGtC,GAAGqB,KAAcD,EAAOnB,QACnC,CAEO,gCAAOqB,CAA0BC,GACpC,MAAMvB,EAAO5B,SAASmD,GAChBF,EACFrB,EAAO,IAAO,EAAI,IAAKlB,YAAckB,EAAO,IAAIlB,WAEpD,OAAOwB,EAAaC,SAASc,EACjC,CAQO,sBAAOG,CAAgBnC,EAAeE,GACzC,MAAO,GAAGD,EAAMD,EAAO,SAASD,OAAO,eAAeE,EAClDC,EACA,SACFH,OAAO,UACb,CAEO,iBAAOqC,CAAWC,EAAWC,GAChC,OAAOrC,EAAMoC,EAAG,QAAQlC,OAAOF,EAAMqC,EAAG,QAAS,SACrD,CAEO,yBAAOC,CACV9B,EACAV,GAEA,IACI,MAAMY,KAAEA,EAAIC,OAAEA,EAAMC,OAAEA,EAAS,IAAOG,EAAeP,EAAOV,GAEtDyC,EAAavB,EAAaC,SAASP,GAGzC,IAAI8B,EAAY,GAAGD,KAFEvB,EAAaC,SAASN,KAI3C,MAAe,SAAXb,GACA0C,GAAa5B,EAAOO,cAEbqB,GAGJA,CACX,CAAE,MAAApB,GACE,MAAO,EACX,CACJ,CAEO,uBAAOqB,CAAiBC,GAI3B,MAAO,CACH3D,QAJYO,KAAKC,MAAMmD,EAAW,IAKlCC,QAJYD,EAAW,GAM/B,CAGO,eAAOE,CAASrE,GACnB,IAAIA,aAAI,EAAJA,EAAMsE,SAAS,SAAStE,aAAI,EAAJA,EAAMsE,SAAS,OAAO,CAC9C,MAAOC,EAAGC,GAAKxE,EAAKK,MAAM,aACnBoE,EAAIC,GAAKH,EAAElE,MAAM,KAAKsE,IAAIC,QACjC,IAAIC,EAAIJ,EAGR,MAFU,OAAND,GAAcK,EAAI,KAAIA,GAAK,IACrB,OAANL,GAAoB,KAANK,IAAUA,EAAI,GACzBC,EAAaD,EAAGH,EAC3B,CACA,OAAO1E,CACX,CAGO,sBAAO+E,CACV9E,EACAsB,EAAqB,OACrBH,EACAC,GAEA,MAAM2D,EAAU,GAChB,IAAIC,EAAiB,EACjBC,EAAa,KAAOjF,EAUxB,IAPImB,IACA6D,EAAiBnF,EAAWqF,cAAc/D,IAE1CC,IACA6D,EAAapF,EAAWqF,cAAc9D,IAGnC4D,GAAkBC,GAAY,CACjC,IAAI5E,EAAQS,KAAKC,MAAMiE,EAAiB,IACxC,MAAMzE,EAAUyE,EAAiB,GAEjC,GAAe,SAAX1D,EAAmB,CACnB,MAAMc,EAAS/B,GAAS,GAAK,KAAO,KAEpCA,GAAgB,GAChBA,EAAQA,GAAgB,GAExB,MAAM8E,EAAaN,EAAaxE,EAAOE,EAAS6B,GAChD2C,EAAQjD,KAAKqD,EACjB,KAAO,CACH,MAAMA,EAAaN,EAAaxE,EAAOE,GACvCwE,EAAQjD,KAAKqD,EACjB,CAEAH,GAAkBhF,CACtB,CAEA,OAAO+E,CACX,CAGO,iBAAOK,CACVC,EACA/D,EAAqB,QAErB,GAAc,KAAV+D,QAA0BC,IAAVD,EAAqB,OAAOA,EAEhD,MAAME,EAAiBF,EAAMG,OAAO7C,cAE9B8C,EADY,8CACMC,KAAKH,GAE7B,IAAKE,EAAO,OAEZ,IAAIpF,EAAQC,SAASmF,EAAM,IAAM,IAAK,IACtC,MAAMlF,EAAUD,SAASmF,EAAM,IAAM,IAAK,IAC1C,IAAIrD,EAASqD,EAAM,GAGnB,QAAiBH,IAAbG,EAAM,IAAoBpF,EAAQ,IAAME,EAAU,GAAI,OAS1D,GANe,MAAX6B,EACAA,EAAS,KACS,MAAXA,IACPA,EAAS,MAGE,SAAXd,EASA,MAPe,OAAXc,GAAmB/B,EAAQ,GAC3BA,GAAS,IACU,OAAX+B,GAA6B,KAAV/B,GAA2B,KAAVA,KAC5CA,EAAQ,GAILwE,EAAaxE,EAAOE,GAI3B6B,EACc,IAAV/B,GAAyB,KAAVA,GACf+B,EAAS,KACT/B,EAAQ,IACDA,EAAQ,KACf+B,EAAS,KACT/B,GAAS,KAGb+B,EAEc,IAAV/B,GAAyB,KAAVA,GAAiBA,EAAQ,GAAKA,EAAQ,GAC/C,KACA,KACVA,EAAQA,EAAQ,IAAM,IAM1B,OAFsBwE,EAAaxE,EAAOE,EAAS6B,EAGvD,CAEO,6BAAOuD,CACVC,EACAC,GAEA,IAAKD,EAAW,OAAOA,EACvB,MAAME,EAAsBjG,EAAWqF,cAAcU,GAErD,IAAIG,EAAc,GACdC,EAAgBC,IAEpB,IAAK,MAAMlG,KAAQ8F,EAAW,CAC1B,MACMK,EADgBrG,EAAWqF,cAAcnF,GACZ+F,EAGnC,GAAII,GAAc,GAAKpF,KAAKqF,IAAID,GAAcF,EAC1CA,EAAgBlF,KAAKqF,IAAID,GACzBH,EAAchG,OAGb,GAAImG,EAAa,EAClB,KAER,CAEA,OAAOH,CACX,CAGO,oBAAOb,CAAcnF,GACxB,MAAOqG,EAAcC,GAAQtG,EAAK4C,cAAcvC,MAAM,YAC/CkG,EAAeC,GAAgBH,EACjChG,MAAM,KACNsE,IAAIC,QACT,IAAI6B,EAAaF,EASjB,MAPa,OAATD,GAAgC,KAAfG,IACjBA,GAAc,IAEL,OAATH,GAAgC,KAAfG,IACjBA,EAAa,GAGG,GAAbA,EAAkBD,CAC7B,CAGO,wBAAOE,CACVtF,EACAC,GAEA,MAAMmF,EAAe1G,EAAWqF,cAAc/D,GAE9C,OADmBtB,EAAWqF,cAAc9D,GACxBmF,CACxB,CAOO,8BAAOG,CACVC,GAEA,MAAMC,WACFA,EAAUC,QACVA,EAAOC,QACPA,EAAO9G,SACPA,EAAQ+G,cACRA,EAAaC,QACbA,GACAL,EAEJ,IAGI,IADkB,oCACHM,KAAKL,GAIhB,OAHAM,QAAQC,KACJ,+BAA+BP,+BAE5B,KAIX,MAAMQ,GAAYJ,aAAO,EAAPA,EAASK,iBACrBxH,EAAWC,uBAAuB8G,EAAY5G,GAC9C4G,GAECvG,EAAOE,GAAW+G,EAAmBF,GAG5C,GAAI5G,MAAMH,IAAUG,MAAMD,GAEtB,OADA2G,QAAQC,KAAK,wBAAwBP,OAC9B,KAGX,MAAMW,EAAwB,GAARlH,EAAaE,GAE5BiH,EAAUC,GAAcH,EAAmBT,GAC5Ca,EAA6B,GAAXF,EAAgBC,GAEjCE,EAAUC,GAAcN,EAAmBR,IAK9CS,EAAgBG,GAChBH,EAL+B,GAAXI,EAAgBC,IAOpCV,QAAQC,KACJ,eAAeP,4BAAqCC,OAAaC,OAQzE,OAJyBS,EAAgBG,GACK1H,EACF+G,CAGhD,CAAE,MAAOc,GAKL,OAJAX,QAAQC,KACJ,iCAAiCP,MACjCiB,GAEG,IACX,CACJ,EAeJ,MAAMP,EAAsBnC,GACjBA,EAAW/E,MAAM,KAAKsE,IAAIC,QAE/BmD,EAAc,CAACvE,EAAoBjC,KACrC,MAAMyG,EAAWzH,SAASiD,GAC1B,MAAkB,SAAXjC,EACDyG,GAAY,GAAKA,GAAY,GAC7BA,GAAY,GAAKA,GAAY,EAAE,EAGnCC,EAAkBzE,IACpB,MAAMwE,EAAWzH,SAASiD,GAC1B,OAAOwE,GAAY,GAAKA,GAAY,EAAE,EAUpCxF,EAAiB,CACnBP,EACAV,KAEA,MAAM2G,EAAUjG,EAAQA,EAAM5B,MAAM,KAAO,GACrCyH,EAAQ,IAAIpH,MAAM,kBAExB,GAAe,SAAXa,EAAmB,CAEnB,GAAuB,IAAnB2G,EAAQC,QAAsC,IAAtBD,EAAQ,GAAGC,OAAc,MAAML,EAE3D,MAAM1F,EAAS8F,EAAQ,GAAGE,UAAU,EAAG,GACjC/F,EAAS6F,EAAQ,GAAGE,UAAU,GAGpC,IACKL,EAAYG,EAAQ,GAAI3G,KACxB0G,EAAe7F,IAtBe,QAFhBiG,EAyBIhG,GAvBNO,eACkB,OAAnCyF,EAAiBzF,cAwBb,MAAMkF,EAGV,MAAO,CACH3F,KAAM+F,EAAQ,GACd9F,SACAC,OAAQ6F,EAAQ,GAAGE,UAAU,GAErC,CAEI,GAAuB,IAAnBF,EAAQC,OAAc,MAAML,EAEhC,IAAKC,EAAYG,EAAQ,GAAI3G,KAAY0G,EAAeC,EAAQ,IAC5D,MAAMJ,EAGV,MAAO,CACH3F,KAAM+F,EAAQ,GACd9F,OAAQ8F,EAAQ,IA7CF,IAACG,CA+CvB,EAGEvD,EAAe,CAACxE,EAAeE,EAAiB6B,IAC3CA,EACD,GAAG/B,KAASE,EAAQS,WAAWC,SAAS,EAAG,OAAOmB,IAClD,GAAG/B,EAAMW,WAAWC,SAAS,EAAG,QAAQV,EACnCS,WACAC,SAAS,EAAG"}

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/v3_theme/colour-primitive/specs/smgs-colour-set.d.ts

@@ -0,0 +1,2 @@
+import type { V3_PrimitiveColourSet } from "../../types";
+export declare const V3_SMGSColourSet: V3_PrimitiveColourSet;

package/v3_theme/colour-primitive/specs/smgs-colour-set.js

@@ -0,0 +1,2 @@
+const r={"brand-10":"#0B181F","brand-20":"#132B35","brand-30":"#1B3D4C","brand-40":"#25546A","brand-50":"#306F8B","brand-60":"#459EC6","brand-70":"#70B5D3","brand-80":"#93C7DE","brand-90":"#CBE4EF","brand-95":"#EBF4F9","brand-100":"#F3F9FB","primary-10":"#0B181F","primary-20":"#132B35","primary-30":"#1B3D4C","primary-40":"#25546A","primary-50":"#306F8B","primary-60":"#459EC6","primary-70":"#70B5D3","primary-80":"#93C7DE","primary-90":"#CBE4EF","primary-95":"#EBF4F9","primary-100":"#F3F9FB","secondary-10":"#1E1500","secondary-20":"#352500","secondary-30":"#4B3500","secondary-40":"#674A00","secondary-50":"#896100","secondary-60":"#C28A00","secondary-70":"#E1A100","secondary-80":"#FAB200","secondary-90":"#FDDD8E","secondary-95":"#FEF2D5","secondary-100":"#FFF9EA","neutral-10":"#161616","neutral-20":"#282828","neutral-30":"#393939","neutral-40":"#4E4E4E","neutral-50":"#686868","neutral-60":"#969492","neutral-70":"#AFACA7","neutral-80":"#C2BFBB","neutral-90":"#E4DFD9","neutral-95":"#F4F1EF","neutral-100":"#F9F8F7","success-10":"#071913","success-20":"#0D2D22","success-30":"#134031","success-40":"#1A5944","success-50":"#237559","success-60":"#31A77E","success-70":"#39C293","success-80":"#67D2AD","success-90":"#B8EAD9","success-95":"#E3F7F0","success-100":"#F1FBF8","warning-10":"#211403","warning-20":"#3B2205","warning-30":"#543108","warning-40":"#73440B","warning-50":"#98590E","warning-60":"#D38221","warning-70":"#DEA057","warning-80":"#E5B77F","warning-90":"#F3DDC3","warning-95":"#FAF2E8","warning-100":"#FDF9F4","error-10":"#2E0A0C","error-20":"#4F1114","error-30":"#70171C","error-40":"#972026","error-50":"#C62932","error-60":"#F7636B","error-70":"#F98D93","error-80":"#FAAAAE","error-90":"#FDD7D9","error-95":"#FEF0F1","error-100":"#FFF6F6","info-10":"#0F1627","info-20":"#1B2745","info-30":"#273763","info-40":"#354D88","info-50":"#4665B3","info-60":"#6A90F6","info-70":"#8DAAF8","info-80":"#A7BEFA","info-90":"#D4DFFD","info-95":"#EEF3FE","info-100":"#F5F8FE",white:"#FFFFFF",black:"#000000","primary-inverse":"#FAB200"};export{r as V3_SMGSColourSet};
+//# sourceMappingURL=smgs-colour-set.js.map